View a markdown version of this page

AWSSupport-EnableWindowsEC2SerialConsole - AWS Systems Manager Referencia del manual de procedimientos de Automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-EnableWindowsEC2SerialConsole

Descripción

El manual le AWSSupport-EnableWindowsEC2SerialConsole ayuda a habilitar la consola en serie de Amazon EC2, la consola de administración especial (SAC) y el menú de arranque en su instancia de Windows de Amazon EC2. Con la función de consola en serie de Amazon Elastic Compute Cloud (Amazon EC2), tiene acceso al puerto serie de la instancia de Amazon EC2 para solucionar problemas de arranque, configuración de red y otros problemas. El manual automatiza los pasos necesarios para habilitar la función en las instancias en estado de ejecución administradas por AWS Systems Manager, así como en aquellas en estado detenido o no administradas por. AWS Systems Manager

¿Cómo funciona?

El manual de AWSSupport-EnableWindowsEC2SerialConsole automatización ayuda a habilitar el SAC y el menú de arranque en las instancias de Amazon EC2 que ejecutan Microsoft Windows Server. En el caso de las instancias en estado de ejecución y administradas por AWS Systems Manager, el libro de ejecución ejecuta un PowerShell script de comando de AWS Systems Manager ejecución para habilitar el SAC y el menú de arranque. En el caso de las instancias que están paradas o no están gestionadas por AWS Systems Manager, el libro de ejecución utiliza el AWSSupport-StartEC2RescueWorkflow para crear una instancia Amazon EC2 temporal a fin de realizar los cambios necesarios sin conexión a Internet.

Para obtener más información, consulte Amazon EC2 Serial Console para instancias de Windows.

importante

  • Si habilita el SAC en una instancia, los servicios de Amazon EC2 que dependen de la recuperación de contraseñas no funcionarán desde la consola de Amazon EC2. Para obtener más información, consulte Usar SAC para solucionar problemas de su instancia de Windows.

  • Para configurar el acceso a la consola en serie, debe conceder el acceso a la consola en serie a nivel de cuenta y, a continuación, configurar las políticas AWS Identity and Access Management (IAM) para conceder el acceso a sus usuarios. También debe configurar un usuario basado en contraseña en cada instancia para que los usuarios puedan utilizar la consola serie para solucionar problemas. Para obtener más información, consulte Configurar el acceso a la consola en serie de Amazon EC2.

  • Para ver si la consola serie está habilitada en tu cuenta, consulta Ver el estado de acceso de la cuenta a la consola serie.

  • El acceso a la consola en serie solo se admite en instancias virtualizadas integradas en el sistema Nitro.

Para obtener más información, consulte los requisitos previos de la consola serie Amazon EC2.

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Windows

