管理、發布及共用目錄

您可以使用 Application Design Center 中的目錄,在不同工作區發布及共用應用程式範本和匯入的元件範本,藉此標準化架構,避免各團隊重複作業。在聊天室中建立或匯入範本時,根據預設,只有該聊天室的成員可以使用這些範本。如果中央平台團隊維護的範本已獲核准且符合政策規定,而其他資料夾或專案中的開發團隊需要部署這些範本,您就可以跨工作區共用目錄。每個空間都包含一個目錄,您可以在其中發布範本、編輯目錄中繼資料,以及與其他應用程式管理邊界中的空間共用目錄。

事前準備

如要執行本文件中的工作,請要求管理員授予您啟用應用程式管理功能的資料夾或管理專案的必要角色,如下表所示:

工作 必要的角色
將應用程式範本發布至聊天室目錄 Application Design Center 管理員 (roles/designcenter.admin)
與目的地工作區共用目錄 Application Design Center 管理員 (roles/designcenter.admin)

如要進一步瞭解角色,請參閱「使用 IAM 控管存取權」。

管理目錄前,請先完成下列事項:

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

您必須先將範本發布至目錄,才能與其他工作區共用。

設計畫布

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

    前往「Catalogs」(目錄) 頁面

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

  3. 在「Add templates to Default Catalog」(將範本新增至預設目錄) 區域中,執行下列操作:

    1. 如要尋找特定範本,請在「Filter」(篩選器) 欄位中輸入範本名稱。
    2. 如要將範本新增至這個目錄,請按一下「Actions」(動作) 欄中的「Add to catalog」(新增至目錄)。
  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. 複製 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. 按一下導覽選單中的「目錄」。

    前往「Catalogs」(目錄) 頁面

  2. 如要管理這個目錄中的範本,請按一下「目錄中的範本」。

  3. 如要移除範本,請按一下 「Actions」(動作),然後選取「Remove from catalog」(從目錄中移除)。

    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. 按一下導覽選單中的「目錄」。

    前往「Catalogs」(目錄) 頁面

  2. 按一下「共用目錄」。

  3. 在「共用對象」欄位中,選取目標聊天室是否位於下列其中一個位置:

    • 資料夾:資料夾層級的應用程式管理邊界。
    • 專案:專案層級的應用程式管理邊界。
  4. 在「Project/Folder ID」(專案/資料夾 ID) 欄位中,輸入目的地空間所在應用程式管理邊界的專案或資料夾 ID。

    系統會自動在「Space name」(空間名稱) 欄位中填入與來源空間位於相同區域的空間。

  5. 按一下「共用」。

    開發人員只要在應用程式設計中心開啟工作區,然後按一下導覽選單中的「Shared templates」,即可查看共用目錄中的範本。

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. 按一下導覽選單中的「目錄」。

    前往「Catalogs」(目錄) 頁面

  2. 按一下「共用聊天室對象」。

  3. 如要停止與特定空間共用這個目錄,請按一下 「Actions」(動作),然後選取「Stop sharing」(停止共用)。

    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. 按一下導覽選單中的「目錄」。

    前往「Catalogs」(目錄) 頁面

  2. 查看目錄詳細資料。

  3. 如要修改「顯示名稱」,請按照下列步驟操作:

    1. 按一下「 編輯顯示名稱」。
    2. 在「Display name」(顯示名稱) 欄位中輸入新名稱。
    3. 按一下「儲存」。
  4. 如要修改「Description」,請按照下列步驟操作:

    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」。

後續步驟