|
| 1 | +# Rocky Linux and Alma Linux |
| 2 | + |
| 3 | +Fluent Bit is distributed as the `fluent-bit` package and is available for the latest |
| 4 | +versions of Rocky or Alma Linux now that CentOS Stream is tracking more recent dependencies. |
| 5 | + |
| 6 | +Fluent Bit supports the following architectures: |
| 7 | + |
| 8 | +- `x86_64` |
| 9 | +- `aarch64` |
| 10 | +- `arm64v8` |
| 11 | + |
| 12 | +## Single line install |
| 13 | + |
| 14 | +Fluent Bit provides an installation script to use for most Linux targets. |
| 15 | +This will always install the most recently released version. |
| 16 | + |
| 17 | +```bash |
| 18 | +curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh |
| 19 | +``` |
| 20 | + |
| 21 | +This is a convenience helper and should always be validated prior to use. |
| 22 | +Older versions of this install script will not support auto-detecting Rocky or Alma Linux. |
| 23 | +The recommended secure deployment approach is to use the following instructions: |
| 24 | + |
| 25 | +## RHEL 9 |
| 26 | + |
| 27 | +From CentOS 9 Stream onwards, the CentOS dependencies will update more often than downstream usage. |
| 28 | +This may mean that incompatible (more recent) versions are provided of certain dependencies (e.g. OpenSSL). |
| 29 | +For OSS, we also provide RockyLinux and AlmaLinux repositories. |
| 30 | +This may be required for RHEL 9 as well which will no longer track equivalent CentOS 9 stream dependencies. |
| 31 | +No RHEL 9 build is provided, it is expected to use one of the OSS variants listed. |
| 32 | + |
| 33 | +## Configure Yum |
| 34 | + |
| 35 | +The `fluent-bit` is provided through a Yum repository. |
| 36 | +To add the repository reference to your system: |
| 37 | + |
| 38 | +1. In `/etc/yum.repos.d/`, add a new file called `fluent-bit.repo`. |
| 39 | +1. Add the following content to the file - replace `almalinux` with `rockylinux` if required: |
| 40 | + |
| 41 | + ```text |
| 42 | + [fluent-bit] |
| 43 | + name = Fluent Bit |
| 44 | + baseurl = https://packages.fluentbit.io/almalinux/$releasever/ |
| 45 | + gpgcheck=1 |
| 46 | + gpgkey=https://packages.fluentbit.io/fluentbit.key |
| 47 | + repo_gpgcheck=1 |
| 48 | + enabled=1 |
| 49 | + ``` |
| 50 | + |
| 51 | +1. As a best practice, enable `gpgcheck` and `repo_gpgcheck` for security reasons. |
| 52 | + Fluent Bit signs its repository metadata and all Fluent Bit packages. |
| 53 | + |
| 54 | +## Install |
| 55 | + |
| 56 | +1. After your repository is configured, run the following command to install it: |
| 57 | + |
| 58 | + ```bash |
| 59 | + sudo yum install fluent-bit |
| 60 | + ``` |
| 61 | + |
| 62 | +1. Instruct `Systemd` to enable the service: |
| 63 | + |
| 64 | + ```bash |
| 65 | + sudo systemctl start fluent-bit |
| 66 | + ``` |
| 67 | + |
| 68 | +If you do a status check, you should see a similar output like this: |
| 69 | + |
| 70 | +```bash |
| 71 | +$ systemctl status fluent-bit |
| 72 | +● fluent-bit.service - Fluent Bit |
| 73 | + Loaded: loaded (/usr/lib/systemd/system/fluent-bit.service; disabled; vendor preset: disabled) |
| 74 | + Active: active (running) since Thu 2016-07-07 02:08:01 BST; 9s ago |
| 75 | + Main PID: 3820 (fluent-bit) |
| 76 | + CGroup: /system.slice/fluent-bit.service |
| 77 | + └─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf |
| 78 | +... |
| 79 | +``` |
| 80 | + |
| 81 | +The default Fluent Bit configuration collect metrics of CPU usage and sends the |
| 82 | +records to the standard output. You can see the outgoing data in your |
| 83 | +`/var/log/messages` file. |
| 84 | + |
0 commit comments