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. 以下のコマンドを実行します。

   oc patch secret system-master-apicast --type=json -p='[{"op": "remove", "path": "/data/BASE_URL"}]'

   Copy to Clipboard Toggle word wrap

2. BASE_URL フィールドが正しく削除されたことを確認します。

   oc get secret system-master-apicast -o json | jq .data

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

1. 以下の考慮事項に注意して、3scale を 0 (ゼロ) にスケールダウンします。

   1. Oracle 12c から切断されているため、3scale のデータベースへの接続に失敗します。

2. Oracle 12c を Oracle 19c にアップグレードします。

   1. アップグレードを実行するには、公式の Oracle ドキュメント Database Upgrade Guide に従ってください。

3. 3scale 2.9.1 用の OpenShift テンプレート のクローンを作成します。

   $ git clone --branch 2.9.1.GA https://github.com/3scale/3scale-amp-openshift-templates.git

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

手順

1. 3scale 2.9.1 用の OpenShift テンプレート のクローンを作成します。

   $ git clone --branch 2.9.1.GA https://github.com/3scale/3scale-amp-openshift-templates.git

   Copy to Clipboard Toggle word wrap
2. Oracle Database の Instant Client パッケージファイルを 3scale-amp-openshift-templates/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. oc start-build コマンドを入力し、新しいシステムイメージをビルドします。

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

   Copy to Clipboard Toggle word wrap

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

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

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