Implementación de Fluent Bit en contenedores de Amazon ECS para Windows

1. Cree el rol de la instancia de contenedor de Amazon ECS denominado “ecsInstanceRole”. Para obtener más información, consulte Rol de IAM de instancia de contenedor de Amazon ECS.

2. Cree un rol de IAM para la tarea de Fluent Bit denominado fluentTaskRole. Para obtener más información, consulte Rol de IAM de tarea de Amazon ECS.

   Los contenedores de tareas asumen los permisos de IAM concedidos en este rol de IAM. Para permitir que Fluent Bit envíe registros a CloudWatch, debe adjuntar los siguientes permisos al rol de IAM de la tarea.

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

3. Asocie la política de al rol.

   1. Guarde el contenido anterior en un archivo denominado fluent-bit-policy.json.

   2. Ejecute el siguiente comando para asociar la política insertada al rol de IAM fluentTaskRole.

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

Para crear una instancia de Amazon ECS

1. Utilice el comando aws ssm get-parameters para recuperar el ID de la AMI de la región que aloja la VPC. Para obtener más información, consulte Recuperación de los metadatos de la AMI optimizada para Amazon ECS.

2. Utilice la consola de Amazon EC2 para lanzar la instancia.

   1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

   2. En la barra de navegación, seleccione la región a utilizar.

   3. En el panel de EC2, elija Launch Instance (Lanzar instancia).

   4. En Name (Nombre), escriba un nombre único.

   5. En Application and OS Images (Amazon Machine Image) (Imágenes de aplicaciones y SO [Amazon Machine Image]), elija la AMI que recuperó en el primer paso.

   6. Para Tipo de instancia, elija t3.xlarge.

   7. En Key pair (login) (Par de claves [inicio de sesión]), elija un par de claves.

   8. En Network settings (Configuración de red), para Security groups (Grupo de seguridad), seleccione un grupo de seguridad existente o cree uno nuevo.

   9. En Network settings (Configuración de red), para Auto-assign Public IP (Asignar automáticamente una IP pública), selecciona Enable (Activar).

   10. En Advanced details (Detalles avanzados), en IAM instance profile (Perfil de instancia de IAM), elija ecsInstanceRole.

   11. Configure su instancia de contenedor de Amazon ECS con los siguientes datos de usuario. En Advanced details (Detalles avanzados), pegue el siguiente script en el campo User data (Datos de usuario), reemplazando cluster_name con el nombre de su clúster.

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

   12. Cuando esté listo, seleccione el campo de confirmación y después elija Launch Instances.

   13. Verá una página de confirmación que indicará que la instancia se está lanzando. Elija View instances para cerrar la página de confirmación y volver a la consola.

Para registrar una definición de tareas

1. Cree un archivo denominado fluent-bit.json con el siguiente contenido.

   Reemplace las siguientes variables:

   • task-iam-role con el nombre de recurso de Amazon (ARN) del rol de IAM de su tarea

   • region con la región en la que se ejecuta la tarea

   {
     "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. Ejecute el siguiente comando para registrar la definición de tarea.

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

   Puede enumerar las definiciones de tarea para su cuenta con el comando list-task-definitions. El resultado muestra los valores de familia y revisión que puede usar junto con run-task o start-task.

Para ejecutar una tarea

1. Ejecute el siguiente comando para iniciar la definición de tarea ecs-windows-fluent-bit:1 (registrada en el paso anterior) como servicio.

   nota

   Esta definición de tareas utiliza el controlador de registro awslogs; la instancia de contenedor debe tener los permisos necesarios.

   Reemplace las siguientes variables:

   • region con la región en la que se ejecuta el servicio

   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. Ejecute el siguiente comando para enumerar las tareas.

   Reemplace las siguientes variables:

   • region con la región en la que se ejecutan las tareas de servicio

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

Para registrar una definición de tareas

1. Cree un archivo denominado windows-app-task.json con el siguiente contenido.

   {
     "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. Ejecute el siguiente comando para registrar la definición de tarea.

   Reemplace las siguientes variables:

   • region con la región en la que se ejecuta la tarea

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

   Puede enumerar las definiciones de tarea para su cuenta con el comando list-task-definitions. El resultado muestra los valores de familia y revisión que puede usar junto con run-task o start-task.

Para ejecutar una tarea

1. Ejecute la definición de tarea windows-app-task:1 registrada en el paso anterior.

   Reemplace las siguientes variables:

   • region con la región en la que se ejecuta la tarea

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

2. Ejecute el siguiente comando para enumerar las tareas.

   aws ecs list-tasks --cluster FluentBit-cluster

Para verificar la configuración de Fluent Bit

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación, seleccione Grupos de registro. Asegúrese de que está en la región donde ha implementado Fluent Bit en los contenedores.

   En la lista de grupos de registro de la Región de AWS, debería ver lo siguiente:

   • /ecs/fluent-bit-logs

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

   Si ve estos grupos de registro, la configuración de Fluent Bit es correcta.

Para borrar los recursos del tutorial, realice el siguiente procedimiento:

1. Detenga la tarea windows-simple-task y la tarea ecs-fluent-bit. Para obtener más información, consulte Detención de una tarea de Amazon ECS.

2. Ejecute el siguiente comando para eliminar el grupo de registro /ecs/fluent-bit-logs. Para obtener más información sobre la eliminación de grupos de registro, consulte delete-log-group en la Referencia de la AWS Command Line Interface.

   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. Ejecute el siguiente comando para finalizar la instancia.

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

4. Ejecute los siguientes comandos para eliminar los roles de IAM.

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

5. Ejecute el siguiente comando para eliminar el clúster de Amazon ECS.

   aws ecs delete-cluster --cluster FluentBit-cluster