3scale の移行

手順

1. 3scale で使用するデータベースに応じて、${SYSTEM_DB} を以下のいずれかの値に設定します。

   • データベースが MySQL の場合: SYSTEM_DB=system-mysql
   • データベースが PostgreSQL の場合: SYSTEM_DB=system-postgresql

2. 既存の DeploymentConfigs でバックアップファイルを作成します。

   $ THREESCALE_DC_NAMES="apicast-production apicast-staging backend-cron backend-listener backend-redis backend-worker system-app system-memcache ${SYSTEM_DB} system-redis system-sidekiq system-sphinx zync zync-database zync-que"
   
   for component in ${THREESCALE_DC_NAMES}; do oc get --export -o yaml dc ${component} > ${component}_dc.yml ; done

   Copy to Clipboard Toggle word wrap

3. export all コマンドでエクスポートされるプロジェクト内のすべての既存 OpenShift リソースをバックアップします。

   $ oc get -o yaml --export all > threescale-project-elements.yaml

   Copy to Clipboard Toggle word wrap

4. export all コマンドでエクスポートされない追加の要素でバックアップファイルを作成します。

   $ for object in rolebindings serviceaccounts secrets imagestreamtags cm rolebindingrestrictions limitranges resourcequotas pvc templates cronjobs statefulsets hpa deployments replicasets poddisruptionbudget endpoints
   do
     oc get -o yaml --export $object > $object.yaml
   done

   Copy to Clipboard Toggle word wrap
5. 生成されたすべてのファイルが空ではないこと、およびそれらすべての内容が予想どおりであることを確認します。

手順

1. AMP_RELEASE にパッチを適用するには、以下のコマンドを実行します。

   $ oc patch cm system-environment --patch '{"data": {"AMP_RELEASE": "2.11"}}'

   Copy to Clipboard Toggle word wrap

2. system-environment ConfigMap の AMP_RELEASE キーの値が 2.11 であることを確認します。

   $ oc get cm system-environment -o json | jq '.data["AMP_RELEASE"]'

   Copy to Clipboard Toggle word wrap

手順

1. system-app DeploymentConfig を編集して、system-app pre-hook pod の変数を更新します。

   $ oc edit dc system-app

   Copy to Clipboard Toggle word wrap

   インタラクティブなエディターセッションを開きます。.spec.strategy.rollingParams.pre.execNewPod.env 配列セクションで BACKEND_ROUTE 環境変数を見つけます。

   1. 次のエントリーを

      - name: BACKEND_ROUTE
        valueFrom:
          secretKeyRef:
            key: route_endpoint
            name: backend-listener

      Copy to Clipboard Toggle word wrap

   2. 以下のエントリーに置き換えます。

      - name: BACKEND_ROUTE
        value: http://backend-listener:3000/internal/

      Copy to Clipboard Toggle word wrap

      変更内容を保存し、インタラクティブエディターセッションを終了します。

2. system-app コンテナーのエントリーを更新します。

   $ oc set env dc/system-app BACKEND_ROUTE="http://backend-listener:3000/internal/"

   Copy to Clipboard Toggle word wrap

   このコマンドがトリガーとなり system-app が再デプロイされます。再デプロイされ、対応する新しい Pod の準備が整い、以前の Pod が終了するまで待ちます。

3. system-sidekiq コンテナーで更新します。

   $ oc set env dc/system-sidekiq BACKEND_ROUTE="http://backend-listener:3000/internal/"

   Copy to Clipboard Toggle word wrap

   このコマンドがトリガーとなり system-sidekiq が再デプロイされます。再デプロイされ、対応する新しい Pod の準備が整い、以前の Pod が終了するまで待ちます。

手順

1. 以下を実行して prometheus.io/port and prometheus.io/scrape アノテーションの現在の値をメモします。

   $ oc get dc zync -o json | jq .metadata.annotations

   Copy to Clipboard Toggle word wrap

2. zync DeploymentConfig の PodTemplate アノテーションに、このアノテーションを追加します。以下のコマンドで prometheus.io/port and prometheus.io/scrape アノテーションの値が異なる場合に、直前のコマンドで示されたように zync DeploymentConfig で現在設定されている値に置き換えてください。

   $ oc patch dc zync --patch '{"spec":{"template":{"metadata":{"annotations":{"prometheus.io/port":"9393","prometheus.io/scrape":"true"}}}}}'

   Copy to Clipboard Toggle word wrap

3. zync Deployment Config のアノテーションからオリジナルのアノテーションを削除します。

   $ oc annotate dc zync prometheus.io/scrape-
   $ oc annotate dc zync prometheus.io/port-

   Copy to Clipboard Toggle word wrap

   このコマンドは zync の再デプロイメントをトリガーします。再デプロイされ、対応する新しい Pod の準備が整い、以前の Pod が終了するまで待ちます。

手順

1. 以下のコマンドで、backend-cronに設定されている現在のリソース要件を確認します。

   $ oc get dc backend-cron -o json | jq .spec.template.spec.containers[0].resources

   Copy to Clipboard Toggle word wrap

   出力が空またはNULLの場合は、リソース要求が設定されていないことを意味します。

