在 Amazon ECS Windows 容器上部署 Fluent Bit

1. 创建名为“ecsInstanceRol”的 Amazon ECS 容器实例角色。有关更多信息，请参阅 Amazon ECS 容器实例 IAM 角色。

2. 为名为 fluentTaskRole 的 Fluent Bit 任务创建一个 IAM 角色。有关更多信息，请参阅 Amazon ECS 任务 IAM 角色。

   在此 IAM 角色中被授予的 IAM 权限由任务容器承担。为了允许 Fluent Bit 向 CloudWatch 发送日志，您需要为任务 IAM 角色附加以下权限。

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

3. 将 策略附加到该角色。

   1. 将上述内容保存在名为 fluent-bit-policy.json 的文件中。

   2. 运行以下命令将内联策略附加到 fluentTaskRole IAM 角色。

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

创建 Amazon ECS 实例

1. 使用 aws ssm get-parameters 命令检索托管您 VPC 的区域的 AMI ID。有关更多信息，请参阅检索经 Amazon ECS 优化的 AMI 元数据。

2. 用来创建启动实例的 Amazon EC2 控制台。

   1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

   2. 从导航栏中，选择要使用的区域。

   3. 从 EC2 控制面板中，选择 Launch Instance（启动实例）。

   4. 对于 Name (名称)，输入唯一的名称。

   5. 对于 Application and OS Images (Amazon Machine Image)（应用程序和操作系统映像 [Amazon 系统映像]），选择您在第一步中检索的 AMI。

   6. 对于实例类型，选择 t3.xlarge。

   7. 对于 Key pair (login)（密钥对 [登录]），选择一个密钥对。

   8. 在 Network settings（网络设置）下，对于 Security group（安全组），可以选择现有安全组或创建新安全组。

   9. 在 Network settings（网络设置）下，对于 Auto-assign Public IP（自动分配公有 IP），选择 Enable（启用）。

   10. 在 Advanced details（高级详细信息）下，对于 IAM instance profile（IAM 实例配置文件），选择 ecsInstanceRole。

   11. 使用以下用户数据配置您的 Amazon ECS 容器实例。在 Advanced Details（高级详细信息）下，将以下脚本粘贴到 User data（用户数据）字段中，将 cluster_name 替换为您的集群的名称。

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

   12. 准备好后，选中确认字段，然后选择 Launch Instances。

   13. 确认页面会让您知道自己的实例已启动。选择 View Instances 以关闭确认页面并返回控制台。

注册任务定义

1. 使用以下内容创建名为 fluent-bit.json 的文件。

   替换以下变量：

   • 用您的任务 IAM 角色的 Amazon 资源名称（ARN）替换 task-iam-role

   • 用您的任务运行所在的区域替换 region

   {
     "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. 运行以下命令注册任务定义。

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

   您可以通过运行 list-task-definitions 命令列出您的账户的任务定义。输出显示了可以与 run-task 或 start-task 一起使用的系列和修订版本值。

运行任务

1. 运行以下命令将 ecs-windows-fluent-bit:1 任务定义（在上一步中注册）作为服务启动。

   注意

   此任务定义使用 awslogs 日志记录驱动程序，您的容器实例需要具有必要的权限。

   替换以下变量：

   • 用您的服务运行所在的区域替换 region

   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. 运行以下命令列出您的任务。

   替换以下变量：

   • 用您的服务任务运行所在的区域替换 region

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

注册任务定义

1. 使用以下内容创建名为 windows-app-task.json 的文件。

   {
     "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. 运行以下命令注册任务定义。

   替换以下变量：

   • 用您的任务运行所在的区域替换 region

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

   您可以通过运行 list-task-definitions 命令列出您的账户的任务定义。输出显示了可以与 run-task 或 start-task 一起使用的系列和修订版本值。

运行任务

1. 运行您在上一步中注册的 windows-app-task:1 任务定义。

   替换以下变量：

   • 用您的任务运行所在的区域替换 region

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

2. 运行以下命令列出您的任务。

   aws ecs list-tasks --cluster FluentBit-cluster

验证 Fluent Bit 设置

1. 通过 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

2. 在导航窗格中，选择 Log groups（日志组）。确保您位于将 Fluent Bit 部署到您的容器的区域中。

   在 AWS 区域 的日志组列表中，您将会看到以下内容：

   • /ecs/fluent-bit-logs

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

   如果看到这些日志组，则代表 Fluent Bit 设置已验证。

清除教程资源

1. 停止 windows-simple-task 任务和 ecs-fluent-bit 任务。有关更多信息，请参阅 停止 Amazon ECS 任务。

2. 运行以下命令删除 /ecs/fluent-bit-logs 日志组。有关删除日志组的更多信息，请参阅《AWS Command Line Interface 参考》中的 delete-log-group。

   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. 运行以下命令终止实例。

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

4. 运行以下命令删除 IAM 角色。

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

5. 运行以下命令删除 Amazon ECS 集群。

   aws ecs delete-cluster --cluster FluentBit-cluster