View a markdown version of this page

Come usare AWS AppConfig Agente per recuperare i dati di configurazione - AWS AppConfig

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Come usare AWS AppConfig Agente per recuperare i dati di configurazione

L' AWS AppConfig Agent è il metodo consigliato per recuperare i flag di AWS AppConfig funzionalità o i dati di configurazione in formato libero. L'agente è supportato su tutte le forme di AWS elaborazione, tra cui Amazon EC2, Amazon ECS, Amazon EKS e Lambda. Dopo aver completato la configurazione iniziale dell'agente, utilizzare l'agente per recuperare i dati di configurazione è più semplice rispetto alla chiamata diretta alle API. AWS AppConfig L'agente implementa automaticamente le best practice e può ridurre i costi di utilizzo grazie AWS AppConfig al minor numero di chiamate API per il recupero delle configurazioni.

Nota

Il recupero dei dati di configurazione da un server separato non è supportato. Account AWS

Utilizzo AWS AppConfig Agente per implementazioni graduali basate su utenti o entità

AWS AppConfig L'agente supporta l'implementazione di feature flag o dati di configurazione in formato libero su segmenti specifici o singoli utenti durante un'implementazione graduale. Entity-based le implementazioni graduali assicurano che, una volta che un utente o un segmento riceve una versione di configurazione, continui a ricevere la stessa versione per tutto il periodo di distribuzione, indipendentemente dalla risorsa di calcolo che soddisfa le sue richieste.

Nelle distribuzioni graduali basate sulle entità, l' AWS AppConfig agente valuta un identificatore univoco () fornito con ogni richiesta HTTP. Entity-Id In base a questo identificatore, l'agente utilizza costantemente la versione di configurazione nuova o precedente per tutto il periodo di distribuzione. Questo processo garantisce che, una volta ricevuta la configurazione aggiornata, l'utente continui a riceverla. Garantisce inoltre che gli allarmi di rollback dispongano di tempo e dati sufficienti per rilevare i problemi.

Prendi in considerazione le implementazioni graduali basate sulle entità se una configurazione modifica direttamente il comportamento rivolto agli utenti e se la modifica del raggio di esplosione (che ha un impatto completo su utenti specifici anziché parzialmente su tutti gli utenti) è accettabile per la tua applicazione.

Importante

Prendi nota delle seguenti importanti informazioni sulle distribuzioni graduali basate sulle entità:

  • Entity-based le distribuzioni graduali richiedono AWS AppConfig la versione dell'agente 2.0.136060 o successiva.

  • Entity-Idaccetta una dimensione massima di stringa di 2 KB.

  • Gli identificatori univoci non devono essere codificati o a bassa cardinalità.

  • Gli identificatori non vengono inviati al servizio. AWS AppConfig AWS AppConfig L'agente valuta gli identificatori univoci sul lato client.

  • Durante una distribuzione, l' AWS AppConfig agente tiene traccia delle entità e delle configurazioni distribuite. Questo monitoraggio viene mantenuto solo durante il periodo di distribuzione. Il monitoraggio termina al termine della distribuzione.

  • Ogni istanza dei AWS AppConfig sondaggi per la distribuzione è indipendente, pertanto gli agenti possono fornire per breve tempo versioni diverse della stessa entità man mano che la percentuale di distribuzione cambia. Questa finestra è determinata dall'intervallo di polling e da un breve periodo di sincronizzazione. È possibile ridurlo impostando l'azione RequiredMinimumPollIntervalInSeconds StartConfigurationSession API. Tuttavia, intervalli più brevi aumentano i tassi di chiamata alle API, il che può aumentare i costi e rischiare la limitazione. Scegli un intervallo di sondaggio che soddisfi i tuoi requisiti. Per ulteriori informazioni, consulta la StartConfigurationSession sezione AWS CLI Riferimenti.

Abilitazione di implementazioni graduali basate sulle entità

Per abilitare le implementazioni graduali basate sulle entità:

  1. Aggiornamento alla versione AWS AppConfig dell'agente 2.0.136060 o successiva.

  2. Fornisci un identificatore univoco nell'intestazione Entity-Id HTTP quando recuperi i dati di configurazione.

La seguente richiesta di esempio utilizza un indirizzo email per Entity-Id

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

Puoi includere l'Entity-Idintestazione nelle richieste a:

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

Per visualizzare esempi di codice Entity-Id Utilizzo di AWS AppConfig Agent per leggere un profilo di configurazione in formato libero con, vedere.

Il Entity-Id valore può essere qualsiasi stringa che identifica in modo univoco un'entità nel sistema, ad esempio:

  • ID cliente

  • Indirizzo e-mail

  • ID account

  • ID del lavoro di backend

  • Session-scoped identificatore (se appropriato)