2. 現在のbackend-cronの必要リソースを増やすには、以下のコマンドを実行します。

   $ oc patch dc backend-cron --patch '{"spec":{"template":{"spec":{"containers":[{"name":"backend-cron","resources":{"limits":{"memory":"500Mi", "cpu": "500m"}, "requests":{"memory":"100Mi", "cpu": "100m"}}}]}}}}'

   Copy to Clipboard Toggle word wrap

   このコマンドがトリガーとなり backend-cron が再デプロイされます。再デプロイされ、対応する新しい Pod の準備が整い、以前の Pod が終了するまで待ちます。

手順

1. GitHub リポジトリーから 3scale OpenShift テンプレートをダウンロードし、アーカイブを展開します。

   tar -xzf 3scale-amp-openshift-templates-3scale-2.11.1-GA.tar.gz

   Copy to Clipboard Toggle word wrap
2. Oracle Database の Instant Client パッケージファイルを 3scale-amp-openshift-templates-3scale-2.11.1-GA/amp/system-oracle/oracle-client-files ディレクトリーに配置します。

3. -f オプションで build.yml OpenShift テンプレートを指定して、oc process コマンドを実行します。

   $ oc process -f build.yml | oc apply -f -

   Copy to Clipboard Toggle word wrap

4. -f オプションで amp.yml OpenShift テンプレートを指定し、-p オプションで WILDCARD_DOMAIN パラメーターに OpenShift クラスターのドメインを指定して、oc new-app コマンドを実行します。

   $ oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com

   Copy to Clipboard Toggle word wrap
   注記

   以下の手順は任意です。インストール後やシステムアップグレード後にORACLE_SYSTEM_PASSWORDを削除する場合に使用します。

5. 以下の oc patch コマンドを入力します。SYSTEM_PASSWORD はOracle Database の準備 で設定した Oracle Database の system パスワードに置き換えます。

   $ oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json
   
   $ oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'

   Copy to Clipboard Toggle word wrap

6. 以下のコマンドを入力します。DATABASE_URL はOracle Database の準備で指定した Oracle Database を参照するように置き換えます。

   $ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'

   Copy to Clipboard Toggle word wrap

7. oc start-build コマンドを入力し、新しいシステムイメージをビルドします。

   $ oc start-build 3scale-amp-system-oracle --from-dir=.

   Copy to Clipboard Toggle word wrap

8. ビルドが完了するまで待ちます。ビルドの状態を確認するには、以下のコマンドを実行します。

   $ oc get build <build-name> -o jsonpath="{.status.phase}"

   Copy to Clipboard Toggle word wrap
   1. ビルドが Complete の状態になるまで待ちます。

9. Oracle Database で 3scale システムイメージを設定したら、system-app DeploymentConfig から ORACLE_SYSTEM_PASSWORD を削除します。新しいバージョンの 3scale にアップグレードするまで、もう一度は必要ありません。

   $ oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-

   Copy to Clipboard Toggle word wrap

手順

1. 3scale で使用するデータベースに応じて、${SYSTEM_DB} を以下のいずれかの値に設定します。

   • データベースが MySQL の場合: SYSTEM_DB=system-mysql
   • データベースが PostgreSQL の場合: SYSTEM_DB=system-postgresql

2. 既存の DeploymentConfigs でバックアップファイルを作成します。

   $ THREESCALE_DC_NAMES="apicast-production apicast-staging backend-cron backend-listener backend-redis backend-worker system-app system-memcache ${SYSTEM_DB} system-redis system-sidekiq system-sphinx zync zync-database zync-que"
   
   for component in ${THREESCALE_DC_NAMES}; do oc get --export -o yaml dc ${component} > ${component}_dc.yml ; done

   Copy to Clipboard Toggle word wrap

3. export all コマンドでエクスポートされるプロジェクト内のすべての既存 OpenShift リソースをバックアップします。

   $ oc get -o yaml --export all > threescale-project-elements.yaml

   Copy to Clipboard Toggle word wrap

4. export all コマンドでエクスポートされない追加の要素でバックアップファイルを作成します。

   $ for object in rolebindings serviceaccounts secrets imagestreamtags cm rolebindingrestrictions limitranges resourcequotas pvc templates cronjobs statefulsets hpa deployments replicasets poddisruptionbudget endpoints
   do
     oc get -o yaml --export $object > $object.yaml
   done

   Copy to Clipboard Toggle word wrap
5. 生成されたすべてのファイルが空ではないこと、およびそれらすべての内容が予想どおりであることを確認します。

手順

1. 以下のコマンドで、backend-cronに設定されている現在のリソース要件を確認します。

   $ oc get dc backend-cron -o json | jq .spec.template.spec.containers[0].resources

   Copy to Clipboard Toggle word wrap

   出力が空またはNULLの場合は、リソース要求が設定されていないことを意味します。

2. 現在のbackend-cronの必要リソースを増やすには、以下のコマンドを実行します。

   $ oc patch dc backend-cron --patch '{"spec":{"template":{"spec":{"containers":[{"name":"backend-cron","resources":{"limits":{"memory":"500Mi", "cpu": "500m"}, "requests":{"memory":"100Mi", "cpu": "100m"}}}]}}}}'

   Copy to Clipboard Toggle word wrap

   このコマンドがトリガーとなり backend-cron が再デプロイされます。再デプロイされ、対応する新しい Pod の準備が整い、以前の Pod が終了するまで待ちます。