Giter Club home page Giter Club logo

ngf-doc-work's Introduction

OpenSSF Scorecard FOSSA Status Continuous Integration Go Report Card codecov GitHub release (latest SemVer) Slack Project Status: Active โ€“ The project has reached a stable, usable state and is being actively developed.

NGINX Gateway Fabric

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, 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 doc.

Learn about our design principles and architecture.

Getting Started

  1. Quick Start on a kind cluster.
  2. Install NGINX Gateway Fabric.
  3. Deploy various examples.
  4. Read our How-to guides.

You can find the comprehensive NGINX Gateway Fabric user documentation on the NGINX Documentation website.

NGINX Gateway Fabric Releases

We publish NGINX Gateway Fabric releases on GitHub. See our releases page.

The latest release is 1.2.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 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. Documentation. 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. Refer to the Issue Lifecycle 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.0.0 1.23+ 1.25.4 R31
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 and are available in SPDX format.

Docker Images

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/nginxinc/nginx-gateway-fabric:edge --format '{{ json (index .SBOM "linux/amd64").SPDX }}' | grype

Troubleshooting

For troubleshooting help, see the Troubleshooting document.

Contacts

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 via [email protected] or on the NGINX Community Slack in the #nginx-gateway-fabric channel.

Community Meetings

Every other Monday at 9AM Pacific / 5PM GMT

For the meeting link, updates, agenda, and meeting notes, check the calendar below:

NGINX Gateway Fabric Meeting Calendar

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 if you'd like to contribute to the project.

Support

NGINX Gateway Fabric is not covered by any support contract.

ngf-doc-work's People

Contributors

dependabot[bot] avatar kate-osborn avatar lucacome avatar pleshakov avatar sjberman avatar ciarams87 avatar bjee19 avatar pre-commit-ci[bot] avatar f5yacobucci avatar salonichf5 avatar kevin85421 avatar adubhlaoich avatar jcahilltorre avatar step-security-bot avatar mpstefan avatar github-actions[bot] avatar owretch avatar nginx-jack avatar leandrocostam avatar nunnatsa avatar pammecrandall avatar cygnuslyra avatar sanathkumarbs avatar pl4nty avatar travisamartin avatar vepatel avatar arukiidou avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.