View a markdown version of this page

Como usar AWS AppConfig Agente para recuperar dados de configuração - AWS AppConfig
Utilizar AWS AppConfig Agente para implantações graduais baseadas em usuários ou entidades

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

Como usar AWS AppConfig Agente para recuperar dados de configuração

O AWS AppConfig Agente é o método recomendado para recuperar sinalizadores de AWS AppConfig recursos ou dados de configuração de formato livre. O agente é compatível com todas as formas de AWS computação, incluindo Amazon EC2, Amazon ECS, Amazon EKS e Lambda. Depois de concluir a configuração inicial do agente, usar o agente para recuperar dados de configuração é mais simples do que chamar AWS AppConfig APIs diretamente. O agente implementa automaticamente as melhores práticas e pode reduzir seu custo de uso AWS AppConfig como resultado de menos chamadas de API para recuperar configurações.

nota

Conta da AWS Não há suporte para recuperar dados de configuração de um arquivo separado.

Utilizar AWS AppConfig Agente para implantações graduais baseadas em usuários ou entidades

AWS AppConfig O agente suporta a implantação de sinalizadores de recursos ou dados de configuração de formato livre em segmentos específicos ou usuários individuais durante uma implantação gradual. Entity-based implantações graduais garantem que, uma vez que um usuário ou segmento receba uma versão de configuração, ele continue recebendo a mesma versão durante todo o período de implantação, independentemente de qual recurso computacional atenda às suas solicitações.

Com implantações graduais baseadas em entidades, o AWS AppConfig Agente avalia um identificador exclusivo (Entity-Id) fornecido com cada solicitação HTTP. Com base nesse identificador, o agente serve consistentemente a versão de configuração nova ou anterior durante todo o período de implantação. Esse processo garante que, uma vez que um usuário receba a configuração atualizada, ele continue a recebê-la. Também garante que os alarmes de reversão tenham tempo e dados suficientes para detectar problemas.

Considere implantações graduais baseadas em entidades se uma configuração mudar diretamente o comportamento voltado para o usuário e se a mudança no raio de explosão (afetando usuários específicos totalmente em vez de todos os usuários parcialmente) for aceitável para seu aplicativo.

Importante

Observe as seguintes informações importantes sobre implantações graduais baseadas em entidades:

  • Entity-based implantações graduais exigem a versão 2.0.136060 ou posterior do AWS AppConfig Agente.

  • Entity-Idaceita um tamanho máximo de string de 2 KB.

  • Os identificadores exclusivos não devem ser codificados ou de baixa cardinalidade.

  • Os identificadores não são enviados para o AWS AppConfig serviço. AWS AppConfig O agente avalia identificadores exclusivos do lado do cliente.

  • Durante uma implantação, o AWS AppConfig Agente acompanha as entidades e as configurações implantadas. Esse rastreamento é mantido somente durante um período de implantação. O rastreamento termina quando a implantação é concluída.

  • Cada instância de AWS AppConfig pesquisa o estado de implantação é independente, portanto, os agentes podem servir brevemente versões diferentes da mesma entidade à medida que a porcentagem de implantação muda. Essa janela é determinada pelo intervalo da pesquisa e por um curto período de sincronização. Você pode reduzi-lo definindo RequiredMinimumPollIntervalInSeconds a ação StartConfigurationSession da API. No entanto, intervalos mais curtos aumentam as taxas de chamadas da API, o que pode aumentar os custos e correr o risco de limitação. Escolha um intervalo de pesquisa que atenda às suas necessidades. Para obter mais informações, consulte StartConfigurationSession na AWS CLI Referência.

Habilitando implantações graduais baseadas em entidades

Para permitir implantações graduais baseadas em entidades:

  1. Atualize para a versão 2.0.136060 ou posterior do AWS AppConfig Agente.

  2. Forneça um identificador exclusivo no cabeçalho Entity-Id HTTP ao recuperar dados de configuração.

O exemplo de solicitação a seguir usa um endereço de e-mail para Entity-Id

GET /applications/myapp/environments/prod/configurations/featureflags HTTP/1.1
Host: localhost:2772
Entity-Id: example@AWS-example-email.com

Você pode incluir o Entity-Id cabeçalho nas solicitações para:

/aplicativos/ {Aplicativo} /ambientes/ {Ambiente} /configurações/ {Configuração}

Para ver exemplos de código comEntity-Id, consulteUsando o AWS AppConfig Agente para ler um perfil de configuração de formato livre.

O Entity-Id valor pode ser qualquer string que identifique de forma exclusiva uma entidade em seu sistema, como:

  • ID da do cliente

  • Endereço de e-mail

  • ID da conta

  • ID do trabalho de back-end

  • Session-scoped identificador (se apropriado)