View a markdown version of this page

Configurazione della AWS AppConfig Estensione Agent Lambda - 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à.

Configurazione della AWS AppConfig Estensione Agent Lambda

È possibile configurare l'estensione modificando le seguenti variabili di AWS Lambda ambiente. Per ulteriori informazioni, consulta Utilizzo delle variabili di AWS Lambda ambiente nella Guida per AWS Lambda gli sviluppatori.

Precaricamento dei dati di configurazione

La variabile di ambiente AWS_APPCONFIG_EXTENSION_PREFETCH_LIST può migliorare il tempo di avvio della funzione. Quando l'estensione AWS AppConfig Agent Lambda viene inizializzata, recupera la configurazione specificata AWS AppConfig prima che Lambda inizi a inizializzare la funzione e richiamare il gestore. In alcuni casi, i dati di configurazione sono già disponibili nella cache locale prima che la funzione li richieda.

Per utilizzare la funzionalità di prefetch, impostate il valore della variabile di ambiente sul percorso corrispondente ai dati di configurazione. Ad esempio, se la configurazione corrisponde a un'applicazione, un ambiente e un profilo di configurazione denominati rispettivamente «my_application», «my_environment» e «my_configuration_data», il percorso sarebbe. /applications/my_application/environments/my_environment/configurations/my_configuration_data È possibile specificare più elementi di configurazione elencandoli come un elenco separato da virgole (se il nome di una risorsa include una virgola, utilizza il valore ID della risorsa anziché il nome).

Accesso ai dati di configurazione da un altro account

L'estensione AWS AppConfig Agent Lambda può recuperare i dati di configurazione da un altro account specificando un ruolo IAM che concede le autorizzazioni ai dati. Per configurarlo, segui questi passaggi:

  1. Nell'account in cui AWS AppConfig viene utilizzato per gestire i dati di configurazione, crea un ruolo con una policy di fiducia che conceda all'account che esegue la funzione Lambda l'accesso alle appconfig:GetLatestConfiguration azioni appconfig:StartConfigurationSession e, insieme agli ARN parziali o completi corrispondenti alle risorse di configurazione. AWS AppConfig

  2. Nell'account che esegue la funzione Lambda, aggiungi la variabile di AWS_APPCONFIG_EXTENSION_ROLE_ARN ambiente alla funzione Lambda con l'ARN del ruolo creato nel passaggio 1.

  3. (Facoltativo) Se necessario, è possibile specificare un ID esterno utilizzando la AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID variabile di ambiente. Analogamente, il nome di una sessione può essere configurato utilizzando la variabile di AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME ambiente.

Nota

Osservare le seguenti informazioni.

  • L'estensione AWS AppConfig Agent Lambda può recuperare dati solo da un account. Se si specifica un ruolo IAM, l'estensione non sarà in grado di recuperare i dati di configurazione dall'account in cui è in esecuzione la funzione Lambda.

  • AWS Lambda registra le informazioni sull'estensione AWS AppConfig Agent Lambda e sulla funzione Lambda utilizzando Amazon Logs. CloudWatch

  • La tabella seguente include una colonna di valori di esempio. A seconda della risoluzione del monitor, potrebbe essere necessario scorrere fino alla fine della tabella e quindi scorrere verso destra per visualizzare la colonna.

Variabile di ambiente Informazioni Valore predefinito Valori di esempio

AWS_APPCONFIG_EXTENSION_EXPERIMENT_ASSIGNMENT_LOG_DESTINATION

Questa variabile di ambiente consente all' AWS AppConfig agente di registrare i record di assegnazione degli esperimenti, che registrano ogni occorrenza di un trattamento sperimentale assegnato a una determinata entità in un determinato momento. Valori possibili: file:<path>/ indica una directory di base in cui i record di assegnazione vengono scritti su disco; stderr indica che i record di assegnazione vengono emessi su stderr. Questa funzionalità richiede l'estensione AWS AppConfig Agent Lambda versione 2.0.20159 o successiva.

Nessuno

file:/tmp/aws-appconfig/assignments/

stderr

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Questa variabile di ambiente specifica la porta su cui viene eseguito il server HTTP locale che ospita l'estensione.

