管理目錄

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

每個空間都包含單一目錄，您可以在其中新增範本及控管共用設定。您可以將初始已啟用應用程式管理功能的資料夾中建立的目錄，分享給子系已啟用應用程式管理功能的資料夾中的工作區。

如要瞭解如何建立後代空間，請參閱「建立空間」。

事前準備

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

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

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

設計畫布

  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. 在「空間」表格的「動作」欄中，按一下「共用目錄」。

    使用者可以在應用程式設計中心開啟工作區，然後點選導覽選單中的「共用範本」，即可查看共用目錄中的範本。

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。

後續步驟