2.4.5. Amazon Simple Storage Service を使用した 3scale のデプロイ

Amazon Simple Storage Service (Amazon S3) を使用した 3scale のデプロイは任意の手順です。以下の手順を使用して、Amazon S3 で 3scale をデプロイします。

手順

  1. amp-s3.yml ダウンロードします。
  2. ターミナルセッションから OpenShift にログインします。

    oc login
  3. プロジェクトを選択するか新しいプロジェクトを作成します。

    oc project <project_name>

    または

oc new-project <project_name>
  1. oc new-app コマンドを入力します。

    • --file オプションを使用して、amp-s3.yml ファイルへのパスを指定します。
    • --param オプションを以下の値を指定します。

      • WILDCARD_DOMAIN: パラメーターは OpenShift クラスターのドメインに設定されます。
      • AWS_BUCKET: ターゲットバケット名に置き換えます。
      • AWS_ACCESS_KEY_ID: AWS 認証情報 ID に置き換えます。
      • AWS_SECRET_ACCESS_KEY: AWS 認証情報 KEY に置き換えます。
      • AWS_REGION: with the AWS: リージョンに置き換えます。
      • AWS_HOSTNAME: Amazon エンドポイント: AWS S3 と互換性のあるプロバイダーエンドポイントのホスト名。
      • AWS_PROTOCOL: デフォルト: HTTPS - AWS S3 と互換性のあるプロバイダーエンドポイントプロトコル。
      • AWS_PATH_STYLE: デフォルト: false - true に設定すると、バケット名は常にリクエスト URI に残り、サブドメインとしてホストに移動されません。
    • 管理ポータルでカスタム名を設定するには --param オプションを指定して TENANT_NAME パラメーターを指定します。省略した場合、デフォルトは 3scale に設定されます。

      oc new-app --file /path/to/amp-s3.yml \
      	--param WILDCARD_DOMAIN=<a-domain-that-resolves-to-your-ocp-cluster.com> \
      	--param TENANT_NAME=3scale \
      	--param AWS_ACCESS_KEY_ID=<your-aws-access-key-id> \
      	--param AWS_SECRET_ACCESS_KEY=<your-aws-access-key-secret> \
      	--param AWS_BUCKET=<your-target-bucket-name> \
      	--param AWS_REGION=<your-aws-bucket-region> \
      	--param FILE_UPLOAD_STORAGE=s3

      ターミナルには、マスターおよびテナント URL と、新たに作成された 3scale 管理ポータルの認証情報が表示されます。この出力には以下の情報が含まれます。

    • マスター管理者のユーザー名
    • マスターのパスワード
    • マスターのトークン情報
    • テナントのユーザー名
    • テナントのパスワード
    • テナントのトークン情報
  2. https://user-admin.3scale-project.example.com に admin/xXxXyz123 としてログインします。

    ...
    
    * With parameters:
     * ADMIN_PASSWORD=xXxXyz123 # generated
     * ADMIN_USERNAME=admin
     * TENANT_NAME=user
     ...
    
     * MASTER_NAME=master
     * MASTER_USER=master
     * MASTER_PASSWORD=xXxXyz123 # generated
     ...
    
    --> Success
    Access your application via route 'user-admin.3scale-project.example.com'
    Access your application via route 'master-admin.3scale-project.example.com'
    Access your application via route 'backend-user.3scale-project.example.com'
    Access your application via route 'user.3scale-project.example.com'
    Access your application via route 'api-user-apicast-staging.3scale-project.example.com'
    Access your application via route 'api-user-apicast-production.3scale-project.example.com'
    Access your application via route 'apicast-wildcard.3scale-project.example.com'
    
    ...
  3. 後で確認できるようにするため、詳細を書き留めておきます。
  4. 以下のコマンドが返されると、OpenShift での 3scale デプロイメントが成功しています。

    oc wait --for=condition=available --timeout=-1s $(oc get dc --output=name)
    注記

    OpenShift への 3scale のデプロイメントに成功すると、ログインクレデンシャルが機能します。