Verwenden AWS AppConfig Agent mit Amazon EC2 und lokalen Maschinen

AWS AppConfig Mithilfe von Agent können Sie Anwendungen integrieren, die auf Ihren Amazon Elastic Compute Cloud (Amazon EC2) Linux-Instances ausgeführt werden. AWS AppConfig Der Agent verbessert die Anwendungsverarbeitung und -verwaltung auf folgende Weise:

*AWS AppConfig Der Agent speichert Daten im Cache, wenn der Dienst Ihre Konfigurationsdaten zum ersten Mal abruft. Aus diesem Grund ist der erste Aufruf zum Abrufen von Daten langsamer als nachfolgende Aufrufe.

Schritt 1: (Erforderlich) Ressourcen erstellen und Berechtigungen konfigurieren

Für die Integration AWS AppConfig mit Anwendungen, die auf Ihren Amazon EC2-Instances ausgeführt werden, müssen Sie AWS AppConfig Artefakte und Konfigurationsdaten erstellen, einschließlich Feature-Flags oder Freiform-Konfigurationsdaten. Weitere Informationen finden Sie unter Erstellen von Feature-Flags und Freiform-Konfigurationsdaten in AWS AppConfig.

Um die von gehosteten Konfigurationsdaten abzurufen AWS AppConfig, müssen Ihre Anwendungen mit Zugriff auf die AWS AppConfig Datenebene konfiguriert sein. Um Ihren Anwendungen Zugriff zu gewähren, aktualisieren Sie die IAM-Berechtigungsrichtlinie, die der Amazon EC2-Instance-Rolle zugewiesen ist. Insbesondere müssen Sie der Richtlinie die appconfig:GetLatestConfiguration Aktionen appconfig:StartConfigurationSession und hinzufügen. Ein Beispiel:

Weitere Informationen zum Hinzufügen von Berechtigungen zu einer Richtlinie finden Sie unter Hinzufügen und Entfernen von IAM-Identitätsberechtigungen im IAM-Benutzerhandbuch.

Schritt 2: (Erforderlich) Installieren und Starten AWS AppConfig Agent auf Amazon EC2-Instances

AWS AppConfig Der Agent wird in einem Amazon Simple Storage Service (Amazon S3) -Bucket gehostet, der von AWS verwaltet wird. Verwenden Sie das folgende Verfahren, um die neueste Version des Agenten auf Ihrer Linux-Instance zu installieren. Wenn Ihre Anwendung auf mehrere Instanzen verteilt ist, müssen Sie dieses Verfahren auf jeder Instanz ausführen, die die Anwendung hostet.

sudo systemctl stop aws-appconfig-agent

Schritt 3: (Optional, aber empfohlen) Logdateien an CloudWatch Logs senden

Standardmäßig veröffentlicht der AWS AppConfig Agent Protokolle auf STDERR. Systemd leitet STDOUT und STDERR für alle Dienste, die auf der Linux-Instanz ausgeführt werden, an das Systemd-Journal weiter. Sie können Protokolldaten im Systemd-Journal anzeigen und verwalten, wenn Sie den AWS AppConfig Agenten nur auf einer oder zwei Instanzen ausführen. Eine bessere Lösung, eine Lösung, die wir für verteilte Anwendungen dringend empfehlen, besteht darin, Protokolldateien auf die Festplatte zu schreiben und dann den Amazon CloudWatch Agent zu verwenden, um die Protokolldaten in die AWS Cloud hochzuladen. Darüber hinaus können Sie den CloudWatch Agenten so konfigurieren, dass er alte Protokolldateien aus Ihrer Instance löscht, wodurch verhindert wird, dass Ihrer Instance der Speicherplatz ausgeht.

Um die Protokollierung auf der Festplatte zu aktivieren, müssen Sie die LOG_PATH Umgebungsvariable festlegen, wie unter beschriebenSchritt 4: (Optional) Verwenden von Umgebungsvariablen zur Konfiguration AWS AppConfig Agent für Amazon EC2.

