Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nginxinc/nginx-gateway-fabric
NGINX Gateway Fabric provides an implementation for the Gateway API using NGINX as the data plane.
https://github.com/nginxinc/nginx-gateway-fabric
gateway-api k8s kubernetes nginx
Last synced: 28 days ago
JSON representation
NGINX Gateway Fabric provides an implementation for the Gateway API using NGINX as the data plane.
- Host: GitHub
- URL: https://github.com/nginxinc/nginx-gateway-fabric
- Owner: nginxinc
- License: apache-2.0
- Created: 2021-10-22T17:59:15.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T19:44:13.000Z (6 months ago)
- Last Synced: 2024-05-22T19:58:08.582Z (6 months ago)
- Topics: gateway-api, k8s, kubernetes, nginx
- Language: Go
- Homepage:
- Size: 21.2 MB
- Stars: 382
- Watchers: 19
- Forks: 78
- Open Issues: 165
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-repositories - nginxinc/nginx-gateway-fabric - NGINX Gateway Fabric provides an implementation for the Gateway API using NGINX as the data plane. (Go)
- awesome-cloud-native - nginx-gateway-fabric - NGINX Gateway Fabric provides an implementation for the Gateway API using NGINX as the data plane. (API Gateway)
README
[](https://scorecard.dev/viewer/?uri=github.com/nginxinc/nginx-gateway-fabric)
[](https://app.fossa.com/projects/custom%2B5618%2Fgithub.com%2Fnginxinc%2Fnginx-gateway-fabric?ref=badge_shield)
[](https://github.com/nginxinc/nginx-gateway-fabric/actions/workflows/ci.yml)
[](https://goreportcard.com/report/github.com/nginxinc/nginx-gateway-fabric)
[](https://codecov.io/gh/nginxinc/nginx-gateway-fabric)
[](https://github.com/nginxinc/nginx-gateway-fabric/releases/latest)
[](https://nginxcommunity.slack.com/channels/nginx-gateway-fabric)
[](https://www.repostatus.org/#active)
# NGINX Gateway Fabric
NGINX Gateway Fabric is an open-source project that provides an implementation of
the [Gateway API](https://gateway-api.sigs.k8s.io/) using [NGINX](https://nginx.org/) as the data plane. The goal of
this project is to implement the core Gateway APIs -- `Gateway`, `GatewayClass`, `HTTPRoute`, `GRPCRoute`, `TCPRoute`, `TLSRoute`,
and `UDPRoute` -- to configure an HTTP or TCP/UDP load balancer, reverse-proxy, or API gateway for applications running
on Kubernetes. NGINX Gateway Fabric supports a subset of the Gateway API.
For a list of supported Gateway API resources and features, see
the [Gateway API Compatibility](https://docs.nginx.com/nginx-gateway-fabric/overview/gateway-api-compatibility/) doc.
Learn about our [design principles](/docs/developer/design-principles.md) and [architecture](https://docs.nginx.com/nginx-gateway-fabric/overview/gateway-architecture/).
## Getting Started
1. [Quick Start on a kind cluster](https://docs.nginx.com/nginx-gateway-fabric/installation/running-on-kind/).
2. [Install](https://docs.nginx.com/nginx-gateway-fabric/installation/) NGINX Gateway Fabric.
3. Deploy various [examples](examples).
4. Read our [How-to guides](https://docs.nginx.com/nginx-gateway-fabric/how-to/).
You can find the comprehensive NGINX Gateway Fabric user documentation on the [NGINX Documentation](https://docs.nginx.com/nginx-gateway-fabric/) website.
## NGINX Gateway Fabric Releases
We publish NGINX Gateway Fabric releases on GitHub. See
our [releases page](https://github.com/nginxinc/nginx-gateway-fabric/releases).
The latest release is [1.4.0](https://github.com/nginxinc/nginx-gateway-fabric/releases/tag/v1.4.0).
The edge version is useful for experimenting with new features that are not yet published in a release. To use, choose
the _edge_ version built from the [latest commit](https://github.com/nginxinc/nginx-gateway-fabric/commits/main)
from the main branch.
The table below summarizes the options regarding the images, manifests, documentation and examples and gives your links
to the correct versions:
| Version | Description | Installation Manifests | Documentation and Examples |
|----------------|------------------------------------------|-----------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Latest release | For production use | [Manifests](https://github.com/nginxinc/nginx-gateway-fabric/tree/v1.4.0/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginxinc/nginx-gateway-fabric/tree/v1.4.0/examples). |
| Edge | For experimental use and latest features | [Manifests](https://github.com/nginxinc/nginx-gateway-fabric/tree/main/deploy). | [Documentation](https://github.com/nginxinc/nginx-gateway-fabric/tree/main/site/content). [Examples](https://github.com/nginxinc/nginx-gateway-fabric/tree/main/examples). |
### Versioning
NGF uses semantic versioning for its releases. For more information, see https://semver.org.
> Major version zero `(0.Y.Z)` is reserved for development, anything MAY change at any time. The public API is not stable.
### Release Planning and Development
The features that will go into the next release are reflected in the
corresponding [milestone](https://github.com/nginxinc/nginx-gateway-fabric/milestones). Refer to
the [Issue Lifecycle](ISSUE_LIFECYCLE.md) document for information on issue creation and assignment to releases.
## Technical Specifications
The following table lists the software versions NGINX Gateway Fabric supports.
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus |
|----------------------|-------------|------------|-----------|------------|
| Edge | 1.1.0 | 1.25+ | 1.27.2 | R32 |
| 1.4.0 | 1.1.0 | 1.25+ | 1.27.1 | R32 |
| 1.3.0 | 1.1.0 | 1.25+ | 1.27.0 | R32 |
| 1.2.0 | 1.0.0 | 1.23+ | 1.25.4 | R31 |
| 1.1.0 | 1.0.0 | 1.23+ | 1.25.3 | n/a |
| 1.0.0 | 0.8.1 | 1.23+ | 1.25.2 | n/a |
| 0.6.0 | 0.8.0 | 1.23+ | 1.25.2 | n/a |
| 0.5.0 | 0.7.1 | 1.21+ | 1.25.x \* | n/a |
| 0.4.0 | 0.7.1 | 1.21+ | 1.25.x \* | n/a |
| 0.3.0 | 0.6.2 | 1.21+ | 1.23.x \* | n/a |
| 0.2.0 | 0.5.1 | 1.21+ | 1.21.x \* | n/a |
| 0.1.0 | 0.5.0 | 1.19+ | 1.21.3 | n/a |
\*the installation manifests use the minor version of NGINX container image (e.g. 1.25) and the patch version is not
specified. This means that the latest available patch version is used.
## SBOM (Software Bill of Materials)
We generate SBOMs for the binaries and the Docker image.
### Binaries
The SBOMs for the binaries are available in the releases page. The SBOMs are generated
using [syft](https://github.com/anchore/syft) and are available in SPDX format.
### Docker Images
The SBOM for the Docker image is available in
the [GitHub Container](https://github.com/nginxinc/nginx-gateway-fabric/pkgs/container/nginx-gateway-fabric)
repository. The SBOM is generated using [syft](https://github.com/anchore/syft) and stored as an attestation in the
image manifest.
For example to retrieve the SBOM for `linux/amd64` and analyze it using [grype](https://github.com/anchore/grype) you
can run the following command:
```shell
docker buildx imagetools inspect ghcr.io/nginxinc/nginx-gateway-fabric:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}' | grype
```
## Troubleshooting
For troubleshooting help, see the [Troubleshooting](https://docs.nginx.com/nginx-gateway-fabric/how-to/monitoring/troubleshooting/) document.
## Contacts
We’d like to hear your feedback! If you experience issues with our Gateway Controller, please [open a bug][bug] in
GitHub. If you have any suggestions or enhancement requests, please [open an idea][idea] on GitHub discussions. You can
contact us directly via [email protected] or on the [NGINX Community Slack][slack] in
the `#nginx-gateway-fabric`
channel.
[bug]: https://github.com/nginxinc/nginx-gateway-fabric/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=
[idea]: https://github.com/nginxinc/nginx-gateway-fabric/discussions/categories/ideas
[slack]: https://nginxcommunity.slack.com/channels/nginx-gateway-fabric
## Community Meetings
Every Tuesday at 9:30AM Pacific / 5:30PM GMT
For the meeting link, updates, agenda, and meeting notes, check the calendar below:
[NGINX Gateway Fabric Meeting Calendar](https://calendar.google.com/calendar/embed?src=a82aa06dc698b4271fb562d43f38e5bf7676585e581057bde026ddd1c71f84e9%40group.calendar.google.com)
If you have a use case for NGINX Gateway Fabric that the project can't quite meet yet, bugs, problems, success stories, or just want to be more involved with the project, come by and say hi!
## Contributing
Please read our [Contributing guide](CONTRIBUTING.md) if you'd like to contribute to the project.
## Support and NGINX Plus
If your team needs dedicated support for NGINX Gateway Fabric in your environment, or you would like to leverage our [advanced NGINX Plus features](https://docs.nginx.com/nginx-gateway-fabric/overview/nginx-plus/), you can reach out [here](https://www.f5.com/content/f5-com/en_us/products/get-f5).
To try NGINX Gateway Fabric with NGINX Plus, you can start your free [30-day trial](https://www.f5.com/trials), then follow the [installation guide](https://docs.nginx.com/nginx-gateway-fabric/installation/installing-ngf/helm/) for installing with NGINX Plus.