Ingress NGINX Controller for Kubernetes

Find a file

James Strong ef5bf06c61 testing auto change Signed-off-by: James Strong <strong.james.e@gmail.com>		2023-01-19 11:25:37 -05:00
.github	add github actions stale bot (#9439 )	2023-01-08 14:25:27 -08:00
build	Optional podman support (#9294 )	2023-01-06 07:07:58 -08:00
changelog	fix change images (#9463 )	2022-12-29 20:59:07 -03:00
charts/ingress-nginx	Implement pathType validation (#9511 )	2023-01-16 23:51:23 -03:00
cmd	Enable profiler-address to be configured (#9311 )	2022-12-04 11:49:54 -08:00
deploy	revert 1.5.2	2022-12-29 19:58:15 -05:00
docs	Align default value for keepalive_request with NGINX default (#9518 )	2023-01-18 05:22:35 -08:00
hack	testing auto change	2023-01-19 11:25:37 -05:00
images	bump OpenTelemetry (#9489 )	2023-01-07 15:37:27 -08:00
internal	Align default value for keepalive_request with NGINX default (#9518 )	2023-01-18 05:22:35 -08:00
pkg	Implement pathType validation (#9511 )	2023-01-16 23:51:23 -03:00
rootfs	feat(configmap): expose gzip-disable (#9505 )	2023-01-16 17:08:32 -08:00
test	Bump `client-go` to remove dependence on go-autorest dependency (#9488 )	2023-01-18 05:10:34 -08:00
version	Refactor version helper (#4437 )	2019-08-13 13:46:16 -04:00
.gitignore	Optional podman support (#9294 )	2023-01-06 07:07:58 -08:00
.goreleaser.yaml	Reimplement kubectl plugin release workflow (#8812 )	2022-08-11 21:22:43 -07:00
.luacheckrc	Enable lj-releng tool to lint lua code.	2020-06-09 18:01:35 +08:00
Changelog.md	Automated Release Controller 1.5.2 (#9455 )	2022-12-29 13:35:32 -08:00
cloudbuild.yaml	with chroot now it can take longer than 30 mins	2022-12-24 15:51:50 -05:00
code-of-conduct.md	Update code-of-conduct.md (#1842 )	2017-12-20 15:34:27 -03:00
CONTRIBUTING.md	Tips for new contributors (#8924 )	2022-09-19 06:15:23 -07:00
go.mod	Bump `client-go` to remove dependence on go-autorest dependency (#9488 )	2023-01-18 05:10:34 -08:00
go.sum	Bump `client-go` to remove dependence on go-autorest dependency (#9488 )	2023-01-18 05:10:34 -08:00
ISSUE_TRIAGE.md	Fix typos in ISSUE_TRIAGE.md (#7863 )	2021-11-04 04:52:03 -07:00
LICENSE	Initial commit	2016-11-04 23:54:14 +01:00
Makefile	Remove nonexistent load flag from docker build commands (#9122 )	2023-01-10 07:47:26 -08:00
mkdocs.yml	set edit_uri value with main branch (#8088 )	2021-12-29 09:21:36 -08:00
NEW_CONTRIBUTOR.md	doc: update NEW_CONTRIBUTOR.md (#9381 )	2022-12-07 16:10:22 -08:00
NGINX_BASE	upgrade nginx base image (#9436 )	2022-12-24 06:17:27 -08:00
OWNERS	Move bowei to emeritus owner (#9150 )	2022-10-12 16:31:03 -07:00
OWNERS_ALIASES	Move bowei to emeritus owner (#9150 )	2022-10-12 16:31:03 -07:00
README.md	Remove 1.5.2 from readme (#9498 )	2023-01-10 13:20:21 -03:00
RELEASE.md	updated the link in RELEASE.md file (#9456 )	2022-12-28 10:13:29 -08:00
SECURITY.md	Add SECURITY.md	2020-07-27 16:01:17 -06:00
SECURITY_CONTACTS	Add security contacts (#7642 )	2021-09-15 12:24:12 -07:00
TAG	start 1.6.0 release	2023-01-18 08:23:07 -05:00

README.md

Ingress NGINX Controller

Overview

ingress-nginx is an Ingress controller for Kubernetes using NGINX as a reverse proxy and load balancer.

Learn more about Ingress on the main Kubernetes documentation site.

Get started

See the Getting Started document.

Troubleshooting

If you encounter issues, review the troubleshooting docs, file an issue, or talk to us on the #ingress-nginx channel on the Kubernetes Slack server.

Changelog

See the list of releases to find out about feature changes. For detailed changes for each release; please check the Changelog.md file. For detailed changes on the ingress-nginx helm chart, please check the following CHANGELOG.md file.

Supported Versions table

Supported versions for the ingress-nginx project mean that we have completed E2E tests, and they are passing for the versions listed. Ingress-Nginx versions may work on older versions but the project does not make that guarantee.

Ingress-NGINX version	k8s supported version	Alpine Version	Nginx Version
v1.5.1	1.25, 1.24, 1.23	3.16.2	1.21.6
v1.4.0	1.25, 1.24, 1.23, 1.22	3.16.2	1.19.10†
v1.3.1	1.24, 1.23, 1.22, 1.21, 1.20	3.16.2	1.19.10†
v1.3.0	1.24, 1.23, 1.22, 1.21, 1.20	3.16.0	1.19.10†
v1.2.1	1.23, 1.22, 1.21, 1.20, 1.19	3.14.6	1.19.10†
v1.1.3	1.23, 1.22, 1.21, 1.20, 1.19	3.14.4	1.19.10†
v1.1.2	1.23, 1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.1.1	1.23, 1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.1.0	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.5	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.4	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.3	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.2	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.1	1.22, 1.21, 1.20, 1.19	3.14.2	1.19.9†
v1.0.0	1.22, 1.21, 1.20, 1.19	3.13.5	1.20.1

† This build is patched against CVE-2021-23017.

See this article if you want upgrade to the stable Ingress API.

Get Involved

Thanks for taking the time to join our community and start contributing!

This project adheres to the Kubernetes Community Code of Conduct. By participating in this project, you agree to abide by its terms.
Contributing: Contributions of all kind are welcome!
- Read CONTRIBUTING.md for information about setting up your environment, the workflow that we expect, and instructions on the developer certificate of origin that we require.
- Join our Kubernetes Slack channel for developer discussion : #ingress-nginx-dev.
- Submit GitHub issues for any feature enhancements, bugs or documentation problems. Please make sure to read the Issue Reporting Checklist before opening an issue. Issues not conforming to the guidelines may be closed immediately.
- Support: Join the #ingress-nginx-users channel inside the Kubernetes Slack to ask questions or get support from the maintainers and other users.
- The GitHub issues in the repository are exclusively for bug reports and feature requests.
- Discuss: Tweet using the #IngressNginx hashtag.

License

Apache License 2.0