Bereitstellen von Fluent Bit in ECS Amazon-Windows-Containern

1. Erstellen Sie die ECS Amazon-Container-Instance-Rolle mit dem Namen "ecsInstanceRole“. Weitere Informationen finden Sie unter ECSIAMAmazon-Container-Instance-Rolle.

2. Erstellen Sie eine IAM Rolle für die Fluent-Bit-Aufgabe mit dem NamenfluentTaskRole. Weitere Informationen finden Sie unter ECSIAMAmazon-Aufgabenrolle.

   Die in dieser IAM Rolle gewährten IAM Berechtigungen werden von den Aufgaben-Containern übernommen. Damit Fluent Bit Protokolle senden kann CloudWatch, müssen Sie der IAM Aufgabenrolle die folgenden Berechtigungen anfügen.

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

3. Fügen Sie der Rolle die -Richtlinie an.

   1. Speichern Sie den obigen Inhalt in einer Datei mit dem Namen fluent-bit-policy.json.

   2. Führen Sie den folgenden Befehl aus, um die Inline-Richtlinie der fluentTaskRole IAM Rolle anzufügen.

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

Um eine ECS Amazon-Instance zu erstellen

1. Verwenden Sie den aws ssm get-parameters Befehl, um die AMI ID für die Region abzurufen, in der Ihre gehostet wirdVPC. Weitere Informationen finden Sie unter Abrufen von ECS Amazon-optimierten Metadaten AMI.

2. Verwenden Sie die EC2 Amazon-Konsole, um die Instance zu starten.

   1. Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.

   2. Wählen Sie die zu verwendende Region in der Navigationsleiste aus.

   3. Wählen Sie im EC2Dashboard die Option Launch instance aus.

   4. Geben Sie für Name einen eindeutigen Namen ein.

   5. Wählen Sie für Application and OS Images (Amazon Machine Image) (Anwendungs- und Betriebssystem-Images (Amazon-Computer-Image)) die Version ausAMI, die Sie im ersten Schritt abgerufen haben.

   6. Wählen Sie für Instance type die Option t3.xlarge aus.

   7. Wählen Sie für Key pair (login) (Schlüsselpaar (Anmeldung)) ein Schlüsselpaar aus.

   8. Wählen Sie unter Network settings (Netzwerkeinstellungen) für Security group (Sicherheitsgruppe) eine vorhandene Sicherheitsgruppe aus oder erstellen Sie eine neue.

   9. Wählen Sie unter Network settings (Netzwerkeinstellungen), für Auto-assign Public IP (Öffentliche IP automatisch zuweisen), die Option Enable (Aktivieren) aus.

   10. Wählen Sie unter Erweiterte Details, zum IAMBeispiel Profil, die Option ecsInstanceRole.

   11. Konfigurieren Sie Ihre ECS Amazon-Container-Instance mit den folgenden Benutzerdaten. Fügen Sie unter Erweiterte Details das folgende Skript in das Feld Benutzerdaten ein und ersetzen Sie cluster_name durch den Namen Ihres Clusters.

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

   12. Wenn Sie bereit sind, wählen Sie das Bestätigungsfeld und danach Launch Instances aus.

   13. Auf einer Bestätigungsseite wird Ihnen mitgeteilt, dass die Instance gestartet wird. Wählen Sie View Instances aus, um die Bestätigungsseite zu schließen und zur Konsole zurückzukehren.

So registrieren Sie eine Aufgabendefinition

1. Erstellen Sie eine Datei mit dem Namen fluent-bit.json und dem folgenden Inhalt.

   Ersetzen Sie die folgenden Variablen:

   • task-iam-role mit dem Amazon-Ressourcennamen (ARN) Ihrer IAM Aufgabenrolle

   • region durch die Region, in der Ihre Aufgabe ausgeführt wird

   {
     "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. Führen Sie den folgenden Befehl aus, um die Aufgabendefinition zu registrieren.

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

   Sie können die Aufgabendefinitionen für Ihr Konto auflisten, indem Sie den list-task-definitions-Befehl ausführen. Die Ausgabe zeigt die Familien- und Revisionswerte an, die Sie zusammen mit run-task oder start-task verwenden können.

Ausführen einer Aufgabe

1. Führen Sie den folgenden Befehl aus, um die ecs-windows-fluent-bit:1-Aufgabendefinition (im vorherigen Schritt registriert) als Service zu starten.

   Anmerkung

   Diese Aufgabendefinition verwendet den awslogs-Protokollierungstreiber. Ihre Container Instance muss über die erforderlichen Berechtigungen verfügen.

   Ersetzen Sie die folgenden Variablen:

   • region durch die Region, in der Ihr Service ausgeführt wird

   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. Führen Sie den folgenden Befehl aus, um Ihre Aufgaben aufzulisten.

   Ersetzen Sie die folgenden Variablen:

   • region durch die Region, in der Ihre Serviceaufgaben ausgeführt werden

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

So registrieren Sie eine Aufgabendefinition

1. Erstellen Sie eine Datei mit dem Namen windows-app-task.json und dem folgenden Inhalt.

   {
     "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. Führen Sie den folgenden Befehl aus, um die Aufgabendefinition zu registrieren.

   Ersetzen Sie die folgenden Variablen:

   • region durch die Region, in der Ihre Aufgabe ausgeführt wird

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

   Sie können die Aufgabendefinitionen für Ihr Konto auflisten, indem Sie den list-task-definitions-Befehl ausführen. Die Ausgabe zeigt die Familien- und Revisionswerte an, die Sie zusammen mit run-task oder start-task verwenden können.

Ausführen einer Aufgabe

1. Führen Sie die windows-app-task:1-Aufgabendefinition aus, die Sie im vorherigen Schritt registriert haben.

   Ersetzen Sie die folgenden Variablen:

   • region durch die Region, in der Ihre Aufgabe ausgeführt wird

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

2. Führen Sie den folgenden Befehl aus, um Ihre Aufgaben aufzulisten.

   aws ecs list-tasks --cluster FluentBit-cluster

So überprüfen Sie die Fluent-Bit-Einrichtung

1. Öffnen Sie die CloudWatch Konsole unter. https://console.aws.amazon.com/cloudwatch/

2. Wählen Sie im Navigationsbereich Protokollgruppen aus. Stellen Sie sicher, dass Sie sich in der Region befinden, in der Sie Fluent Bit für Ihre Container bereitgestellt haben.

   In der Liste der Protokollgruppen in der AWS-Region sollte Folgendes angezeigt werden:

   • /ecs/fluent-bit-logs

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

   Wenn Sie diese Protokollgruppen sehen, wurde die Fluent-Bit-Einrichtung verifiziert.

So bereinigen Sie die Tutorial-Ressourcen

1. Halten Sie die windows-simple-task-Aufgabe und die ecs-fluent-bit-Aufgabe an. Weitere Informationen finden Sie unter Eine ECS Amazon-Aufgabe beenden.

2. Verwenden Sie den folgenden Befehl, um die /ecs/fluent-bit-logs-Protokollgruppe zu löschen. Weitere Informationen zum Löschen von Protokollgruppen finden Sie delete-log-groupin der AWS Command Line Interface Referenz.

   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. Führen Sie den folgenden Befehl aus, um die Instance zu beenden.

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

4. Führen Sie die folgenden Befehle aus, um die IAM Rollen zu löschen.

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

5. Führen Sie den folgenden Befehl aus, um den ECS Amazon-Cluster zu löschen.

   aws ecs delete-cluster --cluster FluentBit-cluster