Instalación del agente de CodeDeploy para Windows Server

En las instancias de Windows Server, puede utilizar uno de estos métodos para descargar e instalar el agente de CodeDeploy:

• Uso de AWS Systems Manager (recomendado)

• Ejecutar una serie de comandos de Windows PowerShell.

• Elegir un enlace de descarga directa.

• Ejecutar un comando copy de Amazon S3.

nota

La carpeta en la que está instalado el agente de CodeDeploy es C:\Program Data\Amazon\CodeDeploy. Asegúrese de que no haya nudos de directorio ni enlaces simbólicos en esta ruta.

Uso de Systems Manager

Siga las instrucciones descritas en Instalación del agente de CodeDeploy con AWS Systems Manager para instalar el agente de CodeDeploy.

Uso de Windows PowerShell

Inicie sesión en la instancia y ejecute los comandos siguientes en Windows PowerShell:

1. Es necesario que todos los scripts y archivos de configuración que se hayan descargado de Internet estén firmados por un editor de confianza. Si se le pide que cambie la política de ejecución, escriba "". "Y."

    Set-ExecutionPolicy RemoteSigned

2. Cargue AWS Tools for Windows PowerShell.

   Import-Module AWSPowerShell

3. Cree un directorio donde se pueda descargar el archivo de instalación del agente de CodeDeploy.

   New-Item -Path "c:\temp" -ItemType "directory" -Force

4. Configure las credenciales de AWS mediante los comandos Set-AWSCredential y Initialize-AWSDefaultConfiguration. Para obtener más información, consulte Uso de las credenciales de AWS en la Guía del usuario de las herramientas de AWS para PowerShell.

5. Descargue el archivo de instalación del agente de CodeDeploy.

   nota

   AWS admite la última versión secundaria del agente de CodeDeploy: Actualmente, la última versión secundaria es la 1.7.x.

   Para instalar la última versión del agente de CodeDeploy:

   • powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi

   Para instalar una versión concreta del agente de CodeDeploy:

   • powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi

   bucket-name es el nombre del bucket de S3 que contiene los archivos del kit de recursos de CodeDeploy de su región. Por ejemplo, en el caso de la región Este de EE. UU. (Ohio), sustituya bucket-name por aws-codedeploy-us-east-2. Para obtener una lista de los nombres de los buckets, consulte Nombres de bucket del kit de recursos por región.

6. Ejecute el archivo de instalación del agente de CodeDeploy.

   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt

Para comprobar que el servicio se está ejecutando, ejecute el siguiente comando:

powershell.exe -Command Get-Service -Name codedeployagent

Si el agente de CodeDeploy se acaba de instalar y no se ha iniciado, después de ejecutar el comando Get-Service, en Estado, debería ver Start...:

Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service

Si el agente de CodeDeploy ya se está ejecutando, después de ejecutar el comando Get-Service, en Estado, debería ver Running:

Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service

Uso de un enlace directo

Si la configuración de seguridad del navegador en la instancia de Windows Server proporciona los permisos (por ejemplo, para https://s3.*.amazonaws.com), puede utilizar el enlace directo de su región para descargar el agente de CodeDeploy y luego ejecutar el instalador manualmente.

El enlace es:

https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi

... donde region es la región de AWS en la que está implementando la aplicación.

Por ejemplo:

https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi

importante

Obtenga el archivo .msi de la misma región que su aplicación de CodeDeploy. La elección de una región diferente puede provocar errores de inconsistent region en el archivo codedeploy-agent-log al ejecutar el archivo .msi.

Uso de un comando copy de Amazon S3

Si AWS CLI está instalado en la instancia, puede utilizar el comando cp de Amazon S3 para descargar el agente de CodeDeploy y luego ejecutar el instalador manualmente. Para obtener información, consulte Instalación de la AWS Command Line Interface en Microsoft Windows.

El comando de Amazon S3 es:

aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region

... donde region es la región de AWS en la que está implementando la aplicación.

Por ejemplo:

aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1