View a markdown version of this page

Comment utiliser l' AWS AppConfig agent pour récupérer les données de configuration - AWS AppConfig
Utilisation de l' AWS AppConfig agent pour des déploiements progressifs basés sur des utilisateurs ou des entités

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment utiliser l' AWS AppConfig agent pour récupérer les données de configuration

L' AWS AppConfig agent est la méthode recommandée pour récupérer les indicateurs de AWS AppConfig fonctionnalités ou les données de configuration sous forme libre. L'agent est pris en charge sur toutes les formes de AWS calcul, notamment Amazon EC2, Amazon ECS, Amazon EKS et Lambda. Une fois la configuration initiale de l'agent terminée, il est plus simple d'utiliser l'agent pour récupérer les données de configuration que d'appeler directement AWS AppConfig APIs. L'agent met automatiquement en œuvre les meilleures pratiques et peut réduire vos coûts d'utilisation AWS AppConfig en réduisant le nombre d'appels d'API pour récupérer les configurations.

Note

La récupération des données de configuration depuis un autre Compte AWS n'est pas prise en charge.

Utilisation de l' AWS AppConfig agent pour des déploiements progressifs basés sur des utilisateurs ou des entités

AWS AppConfig L'agent prend en charge le déploiement d'indicateurs de fonctionnalités ou de données de configuration sous forme libre vers des segments spécifiques ou des utilisateurs individuels lors d'un déploiement progressif. Les déploiements progressifs basés sur les entités garantissent qu'une fois qu'un utilisateur ou un segment reçoit une version de configuration, il continue à recevoir cette même version tout au long de la période de déploiement, quelle que soit la ressource de calcul qui répond à ses demandes.

Dans le cadre des déploiements progressifs basés sur les entités, AWS AppConfig l'agent évalue un identifiant unique (Entity-Id) fourni avec chaque requête HTTP. Sur la base de cet identifiant, l'agent gère systématiquement la nouvelle version de configuration ou la version précédente tout au long de la période de déploiement. Ce processus garantit qu'une fois qu'un utilisateur reçoit la configuration mise à jour, il continue de la recevoir. Cela garantit également que les alarmes d'annulation disposent de suffisamment de temps et de données pour détecter les problèmes.

Envisagez des déploiements progressifs basés sur des entités si une configuration modifie directement le comportement des utilisateurs et si la modification du rayon de propagation (impactant totalement certains utilisateurs plutôt que partiellement) est acceptable pour votre application.

Important

Notez les informations importantes suivantes concernant les déploiements progressifs basés sur des entités :

  • Les déploiements progressifs basés sur des entités nécessitent la version 2.0.136060 ou ultérieure de AWS AppConfig l'agent.

  • Entity-Idaccepte une taille de chaîne maximale de 2 Ko.

  • Les identifiants uniques ne doivent pas être codés en dur ou avoir une faible cardinalité.

  • Les identifiants ne sont pas envoyés au AWS AppConfig service. AWS AppConfig L'agent évalue les identifiants uniques côté client.

  • Au cours d'un déploiement, AWS AppConfig l'agent assure le suivi des entités et des configurations déployées. Ce suivi n'est maintenu que pendant une période de déploiement. Le suivi prend fin lorsque le déploiement est terminé.

  • Chaque instance AWS AppConfig interroge l'état du déploiement indépendamment, de sorte que les agents peuvent brièvement servir différentes versions de la même entité à mesure que le pourcentage de déploiement change. Cette fenêtre est déterminée par l'intervalle entre les sondages et une courte période de synchronisation. Vous pouvez le réduire RequiredMinimumPollIntervalInSeconds en définissant l'action de l'StartConfigurationSessionAPI. Cependant, des intervalles plus courts augmentent le taux d'appels d'API, ce qui peut augmenter les coûts et limiter les risques. Choisissez un intervalle de sondage qui répond à vos besoins. Pour plus d'informations, reportez-vous StartConfigurationSessionà la section AWS CLI Référence.

Permettre des déploiements progressifs basés sur les entités

Pour permettre des déploiements progressifs basés sur les entités :

  1. Effectuez la mise à jour vers la version 2.0.136060 ou ultérieure de l' AWS AppConfig agent.

  2. Fournissez un identifiant unique dans l'en-tête Entity-Id HTTP lors de la récupération des données de configuration.

L'exemple de demande suivant utilise une adresse e-mail pour Entity-Id

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

Vous pouvez inclure l'Entity-Iden-tête dans les demandes visant à :

/applications/ {Application} /environnements/ {Environnement} /configurations/ {Configuration}

Pour afficher des exemples de code avecEntity-Id, voirUtilisation de l' AWS AppConfig agent pour lire un profil de configuration de forme libre.

La Entity-Id valeur peut être n'importe quelle chaîne identifiant de manière unique une entité dans votre système, telle que :

  • ID du client

  • Adresse e-mail

  • ID de compte

  • ID de tâche du backend

  • Identifiant de la portée de la session (le cas échéant)