Ingress NGINX Controller for Kubernetes
Find a file
2018-07-26 14:23:51 -04:00
.github Update GitHub pull request template 2018-04-28 23:43:54 +02:00
.travis Add scripts and tasks to publish docs to github pages 2018-04-26 20:05:08 -03:00
build add support for ExternalName service type in dynamic mode 2018-07-25 09:05:47 -04:00
cmd/nginx Remove KubeConfig Dependency for Store Tests 2018-07-17 11:13:41 -05:00
deploy Release 0.17.1 2018-07-16 17:06:03 -04:00
docs Merge pull request #2811 from takonomura/escape-request-uri 2018-07-21 02:23:38 -07:00
hack Use docker to build go binaries 2018-07-06 23:48:40 -04:00
images Remove setcap from image (#2826) 2018-07-21 18:12:29 -04:00
internal fix issues introduced in #2804 2018-07-26 14:23:51 -04:00
rootfs fix issues introduced in #2804 2018-07-26 14:23:51 -04:00
test test to assert nameservers are passed to lua 2018-07-25 09:33:21 -04:00
vendor Update go dependencies 2018-07-12 13:19:17 -04:00
version Remove GenericController and add tests 2017-11-05 17:51:05 -03:00
.codecov.yml Migrate to codecov.io (#2120) 2018-02-20 08:27:02 -08:00
.dockerignore Move nginx to root directory 2017-10-06 16:58:36 -03:00
.gitignore Multiple optimizations to build targets 2018-07-20 20:08:32 +02:00
.luacheckrc refactor balancer into more testable and extensible interface 2018-05-28 15:51:58 -04:00
.travis.yml Remove KubeConfig Dependency for Store Tests 2018-07-17 11:13:41 -05:00
Changelog.md Release 0.17.1 2018-07-16 17:06:03 -04:00
code-of-conduct.md Update code-of-conduct.md (#1842) 2017-12-20 15:34:27 -03:00
CONTRIBUTING.md Add KubeCon Europe 2018 Video to documentation 2018-05-13 12:19:21 -05:00
Gopkg.lock Simplify handler registration and update promhttp 2018-07-12 13:18:43 -04:00
Gopkg.toml Simplify handler registration and update promhttp 2018-07-12 13:18:43 -04:00
labels.yaml add labels.yaml file 2017-02-09 00:54:30 -05:00
LICENSE Initial commit 2016-11-04 23:54:14 +01:00
Makefile Remove setcap and use authbind instead 2018-07-21 18:56:28 -04:00
mkdocs.yml Add google analytics [ci skip] 2018-04-30 12:59:41 -03:00
OWNERS Add new approvers to the project (#2673) 2018-06-21 09:44:34 -04:00
OWNERS_ALIASES Update owners 2018-04-13 20:08:13 -03:00
README.md Add FOSSA status badge 2018-07-09 23:09:44 -04:00
requirements-docs.txt Update docs and mkdoc dependencies [ci skip] (#2778) 2018-07-13 19:23:13 -04:00
SECURITY_CONTACTS Add security contacts file [ci skip] (#2564) 2018-05-24 10:59:49 -04:00

Help us to improve the NGINX Ingress controller completing the survey


NGINX Ingress Controller

Build Status 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 kubernetes-users mailing list. 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