Skip to content

Commit abc27ed

Browse files
author
Pat
authored
installation: updates for 1.9.9 release (#914)
Signed-off-by: Patrick Stephens <[email protected]> Signed-off-by: Patrick Stephens <[email protected]>
1 parent fae1ec9 commit abc27ed

File tree

2 files changed

+37
-33
lines changed

2 files changed

+37
-33
lines changed

installation/docker.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
Fluent Bit container images are available on Docker Hub ready for production usage. Current available images can be deployed in multiple architectures.
44

5-
### Quick Start
5+
## Quick Start
66

77
Get started by simply typing the following command:
88

9-
```
9+
```shell
1010
docker run -ti cr.fluentbit.io/fluent/fluent-bit
1111
```
1212

@@ -16,6 +16,10 @@ The following table describes the tags that are available on Docker Hub [fluent/
1616

1717
| Tag(s) | Manifest Architectures | Description |
1818
| ----------- | ------------------------- | ------------------------------------------------------------ |
19+
| 1.9.9 | x86\_64, arm64v8, arm32v7 | Release [v1.9.9](https://fluentbit.io/announcements/v1.9.9/) |
20+
| 1.9.9-debug | x86\_64, arm64v8, arm32v7 | v1.9.x releases (production + debug) |
21+
| 1.9.8 | x86\_64, arm64v8, arm32v7 | Release [v1.9.8](https://fluentbit.io/announcements/v1.9.8/) |
22+
| 1.9.8-debug | x86\_64, arm64v8, arm32v7 | v1.9.x releases (production + debug) |
1923
| 1.9.7 | x86\_64, arm64v8, arm32v7 | Release [v1.9.7](https://fluentbit.io/announcements/v1.9.7/) |
2024
| 1.9.7-debug | x86\_64, arm64v8, arm32v7 | v1.9.x releases (production + debug) |
2125
| 1.9.6 | x86\_64, arm64v8, arm32v7 | Release [v1.9.6](https://fluentbit.io/announcements/v1.9.6/) |
@@ -45,20 +49,20 @@ From a deployment perspective, there is no need to specify an architecture, the
4549

4650
Download the last stable image from 1.9 series:
4751

48-
```
52+
```shell
4953
docker pull cr.fluentbit.io/fluent/fluent-bit:1.9
5054
```
5155

5256
Once the image is in place, now run the following (useless) test which makes Fluent Bit measure CPU usage by the container:
5357

54-
```
58+
```shell
5559
docker run -ti cr.fluentbit.io/fluent/fluent-bit:1.9 \
5660
-i cpu -o stdout -f 1
5761
```
5862

5963
That command will let Fluent Bit measure CPU usage every second and flush the results to the standard output, e.g:
6064

61-
```
65+
```shell
6266
[2019/10/01 12:29:02] [ info] [engine] started
6367
[0] cpu.0: [1504290543.000487750, {"cpu_p"=>0.750000, "user_p"=>0.250000, "system_p"=>0.500000, "cpu0.p_cpu"=>0.000000, "cpu0.p_user"=>0.000000, "cpu0.p_system"=>0.000000, "cpu1.p_cpu"=>1.000000, "cpu1.p_user"=>0.000000, "cpu1.p_system"=>1.000000, "cpu2.p_cpu"=>1.000000, "cpu2.p_user"=>1.000000, "cpu2.p_system"=>0.000000, "cpu3.p_cpu"=>0.000000, "cpu3.p_user"=>0.000000, "cpu3.p_system"=>0.000000}]
6468
```

installation/windows.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Fluent Bit has two flavours of Windows installers: a ZIP archive (for quick test
77

88
Make sure to provide a valid Windows configuration with the installation, a sample one is shown below:
99

10-
```
10+
```python
1111
[SERVICE]
1212
# Flush
1313
# =====
@@ -80,19 +80,19 @@ Both are currently provided to allow migration.
8080

8181
## Installation Packages
8282

83-
The latest stable version is 1.9.7, each version is available on the Github release as well as at `https://fluentbit.io/releases/<Major Version>/Major>fluent-bit-<Full Version>-win[32|64].exe`:
83+
The latest stable version is 1.9.9, each version is available on the Github release as well as at `https://fluentbit.io/releases/<Major Version>/Major>fluent-bit-<Full Version>-win[32|64].exe`:
8484

8585
| INSTALLERS | SHA256 CHECKSUMS |
8686
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
87-
| [fluent-bit-1.9.7-win32.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win32.exe) | [e44dbd55298c2885a40a54cd2cc252ba6f9256a73fee155373044b4fd75bf3b9](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win32.exe.sha256) |
88-
| [fluent-bit-1.9.7-win32.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win32.zip) | [6767fca161d36ee38e24e775a3579f046a1ca6c97c92c6f8e1205cb1cefc10d1](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win32.zip.sha256) |
89-
| [fluent-bit-1.9.7-win64.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win64.exe) | [b6fcd36f12e7520485c6a8dda5851899e4ab0e65c2601fb699aaffe70bc7c86f](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win64.exe.sha256) |
90-
| [fluent-bit-1.9.7-win64.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win64.zip) | [6f1c9d8a5bfff47b309d892419c9c2515a1d1030f937406e419074403d788043](https://fluentbit.io/releases/1.9/fluent-bit-1.9.7-win64.zip.sha256) |
87+
| [fluent-bit-1.9.9-win32.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win32.exe) | [a9877bb8d51a06e16e249a7bb90f73dcd0a256be91f1dc2fa926aea5aad607d7](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win32.exe.sha256) |
88+
| [fluent-bit-1.9.9-win32.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win32.zip) | [3672e8b3d0dd9276f728490038d1a775beebef1740d73102269de305f85aa94f](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win32.zip.sha256) |
89+
| [fluent-bit-1.9.9-win64.exe](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win64.exe) | [916bb3ac9591070d8f24ca371c67c0cd6909ea2da280a8c134fe1734837ed4e9](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win64.exe.sha256) |
90+
| [fluent-bit-1.9.9-win64.zip](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win64.zip) | [8423ece1cb8694f741d6a4007f1cb9829447d816d5c76805386103e5cc12835b](https://fluentbit.io/releases/1.9/fluent-bit-1.9.9-win64.zip.sha256) |
9191

9292
To check the integrity, use `Get-FileHash` cmdlet on PowerShell.
9393

94-
```
95-
PS> Get-FileHash fluent-bit-1.9.7-win32.exe
94+
```powershell
95+
PS> Get-FileHash fluent-bit-1.9.9-win32.exe
9696
```
9797

9898
## Installing from ZIP archive
@@ -101,13 +101,13 @@ Download a ZIP archive from above. There are installers for 32-bit and 64-bit en
101101

102102
Then you need to expand the ZIP archive. You can do this by clicking "Extract All" on Explorer, or if you're using PowerShell, you can use `Expand-Archive` cmdlet.
103103

104-
```
105-
PS> Expand-Archive fluent-bit-1.9.7-win64.zip
104+
```powershell
105+
PS> Expand-Archive fluent-bit-1.9.9-win64.zip
106106
```
107107

108108
The ZIP package contains the following set of files.
109109

110-
```
110+
```text
111111
fluent-bit
112112
├── bin
113113
│ ├── fluent-bit.dll
@@ -126,13 +126,13 @@ fluent-bit
126126

127127
Now, launch cmd.exe or PowerShell on your machine, and execute `fluent-bit.exe` as follows.
128128

129-
```
129+
```powershell
130130
PS> .\bin\fluent-bit.exe -i dummy -o stdout
131131
```
132132

133133
If you see the following output, it's working fine!
134134

135-
```
135+
```powershell
136136
PS> .\bin\fluent-bit.exe -i dummy -o stdout
137137
Fluent Bit v1.9.x
138138
* Copyright (C) 2019-2020 The Fluent Bit Authors
@@ -162,22 +162,22 @@ Choose one which is suitable for you.
162162
Double-click the EXE installer you've downloaded.
163163
The installation wizard will automatically start.
164164

165-
![](<../.gitbook/assets/windows_installer (1) (1).png>)
165+
![Installation wizard screenshot](<../.gitbook/assets/windows_installer (1) (1).png>)
166166

167167
Click Next and proceed.
168168
By default, Fluent Bit is installed into `C:\Program Files\fluent-bit\`, so you should be able to launch fluent-bit as follows after installation.
169169

170-
```
170+
```powershell
171171
PS> C:\Program Files\fluent-bit\bin\fluent-bit.exe -i dummy -o stdout
172172
```
173173

174174
### Installer options
175175

176-
The Windows installer is built by [`CPack` using NSIS(https://cmake.org/cmake/help/latest/cpack_gen/nsis.html) and so supports the [default options](https://nsis.sourceforge.io/Docs/Chapter3.html#3.2.1) that all NSIS installers do for silent installation and the directory to install to.
176+
The Windows installer is built by [`CPack` using NSIS(<https://cmake.org/cmake/help/latest/cpack_gen/nsis.html>) and so supports the [default options](https://nsis.sourceforge.io/Docs/Chapter3.html#3.2.1) that all NSIS installers do for silent installation and the directory to install to.
177177

178178
To silently install to `C:\fluent-bit` directory here is an example:
179179

180-
```
180+
```powershell
181181
PS> <installer exe> /S /D=C:\fluent-bit
182182
```
183183

@@ -190,7 +190,7 @@ Windows services are equivalent to "daemons" in UNIX (i.e. long-running backgrou
190190

191191
Suppose you have the following installation layout:
192192

193-
```
193+
```text
194194
C:\fluent-bit\
195195
├── conf
196196
│ ├── fluent-bit.conf
@@ -204,13 +204,13 @@ C:\fluent-bit\
204204

205205
To register Fluent Bit as a Windows service, you need to execute the following command on Command Prompt. Please be careful that a single space is required after `binpath=`.
206206

207-
```
207+
```powershell
208208
% sc.exe create fluent-bit binpath= "\fluent-bit\bin\fluent-bit.exe -c \fluent-bit\conf\fluent-bit.conf"
209209
```
210210

211211
Now Fluent Bit can be started and managed as a normal Windows service.
212212

213-
```
213+
```powershell
214214
% sc.exe start fluent-bit
215215
% sc.exe query fluent-bit
216216
SERVICE_NAME: fluent-bit
@@ -221,7 +221,7 @@ SERVICE_NAME: fluent-bit
221221

222222
To halt the Fluent Bit service, just execute the "stop" command.
223223

224-
```
224+
```powershell
225225
% sc.exe stop fluent-bit
226226
```
227227

@@ -291,7 +291,7 @@ If you need to create a custom executable, you can use the following procedure t
291291

292292
First, you need Microsoft Visual C++ to compile Fluent Bit. You can install the minimum toolkit by the following command:
293293

294-
```
294+
```powershell
295295
PS> wget -o vs.exe https://aka.ms/vs/16/release/vs_buildtools.exe
296296
PS> start vs.exe
297297
```
@@ -300,7 +300,7 @@ When asked which packages to install, choose "C++ Build Tools" (make sure that "
300300

301301
Also you need to install flex and bison. One way to install them on Windows is to use [winflexbison](https://github.com/lexxmark/winflexbison).
302302

303-
```
303+
```powershell
304304
PS> wget -o winflexbison.zip https://github.com/lexxmark/winflexbison/releases/download/v2.5.22/win_flex_bison-2.5.22.zip
305305
PS> Expand-Archive winflexbison.zip -Destination C:\WinFlexBison
306306
PS> cp -Path C:\WinFlexBison\win_bison.exe C:\WinFlexBison\bison.exe
@@ -311,7 +311,7 @@ Add the path `C:\WinFlexBison` to your systems environment variable "Path". [Her
311311

312312
Also you need to install [git](https://git-scm.com/download/win) to pull the source code from the repository.
313313

314-
```
314+
```powershell
315315
PS> wget -o git.exe https://github.com/git-for-windows/git/releases/download/v2.28.0.windows.1/Git-2.28.0-64-bit.exe
316316
PS> start git.exe
317317
```
@@ -322,28 +322,28 @@ Open the start menu on Windows and type "Developer Command Prompt".
322322

323323
Clone the source code of Fluent Bit.
324324

325-
```
325+
```powershell
326326
% git clone https://github.com/fluent/fluent-bit
327327
% cd fluent-bit/build
328328
```
329329

330330
Compile the source code.
331331

332-
```
332+
```powershell
333333
% cmake .. -G "NMake Makefiles"
334334
% cmake --build .
335335
```
336336

337337
Now you should be able to run Fluent Bit:
338338

339-
```
339+
```powershell
340340
% .\bin\debug\fluent-bit.exe -i dummy -o stdout
341341
```
342342

343343
### Packaging
344344

345345
To create a ZIP package, call `cpack` as follows:
346346

347-
```
347+
```powershell
348348
% cpack -G ZIP
349349
```

0 commit comments

Comments
 (0)