

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

# Configurando a extensão do AWS AppConfig Agent Lambda
<a name="appconfig-integration-lambda-extensions-config"></a>

Você pode configurar a extensão alterando as seguintes variáveis de AWS Lambda ambiente. Para obter mais informações, consulte [Usando variáveis de AWS Lambda ambiente](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) no *Guia do AWS Lambda desenvolvedor*. 

**Pré-busca de dados de configuração**

A variável de ambiente `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST` pode melhorar o tempo de inicialização da sua função. Quando a extensão do AWS AppConfig Agent Lambda é inicializada, ela recupera a configuração especificada antes de o AWS AppConfig Lambda começar a inicializar sua função e invocar seu manipulador. Em alguns casos, os dados de configuração já estão disponíveis no cache local antes que sua função os solicite. 

Para usar o recurso de pré-busca, defina o valor da variável de ambiente para o caminho correspondente aos seus dados de configuração. Por exemplo, se sua configuração corresponder a um aplicativo, ambiente e perfil de configuração denominados respectivamente “my\$1application”, “my\$1environment” e “my\$1configuration\$1data”, o caminho será `/applications/my_application/environments/my_environment/configurations/my_configuration_data`. Você pode especificar vários itens de configuração listando-os como uma lista separada por vírgulas (se você tiver um nome de recurso que inclua uma vírgula, use o valor do ID do recurso em vez do nome). 

**Acesso a dados de configuração a partir de outra conta**

A extensão do AWS AppConfig Agent Lambda pode recuperar dados de configuração de outra conta especificando uma função do IAM que concede [permissões](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_permissions-to-switch.html) aos dados. Para configurá-la, siga estas etapas: 

1. Na conta em que AWS AppConfig é usada para gerenciar os dados de configuração, crie uma função com uma política de confiança que conceda à conta que executa a função Lambda acesso às `appconfig:GetLatestConfiguration` ações `appconfig:StartConfigurationSession` e, junto com a parte ou a totalidade ARNs correspondente aos recursos de AWS AppConfig configuração.

1. Na conta que executa a função do Lambda, adicione a variável de ambiente `AWS_APPCONFIG_EXTENSION_ROLE_ARN` à função do Lambda com o ARN da função criada na etapa 1.

1. (Opcional) Se necessário, um [ID externo](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) pode ser especificado usando a variável de ambiente `AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID`. Da mesma forma, um nome de sessão pode ser configurado usando a variável de ambiente `AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME`.

**nota**  
Observe as seguintes informações:  
A extensão do AWS AppConfig Agent Lambda só pode recuperar dados de uma conta. Se você especificar um perfil do IAM, a extensão não poderá recuperar dados de configuração da conta na qual a função do Lambda está sendo executada.
AWS Lambda registra informações sobre a extensão do AWS AppConfig Agent Lambda e a função Lambda usando o Amazon Logs. CloudWatch 
A tabela a seguir inclui uma coluna de **valores de amostra**. Dependendo da resolução do monitor, talvez seja necessário rolar até a parte inferior da tabela e depois rolar para a direita para ver a coluna.


****  

