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

# 为创建 AMI 和容器产品使用说明 AWS Marketplace
<a name="ami-container-product-usage-instructions"></a>

作为 AWS Marketplace 卖家，您以不同的方式向买家配送商品。在配送 Amazon 系统映像 (AMIs) 和容器映像时，您有责任为它们撰写使用说明。下面提供了编写此类产品使用说明的要求与建议。

有关更多信息，请参阅 [AWS Marketplace 中基于 AMI 的产品](ami-products.md)。

**Topics**
+ [要求](#ami-write-usage-instructions)
+ [编写发行说明](#writing-the-release-notes)
+ [编写使用说明](#writing-the-usage-instructions)
+ [编写升级说明](#writing-upgrade-instructions)
+ [撰写 CloudFormation 配送说明](#ami-cloudformation-delivery)

## 要求
<a name="ami-write-usage-instructions"></a>

为产品创建使用说明时，必须包含以下信息：
+ 客户保存的所有敏感信息的位置。
+ 解释所有数据加密配置。如果您的应用程序使用任何加密技术，请提供有关用户如何与您的应用程序交互以解密必要数据的详细说明。
+ 如果您的产品包含加密材料，则必须在使用说明中注明密钥轮换要求。有关使用凭证和加密密钥的列表的基本要求，请参阅 [基于 AMI 的产品要求 AWS Marketplace](product-and-ami-policies.md)。
+ 如果您的产品中的任何数据存储是专有的，请提供 step-by-step有关配置、备份和恢复的说明。
+ Step-by-step 有关如何评估和监控应用程序的运行状况和正常功能的说明。例如：
  + 导航到 [Amazon EC2 控制台](https://us-east-1.signin.aws.amazon.com/oauth?response_type=code&client_id=arn%3Aaws%3Aiam%3A%3A015428540659%3Auser%2Fec2&redirect_uri=https%3A%2F%2Fus-east-1.console.aws.amazon.com%2Fec2%2Fv2%2Fhome%3Fregion%3Dus-east-1%26state%3DhashArgs%2523Home%253A%26isauthcode%3Dtrue&forceMobileLayout=0&forceMobileApp=0&code_challenge=aRqwDZ0gdWGXfWQgSpY_ge8vSRw2poGnBZ_8qsU5fiA&code_challenge_method=SHA-256)并验证您所在的区域是否正确。
  + 选择**实例**并选择您启动的实例。
  + 选择服务器以显示您的元数据页面，然后选择页面底部的**状态检查**选项卡，以查看您的状态检查是通过还是失败。
+ 有关管理 AWS 服务配额的规范性指南。有关更多信息，请参阅《[AWS 参考指南](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)》。
+ 定价明细，包括在标准配额之外添加的运行 AWS 资源的成本。这可以包含在您的产品使用说明中，也可以链接到包含有关管理和请求增加服务限额的详细信息的[文档](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)。

## 编写发行说明
<a name="writing-the-release-notes"></a>

每次更新产品时，必须在发行说明中提供更改说明。发行说明应包含特定的信息以帮助用户决定是否安装更新。请在更新中使用清晰的标签，例如，在安全更新中使用“关键”，或者在其他类型的更新中使用“重要”或“可选”。

## 编写使用说明
<a name="writing-the-usage-instructions"></a>

提供使用说明，帮助确保买家能够成功配置和运行软件。您提供的使用说明将显示在配置过程中。

要编写有效的使用说明，请遵循以下准则：
+ 假设用户感兴趣但不了解相关情况。
+ 向用户提供启动和使用产品所需的所有信息，包括任何配置设置和特殊步骤。

 示例使用说明：

1. 通过一键式操作启动产品。

1. 使用 Web 浏览器通过 `https://<EC2_Instance_Public_DNS>/index.html` 访问应用程序。

1. 使用以下凭证登录：
   + 用户名：`user`
   + 密码：实例 ID（`instance_id`）

## 编写升级说明
<a name="writing-upgrade-instructions"></a>

提供有关买家如何从产品早期版本进行升级的详细信息。包括有关如何在创建另一个实例时保留数据和设置的信息。如果没有升级路径，请编辑此字段以明确说明。

示例升级说明：

1. 执行 \*\*\*\*，然后 \*\*\*\*。

1. 通过执行 \*\*\* 检查由项目使用的所有插件是否与版本 \*.\* 兼容。如果它们不兼容，执行 \*\*\*。

1. 通过执行 \*\*\* 备份您的数据。

## 撰写 CloudFormation 配送说明
<a name="ami-cloudformation-delivery"></a>

使用 CloudFormation 配送时，还必须包括以下内容：
+  CloudFormation 模板创建的每个 AWS Identity and Access Management (IAM) 角色和 IAM 策略的用途
+  CloudFormation 模板创建的每个密钥的用途和位置
+ 涉及多个元素的部署中的网络配置详细信息
+ 详细指南，介绍如何启动应用程序，以及在部署包含多个 AWS 资源时如何配置应用程序以进行通信
+ 定价明细，包括超出标准限制的运行 AWS 资源的成本。提供有关管理 AWS 服务限制的规范性指导。
+ 所有数据加密配置。例如：Amazon S3 服务器端加密、Amazon Elastic Block Store (Amazon EBS)、Linux 统一密钥设置 (LUKS) 等