Déploiement de Fluent Bit sur des conteneurs Amazon ECS Windows

1. Créez le rôle d'instance de ECS conteneur Amazon nommé « ecsInstanceRole ». Pour plus d'informations, consultez le IAMrôle de l'instance de ECS conteneur Amazon.

2. Créez un IAM rôle pour la tâche Fluent Bit intituléefluentTaskRole. Pour de plus amples informations, veuillez consulter IAMRôle de ECS tâche Amazon.

   Les IAM autorisations accordées dans ce IAM rôle sont prises en charge par les conteneurs de tâches. Pour permettre à Fluent Bit d'envoyer des journaux CloudWatch, vous devez associer les autorisations suivantes au IAM rôle de tâche.

   {
       "Version": "2012-10-17",
       "Statement": [
       {
           "Effect": "Allow",
           "Action": [
               "logs:CreateLogStream",
               "logs:CreateLogGroup",
               "logs:DescribeLogStreams",
               "logs:PutLogEvents"
           ],
           "Resource": "*"
       }
       ]
   }

3. Attachez la stratégie au rôle.

   1. Enregistrez le contenu ci-dessus dans un fichier nommé fluent-bit-policy.json.

   2. Exécutez la commande suivante pour associer la politique en ligne au fluentTaskRole IAM rôle.

      aws iam put-role-policy --role-name fluentTaskRole --policy-name fluentTaskPolicy --policy-document file://fluent-bit-policy.json

Pour créer une ECS instance Amazon

1. Utilisez la aws ssm get-parameters commande pour récupérer l'AMIidentifiant de la région qui héberge votreVPC. Pour plus d'informations, consultez la section Extraction de métadonnées ECS optimisées pour AMI Amazon.

