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

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

重要

Amazon Linux 1 は、2020 年 12 月 31 日に標準サポートが終了し、2023 年 12 月 31 日に廃止されました。これは、「AWS ニュースブログ」の「Amazon Linux AMI 廃止に関するアップデート」でお知らせしています。AWS では、このオペレーティングシステム向けの Amazon Machine Images (AMIs) の提供を終了しました。ただし、AWS Systems Manager では、既存の Amazon Linux 1 インスタンスは引き続きサポートします。

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

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

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

開始する前に

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

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

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

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

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

クイックコピーアンドペーストコマンドを使用して Amazon Linux 1 に SSM Agent をインストールするには
  1. SSH など、任意の方法を使用して Amazon Linux 1 インスタンスに接続します。

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

    注記

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

    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 1 用のカスタムエージェントインストールコマンドを作成する

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

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

ヒント

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

次のコマンドで、[Region] (リージョン) をユーザー自身の情報に置き換えます。サポートされている region 値の一覧については、「Amazon Web Services 全般のリファレンス」の「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