Utilisation AWS AppConfig Agent avec Amazon EC2 et machines sur site

Vous pouvez intégrer AWS AppConfig des applications exécutées sur vos instances Linux Amazon Elastic Compute Cloud (Amazon EC2) à l'aide de l' AWS AppConfig Agent. L'agent améliore le traitement et la gestion des applications de la manière suivante :

*AWS AppConfig L'agent met en cache les données la première fois que le service récupère vos données de configuration. C'est pourquoi le premier appel pour récupérer des données est plus lent que les appels suivants.

Étape 1 : (Obligatoire) Création de ressources et configuration des autorisations

Pour intégrer AWS AppConfig les applications exécutées sur vos instances Amazon EC2, vous devez créer des AWS AppConfig artefacts et des données de configuration, notamment des indicateurs de fonctionnalités ou des données de configuration en forme libre. Pour de plus amples informations, veuillez consulter Création d'indicateurs de fonctionnalités et de données de configuration sous forme libre dans AWS AppConfig.

Pour récupérer les données de configuration hébergées par AWS AppConfig, vos applications doivent être configurées avec accès au plan de AWS AppConfig données. Pour donner accès à vos applications, mettez à jour la politique d'autorisations IAM attribuée au rôle d'instance Amazon EC2. Plus précisément, vous devez ajouter les appconfig:GetLatestConfiguration actions appconfig:StartConfigurationSession et à la politique. Voici un exemple :

Pour plus d'informations sur l'ajout d'autorisations à une politique, consultez la section Ajouter et supprimer des autorisations d'identité IAM dans le Guide de l'utilisateur IAM.

Étape 2 : (obligatoire) Installation et démarrage AWS AppConfig Agent sur les instances Amazon EC2

AWS AppConfig L'agent est hébergé dans un compartiment Amazon Simple Storage Service (Amazon S3) géré par AWS. Suivez la procédure suivante pour installer la dernière version de l'agent sur votre instance Linux. Si votre application est distribuée sur plusieurs instances, vous devez exécuter cette procédure sur chaque instance qui héberge l'application.

sudo systemctl stop aws-appconfig-agent

Étape 3 : (Facultatif, mais recommandé) Envoi de fichiers CloudWatch journaux à Logs

Par défaut, AWS AppConfig l'agent publie les journaux sur STDERR. Systemd redirige les protocoles STDOUT et STDERR pour tous les services exécutés sur l'instance Linux vers le journal systemd. Vous pouvez consulter et gérer les données du journal dans le journal systemd si vous n'exécutez AWS AppConfig l'Agent que sur une ou deux instances. Une meilleure solution, que nous recommandons vivement pour les applications distribuées, consiste à écrire des fichiers journaux sur disque, puis à utiliser CloudWatch un agent Amazon pour télécharger les données des journaux AWS dans le cloud. En outre, vous pouvez configurer l' CloudWatch agent pour supprimer les anciens fichiers journaux de votre instance, afin d'éviter que votre instance ne manque d'espace disque.

Pour activer la journalisation sur disque, vous devez définir la variable d'LOG_PATHenvironnement, comme décrit dansÉtape 4 : (Facultatif) Utilisation de variables d'environnement pour configurer AWS AppConfig Agent pour Amazon EC2.

Pour commencer à utiliser l' CloudWatch agent, consultez la section Collecter des métriques et des journaux à partir d'instances Amazon EC2 et de serveurs locaux avec l' CloudWatch agent dans le guide de l' CloudWatch utilisateur Amazon. Vous pouvez utiliser Quick Setup, un outil de Systems Manager qui permet d'installer rapidement l' CloudWatch agent. Pour plus d'informations, consultez la section Configuration rapide de la gestion des hôtes dans le Guide de AWS Systems Manager l'utilisateur.

Après avoir installé l' CloudWatch agent sur votre instance, créez un fichier de configuration de CloudWatch l'agent. Le fichier de configuration indique à CloudWatch l'agent comment utiliser les fichiers journaux de AWS AppConfig l'agent. Pour plus d'informations sur la création d'un fichier de configuration d' CloudWatch agent, voir Création du fichier de configuration d' CloudWatch agent.

Ajoutez la logs section suivante au fichier de configuration de l' CloudWatch agent sur l'instance et enregistrez vos modifications :

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

Si la valeur auto_removal esttrue, l' CloudWatch agent supprime automatiquement les fichiers journaux de l' AWS AppConfig agent pivotés.

Étape 4 : (Facultatif) Utilisation de variables d'environnement pour configurer AWS AppConfig Agent pour Amazon EC2

Vous pouvez configurer AWS AppConfig l'agent pour Amazon EC2 à l'aide de variables d'environnement. Pour définir des variables d'environnement pour un systemd service, vous créez un fichier d'unités intégré. L'exemple suivant montre comment créer un fichier d'unité intégré pour définir le niveau de journalisation de l' AWS AppConfig agent surDEBUG.

Vous pouvez configurer AWS AppConfig l'Agent pour Amazon EC2 en spécifiant les variables d'environnement suivantes dans un fichier d'unités intégré.

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

Étape 5 : (Obligatoire) Récupération des données de configuration

Vous pouvez récupérer les données de configuration depuis AWS AppConfig l'Agent en utilisant un appel HTTP localhost. Les exemples suivants sont utilisés curl avec un client HTTP. Vous pouvez appeler l'agent à l'aide de n'importe quel client HTTP disponible pris en charge par le langage de votre application ou par les bibliothèques disponibles, y compris un AWS SDK.

Pour récupérer le contenu complet de toute configuration déployée

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

Pour récupérer un indicateur unique et ses attributs à partir d'une AWS AppConfig configuration de type Feature Flag

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

Pour accéder à plusieurs drapeaux et à leurs attributs à partir d'une AWS AppConfig configuration de type Feature Flag

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

Étape 6 (facultative, mais recommandée) : Automatiser les mises à jour de AWS AppConfig Agent

AWS AppConfig L'agent est mis à jour périodiquement. Pour vous assurer que vous exécutez la dernière version d' AWS AppConfig Agent sur vos instances, nous vous recommandons d'ajouter les commandes suivantes à vos données utilisateur Amazon EC2. Vous pouvez ajouter les commandes aux données utilisateur de l'instance ou du groupe EC2 Auto Scaling. Le script installe et lance la dernière version de l'agent chaque fois qu'une instance démarre ou redémarre.

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