Skip to content
NGINX Ingress Controller for Kubernetes
Go Lua Shell Makefile Dockerfile Python Other
Branch: master
Clone or download
k8s-ci-robot Merge pull request #4476 from antoineco/bug/nil-err-channel
Initialize nginx process error channel
Latest commit 82b241c Aug 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update GitHub pull request template Apr 28, 2018
.travis Cleanup May 15, 2019
build ewma improvements Aug 15, 2019
cmd Fix file permissions to support volumes Aug 16, 2019
deploy Squash rules regarding ingresses Jul 9, 2019
docs Add rate limit units and error status Aug 22, 2019
hack Start using KEPs for new features or breaking changes Jul 25, 2019
images use latest openresty with CVE patches Aug 14, 2019
internal Merge pull request #4476 from antoineco/bug/nil-err-channel Aug 22, 2019
rootfs Change PemSHA to CASHA Aug 16, 2019
test Merge pull request #4327 from leki75/proxyssl Aug 18, 2019
vendor Update klog (#4426) Aug 10, 2019
version Refactor version helper (#4437) Aug 13, 2019
.codecov.yml Migrate to codecov.io (#2120) Feb 20, 2018
.dockerignore Move nginx to root directory Oct 6, 2017
.gitignore Only support SSL dynamic mode Aug 13, 2019
.luacheckrc lua randomseed per worker Dec 20, 2018
.travis.yml Cleanup May 15, 2019
CONTRIBUTING.md Fix CLA URLs Dec 27, 2018
Changelog.md Release 0.25.1 (#4441) Aug 14, 2019
LICENSE Initial commit Nov 4, 2016
Makefile Release 0.25.1 (#4441) Aug 14, 2019
OWNERS Update OWNERS [skip ci] Jan 30, 2019
OWNERS_ALIASES Update OWNERS [skip ci] (#3205) Oct 8, 2018
README.md Remove travis-ci badge (#4223) Jun 24, 2019
SECURITY_CONTACTS Update embargo doc link in SECURITY_OWNERS and changes PST to PSC Mar 8, 2019
code-of-conduct.md Update code-of-conduct.md (#1842) Dec 20, 2017
go.mod Update klog (#4426) Aug 10, 2019
go.sum Update klog (#4426) Aug 10, 2019
labels.yaml add labels.yaml file Feb 9, 2017
mkdocs.yml Add support for psp Aug 1, 2019
requirements-docs.txt Fix docs build due to an invalid link (#4389) Aug 1, 2019

README.md

Help us to improve the NGINX Ingress controller completing the survey


NGINX Ingress Controller

Coverage Status Go Report Card GitHub license GitHub stars GitHub stars FOSSA Status

Get Involved

  • Contributing: Pull requests are welcome!
    • Read CONTRIBUTING.md and check out help-wanted issues
    • Submit github issues for any feature enhancements, bugs or documentation problems
  • Support: Join to Kubernetes Slack to ask questions to get support from the maintainers and other developers
  • Discuss: Tweet using the #IngressNginx hashtag

Description

This repository contains the NGINX controller built around the Kubernetes Ingress resource that uses ConfigMap to store the NGINX configuration. Make Ingress-Nginx Work for you, and the Community from KubeCon Europe 2018 is a great video to get you started!!

Learn more about using Ingress on k8s.io

What is an Ingress Controller?

Configuring a webserver or loadbalancer is harder than it should be. Most webserver configuration files are very similar. There are some applications that have weird little quirks that tend to throw a wrench in things, but for the most part you can apply the same logic to them and achieve a desired result.

The Ingress resource embodies this idea, and an Ingress controller is meant to handle all the quirks associated with a specific "class" of Ingress.

An Ingress Controller is a daemon, deployed as a Kubernetes Pod, that watches the apiserver's /ingresses endpoint for updates to the Ingress resource. Its job is to satisfy requests for Ingresses.

Documentation

To check out Live Docs

Questions

For questions and support please use the #ingress-nginx channel in the Kubernetes Slack or post to the Kubernetes Forum. The issue list of this repo is exclusively for bug reports and feature requests.

Issues

Please make sure to read the Issue Reporting Checklist before opening an issue. Issues not conforming to the guidelines may be closed immediately.

Changelog

Detailed changes for each release are documented in the Changelog.md

Contribution

Please make sure to read the Contributing Guide before making a pull request.

Thank you to all the people who already contributed to NGINX Ingress Controller!

Code of Conduct

This project adheres to the Kubernetes Community Code of Conduct. By participating in this project you agree to abide by its terms.

License

Apache License 2.0

You can’t perform that action at this time.