View a markdown version of this page

Wie benutzt man den AWS AppConfig Agenten zum Abrufen von Konfigurationsdaten - AWS AppConfig

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Wie benutzt man den AWS AppConfig Agenten zum Abrufen von Konfigurationsdaten

Der AWS AppConfig Agent ist die empfohlene Methode zum Abrufen von AWS AppConfig Feature-Flags oder Freiform-Konfigurationsdaten. Der Agent wird auf allen Arten von AWS Compute unterstützt, einschließlich Amazon EC2, Amazon ECS, Amazon EKS und Lambda. Nachdem Sie die anfängliche Einrichtung des Agenten abgeschlossen haben, ist es einfacher, den Agenten zum Abrufen von Konfigurationsdaten zu verwenden, als direkt APIs aufzurufen AWS AppConfig . Der Agent implementiert automatisch bewährte Methoden und kann Ihre Nutzungskosten senken, AWS AppConfig da weniger API-Aufrufe zum Abrufen von Konfigurationen erforderlich sind.

Anmerkung

Das Abrufen von Konfigurationsdaten von einem separaten Gerät wird AWS-Konto nicht unterstützt.

Verwendung des AWS AppConfig Agenten für schrittweise Bereitstellungen auf Benutzer- oder Entitätsbasis

AWS AppConfig Der Agent unterstützt die Bereitstellung von Feature-Flags oder Freiform-Konfigurationsdaten für bestimmte Segmente oder einzelne Benutzer während einer schrittweisen Einführung. Entity-based Schrittweise Bereitstellungen stellen sicher, dass ein Benutzer oder Segment, sobald er eine Konfigurationsversion erhält, auch während des gesamten Bereitstellungszeitraums dieselbe Version erhält, unabhängig davon, welche Rechenressource seine Anfragen bearbeitet.

Bei entitätsbasierten schrittweisen Bereitstellungen wertet der AWS AppConfig Agent eine eindeutige Kennung (Entity-Id) aus, die mit jeder HTTP-Anfrage bereitgestellt wird. Auf der Grundlage dieser Kennung stellt der Agent während des gesamten Bereitstellungszeitraums konsistent entweder die neue oder die vorherige Konfigurationsversion bereit. Dieser Prozess stellt sicher, dass ein Benutzer, sobald er die aktualisierte Konfiguration erhält, sie auch weiterhin erhält. Außerdem wird sichergestellt, dass Rollback-Alarme über ausreichend Zeit und Daten verfügen, um Probleme zu erkennen.

Ziehen Sie schrittweise Implementierungen auf Entitätsbasis in Betracht, wenn eine Konfiguration das Verhalten der Benutzer direkt ändert und wenn die Änderung des Explosionsradius (die sich auf bestimmte Benutzer vollständig und nicht auf alle Benutzer nur teilweise auswirkt) für Ihre Anwendung akzeptabel ist.

Wichtig

Beachten Sie die folgenden wichtigen Informationen zu entitätsbasierten schrittweisen Bereitstellungen:

  • Entity-based Für schrittweise Bereitstellungen ist die AWS AppConfig Agent-Version 2.0.136060 oder höher erforderlich.

  • Entity-Idakzeptiert eine maximale Zeichenkettengröße von 2 KB.

  • Eindeutige Kennungen dürfen nicht hartcodiert sein oder eine niedrige Kardinalität aufweisen.

  • Identifikatoren werden nicht an den Dienst gesendet. AWS AppConfig AWS AppConfig Der Agent wertet eindeutige Kennungen clientseitig aus.

  • Während einer Bereitstellung verfolgt der AWS AppConfig Agent die Entitäten und bereitgestellten Konfigurationen. Diese Nachverfolgung wird nur während eines Bereitstellungszeitraums aufrechterhalten. Die Nachverfolgung endet, wenn die Bereitstellung abgeschlossen ist.

  • Jede Instanz AWS AppConfig fragt den Bereitstellungsstatus unabhängig ab, sodass Agenten kurzzeitig verschiedene Versionen derselben Entität bereitstellen können, wenn sich der Bereitstellungsprozentsatz ändert. Dieses Fenster wird durch das Abfrageintervall und einen kurzen Synchronisierungszeitraum bestimmt. Sie können es reduzieren, indem RequiredMinimumPollIntervalInSeconds Sie die StartConfigurationSessionAPI-Aktion festlegen. Kürzere Intervalle erhöhen jedoch die API-Aufrufraten, was die Kosten und das Risiko einer Drosselung erhöhen kann. Wählen Sie ein Abfrageintervall, das Ihren Anforderungen entspricht. Weitere Informationen finden Sie StartConfigurationSessionin der AWS CLI Referenz.

Aktivierung entitätsbasierter schrittweiser Bereitstellungen

So ermöglichen Sie schrittweise Bereitstellungen auf Entitätsbasis:

  1. Aktualisieren Sie auf AWS AppConfig Agent-Version 2.0.136060 oder höher.

  2. Geben Sie beim Abrufen von Konfigurationsdaten eine eindeutige Kennung im Entity-Id HTTP-Header ein.

Die folgende Beispielanforderung verwendet eine E-Mail-Adresse für Entity-Id

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

Sie können den Entity-Id Header in Anfragen einbeziehen an:

/applications/ {Application} /environments/ {Environment} /configurations/ {Configuration}

Informationen zum Anzeigen von Entity-Id Codebeispielen Verwenden von AWS AppConfig Agent zum Lesen eines Freiform-Konfigurationsprofils mit finden Sie unter.

Bei dem Entity-Id Wert kann es sich um eine beliebige Zeichenfolge handeln, die eine Entität in Ihrem System eindeutig identifiziert, z. B.:

  • Kunden-ID

  • E-Mail-Adresse

  • Konto-ID

  • Job-ID im Backend

  • Session-scoped Kennung (falls zutreffend)