管理、发布和共享目录

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

每个空间都包含一个目录，您可以在其中添加模板并控制共享。您可以将最初在 应用管理边界中创建的空间中的目录共享给其他应用管理边界中的空间。

准备工作

如需执行本文档中的任务，请让您的管理员为您授予应用已启用的文件夹或管理项目的必要角色，如下表所示：

任务 所需的角色
将应用模板发布到空间目录 Application Design Center Admin (roles/designcenter.admin)
与目标空间共享目录 Application Design Center Admin (roles/designcenter.admin)

如需详细了解角色，请参阅使用 IAM 进行访问权限控制。

在管理目录之前，请执行以下操作：

将应用模板发布到目录

如需与其他空间共享模板，请先将模板发布到目录。

设计器画布

  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. 在项目/文件夹 ID 字段中，输入目标空间所在的应用管理边界的项目或文件夹 ID。

    与您的源空间位于同一区域的空间会自动填充到空间名称 字段中。

  5. 点击共享 。

    开发者可以在 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。

停止与空间共享目录

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

设计器画布

  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。

后续步骤