NGINX Gateway Fabric 通过使用 NGINX 作为数据层,为 Gateway API 提供了实现方案。
NGINX Gateway Fabric 通过使用 NGINX 作为数据层,为 Gateway API 提供了实现方案。
NGINX Gateway Fabric is an open-source project that provides an implementation of
the Gateway API using NGINX 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.
For a list of supported Gateway API resources and features, see the Gateway API Compatibility doc.
Learn about our design principles and architecture.
NGINX Gateway Fabric uses NGINX Agent to configure NGINX.
You can find the comprehensive NGINX Gateway Fabric user documentation on the NGINX Documentation website.
We publish NGINX Gateway Fabric releases on GitHub. See our releases page.
The latest release is 2.7.2.
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 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. | Documentation. Examples. |
| Edge | For experimental use and latest features | Manifests. | Examples. |
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.
The features that will go into the next release are reflected in the corresponding milestone. Refer to the Issue Lifecycle document for information on issue creation and assignment to releases.
The following table lists the software versions NGINX Gateway Fabric supports. Only the latest patch release for each minor version is shown.
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus | NGINX Agent | F5 WAF for NGINX |
|---|---|---|---|---|---|---|
| Edge | 1.6.2 | 1.32+ | 1.31.6 | R37.1 | v3.12.0 | 5.15.0 |
| 2.7.2 | 1.6.1 | 1.32+ | 1.31.6 | R37.1 | v3.12.0 | 5.15.0 |
| 2.6.8 | 1.5.1 | 1.31+ | 1.31.3 | R37.0 | v3.11.2 | 5.13.2 |
| 2.5.1 | 1.5.1 | 1.31+ | 1.29.7 | R36 | v3.8.0 | --- |
| 2.4.2 | 1.4.1 | 1.25+ | 1.29.5 | R36 | v3.7.1 | --- |
| 2.3.0 | 1.4.1 | 1.25+ | 1.29.3 | R36 | v3.6.0 | --- |
| 2.2.2 | 1.3.0 | 1.25+ | 1.29.2 | R35 | v3.6.0 | --- |
| 2.1.4 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.3.1 | --- |
| 2.0.2 | 1.3.0 | 1.25+ | 1.28.0 | R34 | v3.0.1 | --- |
| 1.6.2 | 1.2.1 | 1.25+ | 1.27.4 | R33 | --- | --- |
| 1.5.1 | 1.2.0 | 1.25+ | 1.27.2 | R33 | --- | --- |
| 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 | --- | --- |
The following table lists the OpenShift versions and Operator versions compatible with NGINX Gateway Fabric.
| NGINX Gateway Fabric | Operator | Preferred Gateway API | Compatible Gateway API | OCP with Preferred GWAPI | Supported OCP Versions |
|---|---|---|---|---|---|
| 2.7.x | v1.5.x | v1.6.x | v1.2.1-v1.6.x | --- | 4.19 - 4.22 |
| 2.6.x | v1.4.x | v1.5.x | v1.2.1-v1.5.x | --- | 4.19 - 4.21 |
| 2.5.x | v1.3.x | v1.5.x | v1.2.1-v1.5.x | --- | 4.19 - 4.21 |
| 2.4.x | v1.2.x | v1.4.x | v1.2.1-v1.4.x | 4.20 & 4.21 | 4.19 - 4.21 |
| 2.2.x | v1.0.x | v1.3.0 | v1.2.1 | --- | 4.19 |
We generate SBOMs for the binaries and the Docker image.
The SBOMs for the binaries are available in the releases page. The SBOMs are generated using syft and are available in SPDX format.
The SBOM for the Docker image is available in the GitHub Container repository. The SBOM is generated using syft and stored as an attestation in the image manifest.
For example to retrieve the SBOM for linux/amd64 and analyze it using grype you
can run the following command:
docker buildx imagetools inspect ghcr.io/nginx/nginx-gateway-fabric:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}' | grypeFor troubleshooting help, see the Troubleshooting document.
We’d like to hear your feedback! If you experience issues with our Gateway Controller, please open a bug in GitHub. If you have any suggestions or enhancement requests, please open an idea on GitHub discussions. You can contact us directly on the NGINX Community Forum.
Every Tuesday, alternating time zones at 9:30AM Pacific / 5:30PM GMT or 12:00PM GMT.
For the meeting link, updates, agenda, and meeting notes, check the link below:
NGINX Gateway Fabric Community Meeting
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!
Please read our Contributing guide if you'd like to contribute to the project.
If your team needs dedicated support for NGINX Gateway Fabric in your environment, or you would like to leverage our advanced NGINX Plus features, you can reach out here.
To try NGINX Gateway Fabric with NGINX Plus, you can start your free 30-day trial, then follow the installation guide for installing with NGINX Plus.
暂无开放 Issues，或尚未同步最近议题。