在上添加您的容器产品的新版本 AWS Marketplace - AWS Marketplace
第 1 步：添加存储库 第 2 步：将容器映像和构件上传到存储库第 3 步：向容器产品添加新版本第 4 步：更新版本信息限制 Amazon EKS 附加组件的版本

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在上添加您的容器产品的新版本 AWS Marketplace

作为 AWS Marketplace 卖家，您可以添加集装箱商品的新版本、管理版本和更新版本信息。您的产品在其生命周期内可能有多个版本。每个版本都有一组特定于该版本的容器映像。以下主题将说明如何管理容器产品的产品版本。

注意

只有为产品创建了产品 ID 和定价，才能向产品添加版本。有关这些步骤的更多信息，请参阅第 1 步：为容器产品创建产品 ID 和产品代码。

第 1 步：添加存储库

您的产品容器映像和其他构件存储在 AWS Marketplace中的存储库中。通常，您可以为所需的每个构件创建一个存储库，但该存储库可以存储该构件的多个版本（使用不同的标签）。

注意

产品部署中的所有映像都必须使用 AWS Marketplace 存储库中的映像。

以下过程介绍如何在中添加任何所需的存储库 AWS Marketplace。

要添加存储库，请执行以下操作：

  1. 登录到 AWS Marketplace 管理门户。

  2. 从产品菜单中选择服务器。

  3. 在服务器产品选项卡上，选择要修改的产品，然后从请求更改下拉列表中选择添加存储库。

  4. 输入您要创建的存储库的名称。如果要创建多个新存储库，请执行以下操作：

    • 为每个其他存储库选择 “添加新存储库”。

    • 给它起一个唯一的名字。您选择的唯一名称必须适用于您的卖家账户中的所有商品。

    注意

    存储库将具有以下结构：<repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>. 当您将项目添加到存储库时（在以下过程中），它们将获得一个标签并具有以下结构：<repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>:<tag>。repositoryID是的内部 ID AWS Marketplace。sellerName 是基于您为卖家账户创建的名称。您将在此步骤中定义 respositoryName。tag 是在将构件上传到存储库时设置的。

  5. 选择提交。

注意

对于每个产品，您最多可以有 50 个存储库。

新请求已创建并显示在请求选项卡上。完成后，您可以在几分钟之内开始向已创建的存储库中添加容器映像和其他构件。

第 2 步：将容器映像和构件上传到存储库

要将容器映像和构件上传到存储库，请执行以下操作：

  1. 登录到 AWS Marketplace 管理门户。

  2. 从产品菜单中选择服务器。

  3. 在服务器产品选项卡上，选择要修改的产品。

  4. 从请求更改下拉列表中，选择添加存储库。

  5. 选择查看现有存储库。

  6. 选择要上传到的存储库。

  7. 选择 “查看推送命令” 以打开指令列表，包括可用于推送的命令 Docker 容器镜像和 Helm 该存储库的图表。

    有关如何将容器映像和其他构件推送到存储库的一般信息，请参阅《Amazon Elastic Container Registry 用户指南》中的推送映像。

    注意

    调用 docker pull 或 docker push 时，您可以使用以下Amazon Elastic Container Registry (Amazon ECR) API 操作：

    • DescribeImages – 用于查看存储库中有关映像的元数据。

    • GetAuthorizationToken – 用于在将构件上传到存储库之前进行身份验证，然后使用 docker pull 或 docker push 命令。

    • ListImages – 用于查看您推送的映像列表。

  8. 使用列出的命令将任何需要的工件从本地存储库推送到产品的 AWS Marketplace 存储库。

    注意

    您在 push 命令中提供的 tag 用于区分要上传到存储库的构件的版本。使用对构件所属版本有意义的标签。

  9. 对版本中需要的每个容器映像或构件重复此操作。

    注意

    您的版本在每个交付选项中最多可以包含 50 个容器映像或构件。有关交付选项的更多信息，请参阅以下过程。

上传构件后，您就可以创建产品版本了。

注意

系统会自动扫描您的容器映像，以查看它们是否符合基于容器的产品要求 AWS Marketplace。有关更多信息，请参阅容器产品扫描是否存在安全问题。

添加新的交付选项

容器产品的每个版本都需要一个交付选项。交付选项指定买家可使用的部署选项。根据以下交付选项之一，您需要将相应的构件上传到存储库。

  • 对于容器镜像传送选项，请将安装产品所需的所有容器镜像上传到控制台中创建的亚马逊弹性容器注册表 (Amazon ECR) Container Registry 存储库。 AWS Marketplace

  • 对于 Helm 图表交付选项，上传 Helm 图表和容器图像存储到 AWS Marketplace 控制台中创建的 Amazon ECR 存储库中。

  • 要获取 A mazon EKS 控制台附加组件配送选项，请上传 Helm 图表和容器图像存储到 AWS Marketplace 控制台中创建的 Amazon ECR 存储库中。

