翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Systems Manager オートメーションドキュメントの使用
AWS Systems Manager では、 上のインフラストラクチャを可視化して制御できます AWS。Systems Manager は統合されたユーザーインターフェイスを提供するため、複数の AWS サービスの運用データを表示し、 AWS リソース全体の運用タスクを自動化できます。
[システムマネージャのドキュメント](https://docs.aws.amazon.com//systems-manager/latest/userguide/sysman-systems-manager-docs.html) は、マネージドインスタンスで Systems Manager が実行するアクションを定義します。オートメーションドキュメントは、Amazon Machine Image (AMI) の作成や更新など、一般的なメンテナンスやデプロイメントタスクを実行する際に使用する、Systems Manager キュメントを使用します。このトピックでは、 を使用してオートメーションドキュメントを作成、編集、公開、削除する方法について説明します AWS Toolkit for Visual Studio Code。
**Topics**
+ [仮定条件と前提条件](#systems-manager-assumptions)
+ [Systems Manager Automation ドキュメントの IAM アクセス許可](#systems-manager-permissions)
+ [Systems Manager の自動化ドキュメントの新規作成](#systems-manager-create)
+ [既存のSystems Manager 自動化ドキュメントを開く](#systems-manager-open)
+ [Systems Manager Automation ドキュメントの編集](#systems-manager-edit)
+ [Systems Manager Automation ドキュメントの公開](#systems-manager-publish)
+ [Systems Manager Automation ドキュメントの削除](#systems-manager-delete)
+ [Systems Manager Automation ドキュメントの実行](#systems-manager-run)
+ [Toolkit for VS Code の Systems Manager Automation ドキュメントのトラブルシューティング](systems-manager-troubleshoot.md)
## 仮定条件と前提条件
開始する前に、以下を確認してください。
+ Visual Studio Code と、 AWS Toolkit for Visual Studio Codeの最新バージョンをインストールしています。詳細については、「[AWS Toolkit for Visual Studio Code のインストール](setup-toolkit.md)」を参照してください。
+ Systems Manager に精通しています 詳細については、「[https://docs.aws.amazon.com//systems-manager/latest/userguide/what-is-systems-manager.html](https://docs.aws.amazon.com//systems-manager/latest/userguide/what-is-systems-manager.html)」を参照してください。
+ Systems Manager オートメーションのユースケースに精通しています。詳細については、「*AWS Systems Manager ユーザーガイド*」の「[AWS Systems Manager オートメーション](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-automation.html)」を参照してください。
## Systems Manager Automation ドキュメントの IAM アクセス許可
Toolkit for VS Code には、Systems Manager Automation ドキュメントを作成、編集、公開、削除するために必要な AWS Identity and Access Management (IAM) のアクセス許可を含む、認証情報プロファイルがある必要があります。次のポリシードキュメントは、プリンシパルポリシーで使用できる必要な IAM アクセス権限を定義します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ssm:ListDocuments",
"ssm:ListDocumentVersions",
"ssm:DescribeDocument",
"ssm:GetDocument",
"ssm:CreateDocument",
"ssm:UpdateDocument",
"ssm:UpdateDocumentDefaultVersion",
"ssm:DeleteDocument"
],
"Resource": "*"
}
]
}
```
------
IAM ポリシーの更新方法については、「*IAM ユーザーガイド*」の「[IAM ポリシーの作成 ](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_create.html)」を参照してください。認証情報プロファイルの設定方法については、「[AWS IAM 認証情報](setup-credentials.md)」を参照してください。
## Systems Manager の自動化ドキュメントの新規作成
`JSON` または `YAML` Visual Studio コードで新しいオートメーションドキュメントを作成できます。新しいオートメーションドキュメントを作成すると、そのドキュメントはタイトルのないファイルに表示されます。ファイルの名前を付けて VS Code に保存することはできますが、ファイルの名前は表示されません AWS。
**自動化ドキュメントの作成**
1. VSコードを開きます。
1. **[表示]**で、[**コマンドパレット**]を選択して、[コマンドパレット]を開きます。
1. コマンドパレットで、**[AWS Toolkit が新しいSystems Manager ドキュメントをローカルで作成する]**と入力します。
1. Hello World の例については、スターターテンプレートの 1 つを選択します。
1. [`JSON`] または [`YAML`] のいずれかを選択します。
新しいオートメーションドキュメントが作成されます。
**注記**
VS Code の新しいオートメーションドキュメントは、自動的に AWSには表示されません。実行 AWS する前に、 に発行する必要があります。
## 既存のSystems Manager 自動化ドキュメントを開く
AWS Explorer を使用して、既存の Systems Manager Automation ドキュメントを検索します。既存のオートメーションドキュメントを開くと、VS Code に無題のファイルとして表示されます。
**オートメーションドキュメントを開くには**
1. VSコードを開きます。
1. 左側のナビゲーションで、[**AWS**] を選択して AWS Explorer を開きます。
1. AWS Explorer の **Systems Manager** で、開くドキュメントのダウンロードアイコンを選択し、ドキュメントのバージョンを選択します。ファイルは、そのバージョンの形式で開きます。それ以外の場合は、**[JSON としてダウンロードする]** または **[YAML としてダウンロードする]** を選択します。
**注記**
オートメーションドキュメントを VS Code にファイルとしてローカルに保存しても、そのドキュメントは AWSに表示されません。実行 AWS する前に に発行する必要があります。
## Systems Manager Automation ドキュメントの編集
Automation ドキュメントを所有している場合は、 AWS Explorer の Systems Manager ドキュメントの **Owned by Me** カテゴリに表示されます。にすでに存在するオートメーションドキュメントを所有することも AWS、VS Code AWS から に以前に公開した新規または更新されたドキュメントを所有することもできます。
VS Code で編集用にオートメーションドキュメントを開くと、 AWS マネジメントコンソールで行えること以上のことができます。例えば、次のようになります。
+ `JSON` および `YAML` 形式両方にスキーマ検証があります。
+ ドキュメントエディタには、オートメーションステップタイプの作成に使用できるスニペットがあります。
+ `JSON` および `YAML` のさまざまなオプションにオートコンプリートサポートがあります。
### バージョンの使用
Systems Manager オートメーションドキュメントでは、変更管理にバージョンが使用されます。VS Code では、オートメーションドキュメントのデフォルトバージョンを選択できます。
**デフォルトバージョンを設定するには**
+ AWS Explorer で、デフォルトバージョンを設定するドキュメントに移動し、ドキュメントのコンテキスト (右クリック) メニューを開き、**デフォルトバージョンの設定**を選択します。
**注記**
選択したドキュメントに 1 つのバージョンしかない場合は、デフォルトを変更することはできません。
## Systems Manager Automation ドキュメントの公開
VS Code でオートメーションドキュメントを編集したら、公開できます AWS。
**オートメーションドキュメントを公開するには**
1. [既存のSystems Manager 自動化ドキュメントを開く](#systems-manager-open) で説明されている手順を使用して、公開する自動化ドキュメントを開きます。
1. 公開したい変更を行います。詳細については、「[Systems Manager Automation ドキュメントの編集](#systems-manager-edit)」を参照してください。
1. 開いているファイルの右上にある [Upload] (アップロード) アイコンを選択します。
1. 公開ワークフローダイアログボックスで、自動化ドキュメントを公開する AWS リージョンを選択します。
1. 新しいドキュメントを公開する場合は、**[Quick Create]** を選択します。それ以外の場合は、**クイック更新**を選択して、その AWS リージョンの既存のオートメーションドキュメントを更新します。
1. このオートメーションドキュメントの名前を入力します。
既存の Automation ドキュメントの更新を に発行すると AWS、新しいバージョンがドキュメントに追加されます。
## Systems Manager Automation ドキュメントの削除
VS Code でオートメーションドキュメントを削除できます。オートメーションドキュメントを削除すると、ドキュメントとドキュメントのすべてのバージョンが削除されます。
**重要**
削除は破壊的なアクションで、元に戻すことはできません。
すでに実行されているオートメーション ドキュメントを削除しても、開始時に作成または変更された AWS リソースは削除されません。
**オートメーションドキュメントを削除するには**
1. VSコードを開きます。
1. 左側のナビゲーションで、[**AWS**] を選択して AWS Explorer を開きます。
1. AWS Explorer の **Systems Manager** で、削除するドキュメントのコンテキスト (右クリック) メニューを開き、**ドキュメントの削除**を選択します。
## Systems Manager Automation ドキュメントの実行
オートメーションドキュメントが に公開されたら AWS、それを実行して、 AWS アカウントでユーザーに代わってタスクを実行できます。Automation ドキュメントを実行するには、 AWS マネジメントコンソール、APIs、、 AWS CLIまたは を使用します AWS Tools for PowerShell。オートメーションドキュメントの実行方法については、「*AWS Systems Manager ユーザーガイド*」の「[シンプルなオートメーションを実行する](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)」を参照してください。
または、 AWS SDKs を使用してオートメーションドキュメントを実行する場合は、 [AWS SDK リファレンス](https://aws.amazon.com/getting-started/tools-sdks/)を参照してください。 APIs
**注記**
自動化ドキュメントを実行すると、 に新しいリソースが作成され AWS 、請求コストが発生する可能性があります。オートメーションドキュメントを開始する前に、アカウントにどのようなリソースが作成されるかを把握することを強くお勧めします。