Ejecución de una automatización sencilla - AWS Systems Manager

Ejecución de una automatización sencilla

Los siguientes procedimientos describen cómo ejecutar una automatización sencilla de AWS Systems Manager a través de la consola de Systems Manager y la AWS Command Line Interface (AWS CLI). La automatización se ejecuta en el contexto del usuario de AWS Identity and Access Management (IAM) actual. Esto significa que no tiene que configurar más permisos de IAM siempre y cuando cuente con el permiso para ejecutar el manual de procedimientos y cualquier acción que este solicite. Si tiene permisos de administrador en IAM, ya cuenta con el permiso necesario para ejecutar esta automatización.

nota

Para obtener información acerca de cómo ejecutar una automatización que utilice un rol de servicio de IAM o formas más avanzadas de administración delegada, consulte Ejecución de automatizaciones mediante el uso de diferentes modelos de seguridad.

Ejecución de una automatización sencilla (consola)

El siguiente procedimiento describe cómo utilizar la consola de Systems Manager para ejecutar una automatización sencilla.

Para ejecutar una automatización sencilla

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

  2. En el panel de navegación, elija Automation (Automatización) y, después, seleccione Execute automation (Ejecutar automatización).

  3. En la lista Automation document (Documento de Automation), elija un manual de procedimientos. Elija una o más opciones en el panel Document categories (Categorías de documentos) para filtrar documentos SSM según su propósito. Para ver un manual de procedimientos que le pertenezca, seleccione la pestaña Owned by me (De mi propiedad). Para ver un manual de procedimientos que se haya compartido con su cuenta, elija la pestaña Compartido conmigo. Para ver todos los manuales de procedimientos, seleccione la pestaña All documents (Todos los documentos).

    nota

    Puede ver información acerca de un manual de procedimientos al seleccionar su nombre.

  4. En la sección Document details (Detalles del documento), verifique que Document version (Versión del documento) esté establecido como la versión que desea ejecutar. El sistema incluye las siguientes opciones de versión:

    • Default version at runtime (Versión predeterminada en tiempo de ejecución): seleccione esta opción si el manual de procedimientos de Automation se actualiza de forma periódica y se asigna una nueva versión predeterminada.

    • Latest version at runtime (Última versión en tiempo de ejecución): seleccione esta opción si el manual de procedimientos de Automation se actualiza de forma periódica y desea ejecutar la versión que se ha actualizado más recientemente.

    • 1 (Default) (1 [Predeterminado]): seleccione esta opción para ejecutar la primera versión del documento, que es la versión predeterminada.

  5. Elija Next (Siguiente).

  6. En la sección Execution Mode (Modo de ejecución), seleccione Simple ejecución (Ejecución sencilla).

  7. En la sección Input parameters (Parámetros de entrada), especifique las entradas necesarias: De forma opcional, puede elegir un rol de servicio de IAM de la lista AutomationAssumeRole.

  8. Elija Execute (Ejecutar).

La consola muestra el estado de la automatización. Si no se logra ejecutar la automatización, consulte Solución de problemas de Systems Manager Automation.

Ejecución de una automatización sencilla (línea de comandos)

El siguiente procedimiento describe cómo utilizar la AWS CLI (en Linux o Windows) o las AWS Tools for PowerShell para ejecutar una automatización sencilla.

