ソリューションの表示と起動
このドキュメントでは、サービス カタログからソリューションを表示して起動する方法について説明します。
始める前に
- サービス カタログを使用してソリューションをリリースするには、ソリューションが共有されているGoogle Cloud プロジェクトに対する カタログ ユーザー または IAM 閲覧者の Identity and Access Management(IAM)ロールが必要です。 Google Cloud プロジェクトに対するどちらのロールも付与されていない場合は、組織管理者に連絡してアクセス権をリクエストしてください。
Terraform 構成をデプロイする場合は、Terraform 構成をデプロイする Google Cloud プロジェクトに対して次のロールが必要です。これらのロールがない場合は、アクセス権をリクエストするために、プロジェクト オーナーまたはプロジェクトに対する
setIAMpolicy
権限を持つ担当者に連絡してください。独自のサービス アカウントを使用する場合は、使用するサービス アカウントを含む Google Cloud プロジェクトに対するサービス アカウント ユーザーのロールも必要です。
Terraform 構成をデプロイし、独自のサービス アカウントを使用する場合は、ソリューションを作成するプロジェクトに対して、サービス アカウントに次の IAM ロールが必要です。
- ストレージ管理者。Terraform 構成が別のプロジェクトにある場合、サービス アカウントには、Terraform 構成を含むプロジェクトのストレージ オブジェクト閲覧者ロールも必要です。
- ログ書き込み。
- Terraform 構成の実行に必要な追加の IAM ロール。
Cloud Deployment Manager を使用してソリューションをデプロイする場合は、ソリューションをデプロイするプロジェクトの Deployment Manager 編集者のロール。このロールがない場合は、プロジェクト オーナーまたはプロジェクトに対する
setIAMpolicy
権限を持つ担当者に連絡して、アクセス権をリクエストしてください。
Terraform 構成をリリースする場合は、Cloud Build を設定する必要があります。
-
Enable the Cloud Build API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. - Google Cloud コンソールで、[Cloud Build] ページに移動します。
- [設定] タブを選択します。
- [サービス アカウントのメールアドレス:] に表示されているサービス アカウントを使用します。
独自のサービス アカウントを使用していない場合は、Cloud Build サービス アカウントに次の Identity and Access Management(IAM)ロールを付与します。たとえば、Terraform 構成の作成で提供されているサンプル Terraform 構成ファイルでは、Compute Engine がリソースの 1 つであり、サービス アカウントに対して Compute インスタンス管理者(v1)(
roles/compute.instanceAdmin.v1
)ロールが有効になっています。Terraform 構成をデプロイするプロジェクトのサービス アカウントに、プロジェクト編集者ロールを付与します。
サービス カタログ内のすべての Terraform 状態ファイルを管理するには、構成が共有されているプロジェクトと、構成をデプロイするプロジェクトの Cloud Build サービス アカウントに Storage 管理者ロールを付与します。アクセス権を付与する手順については、Cloud Build サービス アカウントのアクセス権の構成をご覧ください。
-
サービス カタログ ソリューションを表示する
サービス カタログには、 Google Cloud 階層でアクセス権を付与されているすべてのカタログの全ソリューションが表示されます。
使用可能なソリューションを表示するには、 Google Cloud コンソールの [サービス カタログ] ページに移動します。共有されているソリューションがメインパネルに表示されます。
リンクベースのソリューションを起動する
参照リンクベースのソリューションを起動するには次の手順を行います。
Google Cloud コンソールの [サービス カタログ] ページに移動します。
[タイプ] で、[リンク]でフィルタし、ソリューションをクリックします。
[リンクに移動] をクリックします。
これにより、Google ドメイン外のリンク先に移動し、ソリューションをダウンロードできます。
Deployment Manager(DM)ベースのソリューションの起動
DM ベースのソリューションをリリースするには:
Google Cloud コンソールの [サービス カタログ] ページに移動します。
[タイプ] で、[DM テンプレート] でフィルタし、ソリューションをクリックします。
[Compute Engine 上で起動] をクリックします。
プロンプトが表示されたら、Deployment Manager API とサービス カタログ API を有効にします。
API の有効化は完了するまでに数分かかりますが、行う必要があるのは Google Cloud プロジェクトごと(ソリューション単位ではなく)に 1 回のみです。
デプロイメント フォームに入力します。
使用する Compute Engine のリージョンとゾーンを指定して、zone パラメータを手動で入力する必要があります。region の後にダッシュの後に zone(スペースなし)を入力します。
region-zone
たとえば、us-central1-a
はus-central1
が region、a
が zone です。[デプロイ] をクリックします。
ソリューションがデプロイされます。
Terraform 構成のリリース
Terraform 構成をリリースするには:
Google Cloud コンソールの [サービス カタログ] ページに移動します。
[タイプ] で、Terraform でフィルタし、ソリューションをクリックします。
[デプロイ] をクリックします。
プロンプトが表示されたら、そのウィンドウで [新しいデプロイを開始] をクリックします。
プロンプトが表示されたら、Cloud Build API を有効にします。
API の有効化は完了するまでに数分かかりますが、行う必要があるのは Google Cloud プロジェクトごと(ソリューション単位ではなく)に 1 回のみです。
デプロイの名前を作成します。
必要に応じて、[独自のサービス アカウントを選択または入力する] の横にあるチェックボックスをオンにして、独自のサービス アカウントを指定できます。サービス アカウントがソリューションを作成する Google Cloud プロジェクトと同じ場所にある場合は、[現在のプロジェクトからサービス アカウントを選択] を選択し、プルダウン メニューからサービス アカウントを選択します。サービス アカウントがソリューションとは異なる Google Cloud プロジェクトにある場合は、[プロジェクトのサービス アカウントのメールアドレスを入力する] を選択し、サービス アカウントのメールアドレスを入力します。
パラメータを入力する
[プレビューとデプロイ] をクリックします。
デプロイを確認し、[デプロイ] をクリックします。
ソリューションがデプロイされます。
Terraform デプロイメントの更新する
Terraform ソリューションの既存のデプロイでは、パラメータなどのデプロイの詳細を更新できます。ソリューションで使用可能な新しいバージョンの Terraform 構成がある場合は、構成のデプロイを最新バージョンに更新できます。
既存のデプロイを更新するには:
サービス カタログの [デプロイ] ページに移動します。
デプロイのテーブルで、更新するデプロイの名前をクリックします。
[デプロイの詳細] ページで、[デプロイメントの更新] をクリックします。
デプロイの詳細を更新します。
必要に応じて、[独自のサービス アカウントを選択または入力する] の横にあるチェックボックスをオンにして、独自のサービス アカウントを指定できます。サービス アカウントがソリューションを作成する Google Cloud プロジェクトと同じ場所にある場合は、[現在のプロジェクトからサービス アカウントを選択] を選択し、プルダウン メニューからサービス アカウントを選択します。サービス アカウントがソリューションとは異なる Google Cloud プロジェクトにある場合は、[プロジェクトのサービス アカウントのメールアドレスを入力する] を選択し、サービス アカウントのメールアドレスを入力します。
[プレビューとデプロイ] をクリックします。
デプロイを確認し、[デプロイ] をクリックします。
構成の最新バージョンを表示して適用する
Terraform デプロイメントを管理するときに、関連するソリューションが新しいバージョンの Terraform 構成をリリースしているかどうかを確認し、デプロイを最新の構成に更新できます。
デプロイに使用可能な更新があるかどうかを確認し、構成の最新バージョンを適用するには次のようにします。
サービス カタログの [デプロイ] ページに移動します。
[更新が含まれるデプロイメントを表示] をクリックして、デプロイメントのテーブルをフィルタリングします。テーブルで、更新するデプロイを見つけて、[新しいバージョンがあります] をクリックします。
[デプロイの詳細] ページで、[デプロイメントの更新] をクリックします。
[バージョンを選択] で [最新バージョンに更新] を選択します。
必要に応じて、[独自のサービス アカウントを選択または入力する] の横にあるチェックボックスをオンにして、独自のサービス アカウントを指定できます。サービス アカウントがソリューションを作成する Google Cloud プロジェクトと同じ場所にある場合は、[現在のプロジェクトからサービス アカウントを選択] を選択し、プルダウン メニューからサービス アカウントを選択します。サービス アカウントがソリューションとは異なる Google Cloud プロジェクトにある場合は、[プロジェクトのサービス アカウントのメールアドレスを入力する] を選択し、サービス アカウントのメールアドレスを入力します。
プロンプトが表示されたら、追加のパラメータの値を入力します。
[プレビューとデプロイ] をクリックします。
デプロイを確認し、[デプロイ] をクリックします。
Terraform デプロイメントのプロビジョニング解除
Terraform デプロイのプロビジョニングを解除して、すべてのリソースを完全に削除します。
デプロイのプロビジョニングを解除するには次のようにします。
Google Cloud コンソールの [サービス カタログ] ページに移動します。
[Terraform デプロイ] をクリックします。
表で、プロビジョニングを解除するデプロイを見つけます。
[その他の操作] メニュー(縦に並んだ 3 つの点で表示)
をクリックします。必要に応じて、[独自のサービス アカウントを選択または入力する] の横にあるチェックボックスをオンにして、独自のサービス アカウントを指定できます。サービス アカウントがソリューションを作成する Google Cloud プロジェクトと同じ場所にある場合は、[現在のプロジェクトからサービス アカウントを選択] を選択し、プルダウン メニューからサービス アカウントを選択します。サービス アカウントがソリューションとは異なる Google Cloud プロジェクトにある場合は、[プロジェクトのサービス アカウントのメールアドレスを入力する] を選択し、サービス アカウントのメールアドレスを入力します。
[デプロビジョニング] をクリックします。