Instale o agente do CodeDeploy para Windows Server - AWS CodeDeploy
Usar o Systems ManagerUsar Windows PowerShellUsar um link diretoUsar um comando de cópia do Amazon S3

Instale o agente do CodeDeploy para Windows Server

Nas instâncias do Windows Server, você pode usar um dos seguintes métodos para fazer download e instalar o agente do CodeDeploy:

  • Use o AWS Systems Manager (recomendado)

  • Execute uma série de comandos do Windows PowerShell.

  • Escolha um link de download direto.

  • Execute um comando de cópia do Amazon S3.

nota

A pasta na qual o agente do CodeDeploy está instalado é C:\Program Data\Amazon\CodeDeploy. Certifique-se de que não haja junções de diretórios ou links simbólicos nesse caminho.

Usar o Systems Manager

Siga as instruções em Instale o agente do CodeDeploy usando o AWS Systems Manager para instalar o agente do CodeDeploy.

Usar Windows PowerShell

Faça login na instância e execute os seguintes comandos no Windows PowerShell:

  1. Exija que todos os scripts e arquivos de configuração baixados da Internet sejam assinados por um editor confiável. Se você precisar alterar a política de execução, digite "". "Y." 

     Set-ExecutionPolicy RemoteSigned

  2. Carregue o AWS Tools for Windows PowerShell. 

    Import-Module AWSPowerShell

  3. Crie um diretório em que o arquivo de instalação do agente do CodeDeploy é baixado. 

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

  4. Configure as credenciais da AWS usando os comandos Set-AWSCredential e Initialize-AWSDefaultConfiguration. Para obter mais informações, consulte Usando credenciais da AWS no Guia do Usuário de ferramentas da AWS para PowerShell.

  5. Faça download do arquivo de instalação do agente do CodeDeploy.

    nota

    A AWS comporta a versão secundária mais recente do agente do CodeDeploy. Atualmente, a versão secundária mais recente é 1.7.x.

    Para instalar a versão mais recente do agente do CodeDeploy:

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

    Para instalar uma versão específica do agente do CodeDeploy:

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

    bucket-name é o nome do bucket do S3 que contém os arquivos do kit de recursos do CodeDeploy para sua região. Por exemplo, para a região Leste dos EUA (Ohio), substitua bucket-name por aws-codedeploy-us-east-2. Para obter uma lista de nomes de buckets, consulte Nomes de bucket do kit de recursos por região.

  6. Execute o arquivo de instalação do agente do CodeDeploy. 

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

Para verificar se o serviço está em execução, execute o seguinte comando:

powershell.exe -Command Get-Service -Name codedeployagent

Se o agente do CodeDeploy tiver sido instalado, mas ainda não tiver iniciado, após a execução do comando Get-Service, em Status, você verá Start...:


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

Se o agente do CodeDeploy já estiver em execução, após a execução do comando Get-Service, em Status, você verá Running:


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

Se as configurações de segurança do navegador na instância do Windows Server concederem as permissões (por exemplo, para https://s3.*.amazonaws.com), você poderá usar um link direto da região para fazer download do agente do CodeDeploy e, depois, executar o instalador manualmente.

O link é:

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

...em que region é a região da AWS em que você está implantando seu aplicativo.

Por exemplo:

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

Obtenha o arquivo .msi na mesma região do seu aplicativo do CodeDeploy. Escolher uma região diferente pode causar falhas de inconsistent region no arquivo codedeploy-agent-log quando você executar o arquivo .msi.

Usar um comando de cópia do Amazon S3

Se a AWS CLI for instalada na instância, é possível usar o comando cp do Amazon S3 para fazer download do agente do CodeDeploy e, em seguida, executar o instalador manualmente. Para obter informações, consulte Instalar a AWS Command Line Interface no Microsoft Windows.

O comando do Amazon S3 é:

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

...em que region é a região da AWS em que você está implantando seu aplicativo.

Por exemplo:

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