Deployment Manager のデプロイ用の VM イメージを構成する

VM プロダクトの Deployment Manager でデプロイをサポートする場合は、次の手順を行う必要があります。

デプロイパッケージの作成方法を決定する

Producer Portal のガイド付き構成オプションを使用して、Google Cloud コンソールで直接デプロイパッケージを作成することをおすすめします。

ガイド付き構成では、基本的なファイアウォールルールを使用した単一 VM デプロイなどの簡単な VM プロダクトがサポートされますが、複数の VM やカスタム構成フィールドを使用したデプロイなど、複雑な機能はサポートされません。ガイド付き構成でサポートされていない機能が必要な場合は、オープンソース mpdev ツールを使用して、デプロイパッケージを作成するか、既存のパッケージに新しい機能を追加してカスタマイズします。

Google Cloud コンソールや、Cloud Marketplace で Deployment Manager Autogen ツールを使用せずに作成したカスタムデプロイテンプレートの使用はおすすめしません。デプロイパッケージは Google Cloud コンソールで直接作成することをおすすめします。

ガイド付き構成と手動構成を切り替える

Producer Portal のガイド付き構成オプションを使用していて、後でデプロイパッケージを手動構成に切り替える場合は、[Go toManual configuration] をクリックします。

切り替え時に、ガイド付き構成で作成したデプロイパッケージの Autogen 仕様をダウンロードし、手動構成のベースとして使用できます。

ガイド付き構成を完了する

Google Cloud コンソールを使用してシンプルなデプロイパッケージの構成と送信を完了するには、次の手順を行います。

Producer Portal で [デプロイパッケージ] セクションに移動します。
[Deployment Manager configuration] で、[Cloud Storage バケット] というラベルの付いた入力フィールドの横にある [参照] をクリックします。

Cloud Storage バケットをすでに作成している場合は、ここで選択します。

Cloud Storage バケットがない場合は、[新しいバケットを作成] というラベルのアイコンをクリックします。新しいバケットを作成するときは、次の操作を行います。
- バケットの名前を選択します。
- バケットでデータの保存先リージョンを指定します。
- データのストレージクラスを指定します。
- バケットのデータに対する Identity and Access Management（IAM）権限に適用する粒度を決定します。
- 暗号化やデータ保持ポリシーなど、オプションの詳細設定を構成します。
Cloud Storage バケットでオブジェクトのバージョニングが有効になっていることを確認してください。
バケット設定を保存してデプロイパッケージの構成を続けるには、[構成] をクリックします。
[マシンタイプの選択] で、VM プロダクトのデフォルトゾーン、最小マシンタイプ、デフォルトのマシンタイプ、およびブートディスクのサイズとタイプを指定する必要があります。
[オペレーティングシステムの指定] で、VM イメージが使用する OS の名前とバージョン、および VM イメージのバージョン番号を指定する必要があります。
（省略可能）[VM アクセスの設定] で、ユーザーがデプロイ後の VM へのアクセスに使用できるようにするために、サイトと管理者 URL、およびユーザー名とパスワードを指定できます。
（省略可能）[ネットワークの構成] で IP 転送の設定を指定し、ファイアウォール ルールを構成します。
（省略可能）[次のステップの定義] で、プロダクトのユーザーにプロダクトの使用を開始するための手順を提供できます。これらの手順は、プロダクトをデプロイした後に表示されます。
前の手順を完了したら、[生成] をクリックしてデプロイパッケージを作成します。

後からさらにデプロイパッケージに変更を加える必要がある場合は、[編集] をクリックして変更を行い、[生成] をクリックして、これらの変更が適用されたデプロイパッケージを再生成します。

手動構成に切り替える場合は、[ダウンロード] をクリックして、ガイド付き構成で作成したデプロイパッケージの Autogen 仕様をダウンロードし、手動構成のベースとして使用します。
Producer Portal で審査のためにデプロイパッケージを送信します。デプロイパッケージを送信してから Google がパッケージを審査し、承認するまでには最大で 2 週間かかります。

手動構成を完了する

このセクションでは、mpdev ツールを使用してデプロイパッケージを作成し、パッケージを送信して審査を受ける方法について説明します。

mpdev ツールは、Deployment Manager の Autogen を使用して、デプロイパッケージ用の Deployment Manager テンプレートを生成します。このツールは、VM プロダクトの構成入力を含む Autogen の仕様に基づいて、デプロイパッケージを生成します。

デプロイパッケージを生成して送信する大まかな流れは次のとおりです。

デプロイパッケージへのアクセスを保存および管理するための Cloud Storage バケットの作成と構成を行います。
VM プロダクトのイメージの詳細とデプロイ要件を含む Autogen 仕様を作成します。
Autogen 仕様に基づいてデプロイパッケージを生成し、パッケージを Cloud Storage バケットにアップロードします。
Producer Portal で審査のためにデプロイパッケージを送信します。デプロイパッケージを送信してから Google がパッケージを審査し、承認するまでには最大で 2 週間かかります。

