【官方文档】Fluent Bit 安装在 Windows

文章目录

1. 安装包
2. 从 ZIP 归档安装
3. 从 EXE 程序安装
4. Windows 服务支持
5. 从源代码编译
- 5.1. 准备
- 5.2. 编译
- 5.3. 打包

官方文档地址： Windows

Fluent Bit 是作为td-agent-bit包分发给 Windows 的。Fluent Bit 有两种 Windows 安装程序：一个 ZIP 归档文件（用于快速测试）和一个 EXE 安装程序（用于系统安装）。

1. 安装包

最新的稳定版本是1.8.2：

安装程序	SHA256 校验码
td-agent-bit-1.8.2-win32.exe	9ffcd0190bb283a977d1cbba5999ef0549be1170e81e3e8b9017a55b7ef62e5f
td-agent-bit-1.8.2-win32.zip	d791ab752af3e98cc97bf0a2fa5c10bf855417243c8597a3393d596690919196
td-agent-bit-1.8.2-win64.exe	52a83c8ef63343b83a07091a2f46e87e4e27acd8d3d7729db24b5880581b1832
td-agent-bit-1.8.2-win64.zip	2ae6dc186f716215e81b834b1acf852f38fd7cb6788b89fe8300dcff9c19b9f6

要检查完整性，请在 PowerShell 上使用Get-FileHash指令。

PS> Get-FileHash td-agent-bit-1.8.2-win32.exe

2. 从 ZIP 归档安装

从下载页面下载 ZIP 归档文件。有32位和64位环境的安装程序，选择一个适合您的环境的安装程序。

然后需要解压缩 ZIP 归档文件。您可以通过点击资源管理器上的“Extract All”来做到这一点，或者如果您正在使用 PowerShell，您可以使用Expand-Archive指令。

PS> Expand-Archive td-agent-bit-1.8.2-win64.zip

ZIP 软件包包含以下文件集。

td-agent-bit
├── bin
│   ├── fluent-bit.dll
│   └── fluent-bit.exe
├── conf
│   ├── fluent-bit.conf
│   ├── parsers.conf
│   └── plugins.conf
└── include│   ├── flb_api.h│   ├── ...│   └── flb_worker.h└── fluent-bit.h

现在，在您的机器上启动 cmd.exe 或 PowerShell，并执行fluent-bit.exe，如下所示。

PS> .\bin\fluent-bit.exe -i dummy -o stdout

如果您看到以下输出，说明它工作正常！

PS> .\bin\fluent-bit.exe  -i dummy -o stdout
Fluent Bit v1.8.x
* Copyright (C) 2019-2020 The Fluent Bit Authors
* Copyright (C) 2015-2018 Treasure Data
* Fluent Bit is a CNCF sub-project under the umbrella of Fluentd
* https://fluentbit.io[2019/06/28 10:13:04] [ info] [storage] initializing...
[2019/06/28 10:13:04] [ info] [storage] in-memory
[2019/06/28 10:13:04] [ info] [storage] normal synchronization mode, checksum disabled, max_chunks_up=128
[2019/06/28 10:13:04] [ info] [engine] started (pid=10324)
[2019/06/28 10:13:04] [ info] [sp] stream processor started
[0] dummy.0: [1561684385.443823800, {"message"=>"dummy"}]
[1] dummy.0: [1561684386.428399000, {"message"=>"dummy"}]
[2] dummy.0: [1561684387.443641900, {"message"=>"dummy"}]
[3] dummy.0: [1561684388.441405800, {"message"=>"dummy"}]

若要停止该进程，请在终端中按CTRL-C。

3. 从 EXE 程序安装

从下载页面下载 EXE 安装程序。它有32位和64位构建。选择一个适合你的。

然后双击下载的 EXE 安装程序。安装向导将自动启动。

单击 Next 并继续。默认情况下，Fluent Bit 安装到C:\Program Files\ td-agent-bit\中，因此您应该能够在安装后按如下方式启动 Fluent Bit。

PS> C:\Program Files\td-agent-bit\bin\fluent-bit.exe -i dummy -o stdout

4. Windows 服务支持

Windows 服务相当于 UNIX 中的“守护进程”（即长时间运行的后台进程）。从 v1.5.0 开始，Fluent Bit 对 Windows Service 有本机支持。

假设您有以下安装布局：

C:\fluent-bit\
├── conf
│   ├── fluent-bit.conf
│   └── parsers.conf
└── bin├── fluent-bit.dll└── fluent-bit.exe

要将 Fluent Bit 注册为 Windows 服务，您需要在命令提示符上执行以下命令。请注意，binpath=后面需要一个空格。

% sc.exe create fluent-bit binpath= "\fluent-bit\bin\fluent-bit.exe -c \fluent-bit\conf\fluent-bit.conf"

现在，Fluent Bit 可以作为普通 Windows 服务启动和管理。

% sc.exe start fluent-bit
% sc.exe query fluent-bit
SERVICE_NAME: fluent-bitTYPE               : 10  WIN32_OWN_PROCESSSTATE              : 4 Running...

要停止 Fluent Bit 服务，只需执行“stop”命令。

% sc.exe stop fluent-bit

5. 从源代码编译

如果需要创建自定义可执行文件，可以使用以下过程自行编译 Fluent Bit。

5.1. 准备

首先，您需要 Microsoft Visual C++ 来编译 Fluent Bit。您可以通过以下命令安装最小工具包：

PS> wget -o vs.exe https://aka.ms/vs/16/release/vs_buildtools.exe
PS> start vs.exe

当被问及要安装哪些软件包时，选择“C++ Build Tools”（确保也选择了“C++ CMake Tools for Windows”），并等待过程完成。

您还需要安装 flex 和 bison。在Windows上安装它们的一种方法是使用 winflexbison。

PS> wget -o winflexbison.zip https://github.com/lexxmark/winflexbison/releases/download/v2.5.22/win_flex_bison-2.5.22.zip
PS> Expand-Archive winflexbison.zip -Destination C:\WinFlexBison
PS> cp -Path C:\WinFlexBison\win_bison.exe C:\WinFlexBison\bison.exe
PS> cp -Path C:\WinFlexBison\win_flex.exe C:\WinFlexBison\flex.exe
PS> setx /M PATH "%PATH%;C:\WinFlexBison"

您还需要安装 git 来从存储库中获取源代码。

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
PS> start git.exe

5.2. 编译

打开 Windows 上的开始菜单，输入“开发人员命令提示符”。

克隆 Fluent Bit 的源代码。

% git clone https://github.com/fluent/fluent-bit
% cd fluent-bit/build

编译源代码。

% cmake .. -G "NMake Makefiles"
% cmake --build .

现在你应该能够运行 Fluent Bit：

% .\bin\debug\fluent-bit.exe -i dummy -o stdout

5.3. 打包

创建一个 ZIP 包，调用cpack如下：

% cpack -G ZIP