AWS Systems Manager
Guía del usuario

Ejecución de comandos desde la consola

Puede utilizar Run Command desde la consola para configurar instancias sin tener que iniciar sesión en cada instancia. En este tema, se incluye un ejemplo en el que se muestra cómo actualizar el Agente de SSM en una instancia utilizando Run Command.

Antes de empezar

Antes de enviar un comando con Run Command, verifique que las instancias cumplan los requisitos 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 se abre primero la página de inicio de AWS Systems Manager, elija el icono de menú ( ) para abrir el panel de navegación y, a continuación, elija Run Command.

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

  4. En la sección Targets (Destinos), identifique las instancias en las que desea ejecutar esta operación. Para ello, especifique las instancias manualmente o especifique un grupo de recursos.

    nota

    Si decide seleccionar las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte ¿Dónde están mis instancias? para obtener sugerencias sobre la solución del problema.

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

  6. En Other parameters (Otros parámetros):

    • En Comment (Comentario), escriba la información acerca de este comando.

    • En Timeout (seconds) (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.

  7. (Opcional) En Rate control (Control de velocidad):

    • En Concurrency (Concurrencia), especifique un número o un porcentaje de las instancias en las que desea ejecutar el comando al mismo tiempo.

      nota

      Si selecciona destinos especificando etiquetas aplicadas a instancias administradas o especificando grupos de recursos de AWS y no está seguro de cuántas instancias se trata, limite el número de instancias que puede ejecutar el documento al mismo tiempo especificando un porcentaje.

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

  8. En la sección Output options (Opciones de salida), si desea guardar la salida del comando en un archivo, seleccione Write command output to an Amazon S3 bucket (Escribir la salida del comando en un bucket de &S3). Escriba el nombre del bucket y el 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 asignado a la instancia, no los del usuario de IAM que realiza esta tarea. Para obtener más información, consulte Crear un perfil de instancia de IAM para Systems Manager.

  9. En la sección SNS Notifications (Notificaciones SNS), si desea que se envíen notificaciones sobre el estado de la ejecución del comando, seleccione la casilla de verificación Enable SNS notifications (Habilitar notificaciones SNS).

    Para obtener más información acerca de la configuración de notificaciones de Amazon SNS para Run Command, consulte Configuración de notificaciones de Amazon SNS para AWS Systems Manager.

  10. Elija Run (Ejecutar).

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

Actualice Agente de SSM usando Run Command

El siguiente procedimiento describe cómo actualizar rápidamente Agente de SSM ejecutándose en las instancias de Windows y Linux. Puede actualizar a la versión más reciente o volver a una versión anterior. Al ejecutar el comando, el sistema descarga la versión de AWS, la instala y, a continuación, desinstala la versión que existía antes de ejecutar el comando. Si se produce un error durante este proceso, el sistema vuelve a la versión del servidor anterior a la ejecución del comando y el estado del comando mostrará que el comando ha tenido un error.

nota

Si desea recibir notificaciones sobre actualizaciones de Agente de SSM, suscríbase a la página de notas de la versión de Agente de SSM en GitHub.

Para actualizar el Agente de SSM 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 se abre primero la página de inicio de AWS Systems Manager, elija el icono de menú ( ) para abrir el panel de navegación y, a continuación, elija Run Command.

  3. En la lista Command document, elija AWS-UpdateSSMAgent.

  4. En la sección Targets (Destinos), identifique las instancias en las que desea ejecutar esta operación. Para ello, especifique las instancias manualmente o especifique un grupo de recursos.

    nota

    Si decide seleccionar las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte ¿Dónde están mis instancias? para obtener sugerencias sobre la solución del problema.

  5. En la sección Command Parameters, especifique los valores de los parámetros siguientes, si así lo desea:

    1. (Opcional). En Version (Versión), escriba la versión del Agente de SSM que se va a instalar. Puede instalar versiones anteriores del agente. Si no especifica ninguna versión, el servicio instalará la versión más reciente.

    2. (Opcional). En Allow Downgrade (Permitir versiones anteriores), elija true para instalar una versión anterior del Agente de SSM. Si elige esta opción, debe especificar el número de la versión anterior. Elija false para instalar solo la versión más reciente del servicio.

  6. En Other parameters (Otros parámetros):

    • En Comment (Comentario), escriba la información acerca de este comando.

    • En Timeout (seconds) (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.

  7. (Opcional) En Rate control (Control de velocidad):

    • En Concurrency (Concurrencia), especifique un número o un porcentaje de las instancias en las que desea ejecutar el comando al mismo tiempo.

      nota

      Si selecciona destinos especificando etiquetas aplicadas a instancias administradas o especificando grupos de recursos de AWS y no está seguro de cuántas instancias se trata, limite el número de instancias que puede ejecutar el documento al mismo tiempo especificando un porcentaje.

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

  8. En la sección Output options (Opciones de salida), si desea guardar la salida del comando en un archivo, seleccione Write command output to an Amazon S3 bucket (Escribir la salida del comando en un bucket de &S3). Escriba el nombre del bucket y el 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 asignado a la instancia, no los del usuario de IAM que realiza esta tarea. Para obtener más información, consulte Crear un perfil de instancia de IAM para Systems Manager.

  9. En la sección SNS Notifications (Notificaciones SNS), si desea que se envíen notificaciones sobre el estado de la ejecución del comando, seleccione la casilla de verificación Enable SNS notifications (Habilitar notificaciones SNS).

    Para obtener más información acerca de la configuración de notificaciones de Amazon SNS para Run Command, consulte Configuración de notificaciones de Amazon SNS para AWS Systems Manager.

  10. Elija Run (Ejecutar).