以下のセクションでは、デプロイパッケージを生成して送信する手順を説明します。

始める前に

mpdev を使用してデプロイパッケージを作成する場合は、次の手順を行います。

marketplace-tools リポジトリの手順に沿って、mpdev ツールをインストールします。
Google Cloud SDK をダウンロードします。

Cloud Storage バケットを作成する

Producer Portal で使用するのと同じパブリックの Google Cloud プロジェクトで Cloud Storage バケットを作成し、次のようにバケットを構成する必要があります。

バケットのオブジェクトのバージョニングを有効にして、デプロイパッケージが削除または上書きされないように保護します。
ストレージオブジェクト閲覧者（roles/storage.objectViewer）のロールを cloud-commerce-marketplace-onboarding@twosync-src.google.com に付与します。

Cloud Storage バケットを作成して構成するには、次の gsutil コマンドを実行します。

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME

ここで、YOUR_BUCKET_NAME は新しいバケットに付ける名前で、命名要件の対象となります。

Autogen 仕様を作成する

Autogen 仕様を作成するには、marketplace-tools リポジトリで single VM example を初期 Autogen 仕様として使用し、VM の構成の詳細を使用して仕様をカスタマイズすることをおすすめします。

より複雑なユースケースでは、一部の統合開発環境（IDE）でオートコンプリートを設定して、configurations.yaml ファイルの編集と検証を行うことができます。

single VM example から Autogen の仕様を作成するには:

例の事前構成された Autogen 仕様をローカルディレクトリにチェックアウトします。
```
PACKAGE=YOUR_PACKAGE_NAME
mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE
```
ここで、YOUR_PACKAGE_NAME はローカルディレクトリに指定する名前です。例: my-deployment-package
VM の構成の詳細で仕様を更新するには、次の情報で configurations.yaml ファイルを変更します。
- VM イメージの名前。
- VM イメージをホストするパブリック Google Cloud プロジェクトの ID。これは Producer Portal で使用するのと同じプロジェクトです。
configurations.yaml ファイル内の VM イメージと Google Cloud プロジェクトのフィールドを更新する手順については、single VM example の README.md ファイルをご覧ください。
プロダクトに必要な場合は、さらに passwords、deployInput、postDeploy などのフィールドをカスタマイズします。これらのフィールドは、configurations.yaml ファイルの DeploymentSpec の下にあります。カスタマイズ可能なフィールドの詳細については、Autogen のリファレンスドキュメントをご覧ください。

デプロイパッケージを生成する

Autogen 仕様を作成してカスタマイズしたら、その仕様を使用して、デプロイパッケージ用の Deployment Manager テンプレートファイルを生成します。パッケージを保存するには、パッケージを Cloud Storage バケットにアップロードします。

デプロイパッケージを生成してアップロードするには:

デプロイパッケージの出力場所を Cloud Storage バケットに設定します。

注: marketplace-tools リポジトリで Autogen specification examples のいずれかを使用した場合は、次のコマンドを使用できます。 Autogen の仕様を手動で作成した場合は、仕様ファイルを直接編集して、出力場所を更新する必要があります。
```
mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
```
ここで、BUCKET_NAME はパッケージ用に作成したバケットの名前、OBJECT は命名ガイドラインに従って、Cloud Storage オブジェクト用に指定した名前です。
デプロイパッケージを生成します。
```
mpdev apply -f $PACKAGE/configurations.yaml
```

生成されたデプロイパッケージが zip 圧縮され、バケットにアップロードされます。

テンプレートが正しく構成されていることを確認するには、次のコマンドを実行してデプロイを作成します。

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml

Producer Portal で審査のためにデプロイパッケージを送信します。

デプロイパッケージを作成して構成した後、Cloud Marketplace チームがパッケージを審査して承認できるように、パッケージを Producer Portal に送信する必要があります。

Producer Portal で [デプロイパッケージ] セクションに移動します。
[Cloud Storage オブジェクトのロケーションを指定する] で、先ほどアップロードしたデプロイパッケージオブジェクトを選択します。
[検証] をクリックします。検証プロセスには最大 2 時間かかります。完了後に画面を閉じることもできます。
Producer Portal がデプロイパッケージを正常に読み取ったら、[デプロイのプレビュー] をクリックして、VM 構成の表示方法を確認できます。
検証が正常に完了したら、デプロイパッケージを送信してレビューできるようにするために、[送信] をクリックします。デプロイパッケージを送信してから Google がパッケージを審査し、承認するまでには最大で 2 週間かかります。

Terraform デプロイ用の VM イメージを構成する

デプロイパッケージが顧客にどのように表示されるかを把握する