AWS Systems Manager
ユーザーガイド

自動的に SSM エージェント (CLI) を更新する

以下の手順では、AWS Command Line Interface (AWS CLI) を使用して ステートマネージャー の関連付けを作成するプロセスを説明します。関連付けにより、ユーザーが指定したスケジュールに従って SSM エージェント エージェントを自動的に更新できます。SSM エージェント の詳細については、「SSM エージェント のインストールと設定」を参照してください。

SSM エージェント のバージョン別の詳細を確認するには、リリースノートを参照してください。

開始する前に

次の手順を完了する前に、Systems Manager 用に設定されている実行中の Amazon EC2 インスタンス (Linux または Windows) が少なくとも 1 つあることを確認します。詳細については、「Systems Manager の前提条件」を参照してください。

SSM エージェント を自動的に更新するための関連付けを作成するには

  1. 最新バージョンの AWS CLI をローカルマシンにダウンロードします。

  2. AWS CLI を開いて次のコマンドを実行し、認証情報とリージョンを指定します。Amazon EC2 で管理者権限を持っているか、AWS Identity and Access Management (IAM) で適切なアクセス権限を付与されている必要があります。

    aws configure

    以下を指定するよう求められます。

    AWS Access Key ID [None]: key_name AWS Secret Access Key [None]: key_name Default region name [None]: region Default output format [None]: ENTER
  3. 次のコマンドを実行し、Amazon EC2 タグを使用してインスタンスを対象にして、関連付けを作成します。Schedule パラメータは、毎週日曜日の午前 2:00 に関連付けを実行するようスケジュールを設定します。(UTC)

    aws ssm create-association --targets Key=tag:TagKey,Values=TagValue --name AWS-UpdateSSMAgent --schedule-expression "cron(0 0 2 ? * SUN *)"

    注記

    ステートマネージャー の関連付けは、すべての cron および rate 式をサポートしていません。関連付けの cron および rate 式の作成の詳細については、「リファレンス: Systems Manager の Cron および Rate 式」を参照してください。

    必要に応じて、インスタンス ID をカンマ区切りのリストで指定し、複数のインスタンスを対象にすることができます。

    aws ssm create-association --targets Key=instanceids,Values=InstanceID,InstanceID,InstanceID --name your document name --schedule-expression "cron(0 0 2 ? * SUN *)"

    以下のような情報が返されます。

    { "AssociationDescription": { "ScheduleExpression": "cron(0 0 2 ? * SUN *)", "Name": "AWS-UpdateSSMAgent", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "123..............", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1504034257.98, "Date": 1504034257.98, "AssociationVersion": "1", "Targets": [ { "Values": [ "TagValue" ], "Key": "tag:TagKey" } ] } }

    システムはインスタンスで関連付けを作成し、状態を即時に適用します。関連付けのステータスは Pending と表示されます。

  4. 作成した関連付けの最新のステータスを表示するには、次のコマンドを実行します。

    aws ssm list-associations

    注記

    インスタンスで現在最新バージョンの SSM エージェント を実行している場合、ステータスは Failed と表示されます。これは想定される動作です。新しいバージョンの SSM エージェント が公開されると、関連付けによって自動的に新しいエージェントがインストールされ、ステータスが Success と表示されます。