Utilizzo AWS AppConfig Agente con Amazon EC2 e macchine locali

Puoi integrarti AWS AppConfig con le applicazioni in esecuzione sulle tue istanze Linux di Amazon Elastic Compute Cloud (Amazon EC2) utilizzando Agent. AWS AppConfig L'agente migliora l'elaborazione e la gestione delle applicazioni nei seguenti modi:

*AWS AppConfig L'agente memorizza i dati nella cache la prima volta che il servizio recupera i dati di configurazione. Per questo motivo, la prima chiamata per recuperare i dati è più lenta delle chiamate successive.

Fase 1: (Obbligatorio) Creazione di risorse e configurazione delle autorizzazioni

Per l'integrazione AWS AppConfig con le applicazioni in esecuzione sulle tue istanze Amazon EC2, devi creare AWS AppConfig artefatti e dati di configurazione, inclusi flag di funzionalità o dati di configurazione in formato libero. Per ulteriori informazioni, consulta Creazione di flag di funzionalità e dati di configurazione in formato libero in AWS AppConfig.

Per recuperare i dati di configurazione ospitati da AWS AppConfig, le applicazioni devono essere configurate con accesso al piano dati. AWS AppConfig Per consentire l'accesso alle tue applicazioni, aggiorna la policy delle autorizzazioni IAM assegnata al ruolo dell'istanza Amazon EC2. In particolare, è necessario aggiungere le appconfig:GetLatestConfiguration azioni appconfig:StartConfigurationSession e alla policy. Ecco un esempio:

Per ulteriori informazioni sull'aggiunta di autorizzazioni a una policy, consulta Aggiungere e rimuovere le autorizzazioni di identità IAM nella IAM User Guide.

Fase 2: (Obbligatorio) Installazione e avvio AWS AppConfig Agente su istanze Amazon EC2

AWS AppConfig L'agente è ospitato in un bucket Amazon Simple Storage Service (Amazon S3) gestito da. AWS Utilizza la seguente procedura per installare la versione più recente dell'agente sulla tua istanza Linux. Se l'applicazione è distribuita su più istanze, è necessario eseguire questa procedura su ogni istanza che ospita l'applicazione.

sudo systemctl stop aws-appconfig-agent

Passaggio 3: (facoltativo, ma consigliato) Invio dei file di registro ai CloudWatch log

Per impostazione predefinita, AWS AppConfig l'agente pubblica i log su STDERR. Systemd reindirizza STDOUT e STDERR per tutti i servizi in esecuzione sull'istanza Linux al journal systemd. È possibile visualizzare e gestire i dati di registro nel journal systemd se si esegue Agent solo su una o due istanze. AWS AppConfig Una soluzione migliore, una soluzione che consigliamo vivamente per le applicazioni distribuite, consiste nello scrivere i file di log su disco e quindi utilizzare Amazon CloudWatch Agent per caricare i dati di log nel AWS cloud. Inoltre, puoi configurare l' CloudWatch agente per eliminare i vecchi file di registro dalla tua istanza, evitando che l'istanza esaurisca lo spazio su disco.

Per abilitare la registrazione su disco, è necessario impostare la variabile di LOG_PATH ambiente, come descritto inFase 4: (Facoltativo) Utilizzo delle variabili di ambiente per la configurazione AWS AppConfig Agente per Amazon EC2.

Per iniziare a usare l' CloudWatch agente, consulta Raccogli metriche e log da istanze Amazon EC2 e server locali con l' CloudWatch agente nella Amazon User Guide. CloudWatch Puoi utilizzare Quick Setup, uno strumento in Systems Manager per installare rapidamente l'agente. CloudWatch Per ulteriori informazioni, vedere Quick Setup Host Management nella Guida AWS Systems Manager per l'utente.

Dopo aver installato l' CloudWatch agente sulla tua istanza, crea un file di configurazione CloudWatch dell'agente. Il file di configurazione indica all' CloudWatch agente come lavorare con i file di registro AWS AppConfig dell'agente. Per ulteriori informazioni sulla creazione di un file di configurazione CloudWatch dell'agente, vedere Creazione del file di configurazione dell' CloudWatch agente.

Aggiungi la seguente logs sezione al file di configurazione dell' CloudWatch agente sull'istanza e salva le modifiche:

"logs": {
  "logs_collected": {
    "files": {
      "collect_list": [
        {
          "file_path": "/path_you_specified_for_logging",
          "log_group_name": "${YOUR_LOG_GROUP_NAME}/aws-appconfig-agent.log",
          "auto_removal": true
        },
        ...
      ]
    },
    ...
  },
  ...
}

Se il valore auto_removal ètrue, l' CloudWatch agente elimina automaticamente i file di log AWS AppConfig dell'agente ruotati.

Fase 4: (Facoltativo) Utilizzo delle variabili di ambiente per la configurazione AWS AppConfig Agente per Amazon EC2

Puoi configurare AWS AppConfig l'agente per Amazon EC2 utilizzando le variabili di ambiente. Per impostare le variabili di ambiente per un systemd servizio, crei un file di unità drop-in. L'esempio seguente mostra come creare un file di unità drop-in su cui impostare il livello di registrazione dell' AWS AppConfig agente. DEBUG

Puoi configurare AWS AppConfig l'agente per Amazon EC2 specificando le seguenti variabili di ambiente in un file di unità drop-in.

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

Fase 5: (Obbligatorio) Recupero dei dati di configurazione

È possibile recuperare i dati di configurazione dall' AWS AppConfig agente utilizzando una chiamata HTTP localhost. I seguenti esempi vengono utilizzati curl con un client HTTP. È possibile chiamare l'agente utilizzando qualsiasi client HTTP disponibile supportato dal linguaggio dell'applicazione o dalle librerie disponibili, incluso un AWS SDK.

Per recuperare il contenuto completo di qualsiasi configurazione distribuita

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name"

Per recuperare un singolo flag e i relativi attributi da una configurazione di tipo AWS AppConfig Feature Flag

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name"

Per accedere a più flag e ai relativi attributi da una AWS AppConfig configurazione di tipo Feature Flag

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two"

Fase 6 (facoltativa, ma consigliata): Automazione degli aggiornamenti di AWS AppConfig Agente

AWS AppConfig L'agente viene aggiornato periodicamente. Per assicurarti di eseguire la versione più recente di AWS AppConfig Agent sulle tue istanze, ti consigliamo di aggiungere i seguenti comandi ai tuoi dati utente di Amazon EC2. Puoi aggiungere i comandi ai dati utente sull'istanza o sul gruppo EC2 Auto Scaling. Lo script installa e avvia la versione più recente dell'agente ogni volta che un'istanza viene avviata o riavviata.

#!/bin/bash
# install the latest version of the agent
yum install -y https://s3.amazonaws.com/aws-appconfig-downloads/aws-appconfig-agent/linux/x86_64/latest/aws-appconfig-agent.rpm
# optional: configure the agent
mkdir /etc/systemd/system/aws-appconfig-agent.service.d
echo "${MY_AGENT_CONFIG}" > /etc/systemd/system/aws-appconfig-agent.service.d/overrides.conf 
systemctl daemon-reload
# start the agent
systemctl start aws-appconfig-agent