翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# の AMI およびコンテナ製品の使用手順の作成 AWS Marketplace
<a name="ami-container-product-usage-instructions"></a>

 AWS Marketplace 販売者は、さまざまな方法で製品を購入者に配信します。Amazon マシンイメージ (AMI) とコンテナイメージを使用して配信する場合、ユーザーはそれらの使用方法を記述する責任があります。以下のセクションでは、これらの製品タイプの使用手順の記述に関する要件と推奨事項について説明します。

詳細については、「[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) には、認証情報と暗号化キーを使用するリストの基本要件が説明されています。
+ 製品に独自のデータストアがある場合は、設定、バックアップ、リカバリの手順を詳細に説明してください。
+ アプリケーションの正常性と適切な機能を評価およびモニタリングする手順について説明します。例えば、次のようになります。
  + [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 リソースの実行コストを含む料金内訳。この情報は、製品の使用手順に記載することも、Service Quotas (階層) の管理と増額のリクエストに関する詳細情報を含む[ドキュメント](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-Click を使用して製品を起動します。

1. ウェブブラウザを使用して、`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 配信を使用するときは、以下も含める必要があります。
+ テンプレートによって作成された各 AWS Identity and Access Management (IAM) ロールと CloudFormation IAM ポリシーの目的
+  CloudFormation テンプレートによって作成された各キーの目的と場所
+ 複数の要素を含むデプロイにおけるネットワーク設定の詳細
+ アプリケーションの起動方法と、デプロイに複数の AWS リソースが含まれている場合に通信するように設定する方法に関する詳細なガイド
+ 標準制限を超えて追加された AWS リソースの実行コストを含む料金内訳。 AWS サービス制限の管理に関する規範的なガイダンスを提供します。
+ すべてのデータ暗号化設定。例: Amazon S3 サーバー側の暗号化、Amazon Elastic Block Store (Amazon EBS) 暗号化、Linux Unified Key Setup (LUKS) など)