Distribuzione di Fluent Bit su contenitori Amazon ECS Windows

1. Crea il ruolo dell'istanza del contenitore Amazon ECS denominato "ecsInstanceRole». Per ulteriori informazioni, consulta Ruolo IAM delle istanze di container di Amazon ECS.

2. Crea un ruolo IAM per l'attività Fluent Bit denominata fluentTaskRole. Per ulteriori informazioni, consulta Ruolo IAM dell'attività Amazon ECS.

   Le autorizzazioni IAM concesse nel ruolo IAM sono assunte dai container delle attività. Per consentire a Fluent Bit di inviare i log a CloudWatch, devi assegnare le seguenti autorizzazioni al ruolo IAM dell'attività.

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

3. Collegare la policy al ruolo.

   1. Salva il contenuto di cui sopra in un file denominato fluent-bit-policy.json.

   2. Per collegare la policy in linea al ruolo IAM fluentTaskRole, esegui il comando riportato.

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

Creazione di un'istanza Amazon ECS

1. Usa il comando aws ssm get-parameters per recuperare l'ID AMI per la regione che ospita il tuo VPC. Per ulteriori informazioni, consulta Recupero dei metadati dell'AMI ottimizzata per Amazon ECS.

2. Usa la EC2 console Amazon per avviare l'istanza.

   1. Apri la EC2 console Amazon all'indirizzo https://console.aws.amazon.com/ec2/.

   2. Seleziona la Regione da utilizzare nella barra di navigazione.

   3. Dalla EC2 dashboard, scegli Launch instance.

   4. Per Name (Nome), inserisci un nome univoco.

   5. Per Application and OS Images (Amazon Machine Image) (Immagini di applicazioni e sistema operativo [Amazon Machine Image]), scegli l'AMI che è stata recuperata nel primo passaggio.

   6. In Instance type (Tipo di istanza) selezionare t3.xlarge.

   7. Per Key pair (login) (Coppia di chiavi [accesso]), scegli una coppia di chiavi.

   8. In Network settings (Impostazioni di rete), per Security group (Gruppo di sicurezza), scegli un gruppo di sicurezza esistente o creane uno nuovo.

   9. In Network settings (Impostazioni di rete), per Auto-assign Public IP (Assegna automaticamente un IP pubblico), seleziona Enable (Abilita).

   10. In Dettagli avanzati, per il profilo dell'istanza IAM, scegli ecsInstanceRole.

   11. Configura la tua istanza di container Amazon ECS con i seguenti dati utente. In Dettagli avanzati, incolla lo script seguente nel campo Dati utente, sostituendolo cluster_name con il nome del cluster.

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

   12. Quando sei pronto, seleziona il campo di conferma e scegli Launch Instances (Avvia istanze).

   13. Una pagina di conferma indicherà che l'istanza si sta avviando. Scegliere View Instances (Visualizza istanze) per chiudere la pagina di conferma e tornare alla console.

Come registrare una definizione di attività

1. Crea un file denominato fluent-bit.json con i seguenti contenuti.

   Sostituisci le seguenti variabili:

   • task-iam-rolecon l'Amazon Resource Name (ARN) del ruolo IAM della tua attività

   • regioncon la regione in cui viene eseguita l'attività

   {
     "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. Utilizza il comando seguente per registrare la definizione dell'attività.

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

   Puoi sempre ottenere un elenco delle definizioni di attività per l'account tramite il comando list-task-definitions. L'output che mostra i valori della famiglia e delle revisioni che è possibile utilizzare insieme a run-task o start-task.

Per eseguire un'attività

1. Esegui il comando seguente per avviare la definizione di attività ecs-windows-fluent-bit:1 (registrata nel passaggio precedente) come servizio.

   Nota

   Questa definizione di attività utilizza il driver di registrazione awslogs; l'istanza di container deve disporre delle autorizzazioni necessarie.

   Sostituisci le seguenti variabili:

   • regioncon la regione in cui viene eseguito il servizio

   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. Per elencare le attività, esegui il comando riportato.

   Sostituisci le seguenti variabili:

   • regioncon la regione in cui vengono eseguite le attività di assistenza

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

Come registrare una definizione di attività

1. Crea un file denominato windows-app-task.json con i seguenti contenuti.

   {
     "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. Utilizza il comando seguente per registrare la definizione dell'attività.

   Sostituisci le seguenti variabili:

   • regioncon la regione in cui viene eseguita l'attività

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

   Puoi sempre ottenere un elenco delle definizioni di attività per l'account tramite il comando list-task-definitions. L'output che mostra i valori della famiglia e delle revisioni che è possibile utilizzare insieme a run-task o start-task.

Per eseguire un'attività

1. Esegui la definizione di attività windows-app-task:1 registrata nella fase precedente.

   Sostituisci le seguenti variabili:

   • regioncon la regione in cui viene eseguita l'attività

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

2. Per elencare le attività, esegui il comando riportato.

   aws ecs list-tasks --cluster FluentBit-cluster

Verifica della configurazione di Fluent Bit

1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Nel pannello di navigazione, selezionare Log groups (Gruppi di log). Assicurati di trovarti nella regione in cui è stato implementato Fluent Bit sui container.

   Nell'elenco dei gruppi di log di Regione AWS, dovresti vedere quanto segue:

   • /ecs/fluent-bit-logs

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

   Se questi gruppi di log sono visualizzati, la configurazione Fluent Bit è verificata.

Per eliminare le risorse del tutorial

1. Interrompi l'attività windows-simple-task e l'attività ecs-fluent-bit. Per ulteriori informazioni, consulta Interruzione di un'attività Amazon ECS.

2. Esegui il comando riportato per eliminare il gruppo di log /ecs/fluent-bit-logs. Per ulteriori informazioni, sull'eliminazione dei gruppi di log, consulta delete-log-groupla sezione AWS Command Line Interface Reference.

   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. Esegui il comando riportato per terminare l'istanza.

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

4. Esegui i comandi riportati per eliminare i ruoli IAM.

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

5. Esegui il seguente comando per eliminare il cluster Amazon ECS.

   aws ecs delete-cluster --cluster FluentBit-cluster