| Variável de ambiente | Detalhes | Valor padrão  | Exemplos de valores | 
| --- | --- | --- | --- | 
|  `AWS_APPCONFIG_EXTENSION_HTTP_PORT`  |  Esta variável de ambiente especifica a porta na qual é executado o servidor HTTP local que hospeda a extensão.  | 2772 | 2772 | 
|  `AWS_APPCONFIG_EXTENSION_LOG_LEVEL`  |  Esta variável de ambiente especifica o nível de detalhes que o agente registra. Cada nível inclui o nível atual e todos os níveis superiores. O valor diferencia maiúsculas de minúsculas. Do mais detalhado ao menos detalhado, os níveis de log são: `trace`, `debug`, `info`, `warn`, `error`, `fatal` e `none`. O log do `trace` contém informações detalhadas, incluindo informações de tempo, sobre o agente.  |  info  | trace depurar info warn erro fatal nenhuma | 
|  `AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS`  |  Esta variável de ambiente configura o número máximo de conexões que a extensão usa para recuperar as configurações do AWS AppConfig.   | 3 | 3 | 
|  `AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS`  |  Essa variável de ambiente controla a frequência com que o agente pesquisa dados AWS AppConfig de configuração atualizados. É possível especificar um número de segundos para o intervalo. Você também pode especificar um número com uma unidade de tempo: s para segundos, m para minutos, e h para horas. Se nenhuma unidade for especificada, o agente usará segundos como padrão. Por exemplo, 60, 60 s e 1 min resultam no mesmo intervalo de pesquisa.   | 45 | 4545s5 minutos1h | 
|  `AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS`  |  Essa variável de ambiente controla o tempo máximo, em milissegundos, do qual a extensão espera por uma resposta AWS AppConfig ao atualizar os dados no cache. Se AWS AppConfig não responder no período de tempo especificado, a extensão ignora esse intervalo de pesquisa e retorna os dados em cache atualizados anteriormente.  | 3000ms | 3000300ms5s | 
|  `AWS_APPCONFIG_EXTENSION_PREFETCH_LIST`  |  Essa variável de ambiente especifica os dados de configuração que o agente solicita AWS AppConfig assim que é iniciado. Vários identificadores de configuração podem ser disponibilizados em uma lista separada por vírgulas. A pré-busca de dados de configuração do AWS AppConfig pode reduzir significativamente o tempo de inicialização a frio da sua função.  | Nenhum | MyApp:MyEnv:MyConfigabcd123:efgh456:ijkl789MyApp::Config1, ::Config2 MyEnv MyApp MyEnv | 
| AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1HEADERS | Esta variável de ambiente especifica os cabeçalhos exigidos pelo proxy referenciado na variável de ambiente AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1URL. O valor é uma lista de cabeçalhos separados por vírgula. | Nenhum | header: valueh1: v1, h2: v2 | 
| AWS\$1APPCONFIG\$1EXTENSION\$1PROXY\$1URL | Essa variável de ambiente especifica a URL do proxy a ser usada para conexões da AWS AppConfig extensão a. Serviços da AWSHTTPSe HTTP URLs são suportados. | Nenhum | http://localhost:7474https://my-proxy.example.com | 
| AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1ARN | Essa variável de ambiente especifica o ARN da função do IAM correspondente a uma função que deve ser assumida pela extensão para AWS AppConfig recuperar a configuração. | Nenhum | arn: aws: iam: :123456789012: role/ MyRole | 
| AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1EXTERNAL\$1ID | Esta variável de ambiente especifica o ID externo a ser usado em conjunto com o ARN da função assumida. | Nenhum | MyExternalId | 
| AWS\$1APPCONFIG\$1EXTENSION\$1ROLE\$1SESSION\$1NAME | Esta variável de ambiente especifica o nome da sessão a ser associado às credenciais do perfil do IAM assumido. | Nenhum | AWSAppConfigAgentSession | 
| AWS\$1APPCONFIG\$1EXTENSION\$1SERVICE\$1REGION | Essa variável de ambiente especifica uma região alternativa que a extensão deve usar para chamar o AWS AppConfig serviço. Quando indefinida, a extensão usa o endpoint na região atual. | Nenhum | us-east-1eu-west-1 | 
|  `AWS_APPCONFIG_EXTENSION_MANIFEST`  |  Essa variável de ambiente configura o AWS AppConfig Agente para aproveitar os recursos adicionais por configuração, como recuperações de várias contas e salvamento da configuração em disco. Para obter mais informações sobre esses recursos, consulte [Usar um manifesto para habilitar recursos de recuperação adicionais](appconfig-agent-how-to-use-additional-features.md).   | Nenhum | Ao usar a AWS AppConfig configuração como manifesto:`MyApp:MyEnv:MyManifestConfig`.Ao carregar o manifesto do disco: `file:/path/to/manifest.json` | 
|  `AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST`  |  Essa variável de ambiente configura o AWS AppConfig Agente para esperar até que o manifesto seja processado antes de concluir a inicialização.  | true | verdadeirofalse | 