Blue/Green デプロイを作成してステージングする

コンソール

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

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

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. [構成] セクションで、[Blue/Green デプロイを作成] をクリックします。
4. [Blue/Green デプロイを作成] ページの [デプロイ情報] セクションで、[デプロイ名] フィールドにデプロイの一意の名前を入力します。
5. [デプロイのユースケース] リストで、次のいずれかのオプションを選択します。
   • オプション A（メジャー バージョンのアップグレード）: スイッチオーバー前にグリーン インスタンスでメジャー バージョンのアップグレードをステージングしてテストするには、[メジャー バージョンのアップグレード] を選択します。[ターゲット データベースのバージョン] リストで、ターゲット データベースのバージョン（MySQL 8.4 など）を選択します。

     インテントを使用してデプロイを作成すると、Cloud SQL は、グリーン インスタンスを作成する前に、オペレーションの一部としてメジャー バージョン アップグレードの事前チェックを自動的に実行します。または、デプロイを作成する前にメジャー バージョン アップグレードの事前チェックを実行して、アップグレードの阻害要因を特定することをおすすめします。

   • オプション B（デフォルト）: 構成またはハードウェアの変更をテストするために、ソース インスタンスと同じデータベース バージョンでグリーン ステージング環境を作成するには、[デフォルト] を選択します。
6. [作成] をクリックします。

gcloud

gcloud を使用して Blue/Green デプロイを作成するには、blue-green-deployments create コマンドを実行します。

オプション A: インテントを使用して作成する（メジャー バージョンのアップグレード）

インテントを使用してデプロイを作成すると、Cloud SQL は、グリーン インスタンスを作成する前に、オペレーションの一部としてメジャー バージョン アップグレードの事前チェックを自動的に実行します。または、デプロイを作成する前に、ブルー インスタンスでメジャー バージョンのアップグレードの事前チェックを実行して、アップグレードの阻害要因を特定することもできます。

gcloud beta sql blue-green-deployments create DEPLOYMENT_NAME \
  --source-instance=SOURCE_INSTANCE_ID \
  --target-database-version=TARGET_DATABASE_VERSION \
  --region=REGION \
  --async

次のように置き換えます。

• DEPLOYMENT_NAME: デプロイの一意の名前。
• SOURCE_INSTANCE_ID: ブルーのソース インスタンスの名前。
• TARGET_DATABASE_VERSION: ターゲット バージョン（例: MYSQL_8_4）。
• REGION: ブルー インスタンスの Google Cloud リージョン。

オプション B: インテントなしで作成する（ハードウェアまたは構成）

--target-database-version フラグを省略して、Blue インスタンスと同じデータベース バージョンで Green 環境をプロビジョニングします。

gcloud beta sql blue-green-deployments create DEPLOYMENT_NAME \
  --source-instance=SOURCE_INSTANCE_ID \
  --region=REGION \
  --async

Blue/Green デプロイの作成には数分かかります。特に、メジャー バージョンのアップグレードを行う場合は時間がかかります。オペレーションに予想より時間がかかっていることを示すメッセージが表示される場合があります。このメッセージは無視するか、gcloud sql operations wait コマンドを実行してメッセージを閉じ、オペレーションが完了するまで待ちます。

gcloud sql operations wait OPERATION_ID

OPERATION_ID は、コマンドによって返された、またはメッセージに表示されたオペレーション ID に置き換えます。

REST v1

Cloud SQL Admin API を使用して Blue/Green デプロイを作成するには、blueGreenDeployments.create メソッドに POST リクエストを送信します。

オプション A: インテントを使用して作成する（メジャー バージョンのアップグレード）

インテントを使用してデプロイを作成すると、Cloud SQL は、グリーン インスタンスを作成する前に、オペレーションの一部としてメジャー バージョン アップグレードの事前チェックを自動的に実行します。または、デプロイを作成する前に、ブルー インスタンスでメジャー バージョンのアップグレードの事前チェックを実行して、アップグレードの阻害要因を特定することもできます。

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID",
  "requestedConfig": {
    "databaseVersion": "TARGET_DATABASE_VERSION"
  }
}

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• REGION: ブルー インスタンスの Google Cloud リージョン。
• DEPLOYMENT_NAME: デプロイの一意の名前。
• SOURCE_INSTANCE_ID: ブルーのソース インスタンスの名前。
• TARGET_DATABASE_VERSION: ターゲット データベースのバージョン（例: MYSQL_8_4）。

オプション B: インテントなしで作成する（ハードウェアまたは構成）

requestedConfig フィールドを省略して、Blue インスタンスと同じデータベース バージョンで Green 環境をプロビジョニングします。

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID"
}

REST v1beta4

Cloud SQL Admin API を使用して Blue/Green デプロイを作成するには、blueGreenDeployments.create メソッドに POST リクエストを送信します。

オプション A: インテントを使用して作成する（メジャー バージョンのアップグレード）

インテントを使用してデプロイを作成すると、Cloud SQL は、グリーン インスタンスを作成する前に、オペレーションの一部としてメジャー バージョン アップグレードの事前チェックを自動的に実行します。または、デプロイを作成する前に、ブルー インスタンスでメジャー バージョンのアップグレードの事前チェックを実行して、アップグレードの阻害要因を特定することもできます。

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID",
  "requestedConfig": {
    "databaseVersion": "TARGET_DATABASE_VERSION"
  }
}

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• REGION: ブルー インスタンスの Google Cloud リージョン。
• DEPLOYMENT_NAME: デプロイの一意の名前。
• SOURCE_INSTANCE_ID: ブルーのソース インスタンスの名前。
• TARGET_DATABASE_VERSION: ターゲット データベースのバージョン（例: MYSQL_8_4）。

オプション B: インテントなしで作成する（ハードウェアまたは構成）

requestedConfig フィールドを省略して、Blue インスタンスと同じデータベース バージョンで Green 環境をプロビジョニングします。

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments?blueGreenDeploymentId=DEPLOYMENT_NAME
{
  "sourceInstance": "SOURCE_INSTANCE_ID"
}

コンソール

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

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

2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
3. [Blue/Green デプロイのステータス] カードを見つけて、デプロイのステータスを確認します。
4. プロビジョニング タスクと進行状況の詳細を表示するには、[詳細] をクリックして [デプロイの概要] ページを開きます。

gcloud

gcloud を使用して Blue/Green デプロイの進行状況とステータスを確認するには、blue-green-deployments describe コマンドを実行します。

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION

次のように置き換えます。

• DEPLOYMENT_NAME: Blue/Green デプロイの名前。
• REGION: デプロイが作成された Google Cloud リージョン。

作成オペレーションが完了するまで待機するには、gcloud sql operations wait コマンドを実行します。

gcloud sql operations wait OPERATION_ID

OPERATION_ID は、作成オペレーションの ID に置き換えます。

REST v1

Cloud SQL Admin API を使用して Blue/Green デプロイの進行状況とステータスを確認するには、blueGreenDeployments.get メソッドに GET リクエストを送信します。

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• REGION: デプロイが作成された Google Cloud リージョン。
• DEPLOYMENT_NAME: Blue/Green デプロイの名前。

REST v1beta4

Cloud SQL Admin API を使用して Blue/Green デプロイの進行状況とステータスを確認するには、blueGreenDeployments.get メソッドに GET リクエストを送信します。

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• REGION: デプロイが作成された Google Cloud リージョン。
• DEPLOYMENT_NAME: Blue/Green デプロイの名前。