AWS Systems Manager
ユーザーガイド

プロキシを使用するように SSM エージェント を設定する

HTTP プロキシを通じて通信するように SSM エージェント を設定できます。そのためには、http_proxyhttps_proxy、および no_proxy の各設定を amazon-ssm-agent.override 設定ファイルに追加します。より新しいバージョンまたはより古いバージョンの SSM エージェント をインストールすると、オーバーライドファイルにもプロキシ設定が保持されます。このセクションには、upstart 環境および systemd 環境の手順が含まれています。

注記

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

プロキシを使用するように SSM エージェント を設定する (Upstart)

  1. SSM エージェント をインストールした先のインスタンスに接続します。

  2. VIM などのシンプルなエディタを開き、以下の設定を指定します。

    env http_proxy=http://hostname:port env https_proxy=http(s)://hostname:port env no_proxy=169.254.169.254

    注記

    no_proxy 設定をファイルに追加し、ここに示す IP アドレスを指定する必要があります。これは、Systems Manager のインスタンスメタデータのエンドポイントです。この IP アドレスがない場合、Systems Manager への呼び出しは失敗します。

  3. ファイルを amazon-ssm-agent.override という名前で /etc/init/ に保存します。

  4. 次のコマンドを使用して SSM エージェント を停止し、再起動します。

    sudo stop amazon-ssm-agent sudo start amazon-ssm-agent

注記

Upstart 環境で .override ファイルを使用する詳しい方法については、「init: Upstart init daemon job configuration」を参照してください。

プロキシを使用するように SSM エージェント を設定する (systemd)

次の手順のステップでは、systemd 環境でプロキシを使用するように SSM エージェント を設定する方法について説明します。この手順のステップの一部には、Snap を使用してインストールされた Ubuntu Server インスタンス用の明示的な手順が含まれています。

  1. SSM エージェント をインストールした先のインスタンスに接続します。

  2. 次のコマンドを実行します。

    systemctl edit amazon-ssm-agent

    snap を使用してインストールされた Ubuntu Server インスタンスの場合は、次のコマンドを実行します。

    systemctl edit snap.amazon-ssm-agent.amazon-ssm-agent
  3. 以下の設定を指定します。

    [Service] Environment="http_proxy=http://hostname:port" Environment="https_proxy=http(s)://hostname:port" Environment="no_proxy=169.254.169.254"

    注記

    no_proxy 設定をファイルに追加し、ここに示す IP アドレスを指定する必要があります。これは、Systems Manager のインスタンスメタデータのエンドポイントです。この IP アドレスがない場合、Systems Manager への呼び出しは失敗します。

  4. 変更を保存します。システムは etc/systemd/system/amazon-ssm-agent.service.d フォルダに、amazon-ssm-agent.override (または Amazon Linux 2 の override.conf) インスタンスという名前のファイルを作成します。

  5. 以下のコマンドを使用して SSM エージェント を再起動します。

    sudo systemctl stop amazon-ssm-agent sudo systemctl daemon-reload

    snap を使用してインストールされた Ubuntu Server インスタンスの場合は、次のコマンドを使用して SSM エージェント を再起動します。

    systemctl start snap.amazon-ssm-agent.amazon-ssm-agent

注記

システム環境で .override ファイルを使用する詳しい方法については、「既存のユニットファイルの変更」を参照してください。