Installez l'agent SSM et l' CloudWatch agent sur les nœuds de travail Amazon EKS à l'aide de preBootstrapCommands - Recommandations AWS
RécapitulatifConditions préalables et limitationsArchitectureOutilsÉpopéesRessources connexesInformations supplémentaires

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installez l'agent SSM et l' CloudWatch agent sur les nœuds de travail Amazon EKS à l'aide de preBootstrapCommands

Akkamahadevi Hiremath, Amazon Web Services

Récapitulatif

Ce modèle fournit des exemples de code et des étapes pour installer l'agent AWS Systems Manager (agent SSM) et l' CloudWatch agent Amazon sur les nœuds de travail Amazon Elastic Kubernetes Service (Amazon EKS) dans le cloud Amazon Web Services (AWS) lors de la création du cluster Amazon EKS. Vous pouvez installer l'agent SSM et l' CloudWatch agent en utilisant la preBootstrapCommands propriété du schéma du fichier de eksctl configuration (documentation Weaveworks). Vous pouvez ensuite utiliser l'agent SSM pour vous connecter à vos nœuds de travail sans utiliser de paire de clés Amazon Elastic Compute Cloud (Amazon EC2). En outre, vous pouvez utiliser l' CloudWatch agent pour surveiller l'utilisation de la mémoire et du disque sur vos nœuds de travail Amazon EKS.

Conditions préalables et limitations

Prérequis

Limites

  • Nous vous recommandons d'éviter d'ajouter des scripts de longue durée à la preBootstrapCommands propriété, car cela retarde l'adhésion du nœud au cluster Amazon EKS pendant les activités de dimensionnement. Nous vous recommandons plutôt de créer une Amazon Machine Image (AMI) personnalisée.

  • Ce modèle s'applique uniquement aux instances Amazon EC2 Linux.

Architecture

Pile technologique

  • Amazon CloudWatch

  • Amazon Elastic Kubernetes Service (Amazon EKS)

  • AWS Systems Manager Parameter Store

Architecture cible

Le schéma suivant montre un exemple d'utilisateur se connectant aux nœuds de travail Amazon EKS à l'aide de l'agent SSM installé à l'aide dupreBootstrapCommands.

User connecting to Amazon EKS worker nodes via Systems Manager, with SSM Agent and CloudWatch agent on each node.

Le schéma suivant illustre le flux de travail suivant :

  1. L'utilisateur crée un cluster Amazon EKS en utilisant le fichier eksctl de configuration avec la preBootstrapCommands propriété, qui installe l'agent SSM et CloudWatch l'agent.

  2. Toute nouvelle instance qui rejoint le cluster ultérieurement en raison d'activités de dimensionnement est créée avec l'agent SSM et CloudWatch l'agent préinstallés.

  3. L'utilisateur se connecte à Amazon à l'aide EC2 de l'agent SSM, puis surveille l'utilisation de la mémoire et du disque à l'aide de l' CloudWatch agent.

Outils

  • Amazon vous CloudWatch aide à surveiller les indicateurs de vos ressources AWS et des applications que vous exécutez sur AWS en temps réel.

  • Amazon Elastic Kubernetes Service (Amazon EKS) vous aide à exécuter Kubernetes sur AWS sans avoir à installer ou à gérer votre propre plan de contrôle ou vos propres nœuds Kubernetes.

  • AWS Systems Manager Parameter Store fournit un stockage hiérarchique sécurisé pour la gestion des données de configuration et la gestion des secrets.

  • AWS Systems Manager Session Manager vous aide à gérer vos EC2 instances, vos instances sur site et vos machines virtuelles via un shell interactif basé sur un navigateur en un clic ou via l'interface de ligne de commande AWS (AWS CLI).

  • eksctl est un utilitaire de ligne de commande permettant de créer et de gérer des clusters Kubernetes sur Amazon EKS.

  • kubectl est un utilitaire de ligne de commande permettant de communiquer avec le serveur API du cluster.

Épopées

TâcheDescriptionCompétences requises

Stockez le fichier de configuration de l' CloudWatch agent.

Stockez le fichier de configuration de l' CloudWatch agent dans le AWS Systems Manager Parameter Store de la région AWS dans laquelle vous souhaitez créer votre cluster Amazon EKS. Pour ce faire, créez un paramètre dans AWS Systems Manager Parameter Store et notez le nom du paramètre (par exemple,AmazonCloudwatch-linux).

Pour plus d'informations, consultez l'exemple de code de fichier de configuration de l' CloudWatch agent dans la section Informations supplémentaires de ce modèle.

DevOps ingénieur

