Utilizzo di AWS AppConfig Agent con Amazon EC2 e macchine locali

Puoi integrarti AWS AppConfig con le applicazioni in esecuzione sulle tue istanze Amazon Elastic Compute Cloud (AmazonEC2) Linux utilizzando AWS AppConfig Agent. 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.

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

Per l'integrazione AWS AppConfig con le applicazioni in esecuzione sulle tue EC2 istanze Amazon, 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 politica di IAM autorizzazione assegnata al ruolo dell'EC2istanza Amazon. In particolare, devi aggiungere le appconfig:GetLatestConfiguration azioni appconfig:StartConfigurationSession e alla policy. Ecco un esempio:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appconfig:StartConfigurationSession",
                "appconfig:GetLatestConfiguration"
            ],
            "Resource": "*"
        }
    ]
}

Per ulteriori informazioni sull'aggiunta di autorizzazioni a una politica, consulta Aggiungere e rimuovere le autorizzazioni di IAM identità nella Guida per l'IAMutente.

Fase 2: (Obbligatorio) Installazione e avvio AWS AppConfig dell'agente sulle EC2 istanze Amazon

AWS AppConfig L'agente è ospitato in un bucket Amazon Simple Storage Service (Amazon S3) gestito da. AWS Usa 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 registri

Per impostazione predefinita, AWS AppConfig Agent pubblica i log su. STDERR Systemd reindirizza al journal STDOUT systemd STDERR per tutti i servizi in esecuzione sull'istanza Linux. È possibile visualizzare e gestire i dati di registro nel journal systemd se si esegue AWS AppConfig Agent solo su una o due istanze. Una soluzione migliore, una soluzione che consigliamo vivamente per le applicazioni distribuite, è scrivere file di registro su disco e quindi utilizzare Amazon CloudWatch Agent per caricare i dati di registro sul AWS cloud. Inoltre, puoi configurare l' CloudWatch agente per eliminare i vecchi file di registro dall'istanza, in modo da evitare 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 configurare AWS AppConfig Agent for Amazon EC2.

Per iniziare a usare l' CloudWatch agente, consulta Raccogli metriche e log EC2 dalle istanze Amazon e dai server locali con l'agente CloudWatch nella Amazon User Guide. CloudWatch È possibile utilizzare Quick Setup, una funzionalità di Systems Manager per installare rapidamente l' CloudWatch agente. Per ulteriori informazioni, vedere Quick Setup Host Management nella Guida AWS Systems Manager per l'utente.

Dopo aver installato l' CloudWatch agente sull'istanza, crea un file di configurazione CloudWatch dell'agente. Il file di configurazione spiega 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 Creare il file di configurazione dell' CloudWatch agente.

Aggiungi la logs sezione seguente 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 di auto_removal ètrue, l' CloudWatch agente elimina automaticamente i file di registro AWS AppConfig dell'agente ruotati.

Fase 4: (Facoltativo) Utilizzo delle variabili di ambiente per configurare AWS AppConfig Agent for Amazon EC2

Puoi configurare AWS AppConfig Agent for Amazon EC2 utilizzando 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 Agent for 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>

"header: value"

Fase 5: (Obbligatorio) Recupero dei dati di configurazione

È possibile recuperare i dati di configurazione dall' AWS AppConfig agente utilizzando una HTTP chiamata localhost. I seguenti esempi vengono utilizzati curl con un HTTP client. È possibile chiamare l'agente utilizzando qualsiasi HTTP client disponibile supportato dal linguaggio dell'applicazione o dalle librerie disponibili, tra cui 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 AWS AppConfig configurazione di tipo 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"

Passaggio 6 (facoltativo, ma consigliato): Automatizzazione degli aggiornamenti all'agente AWS AppConfig

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 EC2 utente Amazon. È possibile 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