管理目录

在空间中创建应用模板和导入组件模板后，其他空间成员可以访问您的模板。本文档将帮助您通过以下方式在空间外部共享模板：将模板发布到目录，然后与适当的空间共享该目录。

每个空间都包含一个目录，您可以在其中添加模板并控制共享。您可以将初始已启用应用的文件夹中创建的空间中的目录共享给后代已启用应用的文件夹中的空间。

如需了解创建后代空间的步骤，请参阅创建空间。

准备工作

您必须在已启用应用的文件夹或管理项目上拥有 Application Design Center Admin (roles/designcenter.admin) 角色。

将应用模板发布到目录

您必须先将模板发布到目录，然后才能与其他空间共享该模板。

设计画布

  1. 在导航菜单中，点击目录。

    前往“目录”

  2. 点击添加模板。

  3. 在将模板添加到默认目录区域中，执行以下操作：

    1. 如需查找特定模板，请在过滤条件字段中输入模板名称。
    2. 如需将模板添加到此目录，请在操作列中点击添加到目录。

  4. 点击完成。有权访问相应目录的空间也有权访问所选模板。

  5. 如需共享目录，请参阅与空间共享目录。

gcloud CLI

  1. 确定要向哪个目录添加模板，并记下相应目录的 ID。

    gcloud design-center spaces catalogs list \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    替换以下内容：

    • PROJECT：您的管理项目 ID。
    • LOCATION：目录区域。
    • SPACE：您的空间 ID。

    如需了解详情，请参阅 gcloud design-center spaces catalogs list。

  2. 确定要添加到目录中的模板的模板 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。

  3. 提交应用模板。

     gcloud design-center spaces application-templates commit TEMPLATE \
 --project=PROJECT \
 --location=LOCATION \
 --space=SPACE

    替换以下内容：

    • TEMPLATE：要提交的模板的模板 ID。
    • PROJECT：您的管理项目 ID。
    • LOCATION：应用模板区域。
    • SPACE：您的空间 ID。

    如需了解详情，请参阅 gcloud design-center spaces application-templates commit。

  4. 复制提交命令的 name 输出。您将在创建目录模板修订版本时将此名称指定为 application-template-revision-source 值。

  5. 确保应用模板尚未位于目录中。

    gcloud design-center spaces catalogs templates list \
--catalog=CATALOG \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

    替换以下内容：

    • CATALOG：您的目录 ID。例如 default-catalog。
    • PROJECT：您的管理项目 ID。
    • LOCATION：目录区域。
    • SPACE：您的空间 ID。

    如需了解详情，请参阅 gcloud design-center spaces catalogs templates list。

  6. 如果应用模板不在目录中，请创建目录模板。

    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。

  7. 创建目录模板修订版本。这会创建第一个修订版本，开发者可将其用作应用的来源。

    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。例如 r1。
    • PROJECT：您的管理项目 ID。
    • LOCATION：目录区域。
    • SPACE：您的空间 ID。
    • CATALOG：您的目录 ID。
    • CATALOG_TEMPLATE：模板 ID。
    • APPLICATION_TEMPLATE_REVISION_SOURCE：应用模板修订版本来源。您在提交应用模板时复制了此值。例如 projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/r1。

    如需了解详情，请参阅 gcloud design-center spaces catalogs templates revisions create。

共享修订后的模板

如果您对模板进行更改，这些更改不会自动发布到目录中。如需分享最新修订版本，请再次将模板发布到目录。

从目录中移除模板

如果您不想再与某个空间共享特定模板，请将其从目录中移除。

设计画布

  1. 在导航菜单中，点击目录。

    前往“目录”

  2. 如需管理此目录中的模板，请点击目录中的模板。

  3. 如需移除模板，请点击 操作，然后选择从目录中移除。

    1. 在该字段中，输入模板的名称。
    2. 点击移除。

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。

与聊天室共享目录

您可以将初始空间中的目录共享给后代空间。例如，您可以创建一个与整个组织相关的应用模板目录，并将其与所有空间共享。

如需了解创建子空间的步骤，请参阅创建空间。

如需与空间共享目录，请执行以下操作：

设计画布

  1. 在导航菜单中，点击目录。

    前往“目录”

  2. 点击共享目录。

  3. 在过滤条件字段中，输入要分享目录的聊天室的名称。

  4. 在空间表格的操作列中，点击共享目录。

    用户可以在应用设计中心内打开自己的空间，然后从导航菜单中点击共享模板，即可查看共享目录中的模板。

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。

停止与空间共享目录

如果您不再想与某个空间共享目录，请按以下步骤停止共享目录：

设计画布

  1. 在导航菜单中，点击目录。

    前往“目录”

  2. 点击空间共享对象。

  3. 如需停止与某个空间共享此目录，请点击

    操作，然后选择停止共享。

    1. 在该字段中，输入聊天室名称。
    2. 点击停止分享。

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。

修改目录元数据

如需管理目录，您可以执行以下操作，为其指定描述性名称和说明：

设计画布

  1. 在导航菜单中，点击目录。

    前往“目录”

  2. 检查目录详细信息。

  3. 如需修改显示名称，请执行以下操作：

    1. 点击 修改显示名称。
    2. 在显示名称字段中，输入新名称。
    3. 点击保存。

  4. 如需修改说明，请执行以下操作：

    1. 点击 修改说明。
    2. 在说明字段中，输入新说明。
    3. 点击保存。

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 模块，请导入组件。