設定技術元件

本頁面說明如何建立透過 Google Cloud Marketplace 發布容器映像檔產品時需要的主要技術元件。

如在新手上路程序期間有任何疑問，請洽詢 Cloud Marketplace 合作夥伴工程師。如果您不知道自己的指定合作夥伴工程師是哪位，請透過合作夥伴支援服務專員尋求協助，並在說明中加入「Marketplace」一詞。如要進一步瞭解合作夥伴支援服務專員，請參閱「請求 Cloud Marketplace 協助」。

Artifact Registry 和 IAM 設定

您必須先建立測試環境 Artifact Registry 存放區，並將要在產品中發布的映像檔推送至該存放區，才能在 Producer Portal 中建立產品。您必須在專案中將「專案編輯者」角色授予 cloud-commerce-marketplace-onboarding@twosync-src.google.com。

開始使用 Container Registry

如要將加上標記的容器映像檔推送至 Container Registry，請按照 Artifact Registry 說明文件中的「事前準備」所述步驟操作。然後按照下列步驟啟用 Artifact Analysis API。

安裝 gcloud 和 Docker 後，您必須從 API 程式庫頁面啟用下列 API：

  • Artifact Registry API
  • Artifact Analysis API

Artifact Registry API 可讓您推送至 Artifact Registry，而 Artifact Analysis API 可允許安全性掃描。

如果您無法存取這兩種 API，請與合作夥伴工程師聯絡。

標記及推送圖片

  1. 選擇 Artifact Registry 測試環境存放區路徑。建議存放區需按照 us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID 結構。

    • 測試環境存放區必須在 us-docker.pkg.dev 或 gcr.io 內 (目前尚未支援 europe-docker.pkg.dev 或 eu.gcr.io 等其他地區)。
    • 在 Producer Portal 中，儲存或複製建立產品的測試環境存放區路徑。

  2. 建構要推送至 Artifact Registry 測試環境存放區的映像檔。

  3. 透過 Docker 將映像檔標記為 latest。

    docker tag image_name staging_repo_path:tag

    例如：docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

    請注意，如果使用者未指定標記，則會提取標示為 latest 的圖片。

  4. 使用 gcloud 推送圖片：

    gcloud docker push staging_repo_path:tag

  5. 重複您要新增至測試環境存放區的任何其他標記或映像檔。單一映像檔可具有多個標記。

    • 請留意，如果只將圖片推送至測試環境存放區，並不表示該圖片會自動向使用者顯示；只有在您選取標記的圖片及發布後，圖片才會顯示。
    • 存放區的範圍為其路徑指定的資料夾的單一層級。位於存放區其他資料夾中的任何映像檔實際上不在存放區本身之中。換句話說，如果圖片位於 us-docker.pkg.dev/testpartner/testsolution/1.0，則表示該圖片「不在」us-docker.pkg.dev/testpartner/testsolution 存放區中。us-docker.pkg.dev/testpartner/testsolution/1.0 是個別的存放區。

在 Producer Portal 中建立產品

本節說明如何在製作人入口網站中建立及發布容器映像檔產品。

如要在 Producer Portal 中發布產品，請建立產品項目，然後提交下列資訊以供審查：

  • 產品詳細資料：新增產品的產品資訊和行銷資訊。
  • 容器映像檔：提供包含容器映像檔的 Google Container Registry 存放區。

您隨時可以提交這些評論，且順序不限。

如要建立產品的 Cloud Marketplace 項目，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中開啟 Producer Portal：

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID

    將 YOUR_PUBLIC_PROJECT_ID 替換為您為 Cloud Marketplace 建立的公開專案 ID，例如 my-organization-public。

  2. 按一下頁面頂端的「新增產品」。

  3. 選取「容器映像檔」。

  4. 在「產品名稱」下方輸入產品名稱，並確認產品 ID。產品 ID 會用在 Cloud Marketplace 產品資訊的網址中。

  5. 按一下「建立」，系統可能需要幾秒鐘的時間才能建立產品。

新增產品詳細資料

產品詳細資料包括 Cloud Marketplace 上的產品資訊、行銷資訊和說明文件連結。

如要新增產品詳細資料，請按照下列步驟操作：

  1. 在產品清單中，按一下產品 ID。

  2. 在產品的「總覽」頁面中，前往「產品詳細資料」，然後按一下「編輯」。

  3. 填妥「產品詳細資料」專區的「產品資訊」分頁。完成「產品資訊」時，你可以新增類別 ID。顧客在搜尋 Cloud Marketplace 時，可透過類別 ID 在特定類別或篩選器下找到您的產品。

  4. 如要新增教學課程、說明文件，以及視需要新增其他授權協議，請填寫「產品詳細資料」部分的「說明文件」分頁。您的說明文件必須符合使用手冊的需求規定。

  5. 如要新增搜尋中繼資料或關鍵字，或是自訂產品詳細資料頁面的網址，請填寫「產品詳細資料」專區的「產品中繼資料」分頁。

  6. 當您準備好提交產品詳細資料進行後續處理時，請按一下「提交」。

合作夥伴工程團隊需要約 2 到 5 天才能審查及核准產品詳細資料。您可以立即開始編輯詳細資料，並稍後提交評論。

新增容器映像檔

您必須建立一個對應 Container Registry 標記 latest 的版本 (區分大小寫)。這是產品頁面中的預設版本。

如要新增容器映像檔，請按照下列步驟操作：

  1. 在產品清單中，按一下產品 ID。

  2. 在產品的「總覽」頁面中，前往「容器映像檔」，然後按一下「編輯」。

  3. 在「Container images」(容器映像檔) 部分，輸入測試環境 Artifact Registry 存放區的網址。

  4. 按一下「指定版本」。讀取存放區並載入標記可能需要幾秒鐘的時間。

  5. 選取要納入產品的版本的顯示標記。您必須在產品中加入 latest 版本，但可以新增其他版本。為方便使用者，建議您限制產品可用的版本數量。

  6. 您可以視需要新增版本標題和簡短的版本說明。這有助使用者部署所需的版本。

  7. 輸入這個版本支援的作業系統。您可以視需要指定作業系統版本。

  8. 新增所有版本資訊後，按一下「完成」。

  9. 如要新增其他版本，請按一下「新增版本」，然後輸入該版本的資訊。

  10. 將支援的版本新增至產品後，請按一下「儲存並驗證」。系統會將圖片複製到公開存放區，然後針對圖片執行一系列測試。

  11. 按一下「提交」，將容器映像檔送交審查。

預覽容器映像檔產品

如要讓使用者看到 Cloud Marketplace 產品資訊前，先預覽產品資訊：

  1. 在產品清單中，按一下產品 ID。

  2. 在產品的「總覽」頁面中，按一下「完整預覽」。

如果您在 Producer Portal 中驗證容器映像檔後，變更了測試環境存放區中的任何標記，預覽畫面中參照的圖片可能會不準確。

發布容器映像檔產品

如要在 Cloud Marketplace 上發布產品，您必須：

所有審查都獲得核准後，您可以在幾分鐘內發布及推出產品。如要發布產品：

  1. 在產品清單中，按一下產品 ID。

  2. 在產品的「總覽」頁面中，按一下「發布」。

上一頁
提供容器映像檔產品
下一頁
更新、淘汰及刪除容器映像檔產品