Fluent Bit Docker Image

This is Sumo Logic fork of the Fluent Bit Docker Image repository.

To build and release new images for a specific version of Fluent Bit X.Y.Z, create an annotated tag on this repository like vX.Y.Z-sumo-A, where X, Y, Z and A are numbers. For example, to build images for Fluent Bit 1.8.12, run this:

git tag -am "v1.8.12-sumo-1" v1.8.12-sumo-1
git push origin v1.8.12-sumo-1

Creating the tag will trigger GitHub Actions workflow that you can find in the .github/workflows directory.

To build a new image locally, for example to test it before releasing, run:

./ci/build-local-x86_64.sh

The locally built image will be named fluent-bit and the tag will be the result of git describe --tags command. Override these with:

REPO_URL=custom-repo/fluent-bit BUILD_TAG=test-1 ./ci/build-local-x86_64.sh

This will build image named custom-repo/fluent-bit:test-1.

Original README follows.

Fluent Bit container images are available on Docker Hub ready for production usage. Our stable images are based in Distroless focusing on security containing just the Fluent Bit binary, minimal system libraries and basic configuration.

Optionally, we provide debug images which contains Busybox that can be used to troubleshoot or testing purposes.

For a detailed list of Tags and versions available, please refer to the the official documentation:

https://docs.fluentbit.io/manual/installation/docker

1. Checkout Branch

Fluent Bit Dockerfiles are located in separated branches with proper tags:

Branch	Tags Available
1.2	1.2, 1.2-debug, 1.2.0, 1.2.0-debug, 1.2.1, 1.2.1-debug
1.1	1.1, 1.1-debug, 1.1.0, 1.1.0-debug, 1.1.1, 1.1.1-debug, 1.1.2, 1.1.2-debug, 1.1.3, 1.1.3-debug
1.0	1.0, 1.0-debug, 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.0.3-debug, 1.0.4, 1.0.4-debug, 1.0.5, 1.0.5-debug, 1.0.6, 1.0.6-debug
0.14	0.14, 0.14.0, 0.14.1, 0.14.2, 0.14.3, 0.14.4, 0.14.5, 0.14.6, 0.14.7, 0.14.8, 0.14.9
0.13	0.13, 0.13.0, 0.13.1, 0.13.2, 0.13.3, 0.13.4, 0.13.5, 0.13.6, 0.13.7, 0.13.8
0.12	0.12, 0.12.19, 0.12.18, 0.12.17, 0.12.16, 0.12.15, 0.12.14, 0.12.13, 0.12.12, 0.12.11, 0.12.10, 0.12.9, 0.12.8, 0.12.7, 0.12.6, 0.12.5, 0.12.4, 0.12.3, 0.12.2, 0.12.1, 0.12.0

2. Build image

Use docker build command to build the image. This example names the image "fluent-bit:latest":

$ docker build -t fluent/fluent-bit:1.2 ./

3. Test it

Once the image is built, it's ready to run:

docker run -p 127.0.0.1:24224:24224 fluent/fluent-bit:latest

By default, the configuration set a listener on TCP port 24224 through Forward protocol and prints to the standard output interface each message. So this can be used to forward Docker log messages from one container to the Fluent Bit image, e.g:

$ docker run --log-driver=fluentd -t ubuntu echo "Testing a log message"

On Fluent Bit container will print to stdout something like this:

Fluent Bit v1.2.x
Copyright (C) Treasure Data

[0] docker.31c94ceb86ca: [1487548735, {"container_id"=>"31c94ceb86cae7055564eb4d65cd2e2897addd252fe6b86cd11bddd70a871c08", "container_name"=>"/admiring_shannon", "source"=>"stdout","}]og"=>"Testing a log message

Contact

Feel free to join us on our Mailing List or IRC:

Slack: http://slack.fluentd.org / channel #fluent-bit
Mailing List: https://groups.google.com/forum/#!forum/fluent-bit
IRC: irc.freenode.net #fluent-bit
Twitter: http://twitter.com/fluentbit

License

This program is under the terms of the Apache License v2.0.

Authors

Fluent Bit is made and sponsored by Treasure Data among other contributors.