2772 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Questa variabile di ambiente specifica il livello di dettaglio registrato dall'agente. Ogni livello include il livello corrente e tutti i livelli superiori. Il valore non fa distinzione tra maiuscole e minuscole. Dal più dettagliato al meno dettagliato, i livelli di registro sono: tracedebug,,info,warn, errorfatal, enone. Il trace registro include informazioni dettagliate, comprese le informazioni sulla tempistica, sull'agente.

Info

trace

debug

Info

avviso

error

fatali

nessuno

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

Questa variabile di ambiente configura il numero massimo di connessioni da cui l'estensione utilizza per recuperare le configurazioni. AWS AppConfig

3 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Questa variabile di ambiente controlla la frequenza con cui l'agente esegue il polling AWS AppConfig per i dati di configurazione aggiornati. È possibile specificare un numero di secondi per l'intervallo. È inoltre possibile specificare un numero con un'unità di tempo: s per secondi, m per minuti e h per ore. Se non viene specificata un'unità, per impostazione predefinita l'agente utilizza i secondi. Ad esempio, 60, 60s e 1 m corrispondono allo stesso intervallo di polling.

45

45

45 secondi

5 min

1 ora

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

Questa variabile di ambiente controlla il tempo massimo, in millisecondi, in cui l'estensione attende una risposta dal AWS AppConfig momento dell'aggiornamento dei dati nella cache. Se AWS AppConfig non risponde nel periodo di tempo specificato, l'estensione salta questo intervallo di polling e restituisce i dati memorizzati nella cache precedentemente aggiornati.

3000 ms

3000

300 ms

5s

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Questa variabile di ambiente specifica i dati di configurazione richiesti dall'agente non AWS AppConfig appena viene avviato. È possibile fornire più identificatori di configurazione in un elenco separato da virgole. Il precaricamento dei dati di configurazione da AWS AppConfig può ridurre significativamente il tempo di avvio a freddo della funzione.

Nessuno

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Questa variabile di ambiente specifica le intestazioni richieste dal proxy a cui si fa riferimento nella variabile di ambiente. AWS_APPCONFIG_EXTENSION_PROXY_URL Il valore è un elenco di intestazioni separate da virgole. Nessuno

intestazione: valore

h1: v1, h2: v2

AWS_APPCONFIG_EXTENSION_PROXY_URL Questa variabile di ambiente specifica l'URL del proxy da utilizzare per le connessioni dall'estensione a. AWS AppConfig Servizi AWSHTTPSe gli HTTP URL sono supportati. Nessuno

http://localhoste gli URL sono supportati. ----sep----:7474

https://my-proxy.example.com

AWS_APPCONFIG_EXTENSION_ROLE_ARN Questa variabile di ambiente specifica l'ARN del ruolo IAM corrispondente a un ruolo che deve essere assunto dall' AWS AppConfig estensione per recuperare la configurazione. Nessuno arn:aws:iam: :123456789012: role/MyRole
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Questa variabile di ambiente specifica l'id esterno da utilizzare insieme al ruolo assunto ARN. Nessuno MyExternalId
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Questa variabile di ambiente specifica il nome della sessione da associare alle credenziali per il ruolo IAM assunto. Nessuno AWSAppConfigAgentSession
AWS_APPCONFIG_EXTENSION_SERVICE_REGION Questa variabile di ambiente specifica una regione alternativa che l'estensione deve utilizzare per chiamare il servizio. AWS AppConfig Se non è definita, l'estensione utilizza l'endpoint nella regione corrente. Nessuno

us-east-1

eu-west-1

AWS_APPCONFIG_EXTENSION_MANIFEST

Questa variabile di ambiente configura l' AWS AppConfig agente per sfruttare le funzionalità aggiuntive per configurazione, come il recupero di più account e il salvataggio della configurazione su disco. Per ulteriori informazioni su queste caratteristiche, consultare Utilizzo di un manifesto per abilitare funzionalità di recupero aggiuntive.

Nessuno

Quando si utilizza la configurazione come manifesto:. AWS AppConfig MyApp:MyEnv:MyManifestConfig

Quando si carica il manifest dal disco: file:/path/to/manifest.json

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

Questa variabile di ambiente configura l' AWS AppConfig Agent in modo che attenda l'elaborazione del manifest prima di completare l'avvio.

true

true

false