Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/open-feature/flagd
A feature flag daemon with a Unix philosophy
https://github.com/open-feature/flagd
go golang openfeature
Last synced: 5 days ago
JSON representation
A feature flag daemon with a Unix philosophy
- Host: GitHub
- URL: https://github.com/open-feature/flagd
- Owner: open-feature
- License: apache-2.0
- Created: 2022-05-26T12:05:42.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T15:30:45.000Z (19 days ago)
- Last Synced: 2024-11-30T11:17:23.040Z (12 days ago)
- Topics: go, golang, openfeature
- Language: Go
- Homepage: https://openfeature.dev
- Size: 11.5 MB
- Stars: 570
- Watchers: 16
- Forks: 67
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-repositories - open-feature/flagd - A feature flag daemon with a Unix philosophy (Go)
README
A feature flag daemon with a Unix philosophy.
## What's flagd?
flagd is a feature flag daemon with a Unix philosophy. Think of it as a ready-made, open source, OpenFeature-compliant feature flag backend system.
## Features
- 🌐 OpenFeature compliant and [speaks your language](https://openfeature.dev/ecosystem?instant_search%5BrefinementList%5D%5Bvendor%5D%5B0%5D=flagd).
- 🆕 Easy to [extend to new languages](https://flagd.dev/reference/providers/).
- 🔄 Supports multiple data sources simultaneously.
- 🕒 Feature Flag updates occur in near real-time.
- 💪 Contains a [powerful and flexible rule targeting engine](https://flagd.dev/reference/flag-definitions/#targeting-rules) and [deterministic percentage-based rollouts](https://flagd.dev/reference/custom-operations/fractional-operation/).
- 🔦 Flag evaluation traces and metrics are exposed and compatible with [OpenTelemetry](https://flagd.dev/reference/monitoring/#opentelemetry).
## ▶️ Quick Start
Experiment with flagd in your browser using [the Killercoda tutorial](https://killercoda.com/open-feature/scenario/flagd-demo) or follow the instructions below to run on your own infrastructure.
1. flagd can be run as a standalone binary or container. [Download and install flagd or run it as a container](https://flagd.dev/installation/)
Kubernetes-native? flagd can also be run [as part of the Kubernetes Operator](https://github.com/open-feature/open-feature-operator).
2. Start flagd:
```sh
flagd start \
--port 8013 \
--uri https://raw.githubusercontent.com/open-feature/flagd/main/samples/example_flags.flagd.json
```
Or use docker:
_Note - In Windows, use WSL system for both the file location and Docker runtime. Mixed file systems don't
work and this is a [limitation of Docker](https://github.com/docker/for-win/issues/8479)_
```sh
docker run \
--rm -it \
--name flagd \
-p 8013:8013 \
ghcr.io/open-feature/flagd:latest start \
--uri https://raw.githubusercontent.com/open-feature/flagd/main/samples/example_flags.flagd.json
```
If you wish, download the file locally to make changes:
```sh
wget https://raw.githubusercontent.com/open-feature/flagd/main/samples/example_flags.flagd.json
```
In local mode, run flagd like this:
```sh
flagd start \
--port 8013 \
--uri file:./example_flags.flagd.json
```
Or use docker ( _Note - In Windows, this requires WSL system for both the file location and Docker runtime_):
```sh
docker run \
--rm -it \
--name flagd \
-p 8013:8013 \
-v $(pwd):/etc/flagd \
ghcr.io/open-feature/flagd:latest start \
--uri file:./etc/flagd/example_flags.flagd.json
```
`--uri` can be a local file or any remote endpoint. Use `file:` prefix for local files. eg. `--uri file:/path/to/example_flags.flagd.json`. `gRPC` and `http` have their own requirements. More information can be found [here](https://flagd.dev/concepts/syncs/).
Multiple `--uri` parameters can be specified. In other words, flagd can retrieve flags from multiple sources simultaneously.
3. Flagd is now ready to perform flag evaluations over either `HTTP(s)` or `gRPC`. This example utilizes `HTTP` via `cURL`.
Retrieve a `String` value:
```sh
curl -X POST "http://localhost:8013/flagd.evaluation.v1.Service/ResolveString" \
-d '{"flagKey":"myStringFlag","context":{}}' -H "Content-Type: application/json"
```
For Windows we recommend using a [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) terminal.
Otherwise, use the following with `cmd`:
```sh
set json={"flagKey":"myStringFlag","context":{}}
curl -i -X POST -H "Content-Type: application/json" -d %json:"=\"% "localhost:8013/flagd.evaluation.v1.Service/ResolveString"
```
Result:
```json
{
"value": "val1",
"reason": "DEFAULT",
"variant":"key1"
}
```
Updates to the underlying flag store (e.g. JSON file) are reflected by flagd in realtime. No restart is required.
flagd also supports boolean, integer, float and object flag types.
4. Now that flagd is running, it is time to integrate it into your application. Do this by using [an OpenFeature provider in a language of your choice](https://openfeature.dev/ecosystem?instant_search%5BrefinementList%5D%5Bvendor%5D%5B0%5D=FlagD).
## 📐 High-level Architecture
## 📝 Further Documentation
Further documentation including flagd configuration options, fractional evaluation, targeting rules and flag configuration merging strategies can be found at [flagd.dev](https://flagd.dev/) or [in this repository](./docs/index.md).
## 🫶 Contributing
Interested in contributing? Great, we'd love your help! To get started, take a look at the [CONTRIBUTING](CONTRIBUTING.md) guide.
We also hold regular community meetings that are open to everyone.
Check the [OpenFeature community page](https://openfeature.dev/community/) for all the ways to get involved.
Thanks so much to our contributors.
Made with [contrib.rocks](https://contrib.rocks).
## License
[Apache License 2.0](LICENSE)