本页面概述如何创建使用 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 文档中的准备工作中的步骤执行操作。然后按照以下步骤启用 Artifact Analysis API。
安装 gcloud 和 Docker 后，您必须从 API 库页面启用以下 API：
- Artifact Registry API
- Artifact Analysis API
借助 Artifact Registry API，您可以将 借助 Artifact Registry 和 Artifact Analysis API 安全扫描。
如果您无法访问这些 API 中的任何一个，请与您的合作伙伴工程师联系。
标记和推送映像
选择您的 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。
- 暂存代码库必须位于
构建要推送到 Artifact Registry 临时代码库的映像。
通过 Docker 使用
latest标记映像。docker tag image_name staging_repo_path:tag例如：
docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest请注意，如果用户未指定标记
latest，则会拉取标记为latest的映像。 标记前面。使用
gcloud推送您的映像：gcloud docker push staging_repo_path:tag对要添加到临时代码库的任何其他标记或映像重复此操作。单个映像可能具有多个标记。
- 请记住，将映像推送到临时代码库不会自动将映像公开给用户；只有符合下列条件的映像才会自动公开给用户：映像含有您所选择的标记，以及映像已发布。
- 代码库的范围是其路径所指定的文件夹的单个级层。代码库的其他文件夹内的任何映像实际上都不在代码库本身中。换句话说，如果映像位于
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。
要在 Producer Portal 上发布产品，您需要为自己的 ，然后提交以下信息以供审核：
- 产品详情：添加产品的详情和营销信息。
- 容器映像：提供包含容器映像的 Google Container Registry 代码库。
您可以随时按任意顺序提交这些审核材料。
如需创建产品的 Cloud Marketplace 条目，请执行以下操作：
在 Google Cloud 控制台中打开 Producer Portal：
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
将 YOUR_PUBLIC_PROJECT_ID 替换为公开 ID 为 Cloud Marketplace 创建的项目，例如
my-organization-public。在页面顶部，点击添加产品。
选择容器映像。
在产品名称下，为您的产品命名，然后检查产品 ID。产品 ID 用于 Cloud Marketplace 产品详情的网址。
点击创建。创建产品可能需要几秒钟。
添加产品详情
产品详情包括您在 Cloud Marketplace 上的产品详情 营销信息以及指向相关文档的链接
如需添加商品详情，请执行以下操作：
在产品列表中，点击产品 ID。
在产品的概览页面上，前往产品详情，然后点击修改。
完成Product details（产品详情）部分的PRODUCT INFO（产品信息）标签页。您可以在填写PRODUCT INFO（产品信息）的同时添加类别 ID。客户可在搜索 Cloud Marketplace 时，在选择类别或过滤条件下按类别 ID 查找您的产品。
添加教程、文档和其他（可选） 许可协议，完成产品页面的 DOCUMENTATION 标签页 详情部分。您的文档必须符合用户指南的要求。
要添加搜索元数据或关键字，或者自定义产品详情页面的网址，请完成产品详情部分的产品元数据标签页。
准备好提交产品详情以进行处理时，请点击 Submit（提交）。
合作伙伴工程团队大约需要 2-5 天的时间来审核和批准您的产品详情。您可以立即开始修改详细信息，稍后再提交评价。
添加容器映像
您需要创建一个与 Container Registry 标记 latest（区分大小写）对应的版本。这是商品页面中的默认版本。
如需添加容器映像，请执行以下操作：
在产品列表中，点击相应产品的 ID。
在产品的概览页面上，前往容器映像。 然后点击修改。
在容器映像部分中，输入 Artifact Registry 临时存储库的网址。
点击指定版本。系统可能需要几秒钟的时间来阅读 并加载代码
选择要添加到商品中的版本的显示标记。您必须在产品中包含
latest版本，但可以添加其他版本。为方便用户，我们建议您限制商品可用的版本数量。（可选）添加版本标题和版本的简短说明。 这些信息有助于用户部署所需的版本。
输入此版本支持的操作系统。如有必要，您可以指定操作系统版本。
添加完版本的所有信息后，点击完成。
如需添加其他版本，请点击添加版本，然后输入相关信息 。
为产品添加完受支持的版本后，点击保存并验证。系统会将图片复制到一个公共代码库，然后针对这些图片运行一系列测试。
点击提交，提交容器映像以供审核。
预览容器映像产品
如需在用户看到您的 Cloud Marketplace 商品详情之前对其进行预览，请执行以下操作：
在产品列表中，点击产品 ID。
在商品的概览页面上，点击完整预览。
如果您在验证自己的代码之后，更改临时代码库中的任何标记， 容器映像时，预览中引用的映像可能 不准确。
发布容器映像产品
如需在 Cloud Marketplace 上发布产品，您必须满足以下条件：
填写商品详情和容器映像审核。
所有审核均获得审批后，您在几分钟内即可发布和推出产品。如需发布产品，请执行以下操作：
在产品列表中，点击产品 ID。
在产品的概览页面上，点击发布。