View a markdown version of this page

Wie benutzt man AWS AppConfig Agent zum Abrufen von Konfigurationsdaten - AWS AppConfig
Verwenden AWS AppConfig Agent für schrittweise Bereitstellungen auf Benutzer- oder Entitätsbasis

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 AWS AppConfig Agent 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 Agenteneinrichtung abgeschlossen haben, ist es einfacher, den Agenten zum Abrufen von Konfigurationsdaten zu verwenden, als APIs direkt 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 aus einer separaten Datei wird AWS-Konto nicht unterstützt.

Verwenden AWS AppConfig Agent für schrittweise Bereitstellungen auf Benutzer- oder Entitätsbasis

AWS AppConfig Der Agent unterstützt die Bereitstellung von Feature-Flag- 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 ein Segment, sobald er eine Konfigurationsversion erhält, während des gesamten Bereitstellungszeitraums weiterhin dieselbe Version erhält, unabhängig davon, welche Rechenressource seine Anforderungen bedient.

Bei schrittweisen Bereitstellungen auf Entitätsbasis wertet der AWS AppConfig Agent eine eindeutige Kennung (Entity-Id) aus, die mit jeder HTTP-Anfrage angegeben wird. Basierend auf dieser Kennung verwendet der Agent während des gesamten Bereitstellungszeitraums konsistent entweder die neue oder die vorherige Konfigurationsversion. Dieser Prozess stellt sicher, dass ein Benutzer, sobald er die aktualisierte Konfiguration erhalten hat, 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 Bereitstellungen auf Entitätsbasis in Betracht, wenn eine Konfiguration das Verhalten gegenüber Benutzern direkt verändert und wenn die Änderung des Blast-Radius (die sich vollständig auf bestimmte Benutzer und nicht auf alle Benutzer 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 Agentenversion 2.0.136060 oder höher erforderlich.

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

  • Eindeutige Identifikatoren 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 Identifikatoren clientseitig aus.

  • Während einer Bereitstellung verfolgt der AWS AppConfig Agent die Entitäten und bereitgestellten Konfigurationen. Dieses Tracking wird nur während eines Bereitstellungszeitraums beibehalten. Das Tracking endet, wenn die Bereitstellung abgeschlossen ist.

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

Ermöglicht schrittweise Bereitstellungen auf Entitätsbasis

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

  1. Aktualisieren Sie auf AWS AppConfig Agentenversion 2.0.136060 oder höher.

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

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 an Folgendes einbeziehen:

/Anwendungen/ {Anwendung} /Umgebungen/ {Umgebung} /Konfigurationen/ {Konfiguration}

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

  • Backend-Job-ID

  • Session-scoped Identifier (falls zutreffend)