Ejecución de comandos desde la consola

Puede utilizar Run Command, una capacidad de AWS Systems Manager, desde la AWS Management Console para configurar nodos administrados sin tener que iniciar sesión en ellos. En este tema, se incluye un ejemplo en el que se muestra cómo actualizar SSM Agent en un nodo administrado utilizando Run Command.

Antes de empezar

Antes de enviar un comando con Run Command, verifique que los nodos administrados cumplan los requisitos de configuración de Systems Manager.

Para enviar un comando con Run Command

1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

2. En el panel de navegación, elija Run Command.

   -o bien-

   Si la página de inicio de AWS Systems Manager se abre primero, elija el icono de menú ( ) para abrir el panel de navegación y, a continuación, elija Run Command.

3. Elija Run command (Ejecutar comando).

4. En la lista Command document (Documento de Command), elija un documento de Systems Manager.

5. En la sección Command Parameters, especifique los valores de los parámetros obligatorios.

6. En la sección Targets (Destinos), para elegir los nodos administrados en los que desea ejecutar esta operación, especifique las etiquetas, seleccione las instancias o los dispositivos de borde manualmente o especifique un grupo de recursos.

   sugerencia

   Si un nodo administrado que espera ver no aparece en la lista, consulte Solución de problemas de disponibilidad de nodos administrados para obtener consejos de solución de problemas.

7. En Otros parámetros:

   • En Comentario, ingrese la información acerca de este comando.

   • En Tiempo de espera (segundos), especifique el número de segundos que tiene que esperar el sistema antes de indicar que se ha producido un error en la ejecución del comando general.

8. En Rate control (Control de velocidad):

   • En Concurrency (Simultaneidad), especifique un número o un porcentaje de los nodos administrados en los que desea ejecutar el comando al mismo tiempo.

     nota

     Si seleccionó los destinos mediante la especificación de etiquetas aplicadas a nodos administrados o de grupos de recursos de AWS y no está seguro de cuántos nodos administrados tienen destino, limite el número de destinos que puede ejecutar el documento al mismo tiempo. Para ello, especifique un porcentaje.

   • En Error threshold (Umbral de errores), especifique cuándo desea parar la ejecución del comando en los demás nodos administrados después de que haya fallado en un número o un porcentaje de los nodos. Por ejemplo, si especifica tres errores, Systems Manager dejará de enviar el comando cuando se reciba el cuarto error. Los nodos administrados que estén procesando el comando todavía pueden enviar errores.

9. (Opcional) Elija una CloudWatch alarma para aplicarla al comando de supervisión. Para adjuntar una CloudWatch alarma a su comando, el director de IAM que ejecuta el comando debe tener permiso para realizar la iam:createServiceLinkedRole acción. Para obtener más información sobre CloudWatch las alarmas, consulta Uso de CloudWatch las alarmas de Amazon. Tenga en cuenta que si la alarma se activa, no se ejecutará ninguna invocación de comando pendiente.

10. (Opcional) En Opciones de salida, para guardar la salida del comando en un archivo, seleccione el cuadro Write command output to an S3 bucket. Ingrese los nombres del bucket y del prefijo (carpeta) en los cuadros.

    nota

    Los permisos de S3 que conceden la capacidad de escribir datos en un bucket de S3 son los del perfil de instancia (para instancias de EC2) o rol de servicio de IAM (máquinas activadas de manera híbrida) asignados a la instancia, no los del usuario de IAM que realiza esta tarea. Para obtener más información, consulte Configurar permisos de instancia para Systems Manager o Crear un rol de servicio de IAM para un entorno híbrido. Además, si el bucket de S3 especificado se encuentra en una Cuenta de AWS diferente, asegúrese de que el perfil de instancias o el rol de servicio de IAM asociado al nodo administrado tenga los permisos necesarios para escribir en ese bucket.

11. En la sección Notificaciones de SNS, seleccione la casilla de verificación Habilitar notificaciones de SNS si desea recibir notificaciones sobre el estado de ejecución de los comandos.

    Para obtener más información acerca de la configuración de las notificaciones de Amazon SNS para Run Command, consulte Monitoreo de los cambios de estado de Systems Manager mediante las notificaciones de Amazon SNS.

12. Elija Ejecutar.

Para obtener más información acerca de la cancelación de un comando, consulte Cancelación de un comando.

Volver a ejecutar comandos

Systems Manager incluye dos opciones que lo ayudarán a volver a ejecutar un comando desde la página de Run Command en la consola de Systems Manager.

• Rerun (Volver a ejecutar): este botón le permite ejecutar el mismo comando sin realizarle cambios.

• Copy to new (Copiar en nuevo): este botón copia la configuración de un comando en un comando nuevo y le ofrece la opción de editar esa configuración antes de ejecutarlo.

Para volver a ejecutar un comando

1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

2. En el panel de navegación, elija Run Command.

   -o bien-

   Si la página de inicio de AWS Systems Manager se abre primero, elija el icono de menú ( ) para abrir el panel de navegación y, a continuación, elija Run Command.

3. Elija el comando que desea volver a ejecutar. Puede volver a ejecutar un comando inmediatamente después de ejecutarlo desde la página de detalles del comando. O bien, puede elegir un comando que haya ejecutado anteriormente en la pestaña Command history (Historial de comandos).

4. Elija Rerun (Volver a ejecutar) para ejecutar el mismo comando sin realizar ningún cambio o elija Copy to new (Copiar en nuevo) para editar la configuración del comando antes de ejecutarlo.