高可用性向けのレガシー構成

gcloud

1. プライマリ インスタンスとそのフェイルオーバー レプリカを作成します。

   gcloud sql instances create PRIMARY_INSTANCE_NAME \
   --backup-start-time=BACKUP_WINDOW_START_TIME \
   --failover-replica-name=FAILOVER_REPLICA_NAME \
   --cpu=CPU \
   --database-version=DATABASE_VERSION \
   --memory=MEMORY \
   --enable-bin-log

   バックアップ ウィンドウの開始時間は、HH:MM の形式です。

   DATABASE_VERSION プレースホルダは、MySQL 5.6 または MySQL 5.7（--database-version=MYSQL_5_6 または --database-version=MYSQL_5_7）に置き換えてください。
   

   database-version パラメータにバージョンを指定しないと、デフォルトで MySQL 8.0 が選択されます。MySQL の高可用性のレガシー構成では、バージョン 8.0 はサポートされません。

   使用可能なパラメータすべてが記載されたリストは、gcloud sql instances create のリファレンス ページをご覧ください。

2. プライマリ インスタンスの root ユーザーを構成します。

   gcloud sql users set-password root --host=% \
   --instance PRIMARY_INSTANCE_NAME \
   --password PASSWORD

   フェイルオーバー レプリカは、プライマリ インスタンスと同じ CPU とメモリを使用して作成されます。フェイルオーバー レプリカの CPU とメモリは後で変更できますが、少なくともプライマリ インスタンスと同じ大きさにする必要があります。

curl

1. プライマリ インスタンスとそのフェイルオーバー レプリカを作成します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name":"PRIMARY_INSTANCE_NAME", "region":"REGION",
                 "settings": {
                              "tier":"MACHINE_TYPE",
                              "backupConfiguration": {"binaryLogEnabled": true, "enabled": true}},
                              "failoverReplica": {"name": "FAILOVER_REPLICA_NAME"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

   リクエストのパラメータの完全な一覧については、instances:insert ページをご覧ください。
2. プライマリ インスタンスの初期化が完了したら、プライマリ インスタンスの root パスワードを更新します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name": "root", "host": "%", "password": "ROOT_PASSWORD"}' \
        'https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_NAME/users?host=%25&name=root'

   この変更は自動的にレプリカに伝播されます。

gcloud

1. プライマリ インスタンスのステータスを確認します。

   gcloud sql instances describe PRIMARY_INSTANCE_NAME

   databaseReplicationEnabled プロパティが true の場合、インスタンスはレプリカです。レプリカのフェイルオーバー レプリカは作成できません。

2. backupConfiguration の enabled プロパティが false の場合、このステップでプライマリ インスタンスのバックアップを有効にします。

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --backup-start-time HH:MM

   backup-start-time パラメータは、UTC±00 タイムゾーンの 24 時間で指定され、4 時間のバックアップ期間の開始を指定します。バックアップはバックアップ時間枠の任意の時刻に開始できます。

3. binaryLogEnabled プロパティが false の場合、バイナリログを有効にします。

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --enable-bin-log

   バイナリ ロギングを有効にすると、インスタンスが再起動されます。

4. レプリカを作成します。

   gcloud sql instances create FAILOVER_REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME \
   --replica-type=FAILOVER

curl

1. プライマリ インスタンスのステータスを確認します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        -X GET \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME?fields=settings

   出力には backupConfiguration が含まれ、たとえば次のようになります。

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": true,
       "binaryLogEnabled": true
   }
   

2. enabled または binaryLogEnabled のいずれかが false の場合、インスタンス リソースの patch メソッドを使用して、両方を有効にします。そのまま保持するバックアップ構成のプロパティと変更するプロパティを指定します。

   バックアップを有効にするには、enabled を true に設定し、startTime をバックアップ ウィンドウの開始値に設定します。 バイナリ ロギングを有効にするには、binaryLogEnabled を true に設定します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"settings" : {"backupConfiguration" : {"startTime": "HH:MM", "enabled": true, "binaryLogEnabled": true}}}' \
        -X PATCH \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME/

3. インスタンス リソースの insert メソッドを使用して、フェイルオーバー レプリカを作成します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name": "REPLICA_NAME", "masterInstanceName": "PRIMARY_INSTANCE_NAME",
                 "region": "PRIMARY_IMSTANCE_REGION", "databaseVersion": "PRIMARY_DATABASE_VERSION",
                 "replicaConfiguration": {"failoverTarget": true},
                 "settings": {"tier":"MACHINE_TYPE"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

   MACHINE_TYPE は、プライマリ インスタンスのマシンタイプと同じか、それ以上にする必要があります。

gcloud

フェイルオーバーを開始します。

gcloud sql instances failover PRIMARY_INSTANCE_NAME

curl

1. settingsVersion フィールドの値を取得するには、プライマリ インスタンスを記述します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        -X GET \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME

2. フェイルオーバーを開始します。

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"failoverContext":{"settingsVersion":"SETTINGS_VERSION"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME/failover

Console

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. 高可用性を無効にするインスタンスのフェイルオーバー インスタンスを選択します。
3. [インスタンスの詳細] ページで、[削除] をクリックします。
4. レプリカの削除ウィンドウで、フェイルオーバー インスタンスの名前を再度入力します。
5. [削除] をクリックします。元のインスタンスの構成がゾーンに変わります。

gcloud

gcloud sql instances delete FAILOVER_REPLICA_NAME

curl

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json'\
      -X DELETE\
https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_NAME