Exécution de commandes avec ECS Exec

Vous pouvez utiliser Amazon ECS Exec pour collecter des informations de diagnostic relatives à vos conteneurs et résoudre les erreurs rencontrées tout au long du cycle de vie de vos conteneurs.

Prérequis

Avant de commencer à utiliser ECS Exec, assurez-vous d'avoir effectué les actions suivantes :

• Passez en revue les considérations. Pour de plus amples informations, consultez Considérations .

• Configurez ECS Exec pour vos tâches et services. Pour de plus amples informations, consultez Configuration d'ECS Exec.

• Installez et configurez le AWS CLI. Pour plus d'informations, voir Commencer avec le AWS CLI.

• Installez le plugin Session Manager pour AWS CLI. Pour de plus amples informations, veuillez consulter Install the Session Manager plugin for the AWS CLI.

• Configurez un rôle de tâche avec les autorisations appropriées. Vous devez utiliser un rôle de tâche doté des autorisations appropriées pour ECS Exec. Pour plus d'informations, veuillez consulter Rôle IAM de tâche (langue française non garantie).

• Vérifiez les exigences de version. ECS Exec a des exigences de version selon que vos tâches sont hébergées sur Amazon EC2 ou AWS 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 d'agent 1.50.2 ou supérieure. Pour plus d'informations, consultez Amazon ECS optimisé AMIs.

  • Si vous utilisez AWS Fargate, vous devez utiliser une version de plate-forme 1.4.0 ou supérieure (Linux) ou 1.0.0 (Windows). Pour plus d'informations, consultez Versions de plateforme AWS Fargate.

Utilisation de la console pour les tâches de service

Vous pouvez utiliser la console pour exécuter des commandes à l'aide d'ECS Exec.

1. Ouvrez la console à la https://console.aws.amazon.com/ecs/version 2.

2. Sur la page Clusters, choisissez le cluster.

3. Sur la page des détails du cluster, dans la section Services, choisissez le service.

   La page des détails du service s'affiche.

4. Sur la page des détails du service, sélectionnez Tâches. Choisissez ensuite la tâche.

5. Sous Conteneurs, choisissez le conteneur dans lequel vous souhaitez utiliser ECS Exec.

6. Pour exécuter des commandes :, effectuez l'une des opérations suivantes :

   • Choisissez Se connecter.

     Une CloudShell session s'affiche dans laquelle vous pouvez exécuter vos commandes.

   • Cliquez sur la flèche, puis sur la AWS CLI commande Copier.

     Vous pouvez ensuite exécuter les commandes localement.

Résultats attendus

Si la connexion est établie, vous devriez voir une invite shell interactive provenant de votre conteneur. Vous pouvez désormais exécuter des commandes directement dans l'environnement du conteneur. Pour quitter la session, choisissez Fin de session.

Utilisation de la console pour des tâches autonomes

Vous pouvez utiliser la console pour exécuter des commandes à l'aide d'ECS Exec.

1. Ouvrez la console à la https://console.aws.amazon.com/ecs/version 2.

2. Sur la page Clusters, choisissez le cluster.

3. Sur la page des détails du cluster, dans la section Tâches, choisissez la tâche.

   La page des détails de la tâche s'affiche.

4. Sous Conteneurs, choisissez le conteneur dans lequel vous souhaitez utiliser ECS Exec.

5. Pour exécuter des commandes :, effectuez l'une des opérations suivantes :

   • Choisissez Se connecter.

     Une CloudShell session s'affiche dans laquelle vous pouvez exécuter vos commandes.

   • Cliquez sur la flèche, puis sur la AWS CLI commande Copier.

     Vous pouvez ensuite exécuter les commandes localement.

Résultats attendus

Si la connexion est établie, vous devriez voir une invite shell interactive provenant de votre conteneur. Vous pouvez désormais exécuter des commandes directement dans l'environnement du conteneur. Pour quitter la session, choisissez Fin de session.

Utilisation de l'interface de commande

Vous pouvez utiliser l'interface de commande pour exécuter des commandes à l'aide d'ECS Exec.

Une fois que vous avez confirmé que ExecuteCommandAgent est en cours d'exécution, vous pouvez ouvrir un shell interactif sur votre conteneur à l'aide de la commande suivante. Si votre tâche contient plusieurs conteneurs, vous devez spécifier le nom du conteneur à l'aide de l'indicateur --container. Amazon ECS ne prend en charge que le lancement de sessions interactives. Vous devez donc utiliser l'indicateur --interactive.

La commande suivante exécutera une /bin/sh commande interactive sur un conteneur nommé container-name d'après une tâche avec un ID detask-id.

task-idIl s'agit du nom de ressource Amazon (ARN) de la tâche.

aws ecs execute-command --cluster cluster-name \
    --task task-id \
    --container container-name \
    --interactive \
    --command "/bin/sh"

Résultats attendus

Si la commande aboutit, vous devriez voir une invite shell interactive provenant de votre conteneur. Vous pouvez désormais exécuter des commandes directement dans l'environnement du conteneur. Pour quitter la session, tapez exit ou appuyez surCtrl+D.