Repository files navigation

English |中文

BFE (Beyond Front End) is a modern layer 7 load balancer from baidu.

BFE is aCloud Native Computing Foundation (CNCF) sandbox project.

BFE opensource project includes several components, which can be used together as a integrated layer 7 load balancer and traffic management solution.

BFE system consists of data plane and control plane:

• Data plane：responsible for forwarding user's traffic, including below component:
  • BFE Server：BFE forward engine (this repository, bfenetworks/bfe). BFE Server performs content based routing, load balancing and forwards the traffic to backend servers.
• Control plane：responsible for management and configuration of BFE system, including below components:
  • API-Server：provides API and handles update, storage and generation of BFE config
  • Conf-Agent：component for loading config, fetches latest config from API-Server and triggers BFE Server to reload it
  • Dashboard：provides a graphic interface for user to manage and view major config of BFE

Refer toOverview in BFE document for more information

Besides, we also implementBFE Ingress Controller based on BFE, to fulfill Ingress in Kubernetes

This quick start is for users who want to get a running setup fast: build Docker images first, then deploy the Kubernetes example.

From the repository root:

make docker

Notes:

• make docker builds both prod and debug images. Image tags are derived from theVERSION file.
• To override the image name, setBFE_IMAGE_NAME, for example:

make docker BFE_IMAGE_NAME=your-registry/bfe

If you want the Kubernetes deployment to use your locally built image, push it to a registry reachable by your cluster nodes (or load it into a local cluster), then update the bfe image mapping underimages: inexamples/kubernetes/kustomization.yaml.

For more details on building and pushing images (includingmake docker-push), see:

• docs/en_us/installation/install_using_docker.md

cd examples/kuberneteskubectl apply -k.kubectl apply -f whoami-deploy.yaml

For details (image mirror settings, initialization notes, cleanup and finalizer troubleshooting, etc.), see:

• examples/kubernetes/README.md

• Multiple protocols supported, including HTTP, HTTPS, SPDY, HTTP2, WebSocket, TLS, FastCGI, etc.
• Content based routing, support user-defined routing rule in advanced domain-specific language.
• Support multiple load balancing policies.
• Flexible plugin framework to extend functionality. Based on the framework, developer can add new features rapidly.
• Efficient, easy and centralized management, with RESTful API and Dashboard support.
• Detailed built-in metrics available for service status monitor.

• Data plane: BFE Serverbuild and run
• Control plane: English document coming soon.Chinese version
• Kubernetes example (kustomize):examples/kubernetes/README.md

• SeeBuild and run

• English version
• Chinese version

• In-depth Understanding of BFE (Released in Feb 2023)

  This book focuses on BFE open source project, introduces the relevant technical principles of network access, explains the design idea of BFE open source software, and how to build a network front-end platform based on BFE open source software. Readers with development capabilities can also develop BFE extension modules according to their own needs or contribute code to BFE open source projects according to the instructions in this book.

• Please create an issue inissue list.
• Contact Committers/Owners for further discussion if needed.
• Following the golang coding standards.
• See theCONTRIBUTING file for details.

• Owners:MAINTAINERS
• Contributors:CONTRIBUTORS

• BFE community on Slack:Sign up CNCF Slack and join bfe channel.
• BFE developer group on WeChat:Send a request mail with your WeChat ID and a contribution you've made to BFE(such as a PR/Issue). We will invite you right away.

BFE is under the Apache 2.0 license. See theLICENSE file for details.