Amazon Elastic Container Service (Amazon ECS) Exec en AWS Toolkit
Puede usar la característica Amazon ECS Exec para emitir comandos de tareas individuales o ejecutar un intérprete de comandos en un contenedor de Amazon Elastic Container Service (Amazon ECS) directamente desde el AWS Toolkit.
importante
La activación y desactivación de Amazon ECS Exec cambia el estado de sus recursos en su cuenta de AWS. Esto incluye la detención y el reinicio del servicio. La modificación del estado de los recursos mientras Amazon ECS Exec está activado puede generar resultados impredecibles. Para obtener más información sobre Amazon ECS Exec, consulte Utilización de ECS Exec para la depuración en la Guía para desarrolladores.
Requisitos previos de Amazon ECS Exec
Antes de poder utilizar la característica Amazon ECS Exec, deben cumplirse ciertas condiciones previas.
importante
Para habilitar Amazon ECS Exec para un servicio concreto, se debe deshabilitar la depuración en la nube de Amazon ECS para dicho servicio.
Requisitos de Amazon ECS
En función de si las tareas están alojadas en Amazon EC2 o en AWS Fargate, Amazon ECS Exec tiene requisitos de versión distintos.
-
Si utiliza Amazon EC2, debe usar una AMI optimizada para Amazon ECS que se publicó después del 20 de enero de 2021, con un agente versión 1.50.2 o superior. Encontrará información adicional en AMI optimizadas para Amazon ECS en la Guía para desarrolladores.
-
Si utiliza AWS Fargate, debe utilizar la versión 1.4.0 de la plataforma o una superior. Encontrará información adicional sobre los requisitos de Fargate en Versiones de la plataforma de AWS Fargate en la Guía para desarrolladores.
Configuración de la cuenta de AWS y permisos de IAM
Para utilizar la característica Amazon ECS Exec, debe tener un clúster de Amazon ECS asociado a su Cuenta de AWS. Amazon ECS Exec usa Systems Manager para establecer una conexión con los contenedores del clúster y requiere permisos de rol de IAM de tareas específicos para comunicarse con el servicio de SSM.
Puede encontrar información sobre el rol y la política de IAM, específica de Amazon ECS Exec, en la guía para desarrolladores Permisos de IAM requeridos para ECS Exec.
Trabajar con Amazon ECS Exec
Puede habilitar o deshabilitar Amazon ECS Exec directamente desde el Explorador de AWS en el AWS Toolkit for JetBrains. Cuando Amazon ECS Exec está habilitado, puede elegir contenedores en el menú de Amazon ECS y ejecutar comandos en ellos.
Activación de Amazon ECS Exec
-
Desde el Explorador de AWS, expanda el menú de Amazon ECS.
-
Amplíe la sección Clústeres y elija el clúster que desee modificar.
-
Abra el menú contextual (haga clic con el botón derecho) del servicio que quiera modificar y elija Activar ejecución de comandos.
nota
Si la depuración en la nube de Amazon ECS está habilitada para este servicio, la opción Habilitar la ejecución de comandos no estará disponible. Al deshabilitar la depuración en la nube, se restaurará la opción, pero el servicio se detendrá y se reiniciará.
importante
Esto iniciará una nueva implementación de su servicio y puede tardar unos minutos. Para obtener más información, consulte la nota al principio de esta sección.
Desactivación de Amazon ECS Exec
-
Desde el Explorador de AWS, expanda el menú de Amazon ECS.
-
Amplíe la sección Clústeres y elija el clúster que desee modificar.
-
Abra el menú contextual (haga clic con el botón derecho) del servicio que quiera modificar y elija Desactivar ejecución de comandos.
importante
Esto iniciará una nueva implementación de su servicio y puede tardar unos minutos. Para obtener más información, consulte la nota al principio de esta sección.
Ejecución de comandos en un contenedor
Para ejecutar comandos en un contenedor mediante el Explorador de AWS, debe estar habilitado Amazon ECS Exec. Si no está habilitado, consulte el procedimiento para Habilitar Amazon ECS Exec de esta sección.
-
Desde el Explorador de AWS, expanda el menú de Amazon ECS.
-
Amplíe la sección Clústeres y elija el clúster que desee modificar.
-
Expandir un servicio para enumerar sus contenedores.
-
Abra el menú contextual (haga clic con el botón derecho) del contenedor que quiera modificar y seleccione Ejecutar comando en el contenedor.
-
En el cuadro de diálogo Ejecutar comando en el contenedor, elija el ARN de la tarea que quiera.
-
Puede escribir el comando que desee ejecutar o seleccionarlo de una lista de comandos que se ejecutaron durante la misma sesión.
-
Elija Execute (Ejecutar).
Ejecutar comandos desde un intérprete de comandos
Para ejecutar comandos en un contenedor desde un intérprete de comandos, mediante el Explorador de AWS, Amazon ECS Exec debe estar habilitado. Si no está habilitado, consulte el procedimiento para habilitar Amazon ECS Exec de esta sección.
-
Desde el Explorador de AWS, expanda el menú de Amazon ECS.
-
Amplíe la sección Clústeres y elija el clúster que desee modificar.
-
Expanda el servicio para enumerar los contenedores.
-
Abra el menú contextual (haga clic con el botón derecho) del contenedor que quiera modificar y elija Abrir intérprete de comandos interactivo.
-
En el cuadro de diálogo Intérprete de comandos interactivo, elija el ARN de la tarea que quiera.
-
Elija un intérprete de comandos del menú desplegable correspondiente o introduzca el nombre del intérprete de comandos con el que quiera interactuar.
-
Cuando esté satisfecho con la configuración, elija Ejecutar.
-
Cuando el intérprete de comandos se abre en una terminal, puede introducir comandos para interactuar con el contenedor.
