AWS Systems Manager
ユーザーガイド

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

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

注記

SSM エージェント の更新に関する通知を受け取るには、GitHub の「SSM エージェント リリースノート」ページをサブスクライブします。

開始する前に

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

注記

AWS CLI または AWS Tools for Windows PowerShell を使用して関連付けを作成する場合は、次の例に示すように --Targets パラメータを使用してインスタンスをターゲットにします。--InstanceID パラメータは使用しないでください。--InstanceID パラメータはレガシーパラメータです。

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

  1. まだ AWS CLI をインストールして設定していない場合は、インストールして設定します。

    詳細については、「AWS CLI をインストールまたはアップグレードしてから設定する」を参照してください。

  2. 次のコマンドを実行し、Amazon EC2 タグを使用してインスタンスを対象にして、関連付けを作成します。Schedule パラメータは、毎週日曜日の午前 2:00 に関連付けを実行するようスケジュールを設定します。(UTC)

    aws ssm create-association --targets Key=tag:TagKey,Values=TagValue --name AWS-UpdateSSMAgent --schedule-expression "cron(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 2 ? * SUN *)"

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

    {
        "AssociationDescription": {
            "ScheduleExpression": "cron(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 と表示されます。

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

    aws ssm list-associations

    注記

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