Créez le fichier de configuration et le cluster eksctl.

  1. Créez un fichier eksctl de configuration qui inclut les étapes d'installation de l' CloudWatch agent et de l'agent SSM. Pour plus d'informations, consultez l'exemple de code de fichier de configuration eksctl dans la section Informations supplémentaires de ce modèle.

  2. Créez un cluster en exécutant la eksctl create cluster -f cluster.yaml commande.

AWS DevOps
TâcheDescriptionCompétences requises

Testez l'agent SSM.

Utilisez SSH pour vous connecter à vos nœuds de cluster Amazon EKS en utilisant l'une des méthodes décrites dans la section Démarrer une session dans la documentation AWS Systems Manager.

AWS DevOps

Testez l' CloudWatch agent.

Utilisez la CloudWatch console pour valider l' CloudWatch agent :

  1. Connectez-vous à AWS Management Console et ouvrez la console CloudWatch .

  2. Dans le volet de navigation, développez Metrics, puis choisissez All metrics.

  3. Dans le champ de recherche de l'onglet Parcourir, entrez puis choisissez CWAgent des métriques pour voir les métriques de mémoire et de disque.

AWS DevOps

Ressources connexes

Informations supplémentaires

Exemple de fichier CloudWatch de configuration de l'agent

Dans l'exemple suivant, l' CloudWatch agent est configuré pour surveiller l'utilisation du disque et de la mémoire sur les instances Amazon Linux :

{
    "agent": {
        "metrics_collection_interval": 60,
        "run_as_user": "cwagent"
    },
    "metrics": {
        "append_dimensions": {
            "AutoScalingGroupName": "${aws:AutoScalingGroupName}",
            "ImageId": "${aws:ImageId}",
            "InstanceId": "${aws:InstanceId}",
            "InstanceType": "${aws:InstanceType}"
        },
        "metrics_collected": {
            "disk": {
                "measurement": [
                    "used_percent"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ]
            },
            "mem": {
                "measurement": [
                    "mem_used_percent"
                ],
                "metrics_collection_interval": 60
            }
        }
    }
}

Exemple de fichier de configuration eksctl

apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig
metadata:
  name: test
  region: us-east-2
  version: "1.24"
managedNodeGroups:
  - name: test
    minSize: 2
    maxSize: 4
    desiredCapacity: 2
    volumeSize: 20
    instanceType: t3.medium
    preBootstrapCommands:
    - sudo yum install amazon-ssm-agent -y
    - sudo systemctl enable amazon-ssm-agent
    - sudo systemctl start amazon-ssm-agent
    - sudo yum install amazon-cloudwatch-agent -y
    - sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c ssm:AmazonCloudwatch-linux
    iam:
      attachPolicyARNs:
        - arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy
        - arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy
        - arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly
        - arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy
        - arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore

Informations supplémentaires sur le code

  • Dans la dernière ligne de la preBootstrapCommands propriété AmazonCloudwatch-linux se trouve le nom du paramètre créé dans le magasin de paramètres AWS System Manager. Vous devez l'inclure AmazonCloudwatch-linux dans Parameter Store dans la même région AWS où vous avez créé le cluster Amazon EKS. Vous pouvez également spécifier un chemin de fichier, mais nous vous recommandons d'utiliser Systems Manager pour faciliter l'automatisation et la réutilisation.

  • Si vous les utilisez preBootstrapCommands dans le fichier eksctl de configuration, deux modèles de lancement s'affichent dans l'AWS Management Console. Le premier modèle de lancement inclut les commandes spécifiées danspreBootstrapCommands. Le second modèle inclut les commandes spécifiées dans les données utilisateur Amazon EKS par défaut preBootstrapCommands et les contient. Ces données sont nécessaires pour que les nœuds rejoignent le cluster. Le groupe Auto Scaling du groupe de nœuds utilise ces données utilisateur pour créer de nouvelles instances.

  • Si vous utilisez l'iamattribut dans le fichier de eksctl configuration, vous devez répertorier les politiques Amazon EKS par défaut ainsi que toutes les politiques supplémentaires requises dans les politiques AWS Identity and Access Management (IAM) jointes. Dans l'extrait de code issu de l'étape Créer le fichier de configuration et le cluster eksctl, CloudWatchAgentServerPolicy des politiques supplémentaires AmazonSSMMangedInstanceCore sont ajoutées pour garantir que l' CloudWatch agent et l'agent SSM fonctionnent comme prévu. Les AmazonEC2ContainerRegistryReadOnly politiques AmazonEKSWorkerNodePolicyAmazonEKS_CNI_Policy, sont des politiques obligatoires requises pour que le cluster Amazon EKS fonctionne correctement.