第 3 步：向容器产品添加新版本

注意

如果您在向容器添加新版本时收到任何错误，请参阅《AWS Marketplace Catalog API 参考》中的添加新版本异步错误表。

要向容器产品添加新版本，请执行以下操作：

  1. 登录到 AWS Marketplace 管理门户。

  2. 从产品菜单中选择服务器。

  3. 在服务器产品选项卡上，选择要向其添加版本的产品。然后，从请求更改下拉列表中选择添加新版本。

  4. 在添加新版本页面上，输入版本标题和发布说明。

  5. 输入版本详细信息后，下一步是添加交付选项。交付选项是一组说明和信息，买家可以使用这些说明和信息从您的产品版本启动软件。交付选项被称为买家的交付选项。

    注意

    您的产品可以支持具有不同容器镜像的多个平台（例如 Kubernetes 以及 Ubuntu 部署）。您可以为客户设置产品的每种方式创建一个交付选项，每个版本的产品最多可创建四个交付选项。

    1. 如果产品在其他版本中已有交付选项，则可以使用现有选项作为模板，向新版本添加交付选项。在交付选项中，从列表中选择要添加的交付选项。您可以按照以下步骤中的说明编辑该选项。

    2. 要添加新的交付选项，请选择新交付选项。添加选项后，按照以下步骤中的说明，对其进行配置。

  6. 为交付选项选择一种交付方式。交付方式决定了买家将如何启动您的软件。

    • 对于容器映像交付选项，请提供在 AWS Marketplace 控制台中创建的 Amazon Elastic Container Registry (Amazon ECR) 存储库中的容器映像的路径。买家使用容器映像路径通过将映像直接拉入其环境来启动软件。

    • 对于 Helm 图表交付选项，提供路径 Helm 在 AWS Marketplace 控制台中创建的 Amazon ECR 存储库中的图表。买家安装 Helm 在其部署环境中使用图表来启动软件。

    • 要获取 A mazon EKS 控制台附加组件交付选项，请提供路径 Helm 在 AWS Marketplace 控制台中创建的 Amazon ECR 存储库中的图表。买家使用亚马逊 EKS 控制台或原生 Amazon EKS 附加组件安装容器 APIs 来启动软件。有关更多信息，请参阅来自 Amazon EKS 的可用 Amazon EKS 附加组件。

    1. 要添加容器映像交付选项，请执行以下步骤：

      1. 在容器映像中，将 Amazon ECR URL 添加到包含产品版本软件的容器映像中。

      2. 在交付选项标题和部署选项描述中，输入此交付选项的标题和描述。

      3. 在使用说明中，输入详细信息，以帮助买家在启动软件后使用该软件。

      4. 在支持的服务中，选择买家可以在其中启动软件的环境。

      5. 在部署模板中，添加买家可以用来启动软件的资源。输入每个模板的标题和资源 URL。

    2. 要添加 Helm 图表传送选项，请执行以下步骤：

      1. 中Helm 图表，将 Amazon ECR 网址添加到 Helm 购买者将在部署环境中安装的图表，以启动您的软件。

      2. 在容器映像中，将 Amazon ECR URL 添加到包含产品版本软件的容器映像中。

      3. 在交付选项标题和部署选项描述中，输入此交付选项的标题和描述。

      4. 在使用说明中，输入详细信息，以帮助买家在启动软件后使用该软件。

      5. 在支持的服务中，选择买家可以在其中启动软件的环境。

      6. 可选-输入 Helm 版本名称，输入版本的名称 Kubernetes 命名空间其中 Helm 将安装图表。

      7. 可选-输入 Helm 安装命名空间，输入名称 Helm helm install命令将使用的发行版。

      8. 可选-输入 Kubernetes 服务帐户名称，输入名称 Kubernetes 将用于连接的服务账户 AWS Identity and Access Management (IAM)。这些区域有：Kubernetes 服务帐户调用诸如许可或计量之类的 AWS 服务。

      9. 选择在此产品版本QuickLaunch上启用。 QuickLaunch 是中的一项功能 AWS Marketplace。买家可以使用 QuickLaunch 快速创建 Amazon EKS 集群，然后使用在集群上启动您的软件 AWS CloudFormation。有关更多信息，请参阅QuickLaunch 中的 AWS Marketplace。

      10. 在覆盖参数中，输入将用于 Helm 启动软件的 CLI 命令。买家可使用这些参数覆盖提供的默认值。如果已启用 QuickLaunch，还要为 CloudFormation表单输入参数名称和描述。使用 AWS Marketplace 管理控制台时，参数限制为 15 个，但使用时没有限制 AWS Marketplace Catalog API。有关更多信息，请参阅向基于容器的产品添加新版本。

        注意

        一些覆盖参数是必需的。Amazon EKS Anywhere 产品要求为 "${AWSMP_LICENSE_SECRET}" 设置为 DefaultValue 的许可证密钥覆盖参数。对于付费产品，您必须为 "${AWSMP_SERVICE_ACCOUNT}" 设置为 DefaultValue 的服务账号配置覆盖参数。

      11. 选择 “隐藏密码和机密” 以屏蔽控制台、命令行工具和中的敏感信息 APIs。有关更多信息，请参阅《AWS CloudFormation 用户指南》中参数中的 NoEcho 参数文档。

    3. 要添加 Amazon EKS 控制台附加组件交付选项，请确保该构件符合 Amazon EKS 附加组件产品的要求，然后执行以下步骤：

      注意

      每个版本仅支持一个 Amazon EKS 附加组件交付选项。在您正在处理的当前版本发布到 Amazon EKS 控制台之前，您无法添加新版本。

      1. 中Helm 图表，将 Amazon ECR 网址添加到 Helm 购买者将在部署环境中安装的图表，以启动您的软件。

      2. 在容器映像中，将 Amazon ECR URL 添加到包含产品版本软件的容器映像中。确保所有图像都在 Helm 图表已列出。

      3. 在交付选项标题和部署选项描述中，输入此交付选项的标题和描述。

      4. 在可见性中，保持默认值有限选项。

      5. 在附加组件名称中，输入此附加组件的唯一名称。您输入的附加组件名称在 Amazon EKS 控制台中显示时将附加上卖家的名称。

      6. 在附加组件版本中，输入安装或升级此附加组件时将显示的附加组件版本。请遵循格式 major.minor.patch。

      7. 在附加组件类型中，从下拉列表中为您的附加组件选择一个类别。

      8. 中Kubernetes 版本，选择全部 Kubernetes 您的附加组件将支持的版本。

      9. 在架构中，选择您的附加组件支持的平台架构。选项为 AMD64 和 ARM64。我们建议同时支持这两种架构，以最大限度地提高兼容性。如果您的附加组件不支持 ARM64 设备，则必须指定添加支持的计划日期，然后才能在所有广告中发布您的产品 AWS 区域。

      10. 在命名空间中，输入唯一的 Kubernetes 您的插件将安装到的命名空间。安装第三方附加组件时不支持 default、kube-system 和 kube-public 命名空间。

      11. 在环境覆盖参数中，您最多可以从 Amazon EKS 附加组件框架中选择 2 个环境参数。您可以将参数名称从 values.yaml 映射到这些环境变量，即 ${AWS_REGION} 和 ${AWS_EKS_CLUSTER_NAME}。

  7. 要添加其他交付选项，请选择新交付选项，然后重复前面的步骤进行配置。

  8. 选择提交。

