Cloud Deploy を使用すると、複数のターゲットを表すように構成されたターゲットにデプロイでき、アプリケーションはそれらのターゲットに同時にデプロイされます。パイプラインのステージとして特定するターゲットは、マルチ ターゲットと呼ばれ、マルチ ターゲットが構成しているターゲットは、子ターゲットと呼ばれます。
Kubernetes Engine、Cloud Run、GKE Enterprise など、Google Cloud Deploy がサポートする任意のターゲット タイプで並行デプロイを使用できます。
並行デプロイを選ぶ理由
たとえば、アプリケーションを複数の本番環境ターゲットにデプロイするため、並行デプロイを使用できます。この場合、進捗がない（例: 開発からステージング、さらに本番環境に）ため、各ターゲットに連続してデプロイする必要はありません。
この並行デプロイは、通常のデリバリー パイプライン進行の一部になります。
dev -> staging -> prod [prod1, prod2, prod3, prod4, ...]
並行デプロイに使用される Cloud Deploy リソース
並行デプロイでは、次の Cloud Deploy 専用リソースが使用されます。
マルチターゲット
マルチターゲットは、ターゲット構成 YAML の最上位にあるプロパティ
multiTargetで構成されたターゲットであり、ランタイム クラスタまたはサービスを参照するのではなく、multiTarget.targetIdsを使用して、1 つ以上の他のターゲットを参照します。子ターゲット
子ターゲットは、マルチターゲットが
multiTarget.targetIdsとして参照するターゲットです。子は、サポートされているターゲット タイプ（Google Kubernetes Engine、GKE Enterprise、Cloud Run）を参照する必要があります。コントローラのロールアウト
コントローラのロールアウトは、マルチターゲットに対応するロールアウトです。
コントローラのロールアウトでできる操作とできない操作の詳細については、制限事項をご覧ください。
-
子ロールアウトでできることとできないことの詳細については、制限事項をご覧ください。
並行デプロイを設定する
並行デプロイの設定では、1 つのマルチターゲットと、必要な子ターゲットの数（上限まで）を定義します。ターゲットの定義は、すべてのターゲットと同じですが、次の点が異なります。
- マルチターゲットには
multiTargetプロパティが含まれます。 - 子ターゲットには
multiTargetプロパティが含まれませんが、multiTarget.targetIdsプロパティを使用してマルチターゲットから参照されます。 - マルチターゲットは承認用に構成できますが、子ターゲットに
requireApproval:trueを含めることはできません。
マルチターゲットと子ターゲットには、カスタム実行環境構成を含めることができます。子ターゲットが実行環境を指定しない場合、子ターゲットはマルチターゲット定義で定義されているもの、またはデフォルトのものを継承します。詳しくは、実行環境と並行デプロイをご覧ください。
マルチターゲットを構成する
マルチターゲットは、デリバリー パイプラインのステージとして識別される単一のターゲットですが、1 つ以上の子ターゲットを指します。
マルチターゲット構成には、multiTarget プロパティが含まれています。マルチターゲットに gke、run、anthosCluster プロパティを含めることはできません。マルチターゲットの構成は、デプロイ先のランタイムに関係なく同じです。
デリバリー パイプラインの YAML または別の YAML ファイルで、multiTarget を含む基本的なターゲット定義を作成します。
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: TARGET_NAME
description: TARGET_DESCRIPTION
multiTarget:
targetIds: [ CHILD_TARGET1, CHILD_TARGET2, CHILD_TARGETn ]
この YAML では...
TARGET_NAME は、デリバリー パイプライン定義の
stages.targetIdプロパティで使用されるこのマルチターゲットの名前です。CHILD_TARGET1, CHILD_TARGET2,...CHILD_TARGETn は、このマルチターゲットのデプロイ先である子ターゲットの名前です。それぞれの名前は、子ターゲットの定義の
nameプロパティに対応します。
multiTarget.targetIds プロパティがあると、このターゲットはマルチターゲットになります。
子ターゲットを構成する
マルチターゲット構成で、子として識別されたターゲットごとに、子ターゲットとして別のターゲットを構成します。
デリバリー パイプラインの YAML または別の YAML ファイルで、基本的なターゲット定義を作成します。
GKE
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: CHILD_TARGET1
description: TARGET_DESCRIPTION
gke:
cluster: projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME
この YAML では...
CHILD_TARGET1 は、この子ターゲットの名前です。この名前は、マルチターゲット定義の
multiTarget.targetIdsプロパティのターゲット リスト内の 1 人のメンバーに対応します。gke.clusterプロパティの値は、プロジェクト ID、リージョン、クラスタ名など、このターゲットが参照するクラスタのリソース名です。
このターゲットは標準の GKE ターゲットと同じように構成されます。子ターゲットとなるのは、マルチターゲットの multiTarget.targetIds プロパティから参照される場合のみです。
Cloud Run
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: CHILD_TARGET1
description: TARGET_DESCRIPTION
run:
location: projects/PROJECT_ID/locations/REGION
この YAML では...
CHILD_TARGET1 は、この子ターゲットの名前です。この名前は、マルチターゲット定義の
multiTarget.targetIdsプロパティのターゲット リスト内の 1 人のメンバーに対応します。run.locationプロパティの値は、プロジェクト ID とリージョンを含む、このターゲットが参照する Cloud Run サービスのリソース名です。
このターゲットは、標準の Cloud Run ターゲットと同じように構成されます。子ターゲットとなるのは、マルチターゲットの multiTarget.targetIds プロパティから参照される場合のみです。
GKE Enterprise
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: CHILD_TARGET1
description: TARGET_DESCRIPTION
anthosCluster:
membership: projects/PROJECT_ID/locations/global/memberships/MEMBERSHIP_NAME
この YAML では...
CHILD_TARGET1 は、この子ターゲットの名前です。この名前は、マルチターゲット定義の
multiTarget.targetIdsプロパティのターゲット リスト内の 1 人のメンバーに対応します。MEMBERSHIP_NAME は、フリートに GKE Enterprise ユーザー クラスタを登録したときに選択した名前です。
このターゲットは、標準の GKE Enterprise ターゲットと同じように構成されます。子ターゲットとなるのは、マルチターゲットの multiTarget.targetIds プロパティから参照される場合のみです。
リリースを作成する
マルチターゲットと子ターゲットを構成して、デリバリー パイプラインとターゲット リソースを作成し、通常どおりリリースを作成します。
デリバリー パイプラインのライフサイクルは、Cloud Deploy パイプラインとターゲットと同じですが、マルチターゲットを使用してステージに到達すると、Cloud Deploy は、マルチターゲット用のコントローラロールアウトと、各子ターゲットにアプリケーションをデプロイするための子ロールアウトを作成する点が異なります。
Cloud Deploy オペレーションに応答する Pub/Sub メッセージは、コントローラ ロールアウトと子ロールアウトを区別します。
制限事項
マルチターゲットに設定できる子ターゲットは 50 個までです。
1 つのマルチターゲットのすべての子ターゲットが同じターゲット ランタイム（たとえば、すべての GKE またはすべての GKE Enterprise）を持つ必要があります。
デリバリー パイプライン内では、子ターゲットが親のマルチターゲットを 1 つだけ持つことが可能です。
マルチターゲットを子なしにすることはできません。また、マルチターゲット自体や別のマルチターゲットを子ターゲットとして参照することもできません。
1 つのデリバリー パイプライン内で子ターゲットを複数回使用することはできませんが、別のパイプラインで再利用できます。
デフォルト プールには同時実行数の上限がありますが、プライベート プールには上限がありません。
マルチターゲットにデプロイする場合は、Cloud Build の同時実行の上限まで、すべての子ロールアウトが同時にデプロイされます。この制限を超える子ターゲットがある場合、一部のターゲットのデプロイ ジョブは他のターゲットが完了するまで実行されません。つまり、Cloud Deploy ではすべての子ターゲットが同時にデプロイされるわけではありません。
さらに、ターゲットに検証ジョブが含まれている場合、すべての子ターゲットにアプリケーションがデプロイされる前に、1 つ以上の検証ジョブが開始される可能性があります。
Cloud Build のドキュメントで指定された上限よりも多くのターゲットに同時にデプロイする必要がある場合は、次の 2 つの方法があります。
実行できる同時ビルド数の増加をリクエストします。
実行環境と並行デプロイ
各ターゲットは、デフォルト以外の実行環境を使用するように構成できます。
マルチターゲットにデフォルト以外の実行環境がある場合、デフォルトの実行環境を使用するすべての子ターゲットがマルチターゲットからデフォルト以外の環境を継承します
マルチターゲットがデフォルトの実行環境を使用している場合、デフォルト以外の実行環境で構成された子ターゲットは、そのデフォルト以外の環境を使用します。
これらのルールにより、実行環境をマルチターゲットから子ターゲットに簡単に伝達できるため、各子ターゲットの実行環境を定義または変更する必要がなくなりますが、必要な場合は、1 つ以上の子ターゲットに対する実行環境をカスタマイズできます。
Cloud Deploy での実行環境の詳細については、Google Cloud Deploy の実行環境の使用をご覧ください。
並列デプロイをロールバックする
複数の並列ターゲットからデプロイをロールバックする必要がある場合は、ターゲットのロールバックで説明されているように、マルチターゲットをロールバックします。
並行デプロイの承認
他のターゲットと同様に、並行デプロイを構成して、承認を要求できます。ただし、並行デプロイでは、マルチターゲットでのみ承認を構成できます。この承認または拒否は、すべての子ターゲットに同時に影響します。
Google Cloud コンソールで並列デプロイを表示する
Google Cloud コンソールで、マルチターゲット、子ターゲット、コントローラのロールアウト、子ロールアウトの詳細を表示できます。
特定のデリバリー パイプラインのターゲットを一覧表示すると、[デリバリー パイプラインの詳細] でマルチターゲットが一覧表示されますが、子ターゲットは一覧表示されません。ただし、リリースの詳細を表示すると、コントローラのロールアウトと子のロールアウトを確認できます。コントローラと子ロールアウトは、[デリバリー パイプラインの詳細] ページの [ロールアウト] タブにも表示されます。
リリース インスペクタでは、子ロールアウトのレンダリングされたマニフェストを表示、比較できます。
デプロイ パラメータをターゲットに渡す
子ターゲットを区別するには、マニフェストにパラメータを追加し、デリバリー パイプラインの定義に値を指定します。これらの値は、対応するターゲットでのラベル マッチングに基づいて、個別のマニフェストに個別に適用できます。
たとえば、子ターゲットごとに異なるレプリカの数が必要になる場合があります。これを行うには、各パラメータ値のペアに対応する子ターゲットのラベルとともに、デリバリー パイプラインの進行状況にパラメータと値を含めます。
デプロイ パラメータの詳細を確認する。
デプロイ戦略で並列デプロイを使用する
カナリア デプロイ戦略を使用している場合は、並行してデプロイできます。詳細については、カナリア デプロイ戦略で並列デプロイを使用するをご覧ください。
次のステップ
デプロイ パラメータの使用について詳細を確認する。
ターゲット構成スキーマを確認する。
Cloud Deploy サービス アーキテクチャの記事を確認する。