设置技术组件

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

如果您在新手入门流程中有疑问,请咨询 Cloud Marketplace 合作伙伴工程师。如果您不知道为您分配的 合作伙伴工程师是,使用 Partner Support Desk 寻求帮助。 并添加“市场”一词。更多信息 有关 Partner Support Desk 的信息,请访问 请求 Cloud Marketplace 方面的帮助

Artifact Registry 和 IAM 设置

在 Producer Portal 中创建产品之前, 您需要创建一个临时的 Artifact Registry 代码库 以及您想要在商品中分发到该代码库的图片在 您必须向 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.deveu.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,则会拉取标记为 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。

要在 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 替换为公开 ID 为 Cloud Marketplace 创建的项目,例如 my-organization-public.

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

  3. 选择容器映像

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

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

添加产品详情

产品详情包括您在 Cloud Marketplace 上的产品详情 营销信息以及指向相关文档的链接

如需添加商品详情,请执行以下操作:

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

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

  3. 完成Product details(产品详情)部分的PRODUCT INFO(产品信息)标签页。您可以在填写PRODUCT INFO(产品信息)的同时添加类别 ID。类别 ID 可用于 客户可以在特定类别或过滤条件下找到您的产品 搜索 Cloud Marketplace。

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

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

  6. 当您准备好提交商品详情以供处理时,请点击 提交

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

添加容器映像

你需要创建一个 注册标记 latest(区分大小写)。这是 商品页面。

如需添加容器映像,请执行以下操作:

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

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

  3. 容器映像部分中,输入暂存区的网址。 Artifact Registry 代码库。

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

  5. 为您要添加到实验中的版本选择展示广告代码 产品。您必须在产品中添加 latest 版本,但 您可以添加其他版本我们建议您限制 针对您用户的。

  6. (可选)添加版本标题和版本的简短说明。 这些 API 可帮助您的用户部署他们需要的版本。

  7. 请输入此版本支持的操作系统。您可以指定 操作系统版本(如果需要)。

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

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

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

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

预览容器映像产品

如需在向用户显示 Cloud Marketplace 商品详情之前对其进行预览,请执行以下操作:

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

  2. 在商品的概览页面上,点击完整预览

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

发布容器映像产品

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

所有评价获得批准后,您便可以发布和发布商品 就会出现这种问题如需发布产品,请执行以下操作:

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

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