Exécution de commandes avec ECS Exec - Amazon Elastic Container Service
Conditions préalablesUtilisation de la console pour les tâches de serviceUtilisation de la console pour des tâches autonomesUtilisation du shell de commande

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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.

Conditions préalables

Avant de commencer à utiliser ECS Exec, assurez-vous que vous avez effectué les actions suivantes :

  • Prenez connaissance des 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 l’ AWS CLI. Pour plus d’informations, consultez la section Démarrage avec l’ 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, choisissez Tâches. Puis choisissez la tâche.

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

  6. Pour exécuter des commandes, procédez de l’une des manières suivantes :

    • Choisissez Se connecter.

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

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

      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 mettre fin à la session, choisissez Arrêter la 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, procédez de l’une des manières suivantes :

    • Choisissez Se connecter.

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

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

      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 mettre fin à la session, choisissez Arrêter la session.

Utilisation du shell de commande

Vous pouvez utiliser le shell 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 sur Ctrl+D.