管理、发布和共享目录

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

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

准备工作

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

任务 所需的角色
将应用模板发布到空间目录 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. 复制 commit 命令输出的 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 \
--force

替换以下内容：

  • CATALOG_TEMPLATE：要从目录中移除的模板的目录模板 ID。
  • CATALOG：您的目录 ID。
  • PROJECT：您的管理项目 ID。
  • LOCATION：目录区域。
  • SPACE：您的空间 ID。

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

与空间共享目录

您只能与目标空间共享目录，该目标空间必须与源空间位于同一区域，但位于不同的应用管理边界。

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

设计画布

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

    前往“目录”

  2. 点击共享目录。

  3. 在共享对象字段中，选择目标聊天室是否位于以下位置之一：

    • 文件夹：文件夹级应用管理边界。
    • 项目：项目级应用管理边界。

  4. 在项目/文件夹 ID 字段中，输入目标空间所在的应用管理边界的项目或文件夹 ID。

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

  5. 点击共享。

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

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-dest-project/locations/us-central1/spaces/my-dest-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。

后续步骤