Referência de configuração do agente do CodeDeploy - AWS CodeDeploy

Referência de configuração do agente do CodeDeploy

Quando o agente do CodeDeploy está instalado, um arquivo de configuração é colocado na instância. Esse arquivo de configuração especifica caminhos do diretório e outras configurações que o CodeDeploy usa à medida que este interage com a instância. É possível alterar algumas das opções de configuração no arquivo.

Para instâncias do Amazon Linux, Ubuntu Server e Red Hat Enterprise Linux (RHEL), o arquivo de configuração se chama codedeployagent.yml. É possível encontrá-la no diretório /etc/codedeploy-agent/conf.

Para instâncias do Windows Server, o arquivo de configuração se chama conf.yml. É possível encontrá-la no diretório C:\ProgramData\Amazon\CodeDeploy.

As configurações são:

:log_aws_wire:

Defina como true para que o agente do CodeDeploy capture logs de conexão do Amazon S3 e grave-os em um arquivo chamado codedeploy-agent.wire.log no local apontado pela configuração :log_dir:.

Atenção

Você deve definir :log_aws_wire: como true somente durante o tempo necessário para capturar logs de conexão. O arquivo codedeploy-agent.wire.log pode aumentar rapidamente até atingir um tamanho muito grande. A saída do log de conexão nesse arquivo pode conter informações confidenciais, incluindo o conteúdo de texto simples de arquivos transferidos para dentro ou para fora do amazon S3 enquanto essa configuração estava definida como true. Os logs de conexão contêm informações sobre todas as atividades do Amazon S3 associadas à conta da AWS enquanto essa configuração estava definida como true, e não apenas as atividades relacionadas a implantações do CodeDeploy.

A configuração padrão é false.

Essa configuração aplica-se a todos os tipos de instâncias. Você deve adicionar essa definição de configuração a instâncias do Windows Server para poder usá-la.

:log_dir:

A pasta na instância em que os arquivos de log relacionados às operações do agente do CodeDeploy são armazenados.

A configuração padrão é '/var/log/aws/codedeploy-agent' para instâncias Amazon Linux, Ubuntu Server e RHEL e C:\ProgramData\Amazon\CodeDeploy\log para instâncias Windows Server.

:pid_dir:

A pasta onde codedeploy-agent.pid está armazenado.

Esse arquivo contém o ID do processo (PID) do agente do CodeDeploy. A configuração padrão é '/opt/codedeploy-agent/state/.pid'.

Essa configuração se aplica somente às instâncias Amazon Linux, Ubuntu Server e RHEL.

:program_name:

O nome de programa do agente do CodeDeploy.

A configuração padrão é codedeploy-agent.

Essa configuração se aplica somente às instâncias Amazon Linux, Ubuntu Server e RHEL.

:root_dir:

A pasta em que as revisões relacionadas, o histórico de implantação e os scripts de implantação na instância estão armazenados.

A configuração padrão é /opt/codedeploy-agent/deployment-root para instâncias Amazon Linux, Ubuntu Server e RHEL e C:\ProgramData\Amazon\CodeDeploy para instâncias Windows Server.

:verbose:

Defina como true para que o agente do CodeDeploy imprima arquivos de log de mensagens de depuração na instância.

A configuração padrão é false.

:wait_between_runs:

O intervalo, em segundos, entre a sondagem do agente do CodeDeploy de implantações pendentes no CodeDeploy.

A configuração padrão é 1.

:on_premises_config_file:

Para instâncias on-premises, o caminho para um local alternativo para o arquivo de configuração denominado codedeploy.onpremises.yml (para Ubuntu Server e RHEL) ou conf.onpremises.yml (para Windows Server).

Por padrão, esses arquivos são armazenados em /etc/codedeploy-agent/conf/codedeploy.onpremises.yml para Ubuntu Server e RHEL e C:\ProgramData\Amazon\CodeDeploy\conf.onpremises.yml para Windows Server.

Disponível na versão 1.0.1.686 e em versões posteriores do agente do CodeDeploy.

:proxy_uri:

(Opcional) O proxy HTTP através do qual você deseja que o agente do CodeDeploy conecte-se à AWS para suas operações do CodeDeploy. Use um formato semelhante a https://user:password@my.proxy:443/path?query.

Disponível na versão 1.0.1.824 e em versões posteriores do agente do CodeDeploy.

:max_revisions:

(Opcional) O número de revisões de aplicativos para um grupo de implantação que você deseja que o agente do CodeDeploy arquive. Todas as revisões que excederem o número especificado serão excluídas.

Insira qualquer número inteiro positivo. Se nenhum valor for especificado, o CodeDeploy manterá as cinco revisões mais recentes, além da revisão atualmente implantada.

Com suporte na versão 1.0.1.966 e versões posteriores do agente do CodeDeploy.

:enable_auth_policy:

(Opcional) Defina como true se quiser usar a autorização do IAM para configurar o controle de acesso e limitar a permissão do perfil do IAM ou do usuário que o agente do CodeDeploy está usando. Para Use o CodeDeploy com o Amazon Virtual Private Cloud, esse valor deverá ser true.

A configuração padrão é false.

:disable_imds_v1:

Essa configuração está disponível com o agente do CodeDeploy 1.7.0 e versões posteriores.

Defina como true para desabilitar o fallback para o IMDSv1 quando ocorrerem erros do IMDSv2. O padrão é false (habilitar o fallback).

Trabalhar com o agente do CodeDeploy

Gerenciar as operações do agente do CodeDeploy