Configuração da extensão do Lambda do AWS AppConfig Agent - AWS AppConfig

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

Configuração da extensão do Lambda do AWS AppConfig Agent

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 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_application”, “my_environment” e “my_configuration_data”, 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 IAM função que conceda permissões 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.

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

  3. (Opcional) Se necessário, um ID externo 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 uma IAM função, a extensão não poderá recuperar dados de configuração da conta na qual a função 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

Variável de ambiente Detalhes Valor padrão

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Essa variável de ambiente especifica a porta na qual o HTTP servidor local que hospeda a extensão é executado.

2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Essa variável de ambiente especifica quais registros AWS AppConfig específicos da extensão são enviados ao Amazon CloudWatch Logs para uma função. Os valores válidos que não diferenciam maiúsculas e minúsculas são: debug, info, warn, error e none. A depuração inclui informações detalhadas, inclusive informações de tempo, sobre a extensão.

info

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

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Essa variável de ambiente controla a frequência com que a extensão pesquisa AWS AppConfig uma configuração atualizada em segundos.

45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

Essa variável de ambiente controla o tempo máximo, em milissegundos, em que 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.

3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Esta variável de ambiente especifica os dados de configuração que a extensão começa a recuperar antes que a função seja inicializada e o manipulador seja executado. Ela pode reduzir significativamente o tempo de inicialização a frio da função.

Nenhum
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Esta variável de ambiente especifica os cabeçalhos exigidos pelo proxy referenciado na variável de ambiente AWS_APPCONFIG_EXTENSION_PROXY_URL. O valor é uma lista de cabeçalhos separados por vírgula. Cada cabeçalho usa o formato a seguir:
"header: value"
Nenhum
AWS_APPCONFIG_EXTENSION_PROXY_URL Essa variável de ambiente especifica o proxy URL a ser usado para conexões da AWS AppConfig extensão a. Serviços da AWSHTTPSe HTTP URLs são suportados. Nenhum
AWS_APPCONFIG_EXTENSION_ROLE_ARN Essa variável de ambiente especifica a IAM função ARN correspondente a uma função que deve ser assumida pela AWS AppConfig extensão para recuperar a configuração. Nenhum
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Essa variável de ambiente especifica o ID externo a ser usado em conjunto com a função assumida. ARN Nenhum
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Essa variável de ambiente especifica o nome da sessão a ser associado às credenciais da função assumidaIAM. Nenhum
AWS_APPCONFIG_EXTENSION_SERVICE_REGION 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

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. Você pode inserir um dos seguintes valores:

  • "app:env:manifest-config"

  • "file:/fully/qualified/path/to/manifest.json"

Para obter mais informações sobre esses recursos, consulte Usando um manifesto para habilitar recursos adicionais de recuperação.

verdadeiro

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.

verdadeiro