View a markdown version of this page

Cómo usar el AWS AppConfig agente para recuperar los datos de configuración - AWS AppConfig
Uso AWS AppConfig del agente para despliegues graduales basados en usuarios o entidades

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo usar el AWS AppConfig agente para recuperar los datos de configuración

El AWS AppConfig agente es el método recomendado para recuperar indicadores de AWS AppConfig características o datos de configuración de formato libre. El agente es compatible con todas las formas de AWS procesamiento, incluidas Amazon EC2, Amazon ECS, Amazon EKS y Lambda. Tras completar la configuración inicial del agente, utilizar el agente para recuperar los datos de configuración es más sencillo que realizar una llamada directa. AWS AppConfig APIs El agente implementa automáticamente las mejores prácticas y puede reducir el costo de uso, AWS AppConfig ya que se requieren menos llamadas a la API para recuperar las configuraciones.

nota

Cuenta de AWS No se admite la recuperación de los datos de configuración de un sitio independiente.

Uso AWS AppConfig del agente para despliegues graduales basados en usuarios o entidades

AWS AppConfig El agente permite implementar indicadores de funciones o datos de configuración de formato libre en segmentos específicos o usuarios individuales durante una implementación gradual. Las implementaciones graduales basadas en entidades garantizan que, una vez que un usuario o segmento reciba una versión de configuración, siga recibiendo la misma versión durante todo el período de implementación, independientemente del recurso informático que atienda sus solicitudes.

Con las implementaciones graduales basadas en entidades, AWS AppConfig Agent evalúa un identificador único () Entity-Id suministrado con cada solicitud HTTP. En función de este identificador, el agente suministra de forma coherente la versión de configuración nueva o anterior durante todo el período de despliegue. Este proceso garantiza que, una vez que un usuario reciba la configuración actualizada, continúe recibiéndola. También garantiza que las alarmas de reversión dispongan del tiempo y los datos suficientes para detectar problemas.

Considere la posibilidad de implementar implementaciones graduales basadas en entidades si una configuración cambia directamente el comportamiento de cara al usuario y si el cambio en el radio de alcance (que afecta a usuarios específicos en su totalidad y no a todos los usuarios parcialmente) es aceptable para su aplicación.

importante

Tenga en cuenta la siguiente información importante sobre las implementaciones graduales basadas en entidades:

  • Las implementaciones graduales basadas en entidades requieren AWS AppConfig la versión 2.0.136060 del Agente o posterior.

  • Entity-Idacepta un tamaño de cadena máximo de 2 KB.

  • Los identificadores únicos no deben estar codificados de forma rígida ni tener una cardinalidad baja.

  • Los identificadores no se envían al servicio. AWS AppConfig AWS AppConfig El agente evalúa los identificadores únicos por parte del cliente.

  • Durante una implementación, el AWS AppConfig agente realiza un seguimiento de las entidades y las configuraciones implementadas. Este seguimiento se mantiene solo durante un período de despliegue. El seguimiento finaliza cuando se completa la implementación.

  • Cada instancia de AWS AppConfig sondea el estado del despliegue de forma independiente, por lo que los agentes pueden ofrecer brevemente diferentes versiones de la misma entidad a medida que cambia el porcentaje de despliegue. Esta ventana viene determinada por el intervalo de sondeo y por un breve período de sincronización. Puedes reducirlo configurando RequiredMinimumPollIntervalInSeconds la acción de la StartConfigurationSessionAPI. Sin embargo, los intervalos más cortos aumentan las tasas de llamadas a la API, lo que puede aumentar los costes y correr el riesgo de que se limiten. Elija un intervalo de sondeo que cumpla con sus requisitos. Para obtener más información, consulte StartConfigurationSessionla AWS CLI Referencia.

Habilitar despliegues graduales basados en entidades

Para habilitar los despliegues graduales basados en entidades:

  1. Actualice el AWS AppConfig agente a la versión 2.0.136060 o posterior.

  2. Proporcione un identificador único en el encabezado Entity-Id HTTP al recuperar los datos de configuración.

En el siguiente ejemplo de solicitud se utiliza una dirección de correo electrónico para Entity-Id

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

Puedes incluir el Entity-Id encabezado en las solicitudes para:

/applications/ {Aplicación} /entornos/ {Entorno} /configurations/ {Configuración}

Para ver ejemplos de Entity-Id código Uso AWS AppConfig del agente para leer un perfil de configuración de formato libre con, consulte.

El Entity-Id valor puede ser cualquier cadena que identifique de forma exclusiva a una entidad del sistema, por ejemplo:

  • ID de de cliente

  • Dirección de correo electrónico

  • ID de cuenta

  • ID de trabajo de back-end

  • Identificador del ámbito de la sesión (si corresponde)