As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Instale o CodeDeploy agente usando a linha de comando **nota** Recomendamos instalar o CodeDeploy agente AWS Systems Manager para poder configurar as atualizações programadas do agente. Para obter mais informações, consulte [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). Use os tópicos a seguir para instalar e executar o CodeDeploy agente usando a linha de comando. **Topics** + [Instale o CodeDeploy agente para Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md) + [Instale o CodeDeploy agente para o Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md) + [Instale o CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md) # Instale o CodeDeploy agente para Amazon Linux ou RHEL Entre na instância e execute os seguintes comandos, um por vez. Executar primeiro o comando `sudo yum update` é considerado uma prática recomendada ao usar `yum` para instalar pacotes, mas você poderá ignorá-lo se não desejar atualizar todos os pacotes. ``` sudo yum update ``` ``` sudo yum install ruby ``` ``` sudo yum install wget ``` (Opcional) Para limpar a AMI de qualquer informação anterior de armazenamento em cache do agente, execute o seguinte script: ``` #!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y ``` Mude para o diretório inicial. ``` cd /home/ec2-user ``` **nota** No comando anterior, `/home/ec2-user` representa o nome de usuário padrão para uma instância do Amazon EC2 para Amazon Linux ou RHEL. Se a sua instância foi criada usando um AMI personalizado, o proprietário do AMI pode ter especificado um nome de usuário padrão diferente. Baixe o instalador do CodeDeploy agente: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit da sua região e *region-identifier* é o identificador da sua região. Por exemplo: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Para obter uma lista dos nomes de bucket e identificadores de região, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names). Defina as permissões de execução no arquivo `install`: ``` chmod +x ./install ``` Para instalar a versão mais recente do CodeDeploy agente: + ``` sudo ./install auto ``` Para instalar uma versão específica do CodeDeploy agente: + Obtenha uma lista de versões disponíveis em sua região: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$' ``` + Instale uma das versões: ``` sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm ``` **nota** AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x. Para verificar se o serviço está em execução, execute o seguinte comando: ``` systemctl status codedeploy-agent ``` Se o CodeDeploy agente estiver instalado e em execução, você deverá ver uma mensagem como`The AWS CodeDeploy agent is running`. Se você vir uma mensagem como `error: No AWS CodeDeploy agent running`, inicie o serviço e execute os dois comandos a seguir, um de cada vez: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Instale o CodeDeploy agente para o Ubuntu Server **nota** Recomendamos instalar o CodeDeploy agente AWS Systems Manager para poder configurar as atualizações programadas do agente. Para obter mais informações, consulte [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). **Para instalar o CodeDeploy agente no Ubuntu Server** 1. Faça login na instância. 1. Insira o seguinte comando, um após o outro: ``` sudo apt update ``` ``` sudo apt install ruby-full ``` ``` sudo apt install wget ``` 1. Digite o comando: ``` cd /home/ubuntu ``` */home/ubuntu*representa o nome de usuário padrão para uma instância do Ubuntu Server. Se a sua instância foi criada usando um AMI personalizado, o proprietário do AMI pode ter especificado um nome de usuário padrão diferente. 1. Digite o comando: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit da sua região e *region-identifier* é o identificador da sua região. Por exemplo: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Para obter uma lista dos nomes de bucket e identificadores de região, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names). 1. Digite o comando: ``` chmod +x ./install ``` 1. Execute um destes procedimentos: + Para instalar a versão mais recente do CodeDeploy agente em qualquer versão compatível do Ubuntu Server*, exceto* 20.04: ``` sudo ./install auto ``` + Para instalar a versão mais recente do CodeDeploy agente no Ubuntu Server 20.04: **nota** Gravar a saída em um arquivo de log temporário é uma solução alternativa que deve ser usada enquanto resolvemos um bug conhecido com o script `install` no Ubuntu Server 20.04. ``` sudo ./install auto > /tmp/logfile ``` + Para instalar uma versão específica do CodeDeploy agente em qualquer versão compatível do Ubuntu Server, *exceto* 20.04: + Obtenha uma lista de versões disponíveis em sua região: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Instale uma das versões: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb ``` **nota** AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x. + Para instalar uma versão específica do CodeDeploy agente no Ubuntu Server 20.04: + Obtenha uma lista de versões disponíveis em sua região: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Instale uma das versões: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile ``` **nota** Gravar a saída em um arquivo de log temporário é uma solução alternativa que deve ser usada enquanto resolvemos um bug conhecido com o script `install` no Ubuntu Server 20.04. **nota** AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x. **Para verificar se o serviço está em execução** 1. Digite o comando: ``` systemctl status codedeploy-agent ``` Se o CodeDeploy agente estiver instalado e em execução, você deverá ver uma mensagem como`The AWS CodeDeploy agent is running`. 1. Se você vir uma mensagem como `error: No AWS CodeDeploy agent running`, inicie o serviço e execute os dois comandos a seguir, um de cada vez: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Instale o CodeDeploy agente para Windows Server Nas instâncias do Windows Server, você pode usar um desses métodos para baixar e instalar o CodeDeploy agente: + Uso AWS Systems Manager (recomendado) + Execute uma série de PowerShell comandos do Windows. + Escolha um link de download direto. + Execute um comando de cópia do Amazon S3. **nota** A pasta na qual o CodeDeploy agente 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. **Topics** + [Usar o Systems Manager](#codedeploy-agent-operations-install-system-manager) + [Use o Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell) + [Usar um link direto](#codedeploy-agent-operations-install-windows-direct-link) + [Usar um comando de cópia do Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy) ## Usar o Systems Manager Siga as instruções [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) para instalar o CodeDeploy agente. ## Use o 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 ``` 1. Carregue AWS Tools for Windows PowerShell o. ``` Import-Module AWSPowerShell ``` 1. Crie um diretório no qual o arquivo de instalação do CodeDeploy agente é baixado. ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` 1. Configure AWS as credenciais usando os `Initialize-AWSDefaultConfiguration` comandos `Set-AWSCredential` e. Para obter mais informações, consulte [Usando AWS credenciais](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) nas *AWS ferramentas do Guia PowerShell do Usuário*. 1. Baixe o arquivo de instalação do CodeDeploy agente. **nota** AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x. Para instalar a versão mais recente do CodeDeploy agente: + ``` 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 CodeDeploy agente: + ``` 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 Amazon S3 que contém os arquivos do CodeDeploy Resource Kit para sua região. Por exemplo, para a região Leste dos EUA (Ohio), *bucket-name* substitua 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](resource-kit.md#resource-kit-bucket-names). 1. Execute o arquivo de instalação do CodeDeploy agente. ``` 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 CodeDeploy agente acabou de ser instalado e não foi iniciado, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Start...**: ``` Status Name DisplayName ------ ---- ----------- Start... codedeployagent CodeDeploy Host Agent Service ``` Se o CodeDeploy agente já estiver em execução, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Running**: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` ## Usar um link direto Se as configurações de segurança do navegador na instância do Windows Server fornecerem as permissões (por exemplo, para`https://s3.*.amazonaws.com`), você poderá usar um link direto para sua região para baixar o CodeDeploy agente e executar o instalador manualmente. O link é: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi ``` ... onde *region* está a AWS região 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 `.msi` arquivo da mesma região do seu CodeDeploy aplicativo. 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 o AWS CLI estiver instalado na instância, você poderá usar o comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) do Amazon S3 para baixar o CodeDeploy agente e, em seguida, executar o instalador manualmente. Para obter informações, consulte [Instalar o AWS Command Line Interface no Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). O comando do Amazon S3 é: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region ``` ... onde *region* está a AWS região 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 ```