设置技术组件

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

如果您在初始配置过程中有疑问，请与您的 Cloud Marketplace 合作伙伴工程师联系。如果您不知道您的专属合作伙伴工程师是谁，请通过 Partner Support Desk 请求帮助，并在说明中添加“Marketplace”一词。如需详细了解 Partner Support Desk，请访问向 Cloud Marketplace 寻求帮助。

Artifact Registry 和 IAM 设置

您需要先创建一个临时 Artifact Registry 代码库，并将您想要在产品中分发的映像推送到该代码库，然后才能在 Producer Portal 中创建产品。在您的项目中，您必须将 Project Editor 角色授予 cloud-commerce-marketplace-onboarding@twosync-src.google.com。

Container Registry 使用入门

若要将标记的容器映像推送到 Container Registry，请按照 Artifact Registry 文档中的准备工作中的步骤执行操作。然后，使用以下步骤启用工件分析 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. 完成Product details（产品详情）部分的PRODUCT INFO（产品信息）标签页。您可以在填写PRODUCT INFO（产品信息）的同时添加类别 ID。客户可在搜索 Cloud Marketplace 时，在选择类别或过滤条件下按类别 ID 查找您的产品。

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

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

6. 准备好提交产品详情以进行处理时，请点击 Submit（提交）。

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

添加容器映像

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

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

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

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

3. 在容器映像部分中，输入您的 Artifact Registry 临时存储库的网址。

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

5. 选择要添加到商品中的版本的展示标记。您必须在产品中包含 latest 版本，但可以添加其他版本。为方便用户，我们建议您限制商品可用的版本数量。

6. （可选）添加版本标题和版本的简短说明。这些信息有助于用户部署所需的版本。

7. 输入此版本支持的操作系统。如有必要，您可以指定操作系统版本。

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

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

10. 为产品添加完受支持的版本后，点击保存并验证。系统会将图片复制到一个公共代码库，然后针对图片运行一系列测试。

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

预览容器映像产品

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

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

2. 在产品的概览页面上，点击完整预览。

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

发布容器映像产品

如需在 Cloud Marketplace 上发布产品，您必须满足以下条件：

• 完成产品详情和容器映像审核。

• 获得Google Cloud “构建”型合作伙伴资质认证。

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

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

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