第 4 步：更新版本信息

创建版本后，可通过修改与版本关联的信息，向买家提供更新的信息。例如，如果您计划在版本 1.1 发布后限制版本 1.0，则可以更新版本 1.0 的描述以引导买家使用版本 1.1。提供版本 1.0 的受限日期。您可以从 AWS Marketplace 管理门户中更新版本信息。

要更新版本信息，请执行以下操作：

  1. 登录到 AWS Marketplace 管理门户。

  2. 从产品菜单中选择服务器。

  3. 在服务器产品选项卡上，选择要修改的产品。

  4. 从请求更改下拉列表中，选择更新版本信息。

  5. 在更新版本页面上，选择要更新的版本。

  6. 对所选版本进行更新。可供更新的字段取决于产品版本或交付选项的状态。

    1. 对于所有版本，您可以更新发布说明。

    2. 对于尚未公开发布的版本，您可以更新版本标题。

    3. 对于未受限制的交付选项，您可以更新以下字段：

      • 描述

      • 使用说明

      • 支持的服务

    4. 对于尚未公开发布的版本中的交付选项，您可以更新以下字段：

      • 交付选项标题

      • Helm 图表（适用于 Helm 仅限图表交付选项）

      • 容器映像

      • 部署资源

      • AddOn 名称

      • AddOn 版本

      • AddOn 类型

      • Helm 图表网址

      • CompatibleKubernetesVersions

      • SupportedArchitectures

      • 命名空间

      • EnvironmentOverrideParameters

    5. 对于公开版本中的配送选项，您可以更新SupportedArchitectures。

  7. 选择提交。

  8. 验证请求是否显示在请求选项卡上，状态为正在审核。

您可以随时从服务器产品页面的请求选项卡中查看请求的状态。

限制 Amazon EKS 附加组件的版本

要限制作为附加组件发布的容器产品版本，请使用 AWS Marketplace 管理门户 底部的“联系我们”表单联系 AWS Marketplace 运营团队。