Red Hat 3scale API Management の移行

手順

1. APIManager カスタマーリソース (CR) を使用して、system-app の DeploymentConfig (DC) をスケールダウンします。

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIManager
   metadata:
     name: <apimanager_sample>
   spec:
     system:
       appSpec:
         replicas: 0
     wildcardDomain: <example.com>

   Copy to Clipboard Toggle word wrap

2. Pod がスケールダウンされていることを確認します。

   $ oc get deploymentconfig system-app -o jsonpath='{.status.availableReplicas}{"\n"}'
   0

   Copy to Clipboard Toggle word wrap
   1. PostgreSQL の移行を続行する前に、すべての 3scale Pod のステータスが Terminated になるまで待ちます。

3. すべてのデータ、設定、ユーザーアカウントを含む既存の PostgreSQL データベースのバックアップを作成します。

   $ DB_USER=$(oc get secret system-database -o jsonpath="{.data.DB_USER}" | base64 --decode)
   $ DATABASE_NAME=$(oc get secret system-database -o jsonpath="{.data.URL}" | base64 --decode | cut -d '/' -f4)

   Copy to Clipboard Toggle word wrap
   重要

   stdout にパイプしないでください。バイナリーファイルが破損します。

4. カスタム形式でダンプします。

   $ oc rsh $(oc get pods -l 'deploymentConfig=system-postgresql' -o json | jq -r '.items[0].metadata.name') bash -c "pg_dump -U $DB_USER -F c $DATABASE_NAME -f /tmp/<backupfilename>.backup"

   Copy to Clipboard Toggle word wrap

5. バックアップをダウンロードします。

   $ oc cp $(oc get pods -l 'deploymentConfig=system-postgresql' -o json | jq -r '.items[0].metadata.name'):/tmp/<backupfilename>.backup <backupfilename>.backup

   Copy to Clipboard Toggle word wrap
6. 3scale にデプロイしたのと同じバージョンの PostgreSQL 10 をターゲットの外部システムにインストールします。インストール手順に従って、PostgreSQL Web サイトからインストールパッケージをダウンロードします。
7. 既存の PostgreSQL データベースで作成したバックアップ (すべてのデータ、設定、ユーザーアカウントを含む) をターゲットの外部システムにコピーして復元します。

8. PostgreSQL で新しいデータベースを作成します。

   $ createdb -U <username> <databasename>

   Copy to Clipboard Toggle word wrap

9. バックアップファイルから新しい PostgreSQL データベースにデータをインポートします。

   • カスタム形式で復元します。

     $ pg_restore [--host <databasehostname>] -U <username> -d <databasename> --verbose -F c <backupfilename>.backup

     Copy to Clipboard Toggle word wrap

10. データベースに接続してクエリーを実行し、データが新しい PostgreSQL データベースに正常にインポートされたことを確認します。

    postgresql://<username>:<password>@<databasehostname>/<databasename>

    Copy to Clipboard Toggle word wrap

11. system-database シークレットを更新します。

    $ oc apply -f - <<EOF
    ---
    apiVersion: v1
    kind: Secret
    metadata:
      name: system-database
    stringData:
      DB_PASSWORD: <password>
      DB_USER: <username>
      URL: "postgresql://<username>:<password>@<databasehostname>:<databaseport>/<databasename>"
    type: Opaque
    EOF

    Copy to Clipboard Toggle word wrap

12. APImanager CR を更新して外部データベースを有効にし、システムをスケールアップします。

    $ oc patch apimanager <apimanager_sample> --type=merge --patch '{"spec": {"system": {"database": null, "appSpec": {"replicas": 1}}, "externalComponents": {"system": {"database": true}}}}'

    Copy to Clipboard Toggle word wrap

13. ローカルの postgresql デプロイメントを削除します。

    $ oc delete service system-postgresql
    $ oc delete deploymentconfig system-postgresql
    $ oc delete pvc postgresql-data

    Copy to Clipboard Toggle word wrap

14. Pod がスケールアップされていることを確認します。

    $ oc wait --for=condition=available apimanager/<apimanager_sample> --timeout=-1s

    Copy to Clipboard Toggle word wrap