设置技术组件

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

如果您在初始配置过程中有疑问,请与您的 Google Cloud Marketplace 合作伙伴工程师联系。如果您不知道您的专属合作伙伴工程师是谁,请通过 cloud-partner-onboarding@google.com 与我们联系。

Container Registry 和 IAM 设置

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

Container Registry 使用入门

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

安装 gcloud 和 Docker 后,您必须从 API 库页面启用以下 API:

  • Container Registry API
  • Container Analysis API

Container Registry API 可让您将内容推送到 Container Registry,而 Container 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. 使用 latest 通过 Docker 标记映像。

    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 代码库。

您随时可以按任意顺序提交这些评价。

如需创建产品的 Google Cloud Marketplace 条目,请执行以下操作:

  1. 在 Google Cloud Console 中打开 Producer Portal:

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

    YOUR_PUBLIC_PROJECT_ID 替换为您为 Google Cloud Marketplace 创建的公共项目的 ID,例如 my-organization-public

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

  3. 选择容器映像

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

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

添加产品详情

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

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

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

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

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

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

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

  6. 准备好提交商品详情进行处理后,点击提交

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

添加容器映像

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

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

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

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

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

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

  5. 针对要纳入产品的版本,选择显示标记。您必须在产品中添加 latest 版本,但可以添加其他版本。我们建议您为用户提供便利版本数量限制,以方便用户使用。

  6. (可选)添加版本标题和版本的简短说明。 这些内容有助于用户部署他们所需的版本。

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

  8. 添加专辑的所有信息后,点击完成

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

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

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

发布容器映像产品

所有评价获得批准后,您可以在几分钟内发布和发布产品。

您可以点击完整预览,在向用户显示您的 Google Cloud Marketplace 商品详情之前进行预览。在验证门户中的容器映像后,如果您更改了临时代码库中的任何标记,则预览中引用的映像可能不准确。

要发布容器映像产品,请执行以下操作:

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

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

合作伙伴门户

合作伙伴门户的直接链接是:

https://console.cloud.google.com/partner/solutions?project=YOUR_PROJECT_ID

然后导航到 Solutions(解决方案)部分。

如果您没有看到该链接或无法访问该网址,请确认您已选择正确的项目。如果您仍然看不到该链接,请 cloud-partners@google.com 了解详情。

第 2 步:将产品创建为新的解决方案

  1. 点击页面顶部的 ADD SOLUTION(添加解决方案)。
  2. 为解决方案命名并检查解决方案 ID。
  3. 选择 Container(容器)解决方案类型。
  4. 输入您的临时代码库网址。

    • 此网址就是用于标记和推送映像的临时代码库路径。
    • 命令提示符将验证临时代码库路径(请确保它已存在且可通过合作伙伴门户访问)。创建按钮将处于已停用状态,除非提供了有效的代码库。

第 3 步:修改产品的营销信息

  1. 要修改营销信息,请点击您的解决方案 ID。
  2. 完成解决方案元数据 (Solution Metadata)、解决方案详情以及文档和支持 (Documentation & Support) 部分。

第 4 步:创建 latest 版本(以及任何其他版本)

您需要创建一个与 Container Registry 标记 latest(区分大小写)对应的版本。这将是下拉列表中的默认版本,而且在未提供标记时将从官方 Container Registry 代码库中拉取该版本。您可以选择创建其他版本,但我们建议您只创建少数几个版本,以免最终用户不知所措。

  1. 点击解决方案编辑器菜单中 Versions(版本)旁边的修改按钮。
  2. 点击 Create version(创建版本)。
  3. 填写版本信息:

    • 请注意,您所做的所有更改都会反映在修改面板左侧的实时预览中。请记住,您可以点击解决方案标题旁边以及元数据部分中的 Version(版本)下拉列表,不过在您只有一个版本时下拉列表会处于已停用状态:

    • 选择版本应该对应的 Container Registry 标记。这将用于识别版本,而且在创建版本后无法更改。

    • 指定标题(它将显示在下拉列表中)。

    • 指定说明(可选;它将显示在下拉列表和元数据部分中)。

    • 指出适用于您的解决方案的操作系统和其他打包软件(至少一个)。这些项在解决方案提交后无法更改。

    • 点击保存

  4. 对您想要添加的任何后续版本重复此过程。

  5. 通过点击并拖动手柄将版本排列成所需的顺序。

    • 您的更改会以实时预览形式反映。

请注意,您可以离开合作伙伴门户,稍后再回来继续处理,或完成并提交草稿。系统会保存您的进度。

第 5 步:进行任何所需的版本修订

要进行任何必要的版本修订,请点击 Version overview(版本概览)页面上表格中您想要修改的版本的 (Container Registry) 标记。

  • 您可以在提交之前修改版本的标题、说明、当前映像、操作系统或打包软件。

    • 请注意,操作系统和打包软件与特定摘要相关联。草稿提交后,您将无法更改操作系统或打包软件。但是,如果您更新版本的摘要,则系统会要求您确认/修改该特定摘要的操作系统和打包软件。

    • 如果临时代码库中包含标记的当前映像与草稿中的映像不匹配,则系统将启用 Update to current digest(更新到当前摘要)按钮。点击该按钮,并确认/修改新映像的操作系统和打包软件。

    • 您也可以删除尚未提交的版本(只是草稿的一部分),但必需的 latest 版本除外。

第 6 步:提交

确认产品的外观和行为符合您的预期后,请点击解决方案编辑器主菜单中的提交审核 (Submit for review) 按钮。