View a markdown version of this page

(Facoltativo) Utilizzo delle variabili di ambiente per la configurazione AWS AppConfig Agente per Amazon ECS e Amazon EKS - 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à.

(Facoltativo) Utilizzo delle variabili di ambiente per la configurazione AWS AppConfig Agente per Amazon ECS e Amazon EKS

È possibile configurare AWS AppConfig l'agente modificando le seguenti variabili di ambiente per il contenitore dell'agente.

Nota

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

ACCESS_TOKEN

Questa variabile di ambiente definisce un token che deve essere fornito quando si richiedono i dati di configurazione dal server HTTP dell'agente. Il valore del token deve essere impostato nell'intestazione di autorizzazione della richiesta HTTP con un tipo di autorizzazione pari a. Bearer Ecco un esempio.

GET /applications/my_app/... Host: localhost:2772 Authorization: Bearer <token value>
Nessuno MyAccessToken

BACKUP_DIRECTORY

Questa variabile di ambiente consente all' AWS AppConfig agente di salvare un backup di ogni configurazione recuperata nella directory specificata.

Importante

Le configurazioni di cui è stato eseguito il backup su disco non sono crittografate. Se la configurazione contiene dati sensibili, AWS AppConfig consiglia di applicare il principio del privilegio minimo con le autorizzazioni del file system. Per ulteriori informazioni, consulta Sicurezza in AWS AppConfig.

Nessuno //backups path/to

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 la versione AWS AppConfig dell'agente 2.0.175233 o successiva.

Nessuno

file:/tmp/aws-appconfig/assignments/

stderr

HTTP_PORT

Questa variabile di ambiente specifica la porta su cui viene eseguito il server HTTP dell'agente.

2772 2772

HTTP_HOST

La variabile HTTP_HOST controlla il modo in cui l' AWS AppConfig agente si collega alle interfacce di rete. Il comportamento di associazione varia in base all'ambiente di runtime per garantire sicurezza e accessibilità ottimali.

ECS, EKS

  • Associazione predefinita: tutte le interfacce di rete (0.0.0.0)

EC2 e on-prem

  • Associazione predefinita: solo localhost

  • Indirizzo IPv4:127.0.0. 1:2772

  • Indirizzo IPv6: [::1] :2772

Opzioni di configurazione personalizzate. È possibile sovrascrivere il comportamento predefinito utilizzando questi valori:

  • all(si lega a tutte le interfacce)

  • localhost(si lega esplicitamente alle interfacce localhost)

  • Indirizzo IP specifico (ad es.) 192.168.1.1

  • Nome host personalizzato

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

LOG_PATH

La posizione del disco in cui vengono scritti i log. Se non specificato, i log vengono scritti su stderr.

Nessuno

//.log path/to logs/agent

MANIFEST

Questa variabile di ambiente configura l' AWS AppConfig Agent 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

MAX_CONNECTIONS

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

3 3

POLL_INTERVAL

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 secondi

45

45 secondi

5 min

1 ora

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.

Nessuno

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

PRELOAD_BACKUPS

Se impostato sutrue, l' AWS AppConfig agente carica i backup di configurazione trovati BACKUP_DIRECTORY nella memoria e controlla immediatamente se esiste una versione più recente del servizio. Se impostato sufalse, l' AWS AppConfig Agent carica il contenuto di un backup di configurazione solo se non è in grado di recuperare i dati di configurazione dal servizio, ad esempio se c'è un problema con la rete.

true

true

false

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

intestazione: valore

h1: v1, h2: v2

PROXY_URL Questa variabile di ambiente specifica l'URL del proxy da utilizzare per le connessioni dall'agente a, tra cui. Servizi AWS AWS AppConfigHTTPSe gli HTTP URL sono supportati. Nessuno

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

https://my-proxy.example.com

REQUEST_TIMEOUT

Questa variabile di ambiente controlla la quantità di tempo da cui l'agente attende una risposta. AWS AppConfig Se il servizio non risponde, la richiesta ha esito negativo.

Se la richiesta riguarda il recupero iniziale dei dati, l'agente restituisce un errore all'applicazione.

Se il timeout si verifica durante un controllo in background dei dati aggiornati, l'agente registra l'errore e riprova dopo un breve ritardo.

È possibile specificare il numero di millisecondi per il timeout. È inoltre possibile specificare un numero con un'unità di tempo: ms per millisecondi e s per secondi. Se non viene specificata un'unità, per impostazione predefinita l'agente utilizza i millisecondi. Ad esempio, 5000, 5000 ms e 5 secondi danno come risultato lo stesso valore di timeout della richiesta.

3000 ms

3000

3000 ms

5s

ROLE_ARN Questa variabile di ambiente specifica l'Amazon Resource Name (ARN) di un ruolo IAM. AWS AppConfig L'agente assume questo ruolo per recuperare i dati di configurazione. Nessuno arn:aws:iam: :123456789012: role/MyRole
ROLE_EXTERNAL_ID Questa variabile di ambiente specifica l'ID esterno da utilizzare con il ruolo assunto ARN. Nessuno MyExternalId
ROLE_SESSION_NAME Questa variabile di ambiente specifica il nome della sessione da associare alle credenziali per il ruolo IAM assunto. Nessuno AWSAppConfigAgentSession
SERVICE_REGION Questa variabile di ambiente specifica un'alternativa Regione AWS che l' AWS AppConfig Agent utilizza per chiamare il servizio. AWS AppConfig Se non viene definita, l'agente tenta di determinare la regione corrente. In caso contrario, l'agente non si avvia. Nessuno

us-east-1

eu-west-1

WAIT_ON_MANIFEST

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

true

true

false