Configurazione SSM Agent per l'utilizzo di un proxy sui nodi Linux

È possibile configurare AWS Systems Manager Agent (SSM Agent) per comunicare tramite un proxy HTTP creando un file di configurazione sostitutivo e aggiungendo http_proxy no_proxy impostazioni al file. https_proxy Un file di sostituzione mantiene le impostazioni proxy anche se si installano versioni più o meno recenti di SSM Agent. Questa sezione include le procedure per creare un file di sostituzione sia negli ambienti upstart che systemd. Se intendi utilizzarloSession Manager, tieni presente che i server proxy HTTPS non sono supportati.

Configurare SSM Agent per l'utilizzo di un proxy (Upstart)

Usare la procedura seguente per creare un file di configurazione sostitutiva per un ambiente upstart.

Per configurare SSM Agent per l'utilizzo di un proxy (Upstart)

1. Connettersi all'istanza gestita in cui è installato SSM Agent.

2. Aprire un editor semplice come VIM e, a seconda che si stia utilizzando un server proxy HTTP o un server proxy HTTPS, aggiungere una delle seguenti configurazioni.

   Per un server proxy HTTP:

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

   Per un server proxy HTTPS:

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

   Importante

   Aggiungi l'no_proxyimpostazione al file e specifica l'indirizzo IP. L'indirizzo IP per no_proxy è l'endpoint IMDS (Instance Metadata Services) per Systems Manager. Se non viene specificatono_proxy, le chiamate a Systems Manager acquisiscono l'identità dal servizio proxy (se il fallback IMDSv1 è abilitato) o le chiamate a Systems Manager hanno esito negativo (se IMDSv2 è applicato).

   • Per IPv4, no_proxy=169.254.169.254 specificare.

   • Per IPv6, specificare. no_proxy=[fd00:ec2::254] L'indirizzo IPv6 del servizio metadati dell'istanza è compatibile con i comandi IMDSv2. L'indirizzo IPv6 è accessibile solo sulle istanze create sul sistema Nitro.AWS Per ulteriori informazioni, consulta Come funziona Instance Metadata Service versione 2 nella Guida per l'utente di Amazon EC2.

3. Salvare il file con il nome amazon-ssm-agent.override nella posizione seguente: /etc/init/

4. Arrestare e riavviare SSM Agent utilizzando i seguenti comandi.

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

Nota

Per ulteriori informazioni sul funzionamento dei file .override in ambienti Upstart, consultare init: configurazione del processo daemon init di Upstart.

Configurazione di SSM Agent per l'utilizzo di un proxy (systemd)

Utilizzare la procedura seguente per configurare SSM Agent per l'utilizzo di un proxy in un ambiente systemd.

Nota

Alcuni dei passaggi nella procedura contengono istruzioni esplicite per le istanze Ubuntu Server in cui SSM Agent è stato installato tramite Snap.

1. Connettersi all'istanza in cui è installato SSM Agent.

2. A seconda del tipo di sistema operativo, eseguire uno dei seguenti comandi.

   • Sulle istanze di Ubuntu Server dove SSM Agent viene installato utilizzando uno snap:

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

     Su altri sistemi operativi:

     sudo systemctl edit amazon-ssm-agent

3. Aprire un editor semplice come VIM e, a seconda che si stia utilizzando un server proxy HTTP o un server proxy HTTPS, aggiungere una delle seguenti configurazioni.

   Assicurati di inserire le informazioni sopra il commento che dice "### Lines below this comment will be discarded«, come indicato nell'immagine seguente.

   

   Per un server 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)"
   

   Per un server 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)"
   

   Importante

   Aggiungi l'no_proxyimpostazione al file e specifica l'indirizzo IP. L'indirizzo IP per no_proxy è l'endpoint IMDS (Instance Metadata Services) per Systems Manager. Se non viene specificatono_proxy, le chiamate a Systems Manager acquisiscono l'identità dal servizio proxy (se il fallback IMDSv1 è abilitato) o le chiamate a Systems Manager hanno esito negativo (se IMDSv2 è applicato).

   • Per IPv4, no_proxy=169.254.169.254 specificare.

   • Per IPv6, specificare. no_proxy=[fd00:ec2::254] L'indirizzo IPv6 del servizio metadati dell'istanza è compatibile con i comandi IMDSv2. L'indirizzo IPv6 è accessibile solo sulle istanze create sul sistema Nitro.AWS Per ulteriori informazioni, consulta Come funziona Instance Metadata Service versione 2 nella Guida per l'utente di Amazon EC2.

4. Salvare le modifiche. Il sistema crea automaticamente uno dei file riportati di seguito, a seconda del tipo di sistema operativo.

   • Sulle istanze di Ubuntu Server dove SSM Agent viene installato utilizzando uno snap:

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

   • Nelle istanze Amazon Linux 2 e Amazon Linux 2023:

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

   • Su altri sistemi operativi:

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

5. Riavvia SSM Agent utilizza uno dei seguenti comandi, a seconda del tipo di sistema operativo.

   • Sulle istanze di Ubuntu Server installate utilizzando uno snap:

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

   • Su altri sistemi operativi:

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

Nota

Per ulteriori informazioni sull'utilizzo dei file .override in ambienti systemd, consultare Modifica dei file di unità esistenti nella Guida per gli amministratori di sistema di Red Hat Enterprise Linux 7.