Amazon Elastic Container Service (Amazon ECS) Exec nel Kit di strumenti AWS - AWS Toolkit for JetBrains
Prerequisiti di Amazon ECS Exec Utilizzo di Amazon ECS Exec

Amazon Elastic Container Service (Amazon ECS) Exec nel Kit di strumenti AWS

È possibile utilizzare la funzionalità Amazon ECS Exec per emettere comandi singoli o eseguire una shell (interprete di comandi) in un container Amazon Elastic Container Service (Amazon ECS) direttamente tramite il Kit di strumenti AWS.

Importante

L'abilitazione e la disabilitazione di Amazon ECS Exec modificano lo stato delle risorse nell'account AWS. Sono inclusi l'arresto e il riavvio del servizio. Alterare lo stato delle risorse mentre Amazon ECS Exec è abilitato può portare a risultati imprevedibili. Per ulteriori informazioni su Amazon ECS Exec, consulta la pagina Using Amazon ECS Exec for debugging della Guida per gli sviluppatori.

Prerequisiti di Amazon ECS Exec

Prima di poter utilizzare la funzionalità Amazon ECS Exec, è necessario soddisfare alcune condizioni preliminari.

Importante

Per abilitare Amazon ECS Exec per un particolare servizio, Amazon ECS Cloud Debugging deve essere disabilitato per tale servizio.

Requisiti di Amazon ECS

A seconda della posizione in cui sono ospitate le attività, Amazon EC2 o AWS Fargate, Amazon ECS Exec ha requisiti di versione differenti.

  • Se utilizzi Amazon EC2, devi utilizzare un'AMI ottimizzata per Amazon ECS rilasciata dopo il 20 gennaio 2021, con una versione dell'agente 1.50.2 o successiva. Ulteriori informazioni sono disponibili nella guida per gli sviluppatori sulle AMI ottimizzate per Amazon ECS.

  • Se utilizzi AWS Fargate è necessario utilizzare la piattaforma versione 1.4.0 o successiva. Ulteriori informazioni sui requisiti di Fargate sono disponibili nella guida per gli sviluppatori sulle versioni della piattaforma AWS Fargate.

Configurazione dell'account AWS e autorizzazioni IAM

Per utilizzare la funzionalità Amazon ECS Exec, è necessario disporre di un cluster Amazon ECS associato al proprio Account AWS. Amazon ECS Exec utilizza Systems Manager per stabilire una connessione con i container del cluster e richiede autorizzazioni dei ruoli IAM specifiche per le attività per comunicare con il servizio SSM.

Puoi trovare informazioni sui ruoli e sulle policy IAM specifiche per Amazon ECS Exec nella sezione IAM permissions required for ECS Exec della Guida per gli sviluppatori.

Utilizzo di Amazon ECS Exec

È possibile abilitare o disabilitare Amazon ECS Exec direttamente dall'Esploratore AWS nel AWS Toolkit for JetBrains. Una volta abilitato Amazon ECS Exec, è possibile scegliere i container dal menu Amazon ECS ed eseguirvi comandi.

Abilitazione di Amazon ECS Exec

  1. Dall'Esploratore AWS, individua ed espandi il menu Amazon ECS.

  2. Espandi la sezione Cluster e scegli il cluster che desideri modificare.

  3. Apri il menu contestuale (facendo clic con il pulsante destro del mouse) del servizio e seleziona Abilita esecuzione dei comandi.

    Nota

    Se Amazon ECS Cloud Debugging è abilitato per questo servizio, l'opzione Abilita esecuzione dei comandi non sarà disponibile. La disabilitazione di Cloud Debugging ripristinerà l'opzione, ma interromperà e riavvierà il servizio.

Importante

Questa operazione avvia una nuova implementazione del servizio e potrebbe richiedere alcuni minuti. Per ulteriori informazioni, consulta la nota all'inizio di questa sezione.

Disabilitazione di Amazon ECS Exec

  1. Dall'Esploratore AWS, individua ed espandi il menu Amazon ECS.

  2. Espandi la sezione Cluster e scegli il cluster che desideri modificare.

  3. Apri il menu contestuale (facendo clic con il pulsante destro del mouse) del servizio che desideri modificare e seleziona Disabilita esecuzione del comando.

Importante

Questa operazione avvia una nuova implementazione del servizio e potrebbe richiedere alcuni minuti. Per ulteriori informazioni, consultare la nota all'inizio di questa sezione.

Esecuzione di comandi su un container

Per eseguire comandi su un container utilizzando AWS Explorer, Amazon ECS Exec deve essere abilitato. Se non è abilitato, consulta la procedura Abilitazione di Amazon ECS Exec descritta in questa sezione.

  1. Dall'Esploratore AWS, individua ed espandi il menu Amazon ECS.

  2. Espandi la sezione Cluster e scegli il cluster che desideri modificare.

  3. Espandi un servizio per elencarne i container.

  4. Apri il menu contestuale (facendo clic con il pulsante destro del mouse) del container che desideri modificare e scegli Esegui comando nel container.

  5. Nella finestra di dialogo Esegui comando nel container, scegli l'ARN dell'attività che ti interessa.

  6. È possibile digitare il comando che si desidera eseguire o selezionarlo da un elenco di comandi eseguiti durante la stessa sessione.

  7. Scegli Execute (Esegui).

Esecuzione di comandi dall'interno di una shell (interprete di comandi)

Per eseguire comandi su un container all'interno di una shell utilizzando l'Esploratore AWS, Amazon ECS Exec deve essere abilitato. Se non è abilitato, consulta la procedura Abilitazione di Amazon ECS Exec descritta in questa sezione.

  1. Dall'Esploratore AWS, individua ed espandi il menu Amazon ECS.

  2. Espandi la sezione Cluster e scegli il cluster che desideri modificare.

  3. Espandi il servizio per elencare i container associati.

  4. Apri il menu contestuale (facendo clic con il pulsante destro del mouse) del container che desideri modificare e scegli Apri shell interattiva.

  5. Nella finestra di dialogo Shell interattiva, scegli l'ARN dell'attività che ti interessa.

  6. Scegli una shell dal menu a discesa corrispondente o inserisci il nome della shell con la quale vuoi interagire.

  7. Quando le impostazioni ti soddisfano, scegli Esegui.

  8. Quando la shell si apre in un terminale, puoi digitare dei comandi per interagire con il container.