2. Utilisez la EC2 console Amazon pour lancer l'instance.

   1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/.

   2. Dans la barre de navigation, sélectionnez la région à utiliser.

   3. Dans le EC2tableau de bord, choisissez Launch instance.

   4. Pour Name (Nom), saisissez un nom unique.

   5. Pour Application and OS Images (Amazon Machine Image), choisissez celles AMI que vous avez récupérées lors de la première étape.

   6. Concernant l'option Instance type (Type d'instance), choisissez t3.xlarge.

   7. Pour Key pair (login) (Paire de clés (connexion)), choisissez une paire de clés.

   8. Sous Network Settings (Paramètres réseau), pour Security group (Groupe de sécurité), choisissez un groupe de sécurité existant ou créez-en un nouveau.

   9. Sous Network settings (Paramètres réseau), pour Auto-assign Public IP (Attribuer automatiquement l'adresse IP publique), sélectionnez Enable (Activer).

   10. Sous Détails avancés, IAMpar exemple profil, sélectionnez ecsInstanceRole.

   11. Configurez votre instance de ECS conteneur Amazon avec les données utilisateur suivantes. Sous Détails avancés, collez le script suivant dans le champ Données utilisateur, en remplaçant cluster_name par le nom de votre cluster.

       <powershell>
       Import-Module ECSTools
       Initialize-ECSAgent -Cluster cluster-name -EnableTaskENI -EnableTaskIAMRole -LoggingDrivers '["awslogs","fluentd"]'
       </powershell>

   12. Lorsque vous êtes prêt, cochez la case de confirmation, puis sélectionnez Launch Instances (Lancer des instances).

   13. Une page de confirmation indique que l'instance est en cours de lancement. Sélectionnez View Instances (Afficher les instances) pour fermer la page de confirmation et revenir à la console.

Pour enregistrer une définition de tâche

1. Créez un fichier nommé fluent-bit.json avec les contenus suivants.

   Remplacez les variables suivantes :

   • task-iam-role avec le nom de ressource Amazon (ARN) de votre IAM rôle de tâche

   • region par la région dans laquelle votre tâche s'exécute

   {
     "family": "ecs-windows-fluent-bit",
     "taskRoleArn": "task-iam-role",
     "containerDefinitions": [
       {
         "name": "fluent-bit",
         "image": "public.ecr.aws/aws-observability/aws-for-fluent-bit:windowsservercore-latest",
         "cpu": 512,
         "portMappings": [
           {
             "hostPort": 24224,
             "containerPort": 24224,
             "protocol": "tcp"
           }
         ],
         "entryPoint": [
           "Powershell",
           "-Command"
         ],
         "command": [
           "C:\\entrypoint.ps1 -ConfigFile C:\\ecs_windows_forward_daemon\\cloudwatch.conf"
         ],
         "environment": [
           {
             "name": "AWS_REGION",
             "value": "region"
           }
         ],
         "memory": 512,
         "essential": true,
         "logConfiguration": {
           "logDriver": "awslogs",
           "options": {
             "awslogs-group": "/ecs/fluent-bit-logs",
             "awslogs-region": "region",
             "awslogs-stream-prefix": "flb",
             "awslogs-create-group": "true"
           }
         }
       }
     ],
     "memory": "512",
     "cpu": "512"
   }

2. Utilisez la commande suivante pour enregistrer la définition de tâche.

   aws ecs register-task-definition --cli-input-json file://fluent-bit.json --region region

   Vous pouvez répertorier les définitions de tâche de votre compte en exécutant la commande list-task-definitions. La sortie affiche les valeurs de famille et de révision que vous pouvez utiliser conjointement avec run-task ou start-task.

Pour exécuter une tâche

1. Exécutez la commande suivante pour démarrer la définition de la tâche ecs-windows-fluent-bit:1 (enregistrée à l'étape précédente) en tant que service.

   Note

   Cette définition de tâche utilise le pilote de journalisation awslogs. Votre instance de conteneur doit disposer des autorisations nécessaires.

   Remplacez les variables suivantes :

   • region par la région dans laquelle votre service fonctionne

   aws ecs create-service \
       --cluster FluentBit-cluster \
       --service-name FluentBitForwardDaemonService \
       --task-definition ecs-windows-fluent-bit:1 \
       --launch-type EC2 \
       --scheduling-strategy DAEMON \
       --region region

2. Exécutez la commande suivante pour répertorier vos tâches.

   Remplacez les variables suivantes :

   • region par la région dans laquelle les tâches de votre service fonctionnent

   aws ecs list-tasks --cluster FluentBit-cluster --region region

Pour enregistrer une définition de tâche

1. Créez un fichier nommé windows-app-task.json avec les contenus suivants.

   {
     "family": "windows-app-task",
     "containerDefinitions": [
       {
         "name": "sample-container",
         "image": "mcr.microsoft.com/windows/servercore:ltsc2019",
         "cpu": 512,
         "memory": 512,
         "essential": true,
         "entryPoint": [
           "Powershell",
           "-Command"
         ],
         "command": [
           "$count=1;while(1) { Write-Host $count; sleep 1; $count=$count+1;}"
         ],
         "logConfiguration": {
           "logDriver": "fluentd",
           "options": {
             "fluentd-address": "localhost:24224",
             "tag": "{{ index .ContainerLabels \"com.amazonaws.ecs.task-definition-family\" }}",
             "fluentd-async": "true",
             "labels": "com.amazonaws.ecs.cluster,com.amazonaws.ecs.container-name,com.amazonaws.ecs.task-arn,com.amazonaws.ecs.task-definition-family,com.amazonaws.ecs.task-definition-version"
           }
         }
       }
     ],
     "memory": "512",
     "cpu": "512"
   }

2. Utilisez la commande suivante pour enregistrer la définition de tâche.

   Remplacez les variables suivantes :

   • region par la région dans laquelle votre tâche s'exécute

   aws ecs register-task-definition --cli-input-json file://windows-app-task.json --region region

   Vous pouvez répertorier les définitions de tâche de votre compte en exécutant la commande list-task-definitions. La sortie affiche les valeurs de famille et de révision que vous pouvez utiliser conjointement avec run-task ou start-task.

Pour exécuter une tâche

1. Exécutez la définition de tâche windows-app-task:1 que vous avez enregistrée à l'étape précédente.

   Remplacez les variables suivantes :

   • region par la région dans laquelle votre tâche s'exécute

   aws ecs run-task --cluster FluentBit-cluster --task-definition windows-app-task:1 --count 2 --region region

2. Exécutez la commande suivante pour répertorier vos tâches.

   aws ecs list-tasks --cluster FluentBit-cluster

Pour vérifier la configuration Fluent Bit

1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le panneau de navigation, choisissez Groupes de journaux. Assurez-vous que vous êtes dans la région où vous avez déployé Fluent Bit sur vos conteneurs.

   Dans la liste des groupes de journaux de l' Région AWS, vous devez voir ce qui suit :

   • /ecs/fluent-bit-logs

   • /aws/ecs/FluentBit-cluster.windows-app-task

   Si vous voyez ces groupes de journaux, la vérification de la configuration Fluent Bit est terminée.

Pour nettoyer les ressources du didacticiel

1. Arrêtez la tâche windows-simple-task et la tâche ecs-fluent-bit. Pour de plus amples informations, veuillez consulter Arrêter une ECS tâche Amazon.

2. Utilisez la commande suivante pour supprimer le groupe de journaux /ecs/fluent-bit-logs. Pour plus d'informations, sur la suppression de groupes de journaux delete-log-group, voir la AWS Command Line Interface référence.

   aws logs delete-log-group --log-group-name /ecs/fluent-bit-logs
   aws logs delete-log-group --log-group-name /aws/ecs/FluentBit-cluster.windows-app-task

3. Exécutez la commande suivante pour mettre fin à l'instance.

   aws ec2 terminate-instances --instance-ids instance-id

4. Exécutez les commandes suivantes pour supprimer les IAM rôles.

   aws iam delete-role --role-name ecsInstanceRole
   aws iam delete-role --role-name fluentTaskRole

5. Exécutez la commande suivante pour supprimer le ECS cluster Amazon.

   aws ecs delete-cluster --cluster FluentBit-cluster