Parámetros

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "autoscaling:DescribeAutoScalingInstances",
                "ec2:GetSerialConsoleAccessStatus",
                "ec2:Describe*",
                "ec2:createTags",
                "ec2:createImage",
                "ssm:DescribeAutomationExecutions",
                "ssm:DescribeInstanceInformation",
                "ssm:GetAutomationExecution",
                "ssm:ListCommandInvocations",
                "ssm:ListCommands"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:AttachVolume",
                "ec2:DetachVolume",
                "ec2:ModifyInstanceAttribute",
                "ec2:RebootInstances",
                "ec2:StartInstances",
                "ec2:StopInstances",
                "iam:GetInstanceProfile",
                "ssm:GetParameters",
                "ssm:SendCommand",
                "ssm:StartAutomationExecution"
            ],
            "Resource": [
                "arn:aws:ec2:us-east-1:111122223333:instance/i-02573cafcfEXAMPLE",
                "arn:aws:ec2:us-east-1:111122223333:volume/vol-049df61146EXAMPLE",
                "arn:aws:iam::111122223333:instance-profile/instance-profile-name",
                "arn:aws:ssm:us-east-1:111122223333:parameter/aws/service/*",
                "arn:aws:ssm:us-east-1:*:document/AWSSupport-StartEC2RescueWorkflow",
                "arn:aws:ssm:us-east-1:*:document/AWS-ConfigureAWSPackage",
                "arn:aws:ssm:us-east-1:*:document/AWS-RunPowerShellScript",
                "arn:aws:ssm:us-east-1:111122223333:automation-execution/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloudformation:CreateStack"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "aws:RequestTag/Name": "AWSSupport-EC2Rescue: *"
                },
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "AWSSupport-EC2Rescue-AutomationExecution",
                        "Name"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "cloudformation:DeleteStack",
                "cloudformation:DescribeStackEvents",
                "cloudformation:DescribeStackResource",
                "cloudformation:DescribeStacks",
                "ec2:AttachVolume",
                "ec2:DetachVolume",
                "ec2:RebootInstances",
                "ec2:StopInstances",
                "ec2:TerminateInstances",
                "ssm:SendCommand"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "aws:ResourceTag/Name": "AWSSupport-EC2Rescue: *"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:CreateLaunchTemplate",
                "ec2:DeleteLaunchTemplate",
                "ec2:RunInstances"
            ],
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "aws:CalledVia": [
                        "cloudformation.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "ssm.amazonaws.com",
                        "ec2.amazonaws.com"
                    ]
                }
            }
        }
    ]
}

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navega hasta AWSSupport-EnableWindowsEC2SerialConsole la AWS Systems Manager consola.

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • InstanceId: (Obligatorio)

      El ID de la instancia de Amazon EC2 en la que desea habilitar la consola serie (SAC) de Amazon EC2 y el menú de arranque.

    • AutomationAssumeRole: (Opcional)

      El nombre de recurso de Amazon (ARN) del rol de IAM que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este libro de ejecución.

    • HelperInstanceType: (Condicional)

      El tipo de instancia de Amazon EC2 que el runbook aprovisiona para configurar la consola en serie de Amazon EC2 para una instancia offline.

    • HelperInstanceProfileName: (Condicional)

      El nombre de un perfil de instancia de IAM existente para la instancia auxiliar. Si vas a habilitar el SAC y el menú de arranque en una instancia que está detenida o no está gestionada por él AWS Systems Manager, es obligatorio. Si no se especifica un perfil de instancia de IAM, la automatización crea uno en tu nombre.

    • SubnetId: (Condicional)

      El ID de subred de una instancia auxiliar. De forma predeterminada, usa la misma subred en la que reside la instancia proporcionada.

      importante

      Si proporciona una subred personalizada, debe estar en la misma InstanceId zona de disponibilidad y debe permitir el acceso a los puntos finales de Systems Manager. Esto solo es necesario si la instancia de destino está detenida o no está administrada por. AWS Systems Manager

    • CreateInstanceBackupBeforeScriptExecution: (Opcional)

      Especifique True para crear una copia de seguridad de Amazon Machine Images (AMI) de la instancia Amazon EC2 antes de habilitar el SAC y el menú de arranque. La AMI se conservará una vez terminada la automatización. Es su responsabilidad proteger el acceso a la AMI o eliminarla.

    • BackupAmazonMachineImagePrefix: (Condicional)

      Un prefijo para la imagen de máquina de Amazon (AMI) que se crea si el CreateInstanceBackupBeforeScriptExecution parámetro se establece en. True

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • CheckIfEc2SerialConsoleAccessEnabled:

      Comprueba si el acceso a la consola serie de Amazon EC2 está habilitado a nivel de cuenta. Nota: El acceso a la consola en serie no está disponible de forma predeterminada. Para obtener más información, consulte Configurar el acceso a la consola serial de Amazon EC2.

    • CheckIfEc2InstanceIsWindows:

      Afirma si la plataforma de la instancia de destino es Windows.

    • GetInstanceType:

      Recupera el tipo de instancia de la instancia de destino.

    • CheckIfInstanceTypeIsNitro:

      Comprueba si el hipervisor del tipo de instancia es. Nitro-based El acceso a la consola en serie solo se admite en instancias virtualizadas creadas en el sistema Nitro.

    • CheckIfInstanceIsInAutoScalingGroup:

      Comprueba si la instancia de Amazon EC2 forma parte de un grupo de Amazon EC2 Auto Scaling llamando a la API. DescribeAutoScalingInstances Si la instancia forma parte de un grupo de Amazon EC2 Auto Scaling, se asegura de que la instancia de Porting Assistant for .NET esté en estado de ciclo de vida en espera.

    • WaitForEc2InstanceStateStablized:

      Espera a que la instancia esté en ejecución o detenida.

    • GetEc2InstanceState:

      Obtiene el estado actual de la instancia.

    • BranchOnEc2InstanceState:

      Se bifurca según el estado de la instancia recuperado en el paso anterior. Si el estado de la instancia está en ejecución, pasa al CheckIfEc2InstanceIsManagedBySSM paso y, si no, va al CheckIfHelperInstanceProfileIsProvided paso.

    • CheckIfEc2InstanceIsManagedBySSM:

      Comprueba si la instancia está gestionada por AWS Systems Manager. Si se administra, el runbook habilita el SAC y el menú de arranque mediante un comando de PowerShell ejecución.

    • BranchOnPreEC2RescueBackup:

      Las ramas se basan en el parámetro CreateInstanceBackupBeforeScriptExecution de entrada.

    • CreateAmazonMachineImageBackup:

      Crea una copia de seguridad de la instancia en la AMI.

    • EnableSACAndBootMenu:

      Activa el SAC y el menú de arranque mediante la ejecución de un script PowerShell Run Command.

    • RebootInstance:

      Reinicia la instancia de Amazon EC2 para aplicar la configuración. Este es el último paso si la instancia está en línea y está gestionada por. AWS Systems Manager

    • CheckIfHelperInstanceProfileIsProvided:

      Comprueba si lo HelperInstanceProfileName especificado existe antes de habilitar el SAC y el menú de arranque sin conexión mediante una instancia temporal de Amazon EC2.

    • RunAutomationToInjectOfflineScriptForEnablingSACAndBootMenu:

      Ejecuta el menú AWSSupport-StartEC2RescueWorkflow para habilitar el SAC y el menú de arranque cuando la instancia está detenida o no está gestionada por AWS Systems Manager.

    • GetExecutionDetails:

      Recupera el ID de imagen de la salida del script de respaldo y sin conexión.

  7. Una vez completada, revise la sección Resultados para ver los resultados detallados de la ejecución:

    • EnableSACAndBootMenu.Output:

      Resultado de la ejecución del comando en el EnableSACAndBootMenu paso.

    • GetExecutionDetails.OfflineScriptOutput:

      Resultado del script offline ejecutado en el RunAutomationToInjectOfflineScriptForEnablingSACAndBootMenu paso.

    • GetExecutionDetails.BackupBeforeScriptExecution:

      Identificador de imagen de la copia de seguridad de la AMI realizada si el parámetro CreateInstanceBackupBeforeScriptExecution de entrada es verdadero.

Referencias

Automatización de Systems Manager