5.2. MySQL データベースの外部化

手順

1. オンプレミス型 3scale インスタンスをホストする OpenShift ノードにログインし、そのプロジェクトに切り替えます。

   $ oc login -u <user> <url>
   $ oc project <3scale-project>

   Copy to Clipboard Toggle word wrap

   <user>、<url>、および <3scale-project> を、実際のクレデンシャルとプロジェクト名に置き換えます。

2. 以下に示す順序で手順実施し、すべての Pod をスケールダウンします。これにより、データの喪失が回避されます。

   オンプレミス型 3scale の停止

   OpenShift Web コンソールまたはコマンドラインインターフェイス (CLI) から、すべてのデプロイメント設定を以下の順序でゼロレプリカにスケールダウンします。

   • 3scale 2.6 より前のバージョンの場合は apicast-wildcard-router と zync、3scale 2.6 以降の場合は zync-que と zync
   • apicast-staging と apicast-production

   • system-sidekiq、backend-cron、および system-sphinx

     • 3scale 2.3 の場合には system-resque を対象に含めます。
   • system-app
   • backend-listener と backend-worker

   • backend-redis、system-memcache、system-mysql、system-redis、および zync-database

     以下の例は、apicast-wildcard-router と zync について、CLI でこの操作を実施する方法を示しています。

     $ oc scale dc/apicast-wildcard-router --replicas=0
     $ oc scale dc/zync --replicas=0

     Copy to Clipboard Toggle word wrap
     注記

     各ステップのデプロイメント設定は同時にスケールダウンできます。たとえば、apicast-wildcard-router と zync を一緒にスケールダウンできます。ただし、各ステップの Pod が終了するのを待ってから、次の Pod をスケールダウンすることを推奨します。3scale インスタンスは、完全に再起動されるまで一切アクセスできなくなります。

3. 3scale プロジェクトで実行中の Pod がないことを確認するには、以下のコマンドを使用します。

   oc get pods -n <3scale_namespace>

   Copy to Clipboard Toggle word wrap

   このコマンドは、No resources found を返すはずです。

4. 以下のコマンドを使用して、データベースレベルの Pod を再度スケールアップします。

   $ oc scale dc/{backend-redis,system-memcache,system-mysql,system-redis,zync-database} --replicas=1

   Copy to Clipboard Toggle word wrap

5. 次のステップに進む前に、system-mysql Pod を通じて外部 MySQL データベースにログインできることを確認してください。

   $ oc rsh system-mysql-<system_mysql_pod_id>
   mysql -u root -p -h <host>

   Copy to Clipboard Toggle word wrap
   • <system_mysql_pod_id>: system-mysql Pod の識別子

   • ユーザーは必ず root でなければなりません。詳しくは、外部 MySQL データベースに関する制約 を参照してください。

     1. CLI に mysql> が表示されるようになります。exit と入力してから enter キーを押します。次のプロンプトで再度 exit と入力して、OpenShift ノードのコンソールに戻ります。

6. 以下のコマンドを使用して、MySQL のフルダンプを実行します。

   $ oc rsh system-mysql-<system_mysql_pod_id> /bin/bash -c "mysqldump -u root --single-transaction --routines --triggers --all-databases" > system-mysql-dump.sql

   Copy to Clipboard Toggle word wrap
   • <system_mysql_pod_id> を一意の system-mysql Pod ID に置き換えます。

   • 次の例のように、ファイル system-mysql-dump.sql に有効な MySQL レベルのダンプが含まれていることを確認します。

     $ head -n 10 system-mysql-dump.sql
     -- MySQL dump 10.13  Distrib 8.0, for Linux (x86_64)
     --
     -- Host: localhost    Database:
     -- ------------------------------------------------------
     -- Server version   8.0
     
     /*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
     /*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
     /*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
     /*!40101 SET NAMES utf8 */;

     Copy to Clipboard Toggle word wrap

7. system-mysql Pod をスケールダウンし、レプリカが 0 (ゼロ) のままにします。

   $ oc scale dc/system-mysql --replicas=0

   Copy to Clipboard Toggle word wrap

8. <password> と <host> を適宜置き換え、URL mysql2://root:<password>@<host>/system の base64 変換値を取得します。

   $ echo "mysql2://root:<password>@<host>/system" | base64

   Copy to Clipboard Toggle word wrap

9. リモート MySQL データベースのデフォルトの 'user'@'%' を作成します。これには SELECT 権限しか付与する必要はありません。また、その base64 変換値を取得します。

   $ echo "user" | base64
   $ echo "<password>" | base64

   Copy to Clipboard Toggle word wrap
   • <password> を 'user'@'%' のパスワードに置き換えます。

10. バックアップを実行し、OpenShift シークレット system-database を編集します。

    $ oc get secret system-database -o yaml > system-database-orig.bkp.yml
    $ oc edit secret system-database

    Copy to Clipboard Toggle word wrap
    • URL: これを [step-8] で取得した値に置き換えます。
    • DB_USER および DB_PASSWORD: 共に前のステップの値を使用します。
11. system-mysql-dump.sql をリモートデータベースサーバーに送信し、ダンプをインポートします。インポートには、以下のコマンドを使用します。

12. 以下のコマンドを使用して system-mysql-dump.sql をリモートデータベースサーバーに送信し、ダンプをサーバーにインポートします。

    mysql -u root -p < system-mysql-dump.sql

    Copy to Clipboard Toggle word wrap

13. system という新しいデータベースが作成されたことを確認します。

    mysql -u root -p -se "SHOW DATABASES"

    Copy to Clipboard Toggle word wrap

14. 以下の手順を使用して、オンプレミス型 3scale を起動します。これにより、すべての Pod が正しい順序でスケールアップされます。

    オンプレミス型 3scale の起動

    • backend-redis、system-memcache、system-mysql、system-redis、および zync-database
    • backend-listener と backend-worker
    • system-app

    • system-sidekiq、backend-cron、および system-sphinx

      • 3scale 2.3 の場合には system-resque を対象に含めます。
    • apicast-staging と apicast-production

    • 3scale 2.6 より前のバージョンの場合は apicast-wildcard-router と zync、3scale 2.6 以降の場合は zync-que と zync

      以下の例は、backend-redis、system-memcache、system-mysql、system-redis、および zync-database について、CLI でこの操作を実行する方法を示しています。

      $ oc scale dc/backend-redis --replicas=1
      $ oc scale dc/system-memcache --replicas=1
      $ oc scale dc/system-mysql --replicas=1
      $ oc scale dc/system-redis --replicas=1
      $ oc scale dc/zync-database --replicas=1

      Copy to Clipboard Toggle word wrap

      system-app Pod が問題なく起動し、実行されるはずです。

15. 確認後、上記の順序 で他の Pod をスケールアップして元の状態に戻します。
16. system-mysql DeploymentConfig オブジェクトのバックアップを作成します。数日後、すべて正常に動作していることが確認できたら、削除してかまいません。system-mysql DeploymentConfig を削除することで、この手順を今後再び実行する場合の混乱を防ぐことができます。