Amazon ECS용 AWS for Fluent Bit 이미지 리포지토리

AWS는 CloudWatch Logs와 Firehose 둘 다에 대한 플러그인을 갖춘 Fluent Bit 이미지를 제공해요. Fluentd보다 리소스 사용률이 낮기 때문에 로그 라우터로 Fluent Bit를 사용할 것을 권장합니다. 자세한 내용은 Fluent Bit용 CloudWatch Logs와 Fluent Bit용 Amazon Kinesis Firehose를 참고하세요.

출처: 문서

본문

AWS for Fluent Bit 이미지는 고가용성을 위해 Amazon ECR Public Gallery와 Amazon ECR 리포지토리 둘 다에 있습니다.

Amazon ECR Public Gallery

AWS for Fluent Bit 이미지는 Amazon ECR Public Gallery에서 사용할 수 있어요. 퍼블릭 리포지토리이며 모든 AWS 리전에서 사용할 수 있으므로, AWS for Fluent Bit 이미지를 다운로드하기에 권장되는 위치입니다. 자세한 내용은 Amazon ECR Public Gallery의 aws-for-fluent-bit를 참고하세요.

Linux

Amazon ECR Public Gallery의 AWS for Fluent Bit 이미지는 ARM64 또는 x86-64 아키텍처를 가진 Amazon Linux 운영 체제를 지원해요. 원하는 이미지 태그와 함께 리포지토리 URL을 지정하면 Amazon ECR Public Gallery에서 AWS for Fluent Bit 이미지를 풀할 수 있습니다. 사용 가능한 이미지 태그는 Amazon ECR Public Gallery의 Image tags 탭에서 찾을 수 있어요.

다음은 Docker CLI에서 사용할 구문입니다:

docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:tag

예를 들어, 다음 Docker CLI 명령으로 AWS for Fluent Bit 릴리스의 "3.x" 패밀리에서 최신 이미지를 풀할 수 있어요:

docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:3

참고: 인증되지 않은 풀(unauthenticated pull)은 허용되지만 인증된 풀보다 낮은 속도 제한이 적용됩니다. 풀 전에 AWS 계정으로 인증하려면 다음 명령을 사용하세요:

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

AWS for Fluent Bit 3.0.0

기존 AWS for Fluent Bit 2.x 버전에 더해, AWS for Fluent Bit는 새 메이저 버전 3.x를 지원해요. 새 메이저 버전에는 이미지를 Amazon Linux 2에서 Amazon Linux 2023으로, Fluent Bit 버전을 1.9.10에서 4.1.1로 업그레이드하는 것이 포함됩니다. 자세한 내용은 GitHub의 AWS for Fluent Bit 리포지토리를 참고하세요.

AWS for Fluent Bit 3.x 이미지에 대한 업데이트된 태그 예시는 다음과 같습니다. AWS for Fluent Bit 이미지에는 멀티 아키텍처 태그를 사용할 수 있어요.

docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:3

Windows

Amazon ECR Public Gallery의 AWS for Fluent Bit 이미지는 다음 운영 체제와 함께 AMD64 아키텍처를 지원해요:

Windows Server 2022 Full
Windows Server 2022 Core
Windows Server 2019 Full
Windows Server 2019 Core

AWS Fargate에 있는 Windows 컨테이너는 FireLens를 지원하지 않습니다. 원하는 이미지 태그와 함께 리포지토리 URL을 지정하면 Amazon ECR Public Gallery에서 AWS for Fluent Bit 이미지를 풀할 수 있어요. 사용 가능한 이미지 태그는 Amazon ECR Public Gallery의 Image tags 탭에서 찾을 수 있습니다.

다음은 Docker CLI에서 사용할 구문입니다:

docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:tag

예를 들어, 다음 Docker CLI 명령으로 최신 안정 AWS for Fluent Bit 이미지를 풀할 수 있어요:

docker pull public.ecr.aws/aws-observability/aws-for-fluent-bit:windowsservercore-stable

참고: 인증되지 않은 풀은 허용되지만 인증된 풀보다 낮은 속도 제한이 적용됩니다. 풀 전에 AWS 계정으로 인증하려면 다음 명령을 사용하세요:

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

Amazon ECR

AWS for Fluent Bit 이미지는 고가용성을 위해 Amazon ECR에서도 사용할 수 있어요. 다음 명령을 사용해 특정 AWS 리전에서 이미지 URI를 가져오고 이미지 가용성을 확인할 수 있습니다.

Linux

다음 명령으로 최신 안정 AWS for Fluent Bit 이미지 URI를 가져올 수 있어요:

aws ssm get-parameters \
      --names /aws/service/aws-for-fluent-bit/stable \
      --region us-east-1

다음 명령으로 Systems Manager Parameter Store 파라미터를 조회해 모든 버전의 AWS for Fluent Bit 이미지를 나열할 수 있어요:

aws ssm get-parameters-by-path \
      --path /aws/service/aws-for-fluent-bit \
      --region us-east-1

CloudFormation 템플릿에서 Systems Manager 파라미터 스토어 이름을 참조해 최신 안정 AWS for Fluent Bit 이미지를 참조할 수 있어요. 다음은 예시입니다:

Parameters:
  FireLensImage:
    Description: Fluent Bit image for the FireLens Container
    Type: AWS::SSM::Parameter::Value<String>
    Default: /aws/service/aws-for-fluent-bit/stable

참고: 명령이 실패하거나 출력이 없으면, 명령이 호출된 AWS 리전에서 이미지를 사용할 수 없다는 뜻입니다.

Windows

다음 명령으로 최신 안정 AWS for Fluent Bit 이미지 URI를 가져올 수 있어요:

aws ssm get-parameters \
      --names /aws/service/aws-for-fluent-bit/windowsservercore-stable \
      --region us-east-1

다음 명령으로 Systems Manager Parameter Store 파라미터를 조회해 모든 버전의 AWS for Fluent Bit 이미지를 나열할 수 있어요:

aws ssm get-parameters-by-path \
      --path /aws/service/aws-for-fluent-bit/windowsservercore \
      --region us-east-1

CloudFormation 템플릿에서 Systems Manager 파라미터 스토어 이름을 참조해 최신 안정 AWS for Fluent Bit 이미지를 참조할 수 있어요. 다음은 예시입니다:

Parameters:
  FireLensImage:
    Description: Fluent Bit image for the FireLens Container
    Type: AWS::SSM::Parameter::Value<String>
    Default: /aws/service/aws-for-fluent-bit/windowsservercore-stable