Linux ノードでプロキシを使用するための SSM Agent の設定

SSM Agent がプロキシ (Upstart) を使用するように設定する

1. SSM Agent をインストールした先のマネージドインスタンスに接続します。

2. VIM などの単純なエディタを開き、HTTP プロキシサーバーと HTTPS プロキシサーバーのどちらを使用しているかに応じて、以下のいずれかの設定オプションを追加します。

   HTTP プロキシサーバーの場合:

   env http_proxy=http://hostname:port
   env https_proxy=http://hostname:port
   env no_proxy=IP address for instance metadata services (IMDS)

   HTTPS プロキシサーバーの場合:

   env http_proxy=http://hostname:port
   env https_proxy=https://hostname:port
   env no_proxy=IP address for instance metadata services (IMDS)

   重要

   no_proxy 設定をファイルに追加し、その IP アドレスを指定します。no_proxy の IP アドレスは、Systems Manager のインスタンスメタデータサービス (IMDS) エンドポイントです。no_proxy を指定しない場合、Systems Manager への呼び出しによってプロキシサービスからアイデンティティを引き受けるか (IMDSv1 フォールバックが有効の場合)、Systems Manager への呼び出しが失敗します (IMDSv2 が強制されている場合)。

   • IPv4 の場合は、no_proxy=169.254.169.254 を指定します。

   • IPv6 の場合は、no_proxy=[fd00:ec2::254] を指定します。インスタンスメタデータサービスの IPv6 アドレスは、IMDSv2 コマンドと互換性があります。IPv6 アドレスは、AWS Nitro System 上に構築されたインスタンスでのみアクセス可能です。詳細については、「Amazon EC2 ユーザーガイド」の「インスタンスメタデータサービスバージョン 2 の仕組み」を参照してください。

3. amazon-ssm-agent.override という名前のファイルを次の場所に保存します: /etc/init/

4. 次のコマンドを使用して SSM Agent を停止し、再起動します。

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

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

2. オペレーティングシステムの種類に応じて、次のいずれかのコマンドを実行します。

   • スナップを使用して SSM Agent がインストールされる Ubuntu Server インスタンスでは、次の操作を行います。

     sudo systemctl edit snap.amazon-ssm-agent.amazon-ssm-agent

     他のオペレーティングシステムで以下の手順を実行します。

     sudo systemctl edit amazon-ssm-agent

3. VIM などの単純なエディタを開き、HTTP プロキシサーバーと HTTPS プロキシサーバーのどちらを使用しているかに応じて、以下のいずれかの設定オプションを追加します。

   

   HTTP プロキシサーバーの場合:

   [Service]
   Environment="http_proxy=http://hostname:port"
   Environment="https_proxy=http://hostname:port"
   Environment="no_proxy=IP address for instance metadata services (IMDS)"
   

   HTTPS プロキシサーバーの場合:

   [Service]
   Environment="http_proxy=http://hostname:port"
   Environment="https_proxy=https://hostname:port"
   Environment="no_proxy=IP address for instance metadata services (IMDS)"
   

   重要

   no_proxy 設定をファイルに追加し、その IP アドレスを指定します。no_proxy の IP アドレスは、Systems Manager のインスタンスメタデータサービス (IMDS) エンドポイントです。no_proxy を指定しない場合、Systems Manager への呼び出しによってプロキシサービスからアイデンティティを引き受けるか (IMDSv1 フォールバックが有効の場合)、Systems Manager への呼び出しが失敗します (IMDSv2 が強制されている場合)。

   • IPv4 の場合は、no_proxy=169.254.169.254 を指定します。

   • IPv6 の場合は、no_proxy=[fd00:ec2::254] を指定します。インスタンスメタデータサービスの IPv6 アドレスは、IMDSv2 コマンドと互換性があります。IPv6 アドレスは、AWS Nitro System 上に構築されたインスタンスでのみアクセス可能です。詳細については、「Amazon EC2 ユーザーガイド」の「インスタンスメタデータサービスバージョン 2 の仕組み」を参照してください。

4. 変更内容を保存します。オペレーティングシステムの種類に応じて、次のいずれかのファイルが自動的に作成されます。

   • スナップを使用して SSM Agent がインストールされる Ubuntu Server インスタンスでは、次の操作を行います。

     /etc/systemd/system/snap.amazon-ssm-agent.amazon-ssm-agent.service.d/override.conf

   • Amazon Linux 2、Amazon Linux 2023、および RHEL インスタンスの場合:

     /etc/systemd/system/amazon-ssm-agent.service.d/override.conf

   • 他のオペレーティングシステムで以下の手順を実行します。

     /etc/systemd/system/amazon-ssm-agent.service.d/amazon-ssm-agent.override

5. オペレーティングシステムの種類に応じて、次のいずれかの SSM Agent コマンドを使用して再起動します。

   • スナップを使用してインストールされた Ubuntu Server インスタンスで、次の操作を行います。

     sudo systemctl daemon-reload && sudo systemctl restart snap.amazon-ssm-agent.amazon-ssm-agent

   • 他のオペレーティングシステムで以下の手順を実行します。

     sudo systemctl daemon-reload && sudo systemctl restart amazon-ssm-agent