テンプレートからカスタマイズしてデプロイする場合は、アプリケーションを作成します。たとえば、テスト目的でデプロイする予定のアプリケーションを作成するとします。本番環境で使用する別のアプリケーションを作成することもできます。
アプリケーションを作成するときに、アプリケーションの想定される用途に基づいて分類するのに役立つ情報を指定します。この情報は、特定のアプリをフィルタして見つけるのに役立ちます。コンポーネントと接続の詳細を構成することもできます。
始める前に
アプリが有効になっているフォルダまたは管理プロジェクトに対する次のいずれかのロールを付与するよう管理者に依頼します。
- App Design Center 管理者（
roles/designcenter.admin）。 - アプリケーション管理者（
roles/designcenter.applicationAdmin）。 - アプリケーション編集者（
roles/designcenter.applicationEditor）。
アプリケーションのドラフトを作成する
詳細を指定し、必要に応じてコンポーネント構成をオーバーライドして、テンプレートからアプリケーションの下書きを作成します。その後、下書きをデプロイしてアプリケーションを作成できます。
デザイン キャンバス
ナビゲーション メニューで、次のいずれかを行います。
スペースで作成したテンプレートを表示するには、[テンプレート] をクリックします。
別のスペースから共有されたテンプレートを表示するには、[共有テンプレート] をクリックします。
使用するテンプレート ID をクリックします。
デザイン キャンバスで、[アプリの設定] をクリックし、[新しいアプリケーションを作成] をクリックします。
[アプリケーション名エリア] で、次の操作を行ってアプリケーションの名前と説明を入力します。
[名前] フィールドに、一意の識別子を入力します。たとえば、
web-app-stagingのように一意の名前と環境の組み合わせを使用します。これは必須項目です。英小文字、数字、ハイフンを含む 63 文字まで使用できます。名前は小文字で始まり、ハイフンで終わることはできません。名前は変更できません。
[表示名] フィールドに、Google Cloud コンソールに表示する名前を入力します。
[説明] フィールドに、このアプリケーションの目的を入力します。
[プロジェクト ID] フィールドが空のコンポーネントのデフォルト プロジェクトを設定するには、[デプロイ プロジェクト] リストからプロジェクトを選択します。プロジェクトは次の要件を満たしている必要があります。
コンポーネントの [プロジェクト ID] フィールドにプロジェクトがすでに指定されている場合は、この設定ではなくそのプロジェクトが使用されます。
[リージョン] リストから、コンポーネントがデプロイされるリージョンを選択します。コンポーネント リージョンは、次の条件に基づいて適用されます。
アプリケーション スコープが [グローバル]（デフォルト）の場合、リージョンは構成済みのリージョンがないコンポーネントに適用されます。
アプリケーション スコープが [リージョン] の場合、リージョンはすべてのコンポーネントに適用されます。
[Environment] リストから、このアプリケーションをデプロイする環境を選択します。たとえば、
TESTでデプロイが想定どおりに動作することを確認できます。[重要度] リストで、ビジネスへの影響度を選択します。たとえば、
LOWやHIGHです。オーナーを指定するには、[オーナー] 領域で [オーナーを追加] をクリックし、次の項目の表示名とメールアドレスを入力します。
[ビジネス オーナー] 領域に、品質とユーザーの期待に応える責任を負うオーナーを入力します。
[デベロッパーのオーナー] 領域に、開発とコーディングを担当するオーナーを入力します。
[Operator owners] 領域に、アプリケーションの運用を担当するオーナーを入力します。
[範囲] リストから、次のいずれかを選択します。
グローバル（デフォルト）: アプリケーションにグローバル リソースが含まれているか、リソースが複数のリージョンに存在します。
リージョン: すべてのリソースが単一のリージョンにあります。
これは必須項目です。詳細については、グローバル アプリケーションとリージョン アプリケーションを比較するをご覧ください。
[アプリケーションを作成] をクリックします。アプリケーションの詳細が表示されます。
gcloud CLI
アプリケーションの作成に使用するテンプレートのアプリケーション テンプレート リビジョン URI を特定します。
gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,latestRevision)'次のように置き換えます。
APPLICATION_TEMPLATE: アプリケーションのベースとして使用するアプリケーション テンプレートのテンプレート ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション テンプレートのリージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces application-templates describe をご覧ください。
latestRevisionの出力をコピーします。テンプレートに基づいてアプリケーションのドラフトを作成します。
gcloud design-center spaces applications create APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION \ --scope-type=SCOPE_TYPE次のように置き換えます。
APPLICATION: 作成するアプリの下書きのアプリケーション ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション リージョン。SPACE: スペース ID。SOURCE_APPLICATION_TEMPLATE_REVISION: アプリケーション テンプレートの URI。例:projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISIONSCOPE_TYPE: アプリケーションのスコープ。regionalまたはglobalのいずれか。アプリケーション スコープが「global, the region is applied to components that don't already have a configured region. If the application scope isregional」の場合、リージョンはすべてのコンポーネントに適用されます。
詳細については、gcloud design-center spaces applications create をご覧ください。
コンポーネントと接続を構成する
アプリケーションの各コンポーネントについて、リソースが作成されるプロジェクトやデプロイされるロケーションなどの構成の詳細を指定できます。
デフォルトの構成が要件を満たしていない場合は、接続の詳細を変更することもできます。たとえば、環境変数キー名を変更したり、接続ポートを変更したり、サービス アカウントに追加のロールを追加したりできます。
サポートされているリソースごとに必要な詳細情報を構成する必要があります。
コンポーネントと接続を構成する手順は次のとおりです。
デザイン キャンバス
デザイン キャンバスで、コンポーネントをクリックします。
[構成] 領域の [プロジェクト ID] リストで、リソースをデプロイするプロジェクトを選択します。次の条件を満たすプロジェクトを選択します。
リソースの追加設定を構成します。たとえば、Cloud SQL の場合は次のように構成できます。
- 地域
- バックアップ構成
- データベース フラグ
- IP 構成
各コンポーネントの構成ドキュメントへのリンクについては、サポートされているリソースをご覧ください。
デザイン キャンバスでコンポーネントを接続すると、デフォルトの構成値を使用して接続が作成されます。接続の詳細を追加または変更する手順は次のとおりです。
デザイン キャンバスで、2 つのコンポーネント間の接続をクリックします。[接続] パネルが開き、接続パラメータが表示されます。
次のいずれかを行います。
既存の接続パラメータを変更するには、[編集] をクリックします。
新しい接続パラメータを追加するには、[パラメータを追加] をクリックします。
[キー] フィールドと [値] フィールドを更新します。たとえば、次の詳細を変更できます。
- アプリケーションの要件に沿った環境変数キー名。
- 接続ポートの値。
- サービス アカウントに追加されたロール。
[保存] をクリックします。
gcloud CLI
アプリケーションを記述してコンポーネント パラメータを表示し、アプリケーションに必要なパラメータを特定します。
gcloud design-center spaces applications describe APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --format='yaml(name,componentParameters)'次のように置き換えます。
APPLICATION: アプリケーション ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション リージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces applications describe をご覧ください。
変更するコンポーネントごとに、ホーム ディレクトリにパラメータ値を含む JSON ファイルを作成します。
たとえば、Cloud Run コンポーネント用に次のファイルを作成できます。
{ "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT", "parameters": [ { "key": "service_name", "value": "frontend-service" }, { "key": "project_id", "value": "DEPLOYMENT_PROJECT" } ] }アプリケーションを更新して、必要なパラメータを構成します。
gcloud design-center spaces applications update APPLICATION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --component-parameters=COMPONENT_FILE_PATH_1次のように置き換えます。
APPLICATION: アプリケーション ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション リージョン。SPACE: スペース ID。COMPONENT_FILE_PATH_1: コンポーネント パラメータを含む JSON ファイル。追加の JSON ファイルごとに、別の--component-parameter引数と値を追加します。
詳細については、gcloud design-center spaces applications update をご覧ください。
デプロイ手順については、コンソールからアプリケーションをデプロイするをご覧ください。
Terraform コードを編集する
アプリケーションは、設計と構成の詳細を反映する Terraform コードを生成します。Terraform を編集して、コンポーネント構成の詳細を指定できます。
システムは次の Terraform ファイルを生成します。
main.tf: テンプレート内の各コンポーネントのモジュールを含むインフラストラクチャ コード。outputs.tf: デプロイされたインフラストラクチャ コンポーネントに関する情報を公開します。variables.tf:main.tfファイルで使用される変数の名前、型、説明を宣言します。input.tfvars:main.tfファイルで使用される変数の値を定義します。providers.tf: Terraform が Google Cloud API とリソースを操作するのに役立つラベルを定義します。
背景情報については、Google Cloudでの Terraform の概要をご覧ください。
Terraform コードを編集する手順は次のとおりです。
デザイン キャンバスで、[コード] をクリックします。生成された Terraform ファイルが表示されます。
[main.tf] をクリックします。システムに、各コンポーネントの Terraform モジュールが表示されます。
構成の詳細を編集します。詳細については、各サポートされているリソースの構成ドキュメントをご覧ください。
システムは編集内容を自動的に検証し、無効な編集内容がある場合はエラーを表示します。
編集内容をハイライト表示して比較する手順は次のとおりです。
[差分を表示] をクリックします。
変更を元に戻すには、余白で [変更を元に戻すにはここをクリック] をクリックします。
[差分を表示] をクリックして、比較ビューを閉じます。
編集内容を保存するには、[コードの変更を保存] をクリックします。
変更を確認する手順は次のとおりです。
- [デザイン] をクリックします。
- コンポーネントをクリックして、構成の詳細を確認します。
アプリケーション リビジョンを作成する
アプリケーション リビジョンを作成して、詳細またはコンポーネントを変更します。App Design Center の外部でアプリケーション コンポーネントを変更した場合、再デプロイ時にその変更は保持されません。
アプリケーション リビジョンを作成するには:
デザイン キャンバス
ナビゲーション メニューで [アプリケーション] をクリックします。
表で、修正するアプリケーション名をクリックします。
アプリケーションの詳細を変更するには、次の操作を行います。
[編集] をクリックして、詳細を変更します。
[保存] をクリックして、変更を保存します。
このアプリケーションのコンポーネントを変更するには、次の操作を行います。
デザイン キャンバスでコンポーネントをクリックし、[構成] 領域で詳細を編集します。
[保存] をクリックして、変更を保存します。
gcloud CLI
コンポーネントと接続を構成するをご覧ください。
デプロイ手順については、コンソールからアプリケーションをデプロイするをご覧ください。
アプリケーションを削除する
アプリケーションが不要になった場合は、削除できます。たとえば、アプリケーションをデプロイして TEST 環境でテンプレートを確認し、アプリケーションを削除できます。
次のアプリケーションを削除できます。
- デプロイされていないアプリケーション。[アプリケーション] ページで、[ステータス] が [下書き] と表示されます。
TEST、DEVELOPMENT、またはSTAGINGEnvironment にデプロイされたアプリケーション。
アプリケーションを削除すると、次のようになります。
- App Design Center からアプリケーションの詳細が削除されます。
- 基盤となる App Hub アプリケーションが削除されます。
- デプロイした場合は、リソースが削除されます。
アプリケーションを削除するには:
デザイン キャンバス
ナビゲーション メニューで [アプリケーション] をクリックします。
表で、[アプリケーション名] をクリックします。
[アクション] をクリックして、[アプリケーションを削除] を選択します。
[削除] フィールドにアプリケーション名を入力します。
[削除] をクリックします。
gcloud CLI
アプリケーションを削除します。
gcloud design-center spaces applications delete APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
次のように置き換えます。
APPLICATION: 削除するアプリケーションのアプリケーション ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション リージョン。SPACE: スペース ID。詳細については、gcloud design-center spaces applications delete をご覧ください。
次のステップ
次のいずれかを使用してアプリケーションをデプロイします。