Configuration SSM Agent pour utiliser un proxy sur des nœuds Linux

Vous pouvez configurer AWS Systems Manager l'agent (SSM Agent) pour communiquer via un proxy HTTP en créant un fichier de configuration de remplacement et http_proxy en https_proxy ajoutant des no_proxy paramètres au fichier. Un fichier de remplacement préserve également les paramètres du proxy si vous installez des versions plus récentes ou plus anciennes de SSM Agent. Cette section inclut les procédures de création d'un fichier de remplacement dans les environnements upstart et systemd. Si vous avez l'intention d'utiliser Session Manager, notez que les serveurs proxy HTTPS ne sont pas pris en charge.

Configuration SSM Agent pour utiliser un proxy (upstart)

Procédez comme suit pour créer un fichier de configuration de remplacement pour un environnement upstart.

Pour configurer SSM Agent pour utiliser un proxy (upstart)

1. Connectez-vous à l'instance gérée sur laquelle vous avez installé SSM Agent.

2. Ouvrez un éditeur simple comme VIM, et selon que vous utilisez un serveur proxy HTTP ou un serveur proxy HTTPS, ajoutez l'une des configurations suivantes.

   Pour un serveur proxy HTTP :

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

   Pour un serveur proxy HTTPS :

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

   Important

   Ajoutez le paramètre no_proxy au fichier et spécifiez l’adresse IP. L’adresse IP pour no_proxy est le point de terminaison des services de métadonnées d’instance (IMDS) pour Systems Manager. Si vous ne le spécifiez pasno_proxy, les appels à Systems Manager prennent l'identité du service proxy (si la solution de IMDSv1 secours est activée) ou les appels à Systems Manager échouent ( IMDSv2 s'ils sont appliqués).

   • Pour IPv4, spécifiezno_proxy=169.254.169.254.

   • Pour IPv6, spécifiezno_proxy=[fd00:ec2::254]. L' IPv6 adresse du service de métadonnées d'instance est compatible avec IMDSv2 les commandes. L' IPv6 adresse n'est accessible que sur les instances créées sur le système AWS Nitro. Pour plus d'informations, consultez Comment fonctionne le service de métadonnées d'instance version 2 dans le guide de EC2 l'utilisateur Amazon.

3. Enregistrez le fichier sous le nom amazon-ssm-agent.override à l'emplacement suivant : /etc/init/

4. Arrêter et redémarrer SSM Agent à l'aide des commandes suivantes.

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

Note

Pour de plus amples informations sur l'utilisation de fichiers .override dans les environnements Upstart, veuillez consulter init: Upstart init daemon job configuration (init : configuration de tâche Upstart init daemon).

Configuration SSM Agent pour utiliser un proxy (systemd)

Utilisez la procédure suivante pour configurer SSM Agent pour utiliser un proxy dans un systemd environnement.

Note

Certaines étapes de cette procédure contiennent des instructions explicites pour Ubuntu Server cas où SSM Agent a été installé à l'aide de Snap.

1. Connectez-vous à l'instance sur laquelle vous avez installé SSM Agent.

2. Exécutez l'une des commandes suivantes, selon le type de système d'exploitation.

   • Activé Ubuntu Server cas où SSM Agent est installé en un clin d'œil :

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

     Sur d'autres systèmes d'exploitation

     sudo systemctl edit amazon-ssm-agent

3. Ouvrez un éditeur simple comme VIM, et selon que vous utilisez un serveur proxy HTTP ou un serveur proxy HTTPS, ajoutez l'une des configurations suivantes.

   Veillez à saisir les informations au-dessus du commentaire « ### Lines below this comment will be discarded », comme indiqué dans l’image suivante.

   

   Pour un serveur proxy HTTP :

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

   Pour un serveur proxy HTTPS :

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

   Important

   Ajoutez le paramètre no_proxy au fichier et spécifiez l’adresse IP. L’adresse IP pour no_proxy est le point de terminaison des services de métadonnées d’instance (IMDS) pour Systems Manager. Si vous ne le spécifiez pasno_proxy, les appels à Systems Manager prennent l'identité du service proxy (si la solution de IMDSv1 secours est activée) ou les appels à Systems Manager échouent ( IMDSv2 s'ils sont appliqués).

   • Pour IPv4, spécifiezno_proxy=169.254.169.254.

   • Pour IPv6, spécifiezno_proxy=[fd00:ec2::254]. L' IPv6 adresse du service de métadonnées d'instance est compatible avec IMDSv2 les commandes. L' IPv6 adresse n'est accessible que sur les instances créées sur le système AWS Nitro. Pour plus d'informations, consultez Comment fonctionne le service de métadonnées d'instance version 2 dans le guide de EC2 l'utilisateur Amazon.

4. Enregistrez vos modifications. Le système crée automatiquement l'un des fichiers suivants, en fonction du type de système d'exploitation.

   • Activé Ubuntu Server cas où SSM Agent est installé en un clin d'œil :

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

   • Sur les instances Amazon Linux 2 et Amazon Linux 2023 :

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

   • Sur d'autres systèmes d'exploitation

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

5. Redémarrer SSM Agent en utilisant l'une des commandes suivantes, selon le type de système d'exploitation.

   • Activé Ubuntu Server instances installées à l'aide d'un snap :

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

   • Sur d'autres systèmes d'exploitation

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

Note

Pour de plus amples informations sur l'utilisation des fichiers .override dans les environnements systemd, veuillez consulter Modification des fichiers d'unité existants dans le Guide de l'administrateur système Red Hat Enterprise Linux 7.