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á.

# CodeDeploy referência de configuração do agente
<a name="reference-agent-configuration"></a>

Quando o CodeDeploy agente é instalado, um arquivo de configuração é colocado na instância. Esse arquivo de configuração especifica caminhos de diretório e outras configurações CodeDeploy a serem usadas ao interagir 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 `true` para que o CodeDeploy agente capture logs de conexão do Amazon S3 e os grave em um arquivo de log no local indicado pela configuração:log\_dir:.**<br />Para a versão 2.0.x e posterior, o nome do arquivo é `codedeploy-agent.aws_wire.log` (criado com as permissões 0640).<br />Para a versão 1.8.x e anteriores, o nome do arquivo é. `codedeploy-agent.wire.log` Você deve definir **:log\_aws\_wire:** como `true` somente durante o tempo necessário para capturar logs de conexão. O arquivo de registro de conexões pode crescer rapidamente para um tamanho muito grande. A saída do log de conexão pode conter informações confidenciais, incluindo o conteúdo em texto simples dos arquivos transferidos para ou do Amazon S3 enquanto essa configuração estava definida como. `true` Os registros eletrônicos contêm informações sobre todas as atividades do Amazon S3 associadas à AWS conta enquanto essa configuração estava definida`true`, não apenas atividades relacionadas às CodeDeploy implantações. <br />A configuração padrão é `false`.<br />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 CodeDeploy agente são armazenados.<br />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.<br />Esse arquivo contém o ID do processo (PID) do CodeDeploy agente. A configuração padrão é `'/opt/codedeploy-agent/state/.pid'`.<br />Essa configuração se aplica somente às instâncias Amazon Linux, Ubuntu Server e RHEL. | 
| **:program\_name:** | O nome do programa do CodeDeploy agente.<br />A configuração padrão é `codedeploy-agent`.<br />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.<br />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 CodeDeploy agente imprima arquivos de log de mensagens de depuração na instância.<br />A configuração padrão é `false`. | 
| **:wait\_between\_runs:** | O intervalo, em segundos, entre a consulta do CodeDeploy agente CodeDeploy para implantações pendentes.<br />Para a versão 2.0.x e posterior, a configuração padrão é. `30`<br />Para a versão 1.8.x e anteriores, 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). <br />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.<br />Disponível na versão 1.0.1.686 e em versões posteriores do agente do CodeDeploy. | 
| **:proxy\_uri:** | (Opcional) O proxy HTTP por meio do qual você deseja que o CodeDeploy agente se conecte AWS para suas CodeDeploy operações. Use um formato semelhante a `https://user:password@my.proxy:443/path?query`.<br />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 CodeDeploy agente arquive. Todas as revisões que excederem o número especificado serão excluídas. <br />Insira qualquer número inteiro positivo. Se nenhum valor for especificado, CodeDeploy reterá as cinco revisões mais recentes, além da revisão atualmente implantada. <br />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](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization) para configurar o controle de acesso e limitar a permissão da função ou do usuário do IAM que o CodeDeploy agente está usando. Para [Use CodeDeploy com a Amazon Virtual Private Cloud](vpc-endpoints.md), esse valor deverá ser `true`. <br />A configuração padrão é `false`. | 
| **:disable\_imds\_v1:** | Essa configuração está disponível com o CodeDeploy agente 1.7.0 e versões posteriores.<br />Defina como `true` para desabilitar o fallback para o IMDSv1 quando ocorrerem erros do IMDSv2. O padrão é `false` (habilitar o fallback). | 
| **:disable\_core\_dumps:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para suprimir os despejos principais. Definido como `false` para investigação de acidentes.<br />A configuração padrão é `true`. | 
| **:ativar\_porta\_de comando:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para ativar a interface de gerenciamento local somente de loopback (127.0.0.1) para consultar o status do agente e injetar comandos localmente.<br />A configuração padrão é `false`. | 
| **:reject\_symlinks\_in\_bundle:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para rejeitar pacotes que contenham links simbólicos ou hardlinks.<br />A configuração padrão é `false`. | 
| **:reject\_path\_traversal\_in\_bundle:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para rejeitar entradas de arquivamento que contenham `../` caminhos percorridos ou caminhos absolutos e campos de AppSpec origem que escapam da raiz do pacote.<br />A configuração padrão é `false`. | 
| **:reject\_unsafe\_permissions\_in\_bundle:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para rejeitar pacotes que contenham SUID/SGID arquivos ou modos de AppSpec permissão definidos SUID/SGID.<br />A configuração padrão é `false`. | 
| **:reject\_unconfined\_selinux\_em\_bundle:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para rejeitar pacotes que contenham arquivos com tipos MAC-disabling SELinux.<br />A configuração padrão é `false`. | 
| **:rejeitar alvos de permissão de link simbólico:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para rejeitar uma `permissions` entrada de AppSpec arquivo cujo destino é um link simbólico. Por padrão, o agente segue o link quando aplica alterações de propriedade, modo, ACL e SELinux.<br />A configuração padrão é `false`. | 
| **:ignore\_ownership\_in\_bundle:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para redefinir a propriedade dos arquivos extraídos `tar` e dos `tgz` pacotes `root` em vez de aplicar o ID do usuário e o ID do grupo registrados no arquivamento. Os arquivos nos `zip` pacotes são de propriedade de`root`, independentemente dessa configuração.<br />A configuração padrão é `false`. | 
| **:restringir\_agent\_dir\_permissions:** | Para a versão 2.0.x e posterior. Somente instâncias Linux.<br />Defina como `true` para restringir os diretórios e arquivos na raiz de instalação do agente ao acesso somente raiz, em vez dos modos legíveis mundialmente usados por padrão.<br />A configuração padrão é `false`. | 
| **:restrict\_log\_dir\_permissions:** | Para a versão 2.0.x e posterior. Somente instâncias Linux.<br />Defina como `true` para restringir o diretório de registros do agente, que contém o registro do agente e o registro do atualizador, ao acesso somente raiz, em vez dos modos legíveis por todos usados por padrão.<br />A configuração padrão é `false`. | 
| **:restrinja o ambiente do hook\_to\_allowlist:** | Para a versão 2.0.x e posterior.<br />Defina como `true` para executar ganchos de eventos de ciclo de vida com um ambiente mínimo que contenha somente as variáveis básicas do shell e as CodeDeploy variáveis de implantação. Por padrão, os ganchos herdam o ambiente completo do processo do agente.<br />A configuração padrão é `false`. | 
| **:strip\_loader\_env\_in\_hooks:** | Para a versão 2.0.x e posterior. Somente instâncias Linux.<br />Defina como `true` para remover as `LD_AUDIT` variáveis`LD_PRELOAD`,`LD_LIBRARY_PATH`, e do ambiente dos ganchos de eventos do ciclo de vida.<br />A configuração padrão é `false`. | 
| **:disable\_powershell\_profile\_in\_hooks:** | Para a versão 2.0.x e posterior. Somente instâncias do Windows Server.<br />Defina como `true` para executar ganchos de eventos `.ps1` de ciclo de vida com as opções e. `-NoProfile` `-NonInteractive` Por padrão, esses ganchos carregam o PowerShell perfil do usuário com o qual o agente é executado.<br />A configuração padrão é `false`. | 
| **:archive\_max\_extration\_size:** | Para a versão 2.0.x e posterior.<br />Define um limite para o tamanho declarado do pacote não comprimido. Se o conteúdo extraído exceder esse valor, a implantação falhará.<br />O padrão é sem limite (ilimitado). | 
| **:wait\_after\_error:** | O número de segundos que o agente espera após encontrar um erro antes de retomar a operação normal.<br />A configuração padrão é `30`. | 
| **:timeout do http\_read\_out:** | O tempo limite de leitura HTTP em segundos para chamadas de API de serviço.<br />A configuração padrão é `80`. | 
| **:kill\_agent\_max\_wait\_time\_seconds:** | O número máximo de segundos que o agente espera por um desligamento normal antes da finalização forçada. Para a versão 2.0.x e posterior, esse valor é limitado a 24 horas (86400 segundos).<br />A configuração padrão é `7200` (2 horas). | 
| **:habilitar\_log\_de\_implantações:** | Defina como `true` para gravar o registro agregado de implantações ()`codedeploy-agent-deployments.log`.<br />A configuração padrão é `true`. | 
| **:use\_fips\_mode:** | Defina como `true` para usar FIPS-compliant endpoints. Aplica-se somente às regiões dos EUA.<br />A configuração padrão é `false`. | 
| **:deploy\_control\_endpoint:** | (Opcional) Um URL de endpoint do plano de controle personalizado para o serviço. CodeDeploy <br />O padrão é não substituir (o agente resolve o endpoint da região). | 
| **:s3\_endpoint\_override:** | (Opcional) Um URL de endpoint personalizado do Amazon S3 para downloads de pacotes.<br />O padrão é não substituir (o agente resolve o endpoint do Amazon S3 da região). | 
| **:rastreamento\_de\_implantação em andamento:** | O nome do subdiretório usado para o estado de rastreamento da implantação.<br />A configuração padrão é `ongoing-deployment`. | 

## Tópicos relacionados
<a name="reference-agent-configuration-related-topics"></a>

[Trabalhando com o CodeDeploy agente](codedeploy-agent.md)

[Gerenciando operações de CodeDeploy agentes](codedeploy-agent-operations.md)