在 Amazon ECS Windows 容器上部署 Fluent Bit

1. 建立名為「ecsInstanceRole」的 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. 前往 https://console.aws.amazon.com/ec2/ 開啟 Amazon EC2 主控台。

   2. 從導覽列中選取要使用的「區域」。

   3. 在 EC2 儀表板中，選擇 Launch instance (啟動執行個體)。

   4. 在 Name (名稱) 輸入唯一的名稱。

   5. 在 Application and OS Images (Amazon Machine Image) (應用程式和作業系統映像 (Amazon Machine Image)) 欄位中，選擇您在步驟 1 中擷取的 AMI。

   6. 對於 Instance type (執行個體類型)，選擇 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. 準備就緒後，請選取 acknowledgment (確認) 欄位，再選擇 Launch Instances (啟動執行個體)。

   13. 會有確認頁面讓您知道您的執行個體正在啟動。選擇 View Instances (檢視執行個體) 關閉確認頁面並返回主控台。

註冊任務定義

1. 使用下列內容建立名為 fluent-bit.json 的檔案。

   取代下列變數：

   • 將 task-iam-role 替代為任務 IAM 角色的 Amazon Resource Name (ARN)

   • 將 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