Amazon ECS Windows 컨테이너에서 Fluent Bit 배포

1. Amazon ECS 컨테이너 인스턴스 역할 "ecsInstanceRole"을 생성합니다. 자세한 내용은 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)(애플리케이션 및 OS 이미지(Amazon Machine Image))에서 첫 번째 단계에서 검색한 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. 확인 페이지에서 인스턴스가 실행 중인지 확인할 수 있습니다. 인스턴스 보기를 선택하여 확인 페이지를 닫고 콘솔로 돌아갑니다.

태스크 정의를 등록하려면

1. 다음 콘텐츠를 가진 fluent-bit.json이라는 파일을 생성합니다:

   다음 변수를 바꿉니다.

   • task-iam-role을 작업 IAM 역할의 Amazon 리소스 이름(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. 탐색 창에서 로그 그룹을 선택합니다. 컨테이너에 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