Skip to content

Commit

Permalink
Merge pull request #1524 from fluent/lynettemiles/sc-105708/update-in…
Browse files Browse the repository at this point in the history
…stallation-aws-container-md-fluent
  • Loading branch information
esmerel authored Dec 3, 2024
2 parents b5509e7 + 1f18033 commit efba05e
Showing 1 changed file with 30 additions and 19 deletions.
49 changes: 30 additions & 19 deletions installation/aws-container.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,57 @@
# Containers on AWS

AWS maintains a distribution of Fluent Bit combining the latest official release with a set of Go Plugins for sending logs to AWS services. AWS and Fluent Bit are working together to rewrite their plugins for inclusion in the official Fluent Bit distribution.
AWS maintains a distribution of Fluent Bit that combines the latest official release with
a set of Go Plugins for sending logs to AWS services. AWS and Fluent Bit are working
together to rewrite their plugins for inclusion in the official Fluent Bit
distribution.

## Plugins

Currently, the [AWS for Fluent Bit](https://github.com/aws/aws-for-fluent-bit) image contains Go Plugins for:
The [AWS for Fluent Bit](https://github.com/aws/aws-for-fluent-bit) image contains Go
Plugins for:

* [Amazon CloudWatch Logs](https://github.com/aws/amazon-cloudwatch-logs-for-fluent-bit)
* [Amazon Kinesis Firehose](https://github.com/aws/amazon-kinesis-firehose-for-fluent-bit)
* [Amazon Kinesis Streams](https://github.com/aws/amazon-kinesis-streams-for-fluent-bit)
- Amazon CloudWatch as `cloudwatch_logs`. See the
[Fluent Bit docs](https://docs.fluentbit.io/manual/pipeline/outputs/cloudwatch) or the
[Plugin repository](https://github.com/aws/amazon-cloudwatch-logs-for-fluent-bit).
- Amazon Kinesis Data Firehose as `kinesis_firehose`. See the
[Fluent Bit docs](https://docs.fluentbit.io/manual/pipeline/outputs/firehose) or the
[Plugin repository](https://github.com/aws/amazon-kinesis-firehose-for-fluent-bit).
- Amazon Kinesis Data Streams as `kinesis_streams`. See the
[Fluent Bit docs](https://docs.fluentbit.io/manual/pipeline/outputs/kinesis) or the
[Plugin repository](https://github.com/aws/amazon-kinesis-streams-for-fluent-bit).

Fluent Bit includes Amazon CloudWatch Logs plugin named `cloudwatch_logs`, Amazon Kinesis Firehose plugin named `kinesis_firehose` and Amazon Kinesis Data Streams plugin named `kinesis_streams` which are higher performance than Go plugins.
These plugins are higher performance than Go plugins.

* [Amazon CloudWatch](https://docs.fluentbit.io/manual/pipeline/outputs/cloudwatch)
* [Amazon Kinesis Data Firehose](https://docs.fluentbit.io/manual/pipeline/outputs/firehose)
* [Amazon Kinesis Data Streams](https://docs.fluentbit.io/manual/pipeline/outputs/kinesis)
Also, Fluent Bit includes an S3 output plugin named `s3`.

Also, Fluent Bit includes S3 output plugin named `s3`.

* [Amazon S3](https://docs.fluentbit.io/manual/pipeline/outputs/s3)
- [Amazon S3](https://docs.fluentbit.io/manual/pipeline/outputs/s3)

## Versions and Regional Repositories

AWS vends their container image via [Docker Hub](https://hub.docker.com/r/amazon/aws-for-fluent-bit), and a set of highly available regional Amazon ECR repositories. For more information, see the [AWS for Fluent Bit GitHub repo](https://github.com/aws/aws-for-fluent-bit#public-images).
AWS vends their container image using
[Docker Hub](https://hub.docker.com/r/amazon/aws-for-fluent-bit), and a set of highly
available regional Amazon ECR repositories. For more information, see the
[AWS for Fluent Bit GitHub repository](https://github.com/aws/aws-for-fluent-bit#public-images).

The AWS for Fluent Bit image uses a custom versioning scheme because it contains multiple projects. To see what each release contains, check out the [release notes on GitHub](https://github.com/aws/aws-for-fluent-bit/releases).
The AWS for Fluent Bit image uses a custom versioning scheme because it contains
multiple projects. To see what each release contains, see the [release notes on
GitHub](https://github.com/aws/aws-for-fluent-bit/releases).

## SSM Public Parameters

AWS vends SSM Public Parameters with the regional repository link for each image. These parameters can be queried by any AWS account.
AWS vends SSM public parameters with the regional repository link for each image.
These parameters can be queried by any AWS account.

To see a list of available version tags in a given region, run the following command:

```text
```bash
aws ssm get-parameters-by-path --region eu-central-1 --path /aws/service/aws-for-fluent-bit/ --query 'Parameters[*].Name'
```

To see the ECR repository URI for a given image tag in a given region, run the following:

```text
$ aws ssm get-parameter --region ap-northeast-1 --name /aws/service/aws-for-fluent-bit/2.0.0
```bash
aws ssm get-parameter --region ap-northeast-1 --name /aws/service/aws-for-fluent-bit/2.0.0
```

You can use these SSM public parameters as parameters in your CloudFormation templates:
Expand All @@ -51,4 +63,3 @@ Parameters:
Type: AWS::SSM::Parameter::Value<String>
Default: /aws/service/aws-for-fluent-bit/latest
```

0 comments on commit efba05e

Please sign in to comment.