View a markdown version of this page

¿Cómo usarlo? AWS AppConfig Agente para recuperar los datos de configuración - AWS AppConfig

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 usarlo? AWS AppConfig Agente para recuperar los datos de configuración

El AWS AppConfig agente es el método recomendado para recuperar las marcas de AWS AppConfig función o los datos de configuración en 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, usar el agente para recuperar los datos de configuración es más sencillo que llamar AWS AppConfig directamente a las API. El agente implementa automáticamente las mejores prácticas y puede reducir el coste de uso AWS AppConfig al reducir el número de llamadas a la API para recuperar las configuraciones.

nota

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

Utilización AWS AppConfig Agente para despliegues graduales basados en usuarios o entidades

AWS AppConfig El agente admite la implementación de marcadores de funciones o datos de configuración de formato libre en segmentos específicos o usuarios individuales durante una implementación gradual. Entity-based Las implementaciones graduales garantizan que, una vez que un usuario o segmento reciba una versión de configuración, continúe recibiendo esa misma versión durante todo el período de implementación, independientemente del recurso informático que atienda sus solicitudes.

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

Considere la posibilidad de realizar despliegues graduales basados en entidades si una configuración cambia directamente el comportamiento de los usuarios y si el cambio en el radio de expansión (que afecta completamente a usuarios específicos en lugar de 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:

  • Entity-based las implementaciones graduales requieren la versión 2.0.136060 AWS AppConfig del agente o una posterior.

  • Entity-Idacepta un tamaño máximo de cadena 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 del lado 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 implementación. El seguimiento finaliza cuando se completa la implementación.

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

Permitir las implementaciones graduales basadas en entidades

Para habilitar las implementaciones graduales basadas en entidades:

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

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

El siguiente ejemplo de solicitud 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/ {Application} /environments/ {Environment} /configurations/ {Configuration}

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

  • Session-scoped identificador (si corresponde)