View a markdown version of this page

Como usar o AWS AppConfig Agent para recuperar dados de configuração - AWS AppConfig
Usando o AWS AppConfig Agent 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 o AWS AppConfig Agent 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 diretamente. AWS AppConfig APIs 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 as configurações.

nota

A recuperação de dados de configuração de um arquivo separado Conta da AWS não é suportada.

Usando o AWS AppConfig Agent 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 para segmentos específicos ou usuários individuais durante uma implantação gradual. As implantações graduais baseadas em entidades garantem que, quando um usuário ou segmento recebe 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 fornece 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 o 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 alterar diretamente o comportamento voltado para o usuário e se a mudança no raio de explosão (afetando totalmente usuários específicos, em vez de afetar parcialmente todos os usuários) for aceitável para seu aplicativo.

Importante

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

  • Implantações graduais baseadas em entidades exigem a versão 2.0.136060 ou AWS AppConfig posterior do Agente.

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

  • Os identificadores exclusivos não devem ser codificados ou ter 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 das AWS AppConfig pesquisas para implantação é independente, portanto, os agentes podem fornecer 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 configurando RequiredMinimumPollIntervalInSeconds a ação StartConfigurationSessionda API. No entanto, intervalos mais curtos aumentam as taxas de chamadas da API, o que pode aumentar os custos e aumentar o risco de limitação. Escolha um intervalo de votação que atenda às suas necessidades. Para obter mais informações, consulte StartConfigurationSessionna AWS CLI Referência.

Possibilitando 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 Agent.

  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:

/applications/ {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

  • Identificador com escopo de sessão (se apropriado)