Skip to content

Commit 8d8cdde

Browse files
author
Benjamin Huo
authored
Merge pull request #67 from benjaminhuo/master
Update k8s & kubebuilder dependencies as well as roadmap
2 parents 08197b7 + 52c459c commit 8d8cdde

File tree

1 file changed

+12
-23
lines changed

1 file changed

+12
-23
lines changed

README.md

+12-23
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Fluent Bit Operator facilitates the deployment of Fluent Bit and provides great
44

55
Once installed, the Fluent Bit Operator provides the following features:
66

7-
- **Fluent Bit Management**: Deploy and destroy Fluent Bit Daemonset automatically.
7+
- **Fluent Bit Management**: Deploy and destroy Fluent Bit DaemonSet automatically.
88
- **Custom Configuration**: Select input/filter/output plugins via labels.
99
- **Dynamic Reloading**: Update configuration without rebooting Fluent Bit pods.
1010

@@ -51,17 +51,7 @@ To enable fluent-bit to pick up and use the latest config whenever the fluent-bi
5151

5252
### Prerequisites
5353

54-
Kubernetes v1.11.3+ is necessary for running Fluent Bit Operator, while it is always recommended to operate with the latest version.
55-
56-
If you are using Fluent Bit Operator v0.1.0, remove them alongside CRDs before start. **This is true for KubeSphere v2.x users**. Since the whole project has been completely refactored, old CRDs may cause conflicts. Backup your old CRDs if necessary. **KubeSphere v2.x users can run the following commands to clean legacy**:
57-
58-
```shell
59-
kubectl get fluentbits.logging.kubesphere.io -n kubesphere-logging-system fluent-bit -oyaml > fluent-bit-crd-backup.yaml
60-
kubectl delete deploy -n kubesphere-logging-system logging-fluentbit-operator
61-
kubectl delete fluentbits.logging.kubesphere.io -n kubesphere-logging-system fluent-bit
62-
kubectl delete ds -n kubesphere-logging-system fluent-bit
63-
kubectl delete crd fluentbits.logging.kubesphere.io
64-
```
54+
Kubernetes v1.16.13+ is necessary for running Fluent Bit Operator, while it is always recommended to operate with the latest version.
6555

6656
### Quick Start
6757

@@ -86,7 +76,7 @@ Success!
8676

8777
### Logging Stack
8878

89-
This guide provisions a logging pipeline for your work environment. It installs Fluent Bit as DaemonSet for collecting container logs, filtering unneeded fields and forwarding them to the target destinations (eg. Elasticsearch, Kafka and Fluentd).
79+
This guide provisions a logging pipeline for your work environment. It installs Fluent Bit as DaemonSet for collecting container logs, filtering unneeded fields, and forwarding them to the target destinations (eg. Elasticsearch, Kafka, and Fluentd).
9080

9181
![logging stack](docs/images/logging-stack.svg)
9282

@@ -124,7 +114,7 @@ green open ks-logstash-log-2021.04.06 QeI-k_LoQZ2h1z23F3XiHg 5 1 404879 0 298.4
124114

125115
## API Doc
126116

127-
The listing below shows supported plugins currently. It is based on Fluent Bit v1.4.6. For more information, see API docs of each plugin.
117+
The listing below shows supported plugins currently. It is based on Fluent Bit v1.7.3. For more information, please refer to the API docs of each plugin.
128118

129119
- [Input](docs/crd.md#input)
130120
- [dummy](docs/plugins/input/dummy.md)
@@ -158,7 +148,7 @@ The listing below shows supported plugins currently. It is based on Fluent Bit v
158148

159149
### Plugin Grouping
160150

161-
Input, filter and output plugins are connected by the mechanism of tagging and matching. For input and output plugins, always create `Input` or `Output` instances for every plugin. Don't aggregate multiple inputs or outputs into one `Input` or `Output` object, except you have a good reason to do so. Take the demo logging stack for example, we have independent yaml file for each output.
151+
Input, filter, and output plugins are connected by the mechanism of tagging and matching. For input and output plugins, always create `Input` or `Output` instances for every plugin. Don't aggregate multiple inputs or outputs into one `Input` or `Output` object, except you have a good reason to do so. Take the demo `logging stack` for example, we have one yaml file for each output.
162152

163153
However, for filter plugins, if you want a filter chain, the order of filters matters. You need organize multiple filters into an array as the demo [logging stack](manifests/logging-stack/filter-kubernetes.yaml) suggests.
164154

@@ -183,23 +173,22 @@ Check out the demo in the folder `/manifests/regex-parser` for how to use a cust
183173
## Features In Plan
184174

185175
- [x] Support custom parser plugins
176+
- [ ] Support Fluentd as the log aggregation layer
186177
- [ ] Support custom Input/Filter/Output plugins
187-
- [ ] Deploy Fluent Bit as deployment
188178
- [ ] Integrate logging sidecar
189179

190180
## Development
191181

192182
### Prerequisites
193183
- golang v1.13+.
194-
- kubectl v1.11.3+.
195-
- kubebuilder v2.3+ (the project is build with v2.3.0)
196-
- Access to a kubernetes cluster v1.11.3+
184+
- kubectl v1.16.13+.
185+
- kubebuilder v2.3+ (the project is build with v2.3.2)
186+
- Access to a Kubernetes cluster v1.16.13+
197187

198188
### Running
199189

200-
1. Remove legacy from v0.1.0 (optional)
201-
2. Install CRDs: `make install`
202-
3. Run: `make run`
190+
1. Install CRDs: `make install`
191+
2. Run: `make run`
203192

204193
## Contributing
205194

@@ -209,4 +198,4 @@ Check out the demo in the folder `/manifests/regex-parser` for how to use a cust
209198

210199
### Manifests
211200

212-
Most yaml files under the folder [manifests/setup](manifests/setup) are derived from [config](config) which is automatically generated. Don't edit them directly, run `make manifests` instead, then replace them properly.
201+
Most files under the folder [manifests/setup](manifests/setup) are automatically generated from [config](config). Don't edit them directly, run `make manifests` instead, then replace them properly.

0 commit comments

Comments
 (0)