Amazon Linux インスタンスに SSM Agent を手動でインストールする - AWS Systems Manager

Amazon Linux インスタンスに SSM Agent を手動でインストールする

重要

このトピックでは、Amazon Linux インスタンスで SSM Agent を使用するためのコマンドについて説明します。これらのコマンドの一部は、Amazon Linux 2 インスタンスではサポートされていません。続行する前に、インスタンスタイプに対する正しいトピックを参照していることを確認してください。Amazon Linux 2 インスタンスで実行するコマンドについては、「Amazon Linux 2 インスタンスに SSM Agent を手動でインストールする」を参照してください。

ほとんどの場合、AWS が提供する Amazon Linux 用 Amazon Machine Images (AMIs) には、デフォルトで AWS Systems Manager エージェント (SSM Agent) がプリインストールされています。詳細については、「SSM Agent がプリインストールされた Amazon Machine Images (AMIs)」を参照してください。

新しい Amazon Linux インスタンスに SSM Agent がプリインストールされていない場合や、エージェントを手動で再インストールする必要がある場合は、このページの情報を参考にしてください。

開始する前に

Amazon Linux インスタンスに SSM Agent をインストールする前に、次の点に注意してください。

  • すべての Linux ベースのオペレーティングシステムに SSM Agent をインストールする際に適用される重要な情報については、「Linux 用 EC2 インスタンスに手動で SSM Agent をインストールする」を参照してください。

  • プロキシを使用する Amazon Linux AMI から作成されたマネージドノードでは、Patch Manager オペレーションをサポートするために、現行バージョンの Python requests モジュールを実行する必要があります。詳細については、「プロキシサーバーを使用する Amazon Linux インスタンスの Python リクエストをアップグレードする」を参照してください。

  • SSM ドキュメント AWS-UpdateSSMAgent を使用してエージェントがインストールまたは更新された後、マネージドノードで yum コマンドを使用して SSM Agent を更新する場合、「警告: RPMDB が yum 外で変更されました」 というメッセージが表示されることがあります。このメッセージは正常であり、無視してもかまいません。

Amazon Linux の SSM Agent 用クイックインストールコマンド

次のステップに従って、シングルインスタンスに SSM Agent を手動でインストールします。この手順では、グローバルに利用可能なインストールファイルを使用します。

クイックコピーアンドペーストコマンドを使用して Amazon Linux に SSM Agent をインストールするには

  1. SSH など、任意の方法を使用して Amazon Linux インスタンスに接続します。

  2. インスタンスのアーキテクチャのコマンドをコピーして、インスタンスで実行します。

    注記

    次のコマンドの URL には ec2-downloads-windows ディレクトリが含まれていますが、これらは Amazon Linux 用の正しいグローバルインストールファイルです。

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
    x86
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
    ARM64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
  3. (推奨事項) インスタンスのアーキテクチャのコマンドを実行して、エージェントが実行中であることを確認します。

    x86_64 および x86
    sudo status amazon-ssm-agent
    ARM64
    sudo systemctl status amazon-ssm-agent

    ほとんどの場合、次の例に示されているように、コマンドは、エージェントが実行中であることを報告します。

    x86_64 および x86
    amazon-ssm-agent start/running, process 12345
    ARM64
    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: active (running) since Wed 2021-10-20 19:09:29 UTC; 4min 6s ago
                --truncated--

    まれに、次の例に示されているように、コマンドは、エージェントがインストールされているにも関わらず実行されていないことを報告します。

    x86_64 および x86
    amazon-ssm-agent stop/waiting
    ARM64
    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: inactive (dead) since Wed 2021-10-20 22:16:41 UTC; 18s ago
                --truncated--

    このような場合にエージェントをアクティブ化するには、インスタンスのアーキテクチャのコマンドを実行します。

    x86_64 および x86
    sudo start amazon-ssm-agent
    ARM64
    sudo systemctl start amazon-ssm-agent

ユーザーのリージョンで Amazon Linux 用のカスタムエージェントインストールコマンドを作成する

スクリプトまたはテンプレートを使用する複数のインスタンスで SSM Agent をインストールする場合は、作業中の AWS リージョン に保存されているインストールファイルを使用することをお勧めします。

次のコマンドでは、米国東部 (オハイオ) リージョン (us-east-2) でパブリックアクセス可能な Amazon S3 バケットを使用する例を示します。

ヒント

このトピックで前述した手順 Amazon Linux の SSM Agent 用クイックインストールコマンド のグローバル URLは、構築したカスタムリージョン URL に置き換えることもできます。

次のコマンドで、[Region] (リージョン) をユーザー自身の情報に置き換えます。サポートされている region 値の一覧については、アマゾン ウェブ サービスの全般リファレンスの「Systems Manager サービスエンドポイント」にある Region 列を参照してください。

x86_64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

次の例を参照してください。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
x86
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_386/amazon-ssm-agent.rpm

次の例を参照してください。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_386/amazon-ssm-agent.rpm
ARM64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm

次の例を参照してください。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm