構成をプレビューする

このページでは、デプロイを作成する前に構成ファイルをプレビューする方法を説明します。構成の詳細については、構成の概要をご覧ください。

構成ファイルを作成した後で、デプロイの作成前に構成をプレビューできます。構成をプレビューすることで、Deployment Manager が作成するリソースの中で、実際にはインスタンス化されないリソースを確認できます。Deployment Manager サービスは次の方法で構成をプレビューします。

  1. テンプレートを含め、構成を完全に展開します。
  2. デプロイと「シェル」リソースを作成します。

構成をプレビューするには、insert() リクエストを行うときに preview クエリ パラメータを使用します。

始める前に

新しい構成をプレビューする

構成をプレビューするには、gcloud コマンドライン ツールを使用するか、API に直接リクエストを作成します。

gcloud

gcloud コマンドライン ツールの create サブコマンドで --preview フラグを使用します。

gcloud deployment-manager deployments create example-deployment --config configuration-file.yaml \
     --preview

状態が IN_PREVIEW のリソースのリストがサーバーから返されます。

The fingerprint of the deployment is ulPDrJON8E5ySHKC5fcukw==
Waiting for create [operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf]...done.
Create operation operation-1492785372594-54dae2ddbff50-58d45d53-12d483cf completed successfully.
NAME                      TYPE                 STATE       ERRORS  INTENT
datadisk-example  compute.v1.disk      IN_PREVIEW  []      CREATE_OR_ACQUIRE
vm-example        compute.v1.instance  IN_PREVIEW  []      CREATE_OR_ACQUIRE

API

API では、insert() メソッドを使用し、リクエスト本文の中に target フィールドと name フィールドを入れ、preview=true クエリ パラメータを付けます。構成を target フィールドで指定します。

たとえば、次の API リクエストは簡単なテンプレートをプレビューします。

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments?preview=true

{
 "name": "example-deployment",
 "target": {
  "config": {
    "content":  "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
   }
  }
}

デプロイがプレビュー モードの場合は、次の 3 つの方法のいずれかでデプロイを進めることができます。

複数のプレビューを実行する

構成に変更を行った後にさらにプレビューを行うには、update コマンドで --preview フラグを使用します。

gcloud deployment-manager deployments update example-config \
    --config new-config.yaml --preview

API では、既存のデプロイを指定して PUT() リクエストを作成し、preview=true クエリ パラメータを指定します。リクエスト本文の中に intent フィールド、target フィールド、name フィールドが存在する必要があります。たとえば、次の API リクエストはシンプルな更新をプレビューします。

PUT https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-deployment?preview=true

{
 "target": {
  "config": {
   "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default"
  }
 },
 "name": "example-deployment"
}

デプロイまたはプレビューのキャンセル

デプロイをプレビューした後で、デプロイを続行するには、更新を実行して構成を省略します。たとえば、example-config という名前のデプロイが現在プレビュー モードだとします。デプロイを続行するには、次のコマンドを実行します。

gcloud deployment-manager deployments update example-config

Deployment Manager は、最後にプレビューされた構成を使用して新しいデプロイを作成します。

構成を途中で終了する場合には、プレビューをキャンセルしてデプロイを削除することもできます。

gcloud deployment-manager deployments cancel-preview example-config

デプロイがプレビュー モードの場合は、別の構成を進めることはできません。たとえば、vm.yaml という名前の構成を使用したプレビュー モードの example-deployment というデプロイがあるとします。two_vms.yaml という名前の新しい構成を、プレビュー プロセスを省略して、同じデプロイに導入することにします。example-deployment がプレビュー モードの間は新しい構成をデプロイできません。最初に、プレビューをキャンセルしてから、新しい構成でデプロイを更新する必要があります。

次のステップ

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Cloud Deployment Manager のドキュメント