Menyebarkan Fluent Bit di Amazon Windows container ECS

1. Buat peran instance ECS penampung Amazon bernama "ecsInstanceRole”. Untuk informasi selengkapnya, lihat IAMperan instans ECS penampung Amazon.

2. Buat IAM peran untuk tugas Fluent Bit bernamafluentTaskRole. Untuk informasi selengkapnya, lihat IAMPeran ECS tugas Amazon.

   IAMIzin yang diberikan dalam IAM peran ini diasumsikan oleh wadah tugas. Untuk memungkinkan Fluent Bit mengirim log ke CloudWatch, Anda harus melampirkan izin berikut ke peran tugasIAM.

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

3. Lampirkan kebijakan pada peran tersebut.

   1. Simpan konten di atas dalam file bernamafluent-bit-policy.json.

   2. Jalankan perintah berikut untuk melampirkan kebijakan sebaris ke fluentTaskRole IAM peran.

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

Untuk membuat ECS instance Amazon

1. Gunakan aws ssm get-parameters perintah untuk mengambil AMI ID untuk Wilayah yang menjadi tuan rumah AndaVPC. Untuk informasi selengkapnya, lihat Mengambil metadata Amazon ECS -Optimized AMI.

2. Gunakan EC2 konsol Amazon untuk meluncurkan instance.

   1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

   2. Dari bilah navigasi, pilih Wilayah untuk digunakan.

   3. Dari EC2Dasbor, pilih Launch instance.

   4. Untuk Nama, masukkan nama yang unik.

   5. Untuk Aplikasi dan Gambar OS (Amazon Machine Image), pilih AMI yang Anda ambil pada langkah pertama.

   6. Untuk jenis Instance, piliht3.xlarge.

   7. Untuk Key pair (login), pilih key pair.

   8. Di Pengaturan jaringan, untuk Grup keamanan, pilih grup keamanan yang sudah ada, atau buat grup keamanan baru.

   9. Di bawah Pengaturan jaringan, untuk Auto-assign IP Publik, pilih Aktifkan.

   10. Di bawah Detail lanjutan, IAMmisalnya profil, pilih ecsInstanceRole.

   11. Konfigurasikan instance ECS penampung Amazon Anda dengan data pengguna berikut. Di Advanced Details (Detail Lanjutan), tempelkan skrip berikut ke bidang Data pengguna, ganti cluster_name dengan nama klaster Anda.

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

   12. Saat Anda siap, pilih bidang pengakuan, lalu pilih Luncurkan Instans.

   13. Halaman konfirmasi memberi tahu Anda bahwa instans Anda akan diluncurkan. Pilih Lihat Instans untuk menutup halaman konfirmasi dan kembali ke konsol tersebut.

Untuk mendaftarkan ketentuan tugas

1. Buat file yang diberi nama fluent-bit.json dengan konten berikut ini.

   Ganti variabel berikut:

   • task-iam-role dengan Amazon Resource Name (ARN) dari IAM peran tugas Anda

   • region dengan Wilayah tempat tugas Anda berjalan

   {
     "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. Jalankan perintah berikut untuk mendaftarkan ketentuan tugas.

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

   Anda dapat mencantumkan daftar ketentuan tugas untuk akun Anda dengan menjalankan list-task-definitions perintah. Output menampilkan nilai keluarga dan revisi yang dapat Anda gunakan bersama dengan run-task ataustart-task.

Untuk menjalankan tugas

1. Jalankan perintah berikut untuk memulai definisi ecs-windows-fluent-bit:1 tugas (terdaftar pada langkah sebelumnya) sebagai layanan.

   catatan

   Definisi tugas ini menggunakan driver awslogs logging, instance container Anda harus memiliki izin yang diperlukan.

   Ganti variabel berikut:

   • region dengan Wilayah tempat layanan Anda berjalan

   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. Jalankan perintah berikut untuk membuat daftar tugas Anda.

   Ganti variabel berikut:

   • region dengan Wilayah tempat tugas layanan Anda berjalan

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

Untuk mendaftarkan ketentuan tugas

1. Buat file yang diberi nama windows-app-task.json dengan konten berikut ini.

   {
     "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. Jalankan perintah berikut untuk mendaftarkan ketentuan tugas.

   Ganti variabel berikut:

   • region dengan Wilayah tempat tugas Anda berjalan

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

   Anda dapat mencantumkan daftar ketentuan tugas untuk akun Anda dengan menjalankan list-task-definitions perintah. Output menampilkan nilai keluarga dan revisi yang dapat Anda gunakan bersama dengan run-task ataustart-task.

Untuk menjalankan tugas

1. Jalankan windows-app-task:1 ketentuan tugas yang telah Anda daftarkan pada langkah sebelumnya.

   Ganti variabel berikut:

   • region dengan Wilayah tempat tugas Anda berjalan

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

2. Jalankan perintah berikut untuk membuat daftar tugas Anda.

   aws ecs list-tasks --cluster FluentBit-cluster

Untuk memverifikasi pengaturan Fluent Bit

1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

2. Pada panel navigasi, pilih Grup log. Pastikan bahwa Anda berada di Wilayah tempat Anda men-deploy ke kontainer Anda.

   Dalam daftar grup log di Wilayah AWS, Anda akan melihat hal berikut:

   • /ecs/fluent-bit-logs

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

   Jika Anda melihat grup log ini, penyiapan Fluent Bit diverifikasi.

Untuk membersihkan sumber daya tutorial

1. Hentikan windows-simple-task tugas dan ecs-fluent-bit tugas. Untuk informasi selengkapnya, lihat Menghentikan ECS tugas Amazon.

2. Jalankan perintah berikut untuk menghapus grup /ecs/fluent-bit-logs log. Untuk informasi selengkapnya, tentang menghapus grup log lihat delete-log-groupdi AWS Command Line Interface Referensi.

   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. Jalankan perintah berikut untuk menghentikan instans.

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

4. Jalankan perintah berikut untuk menghapus IAM peran.

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

5. Jalankan perintah berikut untuk menghapus ECS klaster Amazon.

   aws ecs delete-cluster --cluster FluentBit-cluster