Informationen zu den ersten Schritten mit dem CloudWatch Agenten finden Sie im CloudWatch Amazon-Benutzerhandbuch unter Erfassung von Metriken und Protokollen von Amazon EC2-Instances und lokalen Servern mit dem CloudWatch Agenten. Sie können Quick Setup, ein Tool im Systems Manager, verwenden, um den Agenten schnell zu installieren. CloudWatch Weitere Informationen finden Sie im AWS Systems Manager Benutzerhandbuch unter Quick Setup Host Management.

Nachdem Sie den CloudWatch Agenten auf Ihrer Instance installiert haben, erstellen Sie eine CloudWatch Agenten-Konfigurationsdatei. Die Konfigurationsdatei weist den CloudWatch Agenten an, wie er mit den AWS AppConfig Agenten-Protokolldateien arbeitet. Weitere Informationen zum Erstellen einer CloudWatch Agentenkonfigurationsdatei finden Sie unter Erstellen der CloudWatch Agentenkonfigurationsdatei.

Fügen Sie der CloudWatch Agentenkonfigurationsdatei auf der Instanz den folgenden logs Abschnitt hinzu und speichern Sie Ihre Änderungen:

"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
        },
        ...
      ]
    },
    ...
  },
  ...
}

Wenn der Wert auto_removal isttrue, löscht der CloudWatch Agent automatisch rotierte AWS AppConfig Agenten-Protokolldateien.

Schritt 4: (Optional) Verwenden von Umgebungsvariablen zur Konfiguration AWS AppConfig Agent für Amazon EC2

Sie können den AWS AppConfig Agenten für Amazon EC2 mithilfe von Umgebungsvariablen konfigurieren. Um Umgebungsvariablen für einen systemd Service festzulegen, erstellen Sie eine Drop-In-Unit-Datei. Das folgende Beispiel zeigt, wie eine Drop-In-Unit-Datei erstellt wird, auf die die AWS AppConfig Agenten-Protokollierungsstufe gesetzt wird. DEBUG

Sie können AWS AppConfig Agent for Amazon EC2 konfigurieren, indem Sie die folgenden Umgebungsvariablen in einer Drop-In-Unit-Datei angeben.

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

Schritt 5: (Erforderlich) Abrufen der Konfigurationsdaten

Sie können Konfigurationsdaten vom AWS AppConfig Agenten abrufen, indem Sie einen HTTP-Localhost-Aufruf verwenden. Die folgenden Beispiele werden curl mit einem HTTP-Client verwendet. Sie können den Agenten mit jedem verfügbaren HTTP-Client aufrufen, der von Ihrer Anwendungssprache unterstützt wird, oder mit verfügbaren Bibliotheken, einschließlich eines AWS SDK.

Um den vollständigen Inhalt einer bereitgestellten Konfiguration abzurufen

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

Um ein einzelnes Flag und seine Attribute aus einer AWS AppConfig Konfiguration des folgenden Typs abzurufen Feature Flag

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

Um auf mehrere Flags und ihre Attribute aus einer AWS AppConfig Konfiguration des folgenden Typs zuzugreifen Feature Flag

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

Schritt 6 (optional, aber empfohlen): Automatisieren von Updates AWS AppConfig Agent

AWS AppConfig Der Agent wird regelmäßig aktualisiert. Um sicherzustellen, dass Sie die neueste Version von AWS AppConfig Agent auf Ihren Instances ausführen, empfehlen wir Ihnen, die folgenden Befehle zu Ihren Amazon EC2-Benutzerdaten hinzuzufügen. Sie können die Befehle entweder auf der Instance oder in der EC2 Auto Scaling-Gruppe zu den Benutzerdaten hinzufügen. Das Skript installiert und startet bei jedem Start oder Neustart einer Instance die neueste Version des Agenten.

#!/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