スペースでアプリケーション テンプレート を作成してコンポーネント テンプレート をインポートすると、他のスペース メンバーがテンプレートにアクセスできるようになります。このドキュメントでは、テンプレートをカタログに公開し、そのカタログを適切なスペースと共有することで、スペース外でテンプレートを共有する方法について説明します。
各スペースには、テンプレートを追加して共有を制御できる単一のカタログが含まれています。最初の アプリケーション管理境界で作成したスペースから、他のアプリケーション管理境界のスペースにカタログを共有できます。
始める前に
カタログを管理する前に、次の操作を行います。
アプリ対応 フォルダまたは管理プロジェクトに対する App Design Center 管理者 (
roles/designcenter.admin) ロールが必要です。App Design Center の初期 設定を完了します。
最初のスペースに加えてスペースを作成するには、スペース を管理するをご覧ください。
アプリケーション テンプレートをカタログに公開する
テンプレートを他のスペースと共有するには、まずテンプレートをカタログに公開します。
デザイン キャンバス
ナビゲーション メニューで [カタログ] をクリックします。
[テンプレートを追加] をクリックします。
[デフォルト カタログにテンプレートを追加] 領域で、次の操作を行います。
- 特定のテンプレートを検索するには、[フィルタ] フィールドにテンプレート名を入力します。
- テンプレートをこのカタログに追加するには、[アクション] 列で [カタログに追加] をクリックします。
[完了] をクリックします。カタログにアクセスできるスペースは、選択したテンプレートにアクセスできます。
カタログを共有するには、スペースとカタログを共有する をご覧ください。
gcloud CLI
テンプレートを追加するカタログのカタログ ID を特定します。
gcloud design-center spaces catalogs list \ --project=PROJECT \ --location=LOCATION \ --space=SPACE次のように置き換えます。
PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces catalogs list をご覧ください。
カタログに追加するテンプレートのテンプレート ID を特定します。たとえば、次のコマンドはアプリケーション テンプレートを一覧表示します。
gcloud design-center spaces application-templates list \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --filter=FILTER次のように置き換えます。
PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。FILTER: 検索結果を絞り込むためのフィルタ。例:"displayName:my-app-template*"
詳細については、gcloud design-center spaces application-templates list をご覧ください。
アプリケーション テンプレートを commit します。
gcloud design-center spaces application-templates commit TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE次のように置き換えます。
TEMPLATE: commit するテンプレートのテンプレート ID。PROJECT: 管理プロジェクト ID。LOCATION: アプリケーション テンプレート リージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces application-templates commit をご覧ください。
commit コマンドの
name出力をコピーします。この名前は、カタログ テンプレートのリビジョンを作成するときにapplication-template-revision-source値として指定します。アプリケーション テンプレートがカタログにまだ存在していないことを確認します。
gcloud design-center spaces catalogs templates list \ --catalog=CATALOG \ --project=PROJECT \ --location=LOCATION \ --space=SPACE次のように置き換えます。
CATALOG: カタログ ID。例:default-catalogPROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces catalogs templates list をご覧ください。
アプリケーション テンプレートがカタログにない場合は、カタログ テンプレートを作成します。
gcloud design-center spaces catalogs templates create CATALOG_TEMPLATE \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template-category=TEMPLATE_CATEGORY次のように置き換えます。
CATALOG_TEMPLATE: 作成するカタログ テンプレートのカタログ テンプレート ID。PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。CATALOG: カタログ ID。TEMPLATE_CATEGORY: テンプレート カテゴリ。例:application-template
詳細については、gcloud design-center spaces catalogs templates create をご覧ください。
カタログ テンプレートのリビジョンを作成します。これにより、デベロッパーがアプリケーションのソースとして使用する最初のリビジョンが作成されます。
gcloud design-center spaces catalogs templates revisions create REVISION \ --project=PROJECT \ --location=LOCATION \ --space=SPACE \ --catalog=CATALOG \ --template=CATALOG_TEMPLATE \ --application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE次のように置き換えます。
REVISION: 作成するリビジョンのリビジョン ID。例:r1PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。CATALOG: カタログ ID。CATALOG_TEMPLATE: テンプレート ID。APPLICATION_TEMPLATE_REVISION_SOURCE: アプリケーション テンプレートのリビジョン ソース。この値は、アプリケーション テンプレートを commit したときにコピーしました。例:projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1
詳細については、gcloud design-center spaces catalogs templates revisions create をご覧ください。
改訂されたテンプレートを共有する
テンプレートに変更を加えても、その変更はカタログに自動的に公開されません。最新のリビジョンを共有するには、テンプレートをカタログに再度公開します。
カタログからテンプレートを削除する
特定のテンプレートをスペースと共有する必要がなくなった場合は、カタログから削除します。
デザイン キャンバス
ナビゲーション メニューで [カタログ] をクリックします。
このカタログのテンプレートを管理するには、[カタログ内のテンプレート] をクリックします。
テンプレートを削除するには、 [アクション] をクリックして [カタログから削除] を選択します。
- フィールドにテンプレートの名前を入力します。
- [削除] をクリックします。
gcloud CLI
カタログからテンプレートを削除します。
gcloud design-center spaces catalogs templates delete CATALOG_TEMPLATE \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE
次のように置き換えます。
CATALOG_TEMPLATE: カタログから削除するテンプレートのカタログ テンプレート ID。CATALOG: カタログ ID。PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。
詳細については、gcloud design-center spaces catalogs templates delete をご覧ください。
スペースとカタログを共有する
カタログを共有できるのは、ソーススペースと同じ リージョンにあり、別の アプリケーション管理境界にある宛先スペースのみです。
スペースとカタログを共有する手順は次のとおりです。
デザイン キャンバス
ナビゲーション メニューで [カタログ] をクリックします。
[カタログを共有] をクリックします。
[共有先] フィールドで、宛先スペースが次のいずれにあるかを選択します。
- フォルダ: フォルダレベルのアプリケーション管理境界。
- プロジェクト: プロジェクト レベルのアプリケーション管理境界。
[プロジェクト/フォルダ ID] フィールドに、宛先スペースが存在するアプリケーション管理境界のプロジェクト ID またはフォルダ ID を入力します。
発信元スペースと同じリージョンにあるスペースが、[スペース名] フィールドに自動的に入力されます。
[共有] をクリックします。
デベロッパーは、App Design Center でスペースを開き、ナビゲーション メニューから [共有テンプレート] をクリックして、共有カタログのテンプレートを表示できます。
gcloud CLI
スペースとカタログを共有します。
gcloud design-center spaces catalogs shares create SHARE \
--project=PROJECT \
--space=SPACE \
--location=LOCATION \
--catalog=CATALOG \
--destination-space=DESTINATION_SPACE
次のように置き換えます。
SHARE: 削除する共有の共有 ID。PROJECT: 管理プロジェクト ID。SPACE: スペース ID。LOCATION: カタログ リージョン。CATALOG: 共有するカタログのカタログ ID。DESTINATION_SPACE: 共有先のスペースの完全修飾スペース名。例:projects/my-project/locations/us-central1/spaces/my-space
詳細については、gcloud design-center spaces catalogs shares create をご覧ください。
スペースとのカタログの共有を停止する
スペースとカタログを共有する必要がなくなった場合は、次の操作を行ってカタログの共有を停止します。
デザイン キャンバス
ナビゲーション メニューで [カタログ] をクリックします。
[共有スペース] をクリックします。
このカタログとスペースの共有を停止するには、
[アクション] をクリックして [共有を停止] を選択します。
- フィールドにスペース名を入力します。
- [共有を停止] をクリックします。
gcloud CLI
スペースとのカタログの共有を停止します。
gcloud design-center spaces catalogs shares delete SHARE \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--catalog=CATALOG
次のように置き換えます。
SHARE: 削除する共有の共有 ID。PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。CATALOG: 共有するカタログのカタログ ID。
詳細については、gcloud design-center spaces catalogs shares delete をご覧ください。
カタログ メタデータを編集する
カタログを管理するには、次の操作を行ってわかりやすい名前と説明を付けます。
デザイン キャンバス
ナビゲーション メニューで [カタログ] をクリックします。
カタログの詳細を確認します。
[**表示名**] を変更する手順は次のとおりです。
- [**表示名を編集**] をクリックします。
- [表示名] フィールドに新しい名前を入力します。
- [保存] をクリックします。
[説明] を変更する手順は次のとおりです。
- [**説明を編集**] をクリックします。
- [説明] フィールドに新しい説明を入力します。
- [保存] をクリックします。
gcloud CLI
gcloud design-center spaces catalogs update CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE \
--description=DESCRIPTION \
--display-name=DISPLAY_NAME
次のように置き換えます。
CATALOG: カタログ ID。PROJECT: 管理プロジェクト ID。LOCATION: カタログ リージョン。SPACE: スペース ID。DESCRIPTION: カタログの説明。DISPLAY_NAME: カタログの表示名。
詳細については、gcloud design-center spaces catalogs update をご覧ください。
次のステップ
- アプリケーション デベロッパーとベスト プラクティスを共有するには、アプリケーション テンプレートを設計します。
- アプリケーション テンプレートに基づいてドラフトを作成するには、アプリケーションを管理します。
- アプリケーション テンプレートの設計で独自の Terraform モジュールを使用するには、コンポーネントをインポートします。