Amazon Elastic Container Service Exec dans AWS Toolkit pour AWS Cloud9

Vous pouvez émettre des commandes uniques dans un conteneur Amazon Elastic Container Service (Amazon ECS) à partir de l'AWS Tookit pour AWS Cloud9. Vous pouvez le faire à l'aide de la fonction Amazon ECS Exec.

Important

L'activation et la désactivation d'Amazon ECS Exec modifient l'état de vos ressources ECS dans votre Compte AWS. Les modifications incluent l'arrêt et le redémarrage du service. En outre, la modification de l'état des ressources alors qu'Amazon ECS Exec est activé peut entraîner des résultats imprévisibles. Pour plus d'informations sur Amazon ECS, consultez Utilisation d’ECS Exec pour le débogage dans le Manuel du développeur Amazon ECS.

Prérequis Amazon ECS Exec

Avant de pouvoir utiliser la fonctionnalité Amazon ECS Exec, vous devez remplir certaines conditions préalables.

Exigences Amazon ECS

ECS Exec a des exigences de version selon que vos tâches sont hébergées sur Amazon EC2 ou AWS Fargate (Fargate) :

• Si vous utilisez Amazon EC2, vous devez utiliser une AMI optimisée pour Amazon ECS publiée après le 20 janvier 2021 avec une version 1.50.2 ou supérieure de l'agent. Pour de plus amples informations, veuillez consulter AMI Linux optimisée pour Amazon ECS dans le Manuel du développeur Amazon Elastic Container Service.

• Si vous utilisez AWS Fargate, vous devez utiliser la version 1.4.0 ou une version ultérieure de la plateforme. Pour plus d'informations, veuillez consulter la rubrique Versions de plateforme AWS Fargate dans le Guide du développeur Amazon Elastic Container Service.

Configuration du compte AWS et autorisations IAM

Pour utiliser la fonction Amazon ECS Exec, vous devez disposer d'un cluster Amazon ECS existant associé à votre Compte AWS. Amazon ECS Exec utilise Systems Manager pour établir une connexion avec les conteneurs de votre cluster. Amazon ECS nécessite des autorisations de rôle IAM spécifiques pour communiquer avec le service SSM.

Pour plus d'informations sur le rôle et la politique IAM spécifiques à Amazon ECS Exec, consultez les autorisations IAM requises pour ECS Exec dans le manuel Amazon ECS Developer Guide.

Utiliser Amazon ECS Exec

Vous pouvez activer ou désactiver Amazon ECS Exec directement depuis l'explorateur AWS dans l'AWS Toolkit pour AWS Cloud9. Lorsque vous avez activé Amazon ECS Exec, choisissez des conteneurs dans le menu Amazon ECS et exécutez des commandes sur ces derniers.

Activation d'Amazon ECS Exec

1. Dans l'explorateur AWS, recherchez et développez le menu Amazon ECS.

2. Développez le cluster à partir du service à modifier.

3. Ouvrez le menu contextuel (clic droit) à partir d'un service et choisissez Enable Command Exec.

Important

Cette étape démarre un nouveau déploiement de votre service et peut prendre quelques minutes. Pour de plus amples informations, veuillez consulter la note au début de cette section.

Désactivation Amazon ECS Exec

1. Dans l'explorateur AWS, recherchez et développez le menu Amazon ECS.

2. Développez le cluster qui contient le service que vous souhaitez.

3. Ouvrez le menu contextuel (clic droit) à partir d'un service et choisissez Désactiver l'exécution de commande.

Important

Cette étape démarre un nouveau déploiement de votre service et peut prendre quelques minutes. Pour de plus amples informations, veuillez consulter la note au début de cette section.

Exécution de commandes sur un conteneur

Pour exécuter des commandes sur un conteneur à l'aide de l'explorateur AWS, Amazon ECS Exec doit être activé. S'il n'est pas activé, consultez la procédure Activation d'Amazon ECS Exec décrite dans cette section.

1. Dans l'explorateur AWS, recherchez et développez le menu Amazon ECS.

2. Développez le cluster à partir d'un service de votre choix.

3. Développez le service pour répertorier les conteneurs associés.

4. Ouvrez le menu contextuel du conteneur (cliquez avec le bouton droit de la souris) et choisissez Exécuter la commande dans le conteneur.

5. Une invite s'ouvre avec la liste des tâches en cours d'exécution. Choisissez l'ARN de la tâche que vous souhaitez.

   Note

   Si une seule tâche est en cours d'exécution, aucune invite ne s'ouvre. Au lieu de cela, la tâche est sélectionnée automatiquement.

6. Lorsque vous y êtes invité, entrez la commande que vous souhaitez exécuter et appuyez sur Entrée pour continuer.