设置技术组件

本页面概述如何创建使用 Google Cloud Marketplace 分发容器映像产品所需的关键技术组件。

如果您在新手入门过程中有任何疑问，请与您的 Cloud Marketplace 合作伙伴工程师联系。如果您不知道您的专属合作伙伴工程师是谁，请使用 Partner Support Desk 寻求帮助，并在说明中添加“Marketplace”一词。如需详细了解 Partner Support Desk，请参阅请求 Cloud Marketplace 方面的帮助。

Container Registry 和 IAM 设置

您需要先创建临时 Container Registry 代码库，并将要在产品中分发的映像推送到该代码库，然后才能在 Producer Portal 中创建产品。在项目中，您必须向 [e-mail] 授予 Project Editor 角色。

Container Registry 使用入门

如需将已标记的容器映像推送到 Container Registry，请按照 Container Registry 文档中准备工作中的步骤操作。然后，按照以下步骤启用 Artifact Analysis API。

对于现有虚拟机合作伙伴：您的临时 Container Registry 代码库可能位于您的开发项目中，而不是位于您的公共项目中。

安装 gcloud 和 Docker 后，您必须从 “API 库”页面启用以下 API：

• Container Registry API
• Artifact Analysis API

您可以使用 Container Registry API 向 Container Registry 推送内容，而使用 Artifact Analysis API 进行安全扫描。

如果您无法访问这些 API 中的任何一个，请与您的合作伙伴工程师联系。

标记和推送映像

1. 选择 Container Registry 临时代码库路径。建议您的存储库遵循结构 gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID。

   • 临时代码库必须位于 gcr.io 中（诸如 eu.gcr.io 等其他区域尚不受支持）
   • 保存或复制临时代码库路径，以便在 Producer Portal 中创建产品。

2. 构建要推送到 Container Registry 临时代码库的映像。

3. 通过 Docker 使用 latest 标记映像。

   docker tag image_name staging_repo_path:tag

   例如：docker tag test-image gcr.io/testpartner/testsolution:latest

   请注意，如果用户未指定标记，则拉取标记为 latest 的映像。

4. 使用 gcloud 推送您的映像：

   gcloud docker push staging_repo_path:tag

5. 对要添加到临时代码库的任何其他标记或映像重复此操作。单个映像可能具有多个标记。

   • 请记住，将映像推送到临时代码库不会自动将映像公开给用户；只有符合下列条件的映像才会自动公开给用户：映像含有您所选择的标记，以及映像已发布。
   • 代码库的范围是其路径所指定的文件夹的单个级层。代码库的其他文件夹内的任何映像实际上都不在代码库本身中。换句话说，如果某个映像位于 gcr.io/testpartner/testsolution/1.0 中，则该映像不在 gcr.io/testpartner/testsolution 代码库中。 gcr.io/testpartner/testsolution/1.0 是一个单独的代码库。

在 Producer Portal 中创建产品

本部分介绍如何在 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）。

   注意：如果您没有看到该链接或无法访问该网址，请确认您已选择正确的项目并且拥有项目的 Editor (roles/editor) 角色。如果您仍然无法访问该网址，请使用 Partner Support Desk 寻求帮助，并在说明中添加“Marketplace”一词。如需详细了解 Partner Support Desk，请访问请求 Cloud Marketplace 方面的帮助。

2. 在页面顶部，点击添加产品。

3. 选择容器映像。

4. 在产品名称下，为您的产品命名，然后检查产品 ID。产品 ID 用于 Cloud Marketplace 产品详情的网址。

   注意 ：商品创建后，商品 ID 和商品类型便无法更改。提交产品之前，您可以更改产品名称。

5. 点击创建。创建产品可能需要几秒钟。

添加产品详情

产品详情包括 Cloud Marketplace 上的产品详情、营销信息和文档链接。

如需添加商品详情，请执行以下操作：

1. 在产品列表中，点击产品 ID。

2. 在产品的概览页面上，前往产品详情，然后点击修改。

3. 完成Product details（产品详情）部分的PRODUCT INFO（产品信息）标签页。您可以在填写PRODUCT INFO（产品信息）的同时添加类别 ID。借助类别 ID，客户在 Cloud Marketplace 中搜索时，可以在所选类别或过滤条件下找到您的产品。

4. 要添加教程、文档和（可选）其他许可协议，请完成产品详情部分的文档标签页。您的文档必须符合用户指南的要求。

5. 要添加搜索元数据或关键字，或者自定义产品详情页面的网址，请完成产品详情部分的产品元数据标签页。

6. 当您准备好提交商品详情以进行处理时，点击提交。

合作伙伴工程团队大约需要 2-5 天的时间来审核和批准您的产品详情。您可以立即开始修改详细信息，稍后再提交评价。

添加容器映像

您需要创建一个与 Container Registry 标记 latest 对应的版本（区分大小写）。这是产品页面中的默认版本。

如需添加容器映像，请执行以下操作：

1. 在产品列表中，点击产品 ID。

2. 在产品的概览页面上，转到容器映像，然后点击修改。

3. 在容器映像部分中，输入临时 Container Registry 代码库的网址。

4. 点击指定版本。读取代码库并加载标记可能需要几秒钟的时间。

5. 选择要在产品中添加的版本对应的显示代码。您必须在产品中添加 latest 版本，但您可以添加其他版本。为方便用户，我们建议您限制产品可用的版本数量。

6. （可选）添加版本标题和版本的简短说明。 这些功能可以帮助您的用户部署他们所需的版本。

7. 输入此版本支持的操作系统。您可以根据需要指定操作系统版本。

8. 添加此发布版本的所有信息后，点击完成。

9. 如需添加其他版本，请点击添加版本，然后输入该版本的信息。

10. 将支持的版本添加到产品后，点击保存并验证。这些映像会复制到公共代码库，然后我们针对这些映像运行一系列测试。

11. 点击提交，提交容器映像以供审核。

预览容器映像产品

如需在用户看到 Cloud Marketplace 产品详情之前对其进行预览，请执行以下操作：

1. 在产品列表中，点击产品 ID。

2. 在产品的 Overview（概览）页面上，点击 Full preview（完整预览）。

自从在 Producer Portal 中验证容器映像以来，如果您更改了临时代码库中的任何标记，则预览中引用的映像可能不准确。

发布容器映像产品

如需在 Cloud Marketplace 上发布产品，您必须执行以下操作：

• 填写商品详情和容器映像评价。

• 获批成为 Google Cloud Build 合作伙伴。

所有审核都获得批准后，您便可以在几分钟内发布和发布产品。如需发布产品，请执行以下操作：

1. 在产品列表中，点击产品 ID。

2. 在产品的概览页面上，点击发布。