-
Notifications
You must be signed in to change notification settings - Fork 541
Update ubuntu install page for style and grammar #1548
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
esmerel
merged 6 commits into
master
from
lynettemiles/sc-105725/update-installation-linux-ubuntu-md-fluent
Jan 16, 2025
Merged
Changes from 4 commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
f49fc95
Update ubuntu install page for style and grammar
esmerel d1934bc
Update ubuntu.md
esmerel e2fcffd
Update ubuntu.md
esmerel 55a7a4f
Update ubuntu.md
esmerel 40b269b
Apply suggestions from code review
esmerel 208ac5f
Apply suggestions from code review
esmerel File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,32 +1,38 @@ | ||
| # Ubuntu | ||
|
|
||
| Fluent Bit is distributed as **fluent-bit** package and is available for long-term support releases of Ubuntu. | ||
| The latest officially supported version is Noble Numbat (24.04). | ||
| Fluent Bit is distributed as the `fluent-bit` package and is available for long-term | ||
| support releases of Ubuntu. The latest officially supported version is Noble Numbat | ||
| (24.04). | ||
|
|
||
| ## Single line install | ||
|
|
||
| A simple installation script is provided to be used for most Linux targets. | ||
| An installation script is provided to be used for most Linux targets. | ||
| This will always install the most recent version released. | ||
|
|
||
| ```bash | ||
| curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh | ||
| ``` | ||
|
|
||
| This is purely a convenience helper and should always be validated prior to use. | ||
| The recommended secure deployment approach is to follow the instructions below. | ||
| The recommended secure deployment approach is to use the following instructions. | ||
|
|
||
| ## Server GPG key | ||
|
|
||
| The first step is to add our server GPG key to your keyring to ensure you can get our signed packages. | ||
| Follow the official Debian wiki guidance: <https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution> | ||
| The first step is to add the Fluent Bit server GPG key to your keyring to ensure | ||
| you can get the correct signed packages. | ||
|
|
||
| Follow the official | ||
| [Debian wiki guidance](https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP_Key_distribution). | ||
|
|
||
| ```bash | ||
| curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg | ||
| ``` | ||
|
|
||
| ### Updated key from March 2022 | ||
|
|
||
| From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at [https://packages.fluentbit.io/fluentbit.key](https://packages.fluentbit.io/fluentbit.key) so ensure this new one is added. | ||
| For releases 1.9.0 and 1.8.15 and later, the | ||
| [GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). Ensure | ||
| the new key is added. | ||
|
|
||
| The GPG Key fingerprint of the new key is: | ||
|
|
||
|
|
@@ -35,53 +41,58 @@ C3C0 A285 34B9 293E AF51 FABD 9F9D DC08 3888 C1CD | |
| Fluentbit releases (Releases signing key) <[email protected]> | ||
| ``` | ||
|
|
||
| The previous key is still available at [https://packages.fluentbit.io/fluentbit-legacy.key](https://packages.fluentbit.io/fluentbit-legacy.key) and may be required to install previous versions. | ||
| The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key) | ||
| and might be required to install previous versions. | ||
|
|
||
| The GPG Key fingerprint of the old key is: | ||
|
|
||
| ```text | ||
| F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A | ||
| ``` | ||
|
|
||
| Refer to the [supported platform documentation](../supported-platforms.md) to see which platforms are supported in each release. | ||
| Refer to the [supported platform documentation](../supported-platforms.md) to see | ||
| which platforms are supported in each release. | ||
|
|
||
| ## Update your sources lists | ||
|
|
||
| On Ubuntu, you need to add our APT server entry to your sources lists, please add the following content at bottom of your **/etc/apt/sources.list** file - ensure to set `CODENAME` to your specific [Ubuntu release name](https://wiki.ubuntu.com/Releases) (e.g. `focal` for Ubuntu 20.04): | ||
| On Ubuntu, you need to add the Fluent Bit APT server entry to your sources lists. | ||
| Add the following content at bottom of your `/etc/apt/sources.list` file. Ensure | ||
| `CODENAME` is set to your specific [Ubuntu release name](https://wiki.ubuntu.com/Releases) | ||
| (for example: `focal` for Ubuntu 20.04): | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ```bash | ||
| deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluentbit.io/ubuntu/${CODENAME} ${CODENAME} main | ||
| ``` | ||
|
|
||
| ### Update your repositories database | ||
|
|
||
| Now let your system update the _apt_ database: | ||
| Now let your system update the `apt` database: | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ```bash | ||
| sudo apt-get update | ||
| ``` | ||
|
|
||
| {% hint style="info" %} | ||
| We recommend upgrading your system (`sudo apt-get upgrade`). This could avoid potential issues with expired certificates. | ||
| {% endhint %} | ||
| Fluent Bit recommends upgrading your system (`sudo apt-get upgrade`). This could | ||
| avoid potential issues with expired certificates. | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| {% hint style="info" %} | ||
| If you have the following error "Certificate verification failed", you might want to check if the package `ca-certificates` is properly installed (`sudo apt-get install ca-certificates`). | ||
| If you have the error `Certificate verification failed`, check if the package | ||
| `ca-certificates` is properly installed (`sudo apt-get install ca-certificates`). | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| {% endhint %} | ||
|
|
||
| ## Install Fluent Bit | ||
|
|
||
| Using the following _apt-get_ command you are able now to install the latest _fluent-bit_: | ||
| 1. Use the following `apt-get` command to install the latest Fluent Bit: | ||
|
|
||
| ```text | ||
| sudo apt-get install fluent-bit | ||
| ``` | ||
| ```bash | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| sudo apt-get install fluent-bit | ||
| ``` | ||
|
|
||
| Now the following step is to instruct _systemd_ to enable the service: | ||
| 1. Instruct `systemd` to enable the service: | ||
|
|
||
| ```bash | ||
| sudo systemctl start fluent-bit | ||
| ``` | ||
| ```bash | ||
esmerel marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| sudo systemctl start fluent-bit | ||
| ``` | ||
|
|
||
| If you do a status check, you should see a similar output like this: | ||
|
|
||
|
|
@@ -99,4 +110,6 @@ systemctl status fluent-bit | |
| ... | ||
| ``` | ||
|
|
||
| The default configuration of **fluent-bit** is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your _/var/log/syslog_ file. | ||
| The default configuration of `fluent-bit` is collecting metrics of CPU usage and | ||
| sending the records to the standard output. You can see the outgoing data in your | ||
| `/var/log/syslog` file. | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.