管理、發布及共用目錄

在工作區中建立應用程式範本和匯入元件範本後，其他工作區成員就能存取這些範本。本文說明如何將範本發布至目錄，並與適當的工作區共用目錄，藉此在工作區外共用範本。

每個工作區都包含單一目錄，您可以在其中新增範本及控管共用設定。您可以將初始應用程式管理邊界中建立的工作區目錄，分享至其他應用程式管理邊界的工作區。

事前準備

管理目錄前，請先完成下列步驟：

  • 您必須在啟用應用程式的資料夾或管理專案中，具備 App Design Center 管理員 (roles/designcenter.admin) 角色。

  • 完成 App Design Center 的初始設定。

  • 如要建立初始空間以外的空間，請參閱「管理空間」。

將應用程式範本發布至目錄

如要與其他工作區共用範本，請先將範本發布至目錄。

設計畫布

  1. 按一下導覽選單中的「目錄」。

    前往「目錄」

  2. 按一下「新增範本」。

  3. 在「將範本新增至預設目錄」區域中，執行下列操作：

    1. 如要尋找特定範本，請在「篩選」欄位中輸入範本名稱。
    2. 如要將範本新增至這個目錄，請在「動作」欄中按一下「新增至目錄」。

  4. 點按「Done」(完成)。有權存取目錄的工作區，也能存取所選範本。

  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. 在「Project/Folder 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. 在「Description」(說明) 欄位中輸入新說明。
    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。

後續步驟