Para ejecutar una automatización sencilla

  1. Si aún no lo ha hecho, instale y configure la AWS CLI o las AWS Tools for PowerShell.

    Para obtener información, consulte Instalar o actualizar herramientas de línea de comandos de AWS.

  2. Ejecute el siguiente comando para iniciar una automatización sencilla.

    Linux & macOS
    aws ssm start-automation-execution \ --document-name DocumentName \ --parameters ParametersRequiredByDocument
    Windows
    aws ssm start-automation-execution ^ --document-name DocumentName ^ --parameters ParametersRequiredByDocument
    PowerShell
    Start-SSMAutomationExecution ` -DocumentName DocumentName ` -Parameter ParametersRequiredByDocument

    A continuación, se muestra un ejemplo en el que se utiliza el manual de procedimientos AWS-RestartEC2Instance para reiniciar la instancia de EC2 especificada.

    Linux & macOS
    aws ssm start-automation-execution \ --document-name "AWS-RestartEC2Instance" \ --parameters "InstanceId=i-1234567890abcdef0"
    Windows
    aws ssm start-automation-execution ^ --document-name "AWS-RestartEC2Instance" ^ --parameters "InstanceId=i-1234567890abcdef0"
    PowerShell
    Start-SSMAutomationExecution ` -DocumentName AWS-RestartEC2Instance ` -Parameter @{"InstanceId"="i-1234567890abcdef0"}

    El sistema devuelve información similar a la siguiente.

    Linux & macOS
    {
        "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0123456789ab"
    }
    Windows
    {
        "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0123456789ab"
    }
    PowerShell
    4105a4fc-f944-11e6-9d32-0123456789ab
  3. Ejecute el siguiente comando para recuperar el estado de la automatización.

    Linux & macOS
    aws ssm describe-automation-executions \ --filter "Key=ExecutionId,Values=4105a4fc-f944-11e6-9d32-0123456789ab"
    Windows
    aws ssm describe-automation-executions ^ --filter "Key=ExecutionId,Values=4105a4fc-f944-11e6-9d32-0123456789ab"
    PowerShell
    Get-SSMAutomationExecutionList | ` Where {$_.AutomationExecutionId -eq "4105a4fc-f944-11e6-9d32-0123456789ab"}

    El sistema devuelve información similar a la siguiente.

    Linux & macOS
    {
        "AutomationExecutionMetadataList": [
            {
                "AutomationExecutionStatus": "InProgress",
                "CurrentStepName": "stopInstances",
                "Outputs": {},
                "DocumentName": "AWS-RestartEC2Instance",
                "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0123456789ab",
                "DocumentVersion": "1",
                "ResolvedTargets": {
                    "ParameterValues": [],
                    "Truncated": false
                },
                "AutomationType": "Local",
                "Mode": "Auto",
                "ExecutionStartTime": 1564600648.159,
                "CurrentAction": "aws:changeInstanceState",
                "ExecutedBy": "arn:aws:sts::123456789012:assumed-role/Administrator/Admin",
                "LogFile": "",
                "Targets": []
            }
        ]
    }
    Windows
    {
        "AutomationExecutionMetadataList": [
            {
                "AutomationExecutionStatus": "InProgress",
                "CurrentStepName": "stopInstances",
                "Outputs": {},
                "DocumentName": "AWS-RestartEC2Instance",
                "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0123456789ab",
                "DocumentVersion": "1",
                "ResolvedTargets": {
                    "ParameterValues": [],
                    "Truncated": false
                },
                "AutomationType": "Local",
                "Mode": "Auto",
                "ExecutionStartTime": 1564600648.159,
                "CurrentAction": "aws:changeInstanceState",
                "ExecutedBy": "arn:aws:sts::123456789012:assumed-role/Administrator/Admin",
                "LogFile": "",
                "Targets": []
            }
        ]
    }
    PowerShell
    AutomationExecutionId       : 4105a4fc-f944-11e6-9d32-0123456789ab
    AutomationExecutionStatus   : InProgress
    AutomationType              : Local
    CurrentAction               : aws:changeInstanceState
    CurrentStepName             : startInstances
    DocumentName                : AWS-RestartEC2Instance
    DocumentVersion             : 1
    ExecutedBy                  : arn:aws:sts::123456789012:assumed-role/Administrator/Admin
    ExecutionEndTime            : 1/1/0001 12:00:00 AM
    ExecutionStartTime          : 7/31/2019 7:17:28 PM
    FailureMessage              : 
    LogFile                     : 
    MaxConcurrency              : 
    MaxErrors                   : 
    Mode                        : Auto
    Outputs                     : {}
    ParentAutomationExecutionId : 
    ResolvedTargets             : Amazon.SimpleSystemsManagement.Model.ResolvedTargets
    Target                      : 
    TargetMaps                  : {}
    TargetParameterName         : 
    Targets                     : {}