Deploy GitHub Pages

This commit is contained in:
Travis Bot 2018-05-03 14:08:21 +00:00
parent a078100980
commit 467b6d7499
54 changed files with 5641 additions and 2237 deletions

View file

@ -240,7 +240,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="/examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="/examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -354,6 +354,18 @@
</li> </li>
<li class="md-nav__item">
<a href="/deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -491,6 +503,18 @@
<li class="md-nav__item">
<a href="/user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="/user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -528,8 +552,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="/user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -552,8 +576,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/user-guide/tls/" title="TLS" class="md-nav__link"> <a href="/user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -565,13 +589,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -636,8 +660,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="/examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -648,8 +672,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/examples/README/" title="Ingress examples" class="md-nav__link"> <a href="/examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -721,6 +745,18 @@
</li> </li>
<li class="md-nav__item">
<a href="/examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -811,8 +847,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="/examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -835,8 +871,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="/examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -875,18 +911,6 @@
<li class="md-nav__item">
<a href="/examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="/examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="/examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -537,6 +537,18 @@
</li> </li>
<li class="md-nav__item">
<a href="upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -674,6 +686,18 @@
<li class="md-nav__item">
<a href="../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -711,8 +735,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -735,8 +759,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -748,13 +772,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -819,8 +843,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -831,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -904,6 +928,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -994,8 +1030,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -1018,8 +1054,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -1058,18 +1094,6 @@
<li class="md-nav__item">
<a href="../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -441,6 +441,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -578,6 +590,18 @@
<li class="md-nav__item">
<a href="../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -615,8 +639,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -639,8 +663,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -652,13 +676,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -723,8 +747,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -735,8 +759,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -808,6 +832,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -898,8 +934,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -922,8 +958,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -962,18 +998,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1244,13 +1268,13 @@ container arguments, and POD_NAMESPACE should be in the nginx-ingress namespace.
</a> </a>
<a href="../../user-guide/nginx-configuration/" title="NGINX Configuration" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../upgrade/" title="Upgrading" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
NGINX Configuration Upgrading
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -36,7 +36,7 @@
<title>Ingress examples - NGINX Ingress Controller</title> <title>Upgrading - NGINX Ingress Controller</title>
@ -95,7 +95,7 @@
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label> <label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<a href="#ingress-examples" tabindex="1" class="md-skip"> <a href="#upgrading" tabindex="1" class="md-skip">
Skip to content Skip to content
</a> </a>
@ -121,7 +121,7 @@
NGINX Ingress Controller NGINX Ingress Controller
</span> </span>
<span class="md-header-nav__topic"> <span class="md-header-nav__topic">
Ingress examples Upgrading
</span> </span>
@ -214,7 +214,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../deploy/" title="Deployment" class="md-tabs__link"> <a href="../" title="Deployment" class="md-tabs__link md-tabs__link--active">
Deployment Deployment
</a> </a>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -321,10 +321,12 @@
<li class="md-nav__item md-nav__item--nested">
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
<label class="md-nav__link" for="nav-2"> <label class="md-nav__link" for="nav-2">
Deployment Deployment
@ -342,7 +344,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../deploy/" title="Installation Guide" class="md-nav__link"> <a href="../" title="Installation Guide" class="md-nav__link">
Installation Guide Installation Guide
</a> </a>
</li> </li>
@ -354,12 +356,69 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../deploy/rbac/" title="Role Based Access Control (RBAC)" class="md-nav__link"> <a href="../rbac/" title="Role Based Access Control (RBAC)" class="md-nav__link">
Role Based Access Control (RBAC) Role Based Access Control (RBAC)
</a> </a>
</li> </li>
<li class="md-nav__item md-nav__item--active">
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="toc">
<label class="md-nav__link md-nav__link--active" for="toc">
Upgrading
</label>
<a href="./" title="Upgrading" class="md-nav__link md-nav__link--active">
Upgrading
</a>
<nav class="md-nav md-nav--secondary">
<label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#without-helm" title="Without Helm" class="md-nav__link">
Without Helm
</a>
</li>
<li class="md-nav__item">
<a href="#with-helm" title="With Helm" class="md-nav__link">
With Helm
</a>
</li>
</ul>
</nav>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +556,18 @@
<li class="md-nav__item">
<a href="../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +605,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +629,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +642,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -621,12 +692,10 @@
<li class="md-nav__item md-nav__item--nested">
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4" checked> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
<label class="md-nav__link" for="nav-4"> <label class="md-nav__link" for="nav-4">
Examples Examples
@ -644,80 +713,9 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="toc">
<label class="md-nav__link md-nav__link--active" for="toc">
Ingress examples
</label>
<a href="./" title="Ingress examples" class="md-nav__link md-nav__link--active">
Ingress examples Ingress examples
</a> </a>
<nav class="md-nav md-nav--secondary">
<label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#scaling" title="Scaling" class="md-nav__link">
Scaling
</a>
</li>
<li class="md-nav__item">
<a href="#algorithms" title="Algorithms" class="md-nav__link">
Algorithms
</a>
</li>
<li class="md-nav__item">
<a href="#auth" title="Auth" class="md-nav__link">
Auth
</a>
</li>
<li class="md-nav__item">
<a href="#customization" title="Customization" class="md-nav__link">
Customization
</a>
</li>
</ul>
</nav>
</li> </li>
@ -727,7 +725,19 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../affinity/cookie/README/" title="Sticky Session" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Prerequisites
</a>
</li>
<li class="md-nav__item">
<a href="../../examples/affinity/cookie/README/" title="Sticky Session" class="md-nav__link">
Sticky Session Sticky Session
</a> </a>
</li> </li>
@ -758,7 +768,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../auth/basic/README/" title="Basic Authentication" class="md-nav__link"> <a href="../../examples/auth/basic/README/" title="Basic Authentication" class="md-nav__link">
Basic Authentication Basic Authentication
</a> </a>
</li> </li>
@ -770,7 +780,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../auth/client-certs/README/" title="Client Certificate Authentication" class="md-nav__link"> <a href="../../examples/auth/client-certs/README/" title="Client Certificate Authentication" class="md-nav__link">
Client Certificate Authentication Client Certificate Authentication
</a> </a>
</li> </li>
@ -782,12 +792,24 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../auth/external-auth/README/" title="External authentication" class="md-nav__link"> <a href="../../examples/auth/external-auth/README/" title="External authentication" class="md-nav__link">
External authentication External authentication
</a> </a>
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -818,7 +840,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/configuration-snippets/README/" title="Configuration Snippets" class="md-nav__link"> <a href="../../examples/customization/configuration-snippets/README/" title="Configuration Snippets" class="md-nav__link">
Configuration Snippets Configuration Snippets
</a> </a>
</li> </li>
@ -830,7 +852,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-configuration/README/" title="Custom Configuration" class="md-nav__link"> <a href="../../examples/customization/custom-configuration/README/" title="Custom Configuration" class="md-nav__link">
Custom Configuration Custom Configuration
</a> </a>
</li> </li>
@ -842,7 +864,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-errors/README/" title="Custom Errors" class="md-nav__link"> <a href="../../examples/customization/custom-errors/README/" title="Custom Errors" class="md-nav__link">
Custom Errors Custom Errors
</a> </a>
</li> </li>
@ -854,7 +876,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-headers/README/" title="Custom Headers" class="md-nav__link"> <a href="../../examples/customization/custom-headers/README/" title="Custom Headers" class="md-nav__link">
Custom Headers Custom Headers
</a> </a>
</li> </li>
@ -866,7 +888,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-upstream-check/README/" title="Custom Upstream server checks" class="md-nav__link"> <a href="../../examples/customization/custom-upstream-check/README/" title="Custom Upstream server checks" class="md-nav__link">
Custom Upstream server checks Custom Upstream server checks
</a> </a>
</li> </li>
@ -878,8 +900,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -890,7 +912,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/external-auth-headers/README/" title="External authentication, authentication service response headers propagation" class="md-nav__link"> <a href="../../examples/customization/external-auth-headers/README/" title="External authentication, authentication service response headers propagation" class="md-nav__link">
External authentication, authentication service response headers propagation External authentication, authentication service response headers propagation
</a> </a>
</li> </li>
@ -902,8 +924,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -914,7 +936,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/sysctl/README/" title="Sysctl tuning" class="md-nav__link"> <a href="../../examples/customization/sysctl/README/" title="Sysctl tuning" class="md-nav__link">
Sysctl tuning Sysctl tuning
</a> </a>
</li> </li>
@ -931,7 +953,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../docker-registry/README/" title="Docker registry" class="md-nav__link"> <a href="../../examples/docker-registry/README/" title="Docker registry" class="md-nav__link">
Docker registry Docker registry
</a> </a>
</li> </li>
@ -943,19 +965,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../external-auth/README/" title="External Authentication" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item">
<a href="../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
</a> </a>
</li> </li>
@ -967,7 +977,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../rewrite/README/" title="Rewrite" class="md-nav__link"> <a href="../../examples/rewrite/README/" title="Rewrite" class="md-nav__link">
Rewrite Rewrite
</a> </a>
</li> </li>
@ -979,7 +989,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../static-ip/README/" title="Static IPs" class="md-nav__link"> <a href="../../examples/static-ip/README/" title="Static IPs" class="md-nav__link">
Static IPs Static IPs
</a> </a>
</li> </li>
@ -991,7 +1001,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls-termination/README/" title="TLS termination" class="md-nav__link"> <a href="../../examples/tls-termination/README/" title="TLS termination" class="md-nav__link">
TLS termination TLS termination
</a> </a>
</li> </li>
@ -1059,29 +1069,15 @@
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#scaling" title="Scaling" class="md-nav__link"> <a href="#without-helm" title="Without Helm" class="md-nav__link">
Scaling Without Helm
</a> </a>
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#algorithms" title="Algorithms" class="md-nav__link"> <a href="#with-helm" title="With Helm" class="md-nav__link">
Algorithms With Helm
</a>
</li>
<li class="md-nav__item">
<a href="#auth" title="Auth" class="md-nav__link">
Auth
</a>
</li>
<li class="md-nav__item">
<a href="#customization" title="Customization" class="md-nav__link">
Customization
</a> </a>
</li> </li>
@ -1102,96 +1098,49 @@
<article class="md-content__inner md-typeset"> <article class="md-content__inner md-typeset">
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/deploy/upgrade.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="ingress-examples">Ingress examples<a class="headerlink" href="#ingress-examples" title="Permanent link">&para;</a></h1> <h1 id="upgrading">Upgrading<a class="headerlink" href="#upgrading" title="Permanent link">&para;</a></h1>
<p>This directory contains a catalog of examples on how to run, configure and <div class="admonition important">
scale Ingress. Please review the <a href="../PREREQUISITES/">prerequisites</a> before <p class="admonition-title">Important</p>
trying them.</p> <p>No matter the method you use for upgrading, <em>if you use template overrides,
<h2 id="scaling">Scaling<a class="headerlink" href="#scaling" title="Permanent link">&para;</a></h2> make sure your templates are compatible with the new version of ingress-nginx</em>.</p>
<table> </div>
<thead> <h2 id="without-helm">Without Helm<a class="headerlink" href="#without-helm" title="Permanent link">&para;</a></h2>
<tr> <p>To upgrade your ingress-nginx installation, it should be enough to change the version of the image
<th>Name</th> in the controller Deployment.</p>
<th>Description</th> <p>I.e. if your deployment resource looks like (partial example):</p>
<th>Complexity Level</th> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">kind</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">Deployment</span>
</tr> <span class="l l-Scalar l-Scalar-Plain">metadata</span><span class="p p-Indicator">:</span>
</thead> <span class="l l-Scalar l-Scalar-Plain">name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">nginx-ingress-controller</span>
<tbody> <span class="l l-Scalar l-Scalar-Plain">namespace</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">ingress-nginx</span>
<tr> <span class="l l-Scalar l-Scalar-Plain">spec</span><span class="p p-Indicator">:</span>
<td><a href="../static-ip/README/">Static-ip</a></td> <span class="l l-Scalar l-Scalar-Plain">replicas</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">1</span>
<td>a single ingress gets a single static ip</td> <span class="l l-Scalar l-Scalar-Plain">selector</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">...</span>
<td>Intermediate</td> <span class="l l-Scalar l-Scalar-Plain">template</span><span class="p p-Indicator">:</span>
</tr> <span class="l l-Scalar l-Scalar-Plain">metadata</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">...</span>
</tbody> <span class="l l-Scalar l-Scalar-Plain">spec</span><span class="p p-Indicator">:</span>
</table> <span class="l l-Scalar l-Scalar-Plain">containers</span><span class="p p-Indicator">:</span>
<h2 id="algorithms">Algorithms<a class="headerlink" href="#algorithms" title="Permanent link">&para;</a></h2> <span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">nginx-ingress-controller</span>
<table> <span class="l l-Scalar l-Scalar-Plain">image</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.9.0</span>
<thead> <span class="l l-Scalar l-Scalar-Plain">args</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">...</span>
<tr> </pre></div>
<th>Name</th>
<th>Description</th>
<th>Complexity Level</th> <p>simply change the <code class="codehilite">0.9.0</code> tag to the version you wish to upgrade to.
</tr> The easiest way to do this is e.g. (do note you may need to change the name parameter according to your installation):</p>
</thead> <div class="codehilite"><pre><span></span>kubectl set image deployment/nginx-ingress-controller \
<tbody> nginx-ingress-controller=nginx:quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.14.0
<tr> </pre></div>
<td><a href="../affinity/cookie/README/">Session stickyness</a></td>
<td>route requests consistently to the same endpoint</td>
<td>Advanced</td> <p>For interactive editing, use <code class="codehilite">kubectl edit deployment nginx-ingress-controller</code>.</p>
</tr> <h2 id="with-helm">With Helm<a class="headerlink" href="#with-helm" title="Permanent link">&para;</a></h2>
</tbody> <p>If you installed ingress-nginx using the Helm command in the deployment docs so its name is <code class="codehilite">ngx-ingress</code>,
</table> you should be able to upgrade using</p>
<h2 id="auth">Auth<a class="headerlink" href="#auth" title="Permanent link">&para;</a></h2> <div class="codehilite"><pre><span></span>helm upgrade --reuse-values ngx-ingress stable/nginx-ingress
<table> </pre></div>
<thead>
<tr>
<th>Name</th>
<th>Description</th>
<th>Complexity Level</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="../auth/basic/README/">Basic auth</a></td>
<td>password protect your website</td>
<td>nginx</td>
</tr>
<tr>
<td><a href="../auth/client-certs/README/">Client certificate authentication</a></td>
<td>secure your website with client certificate authentication</td>
<td>nginx</td>
</tr>
<tr>
<td><a href="../external-auth/README/">External auth plugin</a></td>
<td>defer to an external auth service</td>
<td>Intermediate</td>
</tr>
</tbody>
</table>
<h2 id="customization">Customization<a class="headerlink" href="#customization" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Name</th>
<th>Description</th>
<th>Complexity Level</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="../customization/configuration-snippets/README/">configuration-snippets</a></td>
<td>customize nginx location configuration using annotations</td>
<td>Advanced</td>
</tr>
<tr>
<td><a href="../customization/custom-headers/README/">custom-headers</a></td>
<td>set custom headers before send traffic to backends</td>
<td>Advanced</td>
</tr>
</tbody>
</table>
@ -1212,7 +1161,7 @@ trying them.</p>
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../PREREQUISITES/" title="Prerequisites" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../rbac/" title="Role Based Access Control (RBAC)" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1221,19 +1170,19 @@ trying them.</p>
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Prerequisites Role Based Access Control (RBAC)
</span> </span>
</div> </div>
</a> </a>
<a href="../affinity/cookie/README/" title="Sticky Session" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../user-guide/nginx-configuration/" title="NGINX Configuration" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Sticky Session NGINX Configuration
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -244,7 +244,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -358,6 +358,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -495,6 +507,18 @@
<li class="md-nav__item">
<a href="../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -532,8 +556,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -556,8 +580,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -569,13 +593,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -640,8 +664,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -652,8 +676,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -725,6 +749,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -815,8 +851,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -839,8 +875,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -879,18 +915,6 @@
<li class="md-nav__item">
<a href="../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="./" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -642,6 +666,18 @@
<li class="md-nav__item">
<a href="../" title="Ingress examples" class="md-nav__link">
Ingress examples
</a>
</li>
@ -734,18 +770,6 @@
<li class="md-nav__item">
<a href="../README/" title="Ingress examples" class="md-nav__link">
Ingress examples
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../affinity/cookie/README/" title="Sticky Session" class="md-nav__link"> <a href="../affinity/cookie/README/" title="Sticky Session" class="md-nav__link">
Sticky Session Sticky Session
@ -808,6 +832,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -898,8 +934,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -922,8 +958,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -962,18 +998,6 @@
<li class="md-nav__item">
<a href="../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1334,7 +1358,7 @@ which you can deploy as follows</p>
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../user-guide/third-party-addons/opentracing/" title="OpenTracing" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../" title="Ingress examples" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1343,19 +1367,19 @@ which you can deploy as follows</p>
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
OpenTracing Ingress examples
</span> </span>
</div> </div>
</a> </a>
<a href="../README/" title="Ingress examples" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../affinity/cookie/README/" title="Sticky Session" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Ingress examples Sticky Session
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -774,6 +798,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -864,8 +900,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -888,8 +924,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -928,18 +964,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1175,7 +1199,7 @@ This means that you can face the situation that you've configured Session Affini
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../../README/" title="Ingress examples" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1184,7 +1208,7 @@ This means that you can face the situation that you've configured Session Affini
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Ingress examples Prerequisites
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -769,6 +793,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -859,8 +895,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -883,8 +919,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -923,18 +959,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -769,6 +793,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -859,8 +895,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -883,8 +919,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -923,18 +959,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1246,13 +1270,13 @@ BODY:
</a> </a>
<a href="../../../customization/configuration-snippets/README/" title="Configuration Snippets" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../oauth-external-auth/README/" title="External Authentication" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Configuration Snippets External Authentication
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -31,7 +31,7 @@
<meta name="lang:search.tokenizer" content="[\s\-]+"> <meta name="lang:search.tokenizer" content="[\s\-]+">
<link rel="shortcut icon" href="../../../assets/images/favicon.png"> <link rel="shortcut icon" href="../../../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-0.17.3, mkdocs-material-2.7.3"> <meta name="generator" content="mkdocs-0.17.3, mkdocs-material-2.7.3">
@ -40,13 +40,13 @@
<link rel="stylesheet" href="../../../assets/stylesheets/application.8d40d89b.css"> <link rel="stylesheet" href="../../../../assets/stylesheets/application.8d40d89b.css">
<link rel="stylesheet" href="../../../assets/stylesheets/application-palette.6079476c.css"> <link rel="stylesheet" href="../../../../assets/stylesheets/application-palette.6079476c.css">
<script src="../../../assets/javascripts/modernizr.1aa3b519.js"></script> <script src="../../../../assets/javascripts/modernizr.1aa3b519.js"></script>
<link href="https://fonts.gstatic.com" rel="preconnect" crossorigin> <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
@ -57,7 +57,7 @@
<link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons"> <link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
<link rel="stylesheet" href="../../../extra.css"> <link rel="stylesheet" href="../../../../extra.css">
</head> </head>
@ -104,7 +104,7 @@
<nav class="md-header-nav md-grid"> <nav class="md-header-nav md-grid">
<div class="md-flex"> <div class="md-flex">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<a href="../../.." title="NGINX Ingress Controller" class="md-header-nav__button md-logo"> <a href="../../../.." title="NGINX Ingress Controller" class="md-header-nav__button md-logo">
<i class="md-icon">public</i> <i class="md-icon">public</i>
@ -202,7 +202,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../.." title="Welcome" class="md-tabs__link"> <a href="../../../.." title="Welcome" class="md-tabs__link">
Welcome Welcome
</a> </a>
@ -214,7 +214,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../deploy/" title="Deployment" class="md-tabs__link"> <a href="../../../../deploy/" title="Deployment" class="md-tabs__link">
Deployment Deployment
</a> </a>
@ -231,7 +231,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../user-guide/nginx-configuration/" title="User guide" class="md-tabs__link"> <a href="../../../../user-guide/nginx-configuration/" title="User guide" class="md-tabs__link">
User guide User guide
</a> </a>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -311,7 +311,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../.." title="Welcome" class="md-nav__link"> <a href="../../../.." title="Welcome" class="md-nav__link">
Welcome Welcome
</a> </a>
</li> </li>
@ -342,7 +342,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../deploy/" title="Installation Guide" class="md-nav__link"> <a href="../../../../deploy/" title="Installation Guide" class="md-nav__link">
Installation Guide Installation Guide
</a> </a>
</li> </li>
@ -354,12 +354,24 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../deploy/rbac/" title="Role Based Access Control (RBAC)" class="md-nav__link"> <a href="../../../../deploy/rbac/" title="Role Based Access Control (RBAC)" class="md-nav__link">
Role Based Access Control (RBAC) Role Based Access Control (RBAC)
</a> </a>
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -409,7 +421,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-configuration/" title="NGINX Configuration" class="md-nav__link"> <a href="../../../../user-guide/nginx-configuration/" title="NGINX Configuration" class="md-nav__link">
NGINX Configuration NGINX Configuration
</a> </a>
</li> </li>
@ -421,7 +433,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-configuration/annotations/" title="Annotations" class="md-nav__link"> <a href="../../../../user-guide/nginx-configuration/annotations/" title="Annotations" class="md-nav__link">
Annotations Annotations
</a> </a>
</li> </li>
@ -433,7 +445,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-configuration/configmap/" title="ConfigMaps" class="md-nav__link"> <a href="../../../../user-guide/nginx-configuration/configmap/" title="ConfigMaps" class="md-nav__link">
ConfigMaps ConfigMaps
</a> </a>
</li> </li>
@ -445,7 +457,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-configuration/custom-template/" title="Custom NGINX template" class="md-nav__link"> <a href="../../../../user-guide/nginx-configuration/custom-template/" title="Custom NGINX template" class="md-nav__link">
Custom NGINX template Custom NGINX template
</a> </a>
</li> </li>
@ -457,7 +469,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-configuration/log-format/" title="Log format" class="md-nav__link"> <a href="../../../../user-guide/nginx-configuration/log-format/" title="Log format" class="md-nav__link">
Log format Log format
</a> </a>
</li> </li>
@ -474,7 +486,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/cli-arguments/" title="Command line arguments" class="md-nav__link"> <a href="../../../../user-guide/cli-arguments/" title="Command line arguments" class="md-nav__link">
Command line arguments Command line arguments
</a> </a>
</li> </li>
@ -486,7 +498,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/custom-errors/" title="Custom errors" class="md-nav__link"> <a href="../../../../user-guide/custom-errors/" title="Custom errors" class="md-nav__link">
Custom errors Custom errors
</a> </a>
</li> </li>
@ -498,7 +510,19 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
</a> </a>
</li> </li>
@ -510,7 +534,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/external-articles/" title="External Articles" class="md-nav__link"> <a href="../../../../user-guide/external-articles/" title="External Articles" class="md-nav__link">
External Articles External Articles
</a> </a>
</li> </li>
@ -522,7 +546,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/miscellaneous/" title="Miscellaneous" class="md-nav__link"> <a href="../../../../user-guide/miscellaneous/" title="Miscellaneous" class="md-nav__link">
Miscellaneous Miscellaneous
</a> </a>
</li> </li>
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -546,7 +570,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/nginx-status-page/" title="NGINX status page" class="md-nav__link"> <a href="../../../../user-guide/nginx-status-page/" title="NGINX status page" class="md-nav__link">
NGINX status page NGINX status page
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -589,7 +613,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/third-party-addons/modsecurity/" title="ModSecurity Web Application Firewall" class="md-nav__link"> <a href="../../../../user-guide/third-party-addons/modsecurity/" title="ModSecurity Web Application Firewall" class="md-nav__link">
ModSecurity Web Application Firewall ModSecurity Web Application Firewall
</a> </a>
</li> </li>
@ -601,7 +625,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/third-party-addons/opentracing/" title="OpenTracing" class="md-nav__link"> <a href="../../../../user-guide/third-party-addons/opentracing/" title="OpenTracing" class="md-nav__link">
OpenTracing OpenTracing
</a> </a>
</li> </li>
@ -644,19 +668,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites
</a>
</li>
<li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link">
Ingress examples Ingress examples
</a> </a>
</li> </li>
@ -668,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../affinity/cookie/README/" title="Sticky Session" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Sticky Session Prerequisites
</a> </a>
</li> </li>
@ -679,9 +691,23 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item">
<a href="../../../affinity/cookie/README/" title="Sticky Session" class="md-nav__link">
Sticky Session
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-4-4" type="checkbox" id="nav-4-4"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4-4" type="checkbox" id="nav-4-4" checked>
<label class="md-nav__link" for="nav-4-4"> <label class="md-nav__link" for="nav-4-4">
Auth Auth
@ -699,7 +725,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../auth/basic/README/" title="Basic Authentication" class="md-nav__link"> <a href="../../basic/README/" title="Basic Authentication" class="md-nav__link">
Basic Authentication Basic Authentication
</a> </a>
</li> </li>
@ -711,7 +737,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../auth/client-certs/README/" title="Client Certificate Authentication" class="md-nav__link"> <a href="../../client-certs/README/" title="Client Certificate Authentication" class="md-nav__link">
Client Certificate Authentication Client Certificate Authentication
</a> </a>
</li> </li>
@ -723,161 +749,12 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../auth/external-auth/README/" title="External authentication" class="md-nav__link"> <a href="../../external-auth/README/" title="External authentication" class="md-nav__link">
External authentication External authentication
</a> </a>
</li> </li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-4-5" type="checkbox" id="nav-4-5">
<label class="md-nav__link" for="nav-4-5">
Customization
</label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-4-5">
Customization
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../customization/configuration-snippets/README/" title="Configuration Snippets" class="md-nav__link">
Configuration Snippets
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/custom-configuration/README/" title="Custom Configuration" class="md-nav__link">
Custom Configuration
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/custom-errors/README/" title="Custom Errors" class="md-nav__link">
Custom Errors
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/custom-headers/README/" title="Custom Headers" class="md-nav__link">
Custom Headers
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/custom-upstream-check/README/" title="Custom Upstream server checks" class="md-nav__link">
Custom Upstream server checks
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link">
Deploying the Nginx Ingress controller
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/external-auth-headers/README/" title="External authentication, authentication service response headers propagation" class="md-nav__link">
External authentication, authentication service response headers propagation
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link">
Deploying the Nginx Ingress controller
</a>
</li>
<li class="md-nav__item">
<a href="../../customization/sysctl/README/" title="Sysctl tuning" class="md-nav__link">
Sysctl tuning
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../docker-registry/README/" title="Docker registry" class="md-nav__link">
Docker registry
</a>
</li>
@ -955,13 +832,162 @@
</li> </li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-4-5" type="checkbox" id="nav-4-5">
<label class="md-nav__link" for="nav-4-5">
Customization
</label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-4-5">
Customization
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../customization/configuration-snippets/README/" title="Configuration Snippets" class="md-nav__link">
Configuration Snippets
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/custom-configuration/README/" title="Custom Configuration" class="md-nav__link">
Custom Configuration
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/custom-errors/README/" title="Custom Errors" class="md-nav__link">
Custom Errors
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/custom-headers/README/" title="Custom Headers" class="md-nav__link">
Custom Headers
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/custom-upstream-check/README/" title="Custom Upstream server checks" class="md-nav__link">
Custom Upstream server checks
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Custom VTS metrics with Prometheus
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/external-auth-headers/README/" title="External authentication, authentication service response headers propagation" class="md-nav__link">
External authentication, authentication service response headers propagation
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Custom DH parameters for perfect forward secrecy
</a>
</li>
<li class="md-nav__item">
<a href="../../../customization/sysctl/README/" title="Sysctl tuning" class="md-nav__link">
Sysctl tuning
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../../docker-registry/README/" title="Docker registry" class="md-nav__link">
Docker registry
</a>
</li>
<li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
</a> </a>
</li> </li>
@ -973,7 +999,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../rewrite/README/" title="Rewrite" class="md-nav__link"> <a href="../../../rewrite/README/" title="Rewrite" class="md-nav__link">
Rewrite Rewrite
</a> </a>
</li> </li>
@ -985,7 +1011,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../static-ip/README/" title="Static IPs" class="md-nav__link"> <a href="../../../static-ip/README/" title="Static IPs" class="md-nav__link">
Static IPs Static IPs
</a> </a>
</li> </li>
@ -997,7 +1023,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls-termination/README/" title="TLS termination" class="md-nav__link"> <a href="../../../tls-termination/README/" title="TLS termination" class="md-nav__link">
TLS termination TLS termination
</a> </a>
</li> </li>
@ -1014,7 +1040,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../development/" title="Developing for NGINX Ingress Controller" class="md-nav__link"> <a href="../../../../development/" title="Developing for NGINX Ingress Controller" class="md-nav__link">
Developing for NGINX Ingress Controller Developing for NGINX Ingress Controller
</a> </a>
</li> </li>
@ -1026,7 +1052,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../ingress-controller-catalog/" title="Ingress Controller Catalog" class="md-nav__link"> <a href="../../../../ingress-controller-catalog/" title="Ingress Controller Catalog" class="md-nav__link">
Ingress Controller Catalog Ingress Controller Catalog
</a> </a>
</li> </li>
@ -1038,7 +1064,7 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../troubleshooting/" title="Debug & Troubleshooting" class="md-nav__link"> <a href="../../../../troubleshooting/" title="Debug & Troubleshooting" class="md-nav__link">
Debug & Troubleshooting Debug & Troubleshooting
</a> </a>
</li> </li>
@ -1114,7 +1140,7 @@
<article class="md-content__inner md-typeset"> <article class="md-content__inner md-typeset">
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/external-auth/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/auth/oauth-external-auth/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="external-authentication">External Authentication<a class="headerlink" href="#external-authentication" title="Permanent link">&para;</a></h1> <h1 id="external-authentication">External Authentication<a class="headerlink" href="#external-authentication" title="Permanent link">&para;</a></h1>
@ -1209,7 +1235,7 @@ into a Kubernetes cluster and use it to protect the Kubernetes Dashboard using g
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../docker-registry/README/" title="Docker registry" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../external-auth/README/" title="External authentication" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1218,19 +1244,19 @@ into a Kubernetes cluster and use it to protect the Kubernetes Dashboard using g
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Docker registry External authentication
</span> </span>
</div> </div>
</a> </a>
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../../customization/configuration-snippets/README/" title="Configuration Snippets" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Multi TLS certificate termination Configuration Snippets
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
@ -1260,9 +1286,9 @@ into a Kubernetes cluster and use it to protect the Kubernetes Dashboard using g
</div> </div>
<script src="../../../assets/javascripts/application.b438e6c5.js"></script> <script src="../../../../assets/javascripts/application.b438e6c5.js"></script>
<script>app.initialize({version:"0.17.3",url:{base:"../../.."}})</script> <script>app.initialize({version:"0.17.3",url:{base:"../../../.."}})</script>

View file

Before

Width:  |  Height:  |  Size: 86 KiB

After

Width:  |  Height:  |  Size: 86 KiB

View file

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

View file

Before

Width:  |  Height:  |  Size: 50 KiB

After

Width:  |  Height:  |  Size: 50 KiB

View file

Before

Width:  |  Height:  |  Size: 90 KiB

After

Width:  |  Height:  |  Size: 90 KiB

View file

Before

Width:  |  Height:  |  Size: 84 KiB

After

Width:  |  Height:  |  Size: 84 KiB

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -866,8 +902,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -890,8 +926,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -930,18 +966,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1109,7 +1133,7 @@
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../../auth/external-auth/README/" title="External authentication" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1118,7 +1142,7 @@
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
External authentication External Authentication
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -859,8 +895,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -883,8 +919,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -923,18 +959,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1098,13 +1122,13 @@ spec:
</a> </a>
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -36,7 +36,7 @@
<title>Deploying the Nginx Ingress controller - NGINX Ingress Controller</title> <title>Custom VTS metrics with Prometheus - NGINX Ingress Controller</title>
@ -95,7 +95,7 @@
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label> <label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<a href="#deploying-the-nginx-ingress-controller" tabindex="1" class="md-skip"> <a href="#custom-vts-metrics-with-prometheus" tabindex="1" class="md-skip">
Skip to content Skip to content
</a> </a>
@ -121,7 +121,7 @@
NGINX Ingress Controller NGINX Ingress Controller
</span> </span>
<span class="md-header-nav__topic"> <span class="md-header-nav__topic">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</span> </span>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,11 +866,11 @@
<label class="md-nav__link md-nav__link--active" for="toc"> <label class="md-nav__link md-nav__link--active" for="toc">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</label> </label>
<a href="./" title="Deploying the Nginx Ingress controller" class="md-nav__link md-nav__link--active"> <a href="./" title="Custom VTS metrics with Prometheus" class="md-nav__link md-nav__link--active">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
@ -945,8 +981,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -985,18 +1021,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1189,7 +1213,7 @@
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/customization/custom-vts-metrics-prometheus/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/customization/custom-vts-metrics-prometheus/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="deploying-the-nginx-ingress-controller">Deploying the Nginx Ingress controller<a class="headerlink" href="#deploying-the-nginx-ingress-controller" title="Permanent link">&para;</a></h1> <h1 id="custom-vts-metrics-with-prometheus">Custom VTS metrics with Prometheus<a class="headerlink" href="#custom-vts-metrics-with-prometheus" title="Permanent link">&para;</a></h1>
<p>This example aims to demonstrate the deployment of an nginx ingress controller and use a ConfigMap to enable <a href="https://github.com/vozlt/nginx-module-vts">nginx vts module</a> to export metrics in prometheus format. </p> <p>This example aims to demonstrate the deployment of an nginx ingress controller and use a ConfigMap to enable <a href="https://github.com/vozlt/nginx-module-vts">nginx vts module</a> to export metrics in prometheus format. </p>
<h2 id="vts-metrics">vts-metrics<a class="headerlink" href="#vts-metrics" title="Permanent link">&para;</a></h2> <h2 id="vts-metrics">vts-metrics<a class="headerlink" href="#vts-metrics" title="Permanent link">&para;</a></h2>
<p>Vts-metrics export NGINX metrics. To deploy all the files simply run <code class="codehilite">kubectl apply -f nginx</code>. A deployment and service will be <p>Vts-metrics export NGINX metrics. To deploy all the files simply run <code class="codehilite">kubectl apply -f nginx</code>. A deployment and service will be

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -821,8 +857,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1171,7 +1195,7 @@ follows:</p>
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1180,19 +1204,19 @@ follows:</p>
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</span> </span>
</div> </div>
</a> </a>
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -36,7 +36,7 @@
<title>Deploying the Nginx Ingress controller - NGINX Ingress Controller</title> <title>Custom DH parameters for perfect forward secrecy - NGINX Ingress Controller</title>
@ -95,7 +95,7 @@
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label> <label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<a href="#deploying-the-nginx-ingress-controller" tabindex="1" class="md-skip"> <a href="#custom-dh-parameters-for-perfect-forward-secrecy" tabindex="1" class="md-skip">
Skip to content Skip to content
</a> </a>
@ -121,7 +121,7 @@
NGINX Ingress Controller NGINX Ingress Controller
</span> </span>
<span class="md-header-nav__topic"> <span class="md-header-nav__topic">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</span> </span>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -821,8 +857,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,11 +890,11 @@
<label class="md-nav__link md-nav__link--active" for="toc"> <label class="md-nav__link md-nav__link--active" for="toc">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</label> </label>
<a href="./" title="Deploying the Nginx Ingress controller" class="md-nav__link md-nav__link--active"> <a href="./" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link md-nav__link--active">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
@ -937,18 +973,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1093,7 +1117,7 @@
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/customization/ssl-dh-param/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/examples/customization/ssl-dh-param/README.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="deploying-the-nginx-ingress-controller">Deploying the Nginx Ingress controller<a class="headerlink" href="#deploying-the-nginx-ingress-controller" title="Permanent link">&para;</a></h1> <h1 id="custom-dh-parameters-for-perfect-forward-secrecy">Custom DH parameters for perfect forward secrecy<a class="headerlink" href="#custom-dh-parameters-for-perfect-forward-secrecy" title="Permanent link">&para;</a></h1>
<p>This example aims to demonstrate the deployment of an nginx ingress controller and <p>This example aims to demonstrate the deployment of an nginx ingress controller and
use a ConfigMap to configure custom Diffie-Hellman parameters file to help with use a ConfigMap to configure custom Diffie-Hellman parameters file to help with
"Perfect Forward Secrecy".</p> "Perfect Forward Secrecy".</p>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -821,8 +857,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -845,8 +881,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1045,7 +1069,7 @@ using <code class="codehilite">kubectl patch</code></p>
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1054,7 +1078,7 @@ using <code class="codehilite">kubectl patch</code></p>
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -819,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -843,8 +879,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -948,18 +984,6 @@
<li class="md-nav__item">
<a href="../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1193,13 +1217,13 @@
</a> </a>
<a href="../../external-auth/README/" title="External Authentication" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
External Authentication Multi TLS certificate termination
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

1256
examples/index.html Normal file

File diff suppressed because it is too large Load diff

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -819,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -843,8 +879,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -882,18 +918,6 @@
<li class="md-nav__item">
<a href="../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
@ -1130,7 +1154,7 @@
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../external-auth/README/" title="External Authentication" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../docker-registry/README/" title="Docker registry" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1139,7 +1163,7 @@
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
External Authentication Docker registry
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -819,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -843,8 +879,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -883,18 +919,6 @@
<li class="md-nav__item">
<a href="../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -819,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -843,8 +879,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -883,18 +919,6 @@
<li class="md-nav__item">
<a href="../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../PREREQUISITES/" title="Examples" class="md-tabs__link md-tabs__link--active"> <a href="../../" title="Examples" class="md-tabs__link md-tabs__link--active">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -497,6 +509,18 @@
<li class="md-nav__item">
<a href="../../../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -534,8 +558,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -558,8 +582,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../../../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -571,13 +595,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -644,8 +668,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -656,8 +680,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../README/" title="Ingress examples" class="md-nav__link"> <a href="../../PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -729,6 +753,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -819,8 +855,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -843,8 +879,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -883,18 +919,6 @@
<li class="md-nav__item">
<a href="../../external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -244,7 +244,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -396,6 +396,18 @@
</li> </li>
<li class="md-nav__item">
<a href="deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -533,6 +545,18 @@
<li class="md-nav__item">
<a href="user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -570,8 +594,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -594,8 +618,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="user-guide/tls/" title="TLS" class="md-nav__link"> <a href="user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -607,13 +631,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -678,8 +702,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -690,8 +714,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="examples/README/" title="Ingress examples" class="md-nav__link"> <a href="examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -763,6 +787,18 @@
</li> </li>
<li class="md-nav__item">
<a href="examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -853,8 +889,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -877,8 +913,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -917,18 +953,6 @@
<li class="md-nav__item">
<a href="examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -244,7 +244,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -358,6 +358,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -495,6 +507,18 @@
<li class="md-nav__item">
<a href="../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -532,8 +556,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -556,8 +580,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -569,13 +593,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -640,8 +664,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -652,8 +676,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -725,6 +749,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -815,8 +851,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -839,8 +875,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -879,18 +915,6 @@
<li class="md-nav__item">
<a href="../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

File diff suppressed because one or more lines are too long

View file

@ -4,7 +4,7 @@
<url> <url>
<loc>/</loc> <loc>/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -13,13 +13,19 @@
<url> <url>
<loc>/deploy/</loc> <loc>/deploy/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/deploy/rbac/</loc> <loc>/deploy/rbac/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>/deploy/upgrade/</loc>
<lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -35,49 +41,55 @@
<url> <url>
<loc>/user-guide/cli-arguments/</loc> <loc>/user-guide/cli-arguments/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/custom-errors/</loc> <loc>/user-guide/custom-errors/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>/user-guide/default-backend/</loc>
<lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/exposing-tcp-udp-services/</loc> <loc>/user-guide/exposing-tcp-udp-services/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/external-articles/</loc> <loc>/user-guide/external-articles/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/miscellaneous/</loc> <loc>/user-guide/miscellaneous/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/multiple-ingress/</loc> <loc>/user-guide/multiple-ingress/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/nginx-status-page/</loc> <loc>/user-guide/nginx-status-page/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/user-guide/tls/</loc> <loc>/user-guide/tls/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -92,20 +104,20 @@
<url> <url>
<loc>/examples/PREREQUISITES/</loc> <loc>/examples/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/README/</loc> <loc>/examples/PREREQUISITES/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/affinity/cookie/README/</loc> <loc>/examples/affinity/cookie/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -123,37 +135,31 @@
<url> <url>
<loc>/examples/docker-registry/README/</loc> <loc>/examples/docker-registry/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>/examples/external-auth/README/</loc>
<lastmod>2018-05-02</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/multi-tls/README/</loc> <loc>/examples/multi-tls/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/rewrite/README/</loc> <loc>/examples/rewrite/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/static-ip/README/</loc> <loc>/examples/static-ip/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>/examples/tls-termination/README/</loc> <loc>/examples/tls-termination/README/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -162,7 +168,7 @@
<url> <url>
<loc>/development/</loc> <loc>/development/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -170,7 +176,7 @@
<url> <url>
<loc>/ingress-controller-catalog/</loc> <loc>/ingress-controller-catalog/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
@ -178,7 +184,7 @@
<url> <url>
<loc>/troubleshooting/</loc> <loc>/troubleshooting/</loc>
<lastmod>2018-05-02</lastmod> <lastmod>2018-05-03</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>

View file

@ -244,7 +244,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -358,6 +358,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -495,6 +507,18 @@
<li class="md-nav__item">
<a href="../user-guide/default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../user-guide/exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -532,8 +556,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../user-guide/multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -556,8 +580,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../user-guide/tls/" title="TLS" class="md-nav__link"> <a href="../user-guide/tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -569,13 +593,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -640,8 +664,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -652,8 +676,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -725,6 +749,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -815,8 +851,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -839,8 +875,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -879,18 +915,6 @@
<li class="md-nav__item">
<a href="../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -508,6 +520,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -545,8 +569,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,8 +593,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -582,13 +606,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -653,8 +677,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -665,8 +689,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -738,6 +762,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -828,8 +864,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -852,8 +888,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -892,18 +928,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -508,6 +520,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -545,8 +569,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,8 +593,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -582,13 +606,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -653,8 +677,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -665,8 +689,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -738,6 +762,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -828,8 +864,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -852,8 +888,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -892,18 +928,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1072,13 +1096,13 @@ Each request to the default backend includes two headers:</p>
</a> </a>
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../default-backend/" title="Default backend" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Exposing TCP and UDP services Default backend
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

File diff suppressed because it is too large Load diff

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -498,6 +510,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
@ -545,8 +569,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,8 +593,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -582,13 +606,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -653,8 +677,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -665,8 +689,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -738,6 +762,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -828,8 +864,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -852,8 +888,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -892,18 +928,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1062,7 +1086,7 @@ The next example shows how to expose the service <code class="codehilite">kube-d
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../custom-errors/" title="Custom errors" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../default-backend/" title="Default backend" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1071,7 +1095,7 @@ The next example shows how to expose the service <code class="codehilite">kube-d
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Custom errors Default backend
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -545,8 +569,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,8 +593,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -582,13 +606,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -653,8 +677,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -665,8 +689,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -738,6 +762,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -828,8 +864,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -852,8 +888,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -892,18 +928,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -550,20 +574,6 @@
<label class="md-nav__title" for="toc">Table of contents</label> <label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#conventions" title="Conventions" class="md-nav__link">
Conventions
</a>
</li>
<li class="md-nav__item">
<a href="#requirements" title="Requirements" class="md-nav__link">
Requirements
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#source-ip-address" title="Source IP address" class="md-nav__link"> <a href="#source-ip-address" title="Source IP address" class="md-nav__link">
Source IP address Source IP address
@ -630,8 +640,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -654,8 +664,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -667,13 +677,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -738,8 +748,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -750,8 +760,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -823,6 +833,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -913,8 +935,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -937,8 +959,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -977,18 +999,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1093,20 +1103,6 @@
<label class="md-nav__title" for="toc">Table of contents</label> <label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#conventions" title="Conventions" class="md-nav__link">
Conventions
</a>
</li>
<li class="md-nav__item">
<a href="#requirements" title="Requirements" class="md-nav__link">
Requirements
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#source-ip-address" title="Source IP address" class="md-nav__link"> <a href="#source-ip-address" title="Source IP address" class="md-nav__link">
Source IP address Source IP address
@ -1176,18 +1172,6 @@
<h1 id="miscellaneous">Miscellaneous<a class="headerlink" href="#miscellaneous" title="Permanent link">&para;</a></h1> <h1 id="miscellaneous">Miscellaneous<a class="headerlink" href="#miscellaneous" title="Permanent link">&para;</a></h1>
<h2 id="conventions">Conventions<a class="headerlink" href="#conventions" title="Permanent link">&para;</a></h2>
<p>Anytime we reference a tls secret, we mean (x509, pem encoded, RSA 2048, etc). You can generate such a certificate with:
<code class="codehilite">openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout <span class="cp">${</span><span class="n">KEY_FILE</span><span class="cp">}</span> -out <span class="cp">${</span><span class="n">CERT_FILE</span><span class="cp">}</span> -subj &quot;/CN=<span class="cp">${</span><span class="n">HOST</span><span class="cp">}</span>/O=<span class="cp">${</span><span class="n">HOST</span><span class="cp">}</span>&quot;</code>
and create the secret via <code class="codehilite">kubectl create secret tls <span class="cp">${</span><span class="n">CERT_NAME</span><span class="cp">}</span> --key <span class="cp">${</span><span class="n">KEY_FILE</span><span class="cp">}</span> --cert <span class="cp">${</span><span class="n">CERT_FILE</span><span class="cp">}</span></code></p>
<h2 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Permanent link">&para;</a></h2>
<p>The default backend is a service which handles all url paths and hosts the nginx controller doesn't understand (i.e., all the requests that are not mapped with an Ingress).
Basically a default backend exposes two URLs:</p>
<ul>
<li><code class="codehilite">/healthz</code> that returns 200</li>
<li><code class="codehilite">/</code> that returns 404</li>
</ul>
<p>The sub-directory <a href="https://github.com/kubernetes/ingress-nginx/tree/master/images/404-server"><code class="codehilite">/images/404-server</code></a> provides a service which satisfies the requirements for a default backend. The sub-directory <a href="https://github.com/kubernetes/ingress-nginx/tree/master/images/custom-error-pages"><code class="codehilite">/images/custom-error-pages</code></a> provides an additional service for the purpose of customizing the error pages served via the default backend.</p>
<h2 id="source-ip-address">Source IP address<a class="headerlink" href="#source-ip-address" title="Permanent link">&para;</a></h2> <h2 id="source-ip-address">Source IP address<a class="headerlink" href="#source-ip-address" title="Permanent link">&para;</a></h2>
<p>By default NGINX uses the content of the header <code class="codehilite">X-Forwarded-For</code> as the source of truth to get information about the client IP address. This works without issues in L7 <strong>if we configure the setting <code class="codehilite">proxy-real-ip-cidr</code></strong> with the correct information of the IP/network address of trusted external load balancer.</p> <p>By default NGINX uses the content of the header <code class="codehilite">X-Forwarded-For</code> as the source of truth to get information about the client IP address. This works without issues in L7 <strong>if we configure the setting <code class="codehilite">proxy-real-ip-cidr</code></strong> with the correct information of the IP/network address of trusted external load balancer.</p>
<p>If the ingress controller is running in AWS we need to use the VPC IPv4 CIDR.</p> <p>If the ingress controller is running in AWS we need to use the VPC IPv4 CIDR.</p>
@ -1253,13 +1237,13 @@ The previous behavior can be restored using <code class="codehilite">retry-non-i
</a> </a>
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Multiple ingress controllers Multiple Ingress controllers
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -36,7 +36,7 @@
<title>Multiple ingress controllers - NGINX Ingress Controller</title> <title>Multiple Ingress controllers - NGINX Ingress Controller</title>
@ -121,7 +121,7 @@
NGINX Ingress Controller NGINX Ingress Controller
</span> </span>
<span class="md-header-nav__topic"> <span class="md-header-nav__topic">
Multiple ingress controllers Multiple Ingress controllers
</span> </span>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -545,11 +569,11 @@
<label class="md-nav__link md-nav__link--active" for="toc"> <label class="md-nav__link md-nav__link--active" for="toc">
Multiple ingress controllers Multiple Ingress controllers
</label> </label>
<a href="./" title="Multiple ingress controllers" class="md-nav__link md-nav__link--active"> <a href="./" title="Multiple Ingress controllers" class="md-nav__link md-nav__link--active">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
@ -563,22 +587,8 @@
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#running-multiple-ingress-controllers" title="Running multiple ingress controllers" class="md-nav__link"> <a href="#multiple-ingress-nginx-controllers" title="Multiple ingress-nginx controllers" class="md-nav__link">
Running multiple ingress controllers Multiple ingress-nginx controllers
</a>
</li>
<li class="md-nav__item">
<a href="#annotation-ingressclass" title="Annotation ingress.class" class="md-nav__link">
Annotation ingress.class
</a>
</li>
<li class="md-nav__item">
<a href="#disabling-nginx-ingress-controller" title="Disabling NGINX ingress controller" class="md-nav__link">
Disabling NGINX ingress controller
</a> </a>
</li> </li>
@ -612,8 +622,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -625,13 +635,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -696,8 +706,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -708,8 +718,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -781,6 +791,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -871,8 +893,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -895,8 +917,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -935,18 +957,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1052,22 +1062,8 @@
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#running-multiple-ingress-controllers" title="Running multiple ingress controllers" class="md-nav__link"> <a href="#multiple-ingress-nginx-controllers" title="Multiple ingress-nginx controllers" class="md-nav__link">
Running multiple ingress controllers Multiple ingress-nginx controllers
</a>
</li>
<li class="md-nav__item">
<a href="#annotation-ingressclass" title="Annotation ingress.class" class="md-nav__link">
Annotation ingress.class
</a>
</li>
<li class="md-nav__item">
<a href="#disabling-nginx-ingress-controller" title="Disabling NGINX ingress controller" class="md-nav__link">
Disabling NGINX ingress controller
</a> </a>
</li> </li>
@ -1091,27 +1087,10 @@
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/user-guide/multiple-ingress.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/user-guide/multiple-ingress.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="multiple-ingress-controllers">Multiple ingress controllers<a class="headerlink" href="#multiple-ingress-controllers" title="Permanent link">&para;</a></h1> <h1 id="multiple-ingress-controllers">Multiple Ingress controllers<a class="headerlink" href="#multiple-ingress-controllers" title="Permanent link">&para;</a></h1>
<h2 id="running-multiple-ingress-controllers">Running multiple ingress controllers<a class="headerlink" href="#running-multiple-ingress-controllers" title="Permanent link">&para;</a></h2> <p>If you're running multiple ingress controllers, or running on a cloud provider that natively handles ingress such as GKE,
<p>If you're running multiple ingress controllers, or running on a cloud provider that natively handles ingress, you need to specify the annotation <code class="codehilite">kubernetes.io/ingress.class: &quot;nginx&quot;</code> in all ingresses that you would like this controller to claim.</p> you need to specify the annotation <code class="codehilite">kubernetes.io/ingress.class: &quot;nginx&quot;</code> in all ingresses that you would like the ingress-nginx controller to claim.</p>
<p>This mechanism also provides users the ability to run <em>multiple</em> NGINX ingress controllers (e.g. one which serves public traffic, one which serves "internal" traffic). When utilizing this functionality the option <code class="codehilite">--ingress-class</code> should be changed to a value unique for the cluster within the definition of the replication controller. Here is a partial example:</p> <p>For instance,</p>
<div class="codehilite"><pre><span></span><span class="n">spec</span><span class="o">:</span>
<span class="n">template</span><span class="o">:</span>
<span class="n">spec</span><span class="o">:</span>
<span class="n">containers</span><span class="o">:</span>
<span class="o">-</span> <span class="n">name</span><span class="o">:</span> <span class="n">nginx</span><span class="o">-</span><span class="n">ingress</span><span class="o">-</span><span class="kd">internal</span><span class="o">-</span><span class="n">controller</span>
<span class="n">args</span><span class="o">:</span>
<span class="o">-</span> <span class="o">/</span><span class="n">nginx</span><span class="o">-</span><span class="n">ingress</span><span class="o">-</span><span class="n">controller</span>
<span class="o">-</span> <span class="s1">&#39;--default-backend-service=ingress/nginx-ingress-default-backend&#39;</span>
<span class="o">-</span> <span class="s1">&#39;--election-id=ingress-controller-leader-internal&#39;</span>
<span class="o">-</span> <span class="s1">&#39;--ingress-class=nginx-internal&#39;</span>
<span class="o">-</span> <span class="s1">&#39;--configmap=ingress/nginx-ingress-internal-controller&#39;</span>
</pre></div>
<h2 id="annotation-ingressclass">Annotation ingress.class<a class="headerlink" href="#annotation-ingressclass" title="Permanent link">&para;</a></h2>
<p>If you have multiple Ingress controllers in a single cluster, you can pick one by specifying the <code class="codehilite">ingress.class</code>
annotation, eg creating an Ingress with an annotation like</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">metadata</span><span class="p p-Indicator">:</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">metadata</span><span class="p p-Indicator">:</span>
<span class="l l-Scalar l-Scalar-Plain">name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">foo</span> <span class="l l-Scalar l-Scalar-Plain">name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">foo</span>
<span class="l l-Scalar l-Scalar-Plain">annotations</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">annotations</span><span class="p p-Indicator">:</span>
@ -1128,10 +1107,31 @@ annotation, eg creating an Ingress with an annotation like</p>
<p>will target the nginx controller, forcing the GCE controller to ignore it.</p> <p>will target the nginx controller, forcing the GCE controller to ignore it.</p>
<p><strong>Note</strong>: Deploying multiple ingress controller and not specifying the annotation will result in both controllers fighting to satisfy the Ingress.</p> <p>To reiterate, setting the annotation to any value which does not match a valid ingress class will force the NGINX Ingress controller to ignore your Ingress.
<h2 id="disabling-nginx-ingress-controller">Disabling NGINX ingress controller<a class="headerlink" href="#disabling-nginx-ingress-controller" title="Permanent link">&para;</a></h2> If you are only running a single NGINX ingress controller, this can be achieved by setting the annotation to any value except "nginx" or an empty string.</p>
<p>Setting the annotation <code class="codehilite">kubernetes.io/ingress.class</code> to any other value which does not match a valid ingress class will force the NGINX Ingress controller to ignore your Ingress. If you are only running a single NGINX ingress controller, this can be achieved by setting this to any value except "nginx" or an empty string.</p>
<p>Do this if you wish to use one of the other Ingress controllers at the same time as the NGINX controller.</p> <p>Do this if you wish to use one of the other Ingress controllers at the same time as the NGINX controller.</p>
<div class="admonition important">
<p class="admonition-title">Important</p>
<p>Deploying multiple Ingress controllers and not specifying a class annotation will
result in both or all controllers fighting to satisfy the Ingress, and all of them
updating the Ingress status field in confusing ways.</p>
</div>
<h2 id="multiple-ingress-nginx-controllers">Multiple ingress-nginx controllers<a class="headerlink" href="#multiple-ingress-nginx-controllers" title="Permanent link">&para;</a></h2>
<p>This mechanism also provides users the ability to run <em>multiple</em> NGINX ingress controllers (e.g. one which serves public traffic, one which serves "internal" traffic).
To do this, the option <code class="codehilite">--ingress-class</code> must be changed to a value unique for the cluster within the definition of the replication controller.
Here is a partial example:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">spec</span><span class="p p-Indicator">:</span>
<span class="l l-Scalar l-Scalar-Plain">template</span><span class="p p-Indicator">:</span>
<span class="l l-Scalar l-Scalar-Plain">spec</span><span class="p p-Indicator">:</span>
<span class="l l-Scalar l-Scalar-Plain">containers</span><span class="p p-Indicator">:</span>
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">name</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">nginx-ingress-internal-controller</span>
<span class="l l-Scalar l-Scalar-Plain">args</span><span class="p p-Indicator">:</span>
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">/nginx-ingress-controller</span>
<span class="p p-Indicator">-</span> <span class="s">&#39;--default-backend-service=ingress/nginx-ingress-default-backend&#39;</span>
<span class="p p-Indicator">-</span> <span class="s">&#39;--election-id=ingress-controller-leader-internal&#39;</span>
<span class="p p-Indicator">-</span> <span class="s">&#39;--ingress-class=nginx-internal&#39;</span>
<span class="p p-Indicator">-</span> <span class="s">&#39;--configmap=ingress/nginx-ingress-internal-controller&#39;</span>
</pre></div>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -463,6 +475,19 @@
Session Affinity Session Affinity
</a> </a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#cookie-affinity" title="Cookie affinity" class="md-nav__link">
Cookie affinity
</a>
</li>
</ul>
</nav>
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
@ -612,8 +637,8 @@
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#redirect-from-to-www" title="Redirect from to www" class="md-nav__link"> <a href="#redirect-fromto-www" title="Redirect from/to www." class="md-nav__link">
Redirect from to www Redirect from/to www.
</a> </a>
</li> </li>
@ -623,13 +648,6 @@
Whitelist source range Whitelist source range
</a> </a>
</li>
<li class="md-nav__item">
<a href="#cookie-affinity" title="Cookie affinity" class="md-nav__link">
Cookie affinity
</a>
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
@ -783,6 +801,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -820,8 +850,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -844,8 +874,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -857,13 +887,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -928,8 +958,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -940,8 +970,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -1013,6 +1043,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -1103,8 +1145,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -1127,8 +1169,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -1167,18 +1209,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1295,6 +1325,19 @@
Session Affinity Session Affinity
</a> </a>
<nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#cookie-affinity" title="Cookie affinity" class="md-nav__link">
Cookie affinity
</a>
</li>
</ul>
</nav>
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
@ -1444,8 +1487,8 @@
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#redirect-from-to-www" title="Redirect from to www" class="md-nav__link"> <a href="#redirect-fromto-www" title="Redirect from/to www." class="md-nav__link">
Redirect from to www Redirect from/to www.
</a> </a>
</li> </li>
@ -1455,13 +1498,6 @@
Whitelist source range Whitelist source range
</a> </a>
</li>
<li class="md-nav__item">
<a href="#cookie-affinity" title="Cookie affinity" class="md-nav__link">
Cookie affinity
</a>
</li> </li>
<li class="md-nav__item"> <li class="md-nav__item">
@ -1561,6 +1597,13 @@
Other types, such as boolean or numeric values must be quoted, Other types, such as boolean or numeric values must be quoted,
i.e. <code class="codehilite">&quot;true&quot;</code>, <code class="codehilite">&quot;false&quot;</code>, <code class="codehilite">&quot;100&quot;</code>.</p> i.e. <code class="codehilite">&quot;true&quot;</code>, <code class="codehilite">&quot;false&quot;</code>, <code class="codehilite">&quot;100&quot;</code>.</p>
</div> </div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The annotation prefix can be changed using the
<a href="../../cli-arguments/"><code class="codehilite">--annotations-prefix</code> command line argument</a>,
but the default is <code class="codehilite">nginx.ingress.kubernetes.io</code>, as described in the
table below.</p>
</div>
<table> <table>
<thead> <thead>
<tr> <tr>
@ -1825,11 +1868,28 @@ Set the annotation <code class="codehilite">nginx.ingress.kubernetes.io/rewrite-
<p>If the application contains relative links it is possible to add an additional annotation <code class="codehilite">nginx.ingress.kubernetes.io/add-base-url</code> that will prepend a <a href="https://developer.mozilla.org/en/docs/Web/HTML/Element/base"><code class="codehilite">base</code> tag</a> in the header of the returned HTML from the backend.</p> <p>If the application contains relative links it is possible to add an additional annotation <code class="codehilite">nginx.ingress.kubernetes.io/add-base-url</code> that will prepend a <a href="https://developer.mozilla.org/en/docs/Web/HTML/Element/base"><code class="codehilite">base</code> tag</a> in the header of the returned HTML from the backend.</p>
<p>If the scheme of <a href="https://developer.mozilla.org/en/docs/Web/HTML/Element/base"><code class="codehilite">base</code> tag</a> need to be specific, set the annotation <code class="codehilite">nginx.ingress.kubernetes.io/base-url-scheme</code> to the scheme such as <code class="codehilite">http</code> and <code class="codehilite">https</code>.</p> <p>If the scheme of <a href="https://developer.mozilla.org/en/docs/Web/HTML/Element/base"><code class="codehilite">base</code> tag</a> need to be specific, set the annotation <code class="codehilite">nginx.ingress.kubernetes.io/base-url-scheme</code> to the scheme such as <code class="codehilite">http</code> and <code class="codehilite">https</code>.</p>
<p>If the Application Root is exposed in a different path and needs to be redirected, set the annotation <code class="codehilite">nginx.ingress.kubernetes.io/app-root</code> to redirect requests for <code class="codehilite">/</code>.</p> <p>If the Application Root is exposed in a different path and needs to be redirected, set the annotation <code class="codehilite">nginx.ingress.kubernetes.io/app-root</code> to redirect requests for <code class="codehilite">/</code>.</p>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Please check the <a href="../../../examples/rewrite/README/">rewrite</a> example.</p> <p>Please check the <a href="../../../examples/rewrite/README/">rewrite</a> example.</p>
</div>
<h3 id="session-affinity">Session Affinity<a class="headerlink" href="#session-affinity" title="Permanent link">&para;</a></h3> <h3 id="session-affinity">Session Affinity<a class="headerlink" href="#session-affinity" title="Permanent link">&para;</a></h3>
<p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/affinity</code> enables and sets the affinity type in all Upstreams of an Ingress. This way, a request will always be directed to the same upstream server. <p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/affinity</code> enables and sets the affinity type in all Upstreams of an Ingress. This way, a request will always be directed to the same upstream server.
The only affinity type available for NGINX is <code class="codehilite">cookie</code>.</p> The only affinity type available for NGINX is <code class="codehilite">cookie</code>.</p>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Please check the <a href="../../../examples/affinity/cookie/README/">affinity</a> example.</p> <p>Please check the <a href="../../../examples/affinity/cookie/README/">affinity</a> example.</p>
</div>
<h4 id="cookie-affinity">Cookie affinity<a class="headerlink" href="#cookie-affinity" title="Permanent link">&para;</a></h4>
<p>If you use the <code class="codehilite">cookie</code> affinity type you can also specify the name of the cookie that will be used to route the requests with the annotation <code class="codehilite">nginx.ingress.kubernetes.io/session-cookie-name</code>. The default is to create a cookie named 'INGRESSCOOKIE'.</p>
<p>In case of NGINX the annotation <code class="codehilite">nginx.ingress.kubernetes.io/session-cookie-hash</code> defines which algorithm will be used to hash the used upstream. Default value is <code class="codehilite">md5</code> and possible values are <code class="codehilite">md5</code>, <code class="codehilite">sha1</code> and <code class="codehilite">index</code>.</p>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>The <code class="codehilite">index</code> option is not an actual hash; an in-memory index is used instead, which has less overhead.
However, with <code class="codehilite">index</code>, matching against a changing upstream server list is inconsistent.
So, at reload, if upstream servers have changed, index values are not guaranteed to correspond to the same server as before!
<strong>Use <code class="codehilite">index</code> with caution</strong> and only if you need to!</p>
</div>
<p>In NGINX this feature is implemented by the third party module <a href="https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng">nginx-sticky-module-ng</a>. The workflow used to define which upstream server will be used is explained <a href="https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/raw/08a395c66e425540982c00482f55034e1fee67b6/docs/sticky.pdf">here</a></p>
<h3 id="authentication">Authentication<a class="headerlink" href="#authentication" title="Permanent link">&para;</a></h3> <h3 id="authentication">Authentication<a class="headerlink" href="#authentication" title="Permanent link">&para;</a></h3>
<p>Is possible to add authentication adding additional annotations in the Ingress rule. The source of the authentication is a secret that contains usernames and passwords inside the key <code class="codehilite">auth</code>.</p> <p>Is possible to add authentication adding additional annotations in the Ingress rule. The source of the authentication is a secret that contains usernames and passwords inside the key <code class="codehilite">auth</code>.</p>
<p>The annotations are:</p> <p>The annotations are:</p>
@ -1848,7 +1908,10 @@ This annotation also accepts the alternative form "namespace/secretName", in whi
</pre></div> </pre></div>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Please check the <a href="../../../examples/auth/basic/README/">auth</a> example.</p> <p>Please check the <a href="../../../examples/auth/basic/README/">auth</a> example.</p>
</div>
<h3 id="custom-nginx-upstream-checks">Custom NGINX upstream checks<a class="headerlink" href="#custom-nginx-upstream-checks" title="Permanent link">&para;</a></h3> <h3 id="custom-nginx-upstream-checks">Custom NGINX upstream checks<a class="headerlink" href="#custom-nginx-upstream-checks" title="Permanent link">&para;</a></h3>
<p>NGINX exposes some flags in the <a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream">upstream configuration</a> that enable the configuration of each server in the upstream. The Ingress controller allows custom <code class="codehilite">max_fails</code> and <code class="codehilite">fail_timeout</code> parameters in a global context using <code class="codehilite">upstream-max-fails</code> and <code class="codehilite">upstream-fail-timeout</code> in the NGINX ConfigMap or in a particular Ingress rule. <code class="codehilite">upstream-max-fails</code> defaults to 0. This means NGINX will respect the container's <code class="codehilite">readinessProbe</code> if it is defined. If there is no probe and no values for <code class="codehilite">upstream-max-fails</code> NGINX will continue to send traffic to the container.</p> <p>NGINX exposes some flags in the <a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#upstream">upstream configuration</a> that enable the configuration of each server in the upstream. The Ingress controller allows custom <code class="codehilite">max_fails</code> and <code class="codehilite">fail_timeout</code> parameters in a global context using <code class="codehilite">upstream-max-fails</code> and <code class="codehilite">upstream-fail-timeout</code> in the NGINX ConfigMap or in a particular Ingress rule. <code class="codehilite">upstream-max-fails</code> defaults to 0. This means NGINX will respect the container's <code class="codehilite">readinessProbe</code> if it is defined. If there is no probe and no values for <code class="codehilite">upstream-max-fails</code> NGINX will continue to send traffic to the container.</p>
<div class="admonition tip"> <div class="admonition tip">
@ -1859,11 +1922,15 @@ This annotation also accepts the alternative form "namespace/secretName", in whi
<p><code class="codehilite">nginx.ingress.kubernetes.io/upstream-max-fails</code>: number of unsuccessful attempts to communicate with the server that should occur in the duration set by the <code class="codehilite">upstream-fail-timeout</code> parameter to consider the server unavailable.</p> <p><code class="codehilite">nginx.ingress.kubernetes.io/upstream-max-fails</code>: number of unsuccessful attempts to communicate with the server that should occur in the duration set by the <code class="codehilite">upstream-fail-timeout</code> parameter to consider the server unavailable.</p>
<p><code class="codehilite">nginx.ingress.kubernetes.io/upstream-fail-timeout</code>: time in seconds during which the specified number of unsuccessful attempts to communicate with the server should occur to consider the server unavailable. This is also the period of time the server will be considered unavailable.</p> <p><code class="codehilite">nginx.ingress.kubernetes.io/upstream-fail-timeout</code>: time in seconds during which the specified number of unsuccessful attempts to communicate with the server should occur to consider the server unavailable. This is also the period of time the server will be considered unavailable.</p>
<p>In NGINX, backend server pools are called "<a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html">upstreams</a>". Each upstream contains the endpoints for a service. An upstream is created for each service that has Ingress rules defined.</p> <p>In NGINX, backend server pools are called "<a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html">upstreams</a>". Each upstream contains the endpoints for a service. An upstream is created for each service that has Ingress rules defined.</p>
<div class="admonition important"> <div class="admonition attention">
<p class="admonition-title">Important</p> <p class="admonition-title">Attention</p>
<p>All Ingress rules using the same service will use the same upstream. Only one of the Ingress rules should define annotations to configure the upstream servers.</p> <p>All Ingress rules using the same service will use the same upstream.<br />
Only one of the Ingress rules should define annotations to configure the upstream servers.</p>
</div> </div>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Please check the <a href="../../../examples/customization/custom-upstream-check/README/">custom upstream check</a> example.</p> <p>Please check the <a href="../../../examples/customization/custom-upstream-check/README/">custom upstream check</a> example.</p>
</div>
<h3 id="custom-nginx-upstream-hashing">Custom NGINX upstream hashing<a class="headerlink" href="#custom-nginx-upstream-hashing" title="Permanent link">&para;</a></h3> <h3 id="custom-nginx-upstream-hashing">Custom NGINX upstream hashing<a class="headerlink" href="#custom-nginx-upstream-hashing" title="Permanent link">&para;</a></h3>
<p>NGINX supports load balancing by client-server mapping based on <a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#hash">consistent hashing</a> for a given key. The key can contain text, variables or any combination thereof. This feature allows for request stickiness other than client IP or cookies. The <a href="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</a> consistent hashing method will be used which ensures only a few keys would be remapped to different servers on upstream group changes.</p> <p>NGINX supports load balancing by client-server mapping based on <a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#hash">consistent hashing</a> for a given key. The key can contain text, variables or any combination thereof. This feature allows for request stickiness other than client IP or cookies. The <a href="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</a> consistent hashing method will be used which ensures only a few keys would be remapped to different servers on upstream group changes.</p>
<p>To enable consistent hashing for a backend:</p> <p>To enable consistent hashing for a backend:</p>
@ -1878,37 +1945,26 @@ This annotation also accepts the alternative form "namespace/secretName", in whi
<h3 id="client-certificate-authentication">Client Certificate Authentication<a class="headerlink" href="#client-certificate-authentication" title="Permanent link">&para;</a></h3> <h3 id="client-certificate-authentication">Client Certificate Authentication<a class="headerlink" href="#client-certificate-authentication" title="Permanent link">&para;</a></h3>
<p>It is possible to enable Client Certificate Authentication using additional annotations in Ingress Rule.</p> <p>It is possible to enable Client Certificate Authentication using additional annotations in Ingress Rule.</p>
<p>The annotations are:</p> <p>The annotations are:</p>
<div class="codehilite"><pre><span></span>nginx.ingress.kubernetes.io/auth-tls-secret: secretName <ul>
</pre></div> <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-tls-secret: secretName</code>:
The name of the Secret that contains the full Certificate Authority chain <code class="codehilite">ca.crt</code> that is enabled to authenticate against this Ingress.
This annotation also accepts the alternative form "namespace/secretName", in which case the Secret lookup is performed in the referenced namespace instead of the Ingress namespace.</li>
<p>The name of the Secret that contains the full Certificate Authority chain <code class="codehilite">ca.crt</code> that is enabled to authenticate against this Ingress. <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-tls-verify-depth</code>:
This annotation also accepts the alternative form "namespace/secretName", in which case the Secret lookup is performed in the referenced namespace instead of the Ingress namespace.</p> The validation depth between the provided client certificate and the Certification Authority chain.</li>
<div class="codehilite"><pre><span></span>nginx.ingress.kubernetes.io/auth-tls-verify-depth <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-tls-verify-client</code>:
</pre></div> Enables verification of client certificates.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/auth-tls-error-page</code>:
The URL/Page that user should be redirected in case of a Certificate Authentication Error</li>
<p>The validation depth between the provided client certificate and the Certification Authority chain.</p> <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream</code>:
<div class="codehilite"><pre><span></span>nginx.ingress.kubernetes.io/auth-tls-verify-client Indicates if the received certificates should be passed or not to the upstream server. By default this is disabled.</li>
</pre></div> </ul>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Enables verification of client certificates.</p>
<div class="codehilite"><pre><span></span>nginx.ingress.kubernetes.io/auth-tls-error-page
</pre></div>
<p>The URL/Page that user should be redirected in case of a Certificate Authentication Error</p>
<div class="codehilite"><pre><span></span>nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream
</pre></div>
<p>Indicates if the received certificates should be passed or not to the upstream server.
By default this is disabled.</p>
<p>Please check the <a href="../../../examples/auth/client-certs/README/">client-certs</a> example.</p> <p>Please check the <a href="../../../examples/auth/client-certs/README/">client-certs</a> example.</p>
<div class="admonition important"> </div>
<p class="admonition-title">Important</p> <div class="admonition attention">
<p>TLS with Client Authentication is NOT possible in Cloudflare as is not allowed it and might result in unexpected behavior.</p> <p class="admonition-title">Attention</p>
<p>TLS with Client Authentication is <strong>not</strong> possible in Cloudflare and might result in unexpected behavior.</p>
<p>Cloudflare only allows Authenticated Origin Pulls and is required to use their own certificate: <a href="https://blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/">https://blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/</a></p> <p>Cloudflare only allows Authenticated Origin Pulls and is required to use their own certificate: <a href="https://blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/">https://blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/</a></p>
<p>Only Authenticated Origin Pulls are allowed and can be configured by following their tutorial: <a href="https://support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin-Pulls">https://support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin-Pulls</a></p> <p>Only Authenticated Origin Pulls are allowed and can be configured by following their tutorial: <a href="https://support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin-Pulls">https://support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin-Pulls</a></p>
</div> </div>
@ -1920,40 +1976,58 @@ By default this is disabled.</p>
<h3 id="default-backend">Default Backend<a class="headerlink" href="#default-backend" title="Permanent link">&para;</a></h3> <h3 id="default-backend">Default Backend<a class="headerlink" href="#default-backend" title="Permanent link">&para;</a></h3>
<p>The ingress controller requires a default backend. This service handles the response when the service in the Ingress rule does not have endpoints. <p>The ingress controller requires a <a href="../../default-backend/">default backend</a>.
This service handles the response when the service in the Ingress rule does not have endpoints.
This is a global configuration for the ingress controller. In some cases could be required to return a custom content or format. In this scenario we can use the annotation <code class="codehilite">nginx.ingress.kubernetes.io/default-backend: &lt;svc name&gt;</code> to specify a custom default backend.</p> This is a global configuration for the ingress controller. In some cases could be required to return a custom content or format. In this scenario we can use the annotation <code class="codehilite">nginx.ingress.kubernetes.io/default-backend: &lt;svc name&gt;</code> to specify a custom default backend.</p>
<h3 id="enable-cors">Enable CORS<a class="headerlink" href="#enable-cors" title="Permanent link">&para;</a></h3> <h3 id="enable-cors">Enable CORS<a class="headerlink" href="#enable-cors" title="Permanent link">&para;</a></h3>
<p>To enable Cross-Origin Resource Sharing (CORS) in an Ingress rule add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/enable-cors: &quot;true&quot;</code>. This will add a section in the server location enabling this functionality.</p> <p>To enable Cross-Origin Resource Sharing (CORS) in an Ingress rule,
add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/enable-cors: &quot;true&quot;</code>.
This will add a section in the server location enabling this functionality.</p>
<p>CORS can be controlled with the following annotations:</p> <p>CORS can be controlled with the following annotations:</p>
<ul> <ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-methods</code> controls which methods are accepted. This is a multi-valued field, separated by ',' and accepts only letters (upper and lower case).</li> <li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-methods</code>
controls which methods are accepted.
This is a multi-valued field, separated by ',' and accepts only letters (upper and lower case).
Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-methods: &quot;PUT, GET, POST, OPTIONS&quot;</code></p>
</li>
<li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-headers</code>
controls which headers are accepted.
This is a multi-valued field, separated by ',' and accepts letters, numbers, _ and -.
Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-headers: &quot;X-Forwarded-For, X-app123-XPTO&quot;</code></p>
</li>
<li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-origin</code>
controls what's the accepted Origin for CORS and defaults to '*'.
This is a single field value, with the following format: <code class="codehilite">http(s)://origin-site.com</code> or <code class="codehilite">http(s)://origin-site.com:port</code>
Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-origin: &quot;https://origin-site.com:4443&quot;</code></p>
</li>
<li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-credentials</code>
controls if credentials can be passed during CORS operations.
Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-credentials: &quot;true&quot;</code></p>
</li>
<li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/cors-max-age</code>
controls how long preflight requests can be cached.
Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-max-age: 600</code></p>
</li>
</ul> </ul>
<p>Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-methods: &quot;PUT, GET, POST, OPTIONS&quot;</code></p>
<ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-headers</code> controls which headers are accepted. This is a multi-valued field, separated by ',' and accepts letters, numbers, _ and -.</li>
</ul>
<p>Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-headers: &quot;X-Forwarded-For, X-app123-XPTO&quot;</code></p>
<ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-origin</code> controls what's the accepted Origin for CORS and defaults to '*'. This is a single field value, with the following format: http(s)://origin-site.com or http(s)://origin-site.com:port</li>
</ul>
<p>Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-origin: &quot;https://origin-site.com:4443&quot;</code></p>
<ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-credentials</code> controls if credentials can be passed during CORS operations.</li>
</ul>
<p>Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-allow-credentials: &quot;true&quot;</code></p>
<ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/cors-max-age</code> controls how long preflight requests can be cached.</li>
</ul>
<p>Example: <code class="codehilite">nginx.ingress.kubernetes.io/cors-max-age: 600</code></p>
<p>For more information please see <a href="https://enable-cors.org/server_nginx.html">https://enable-cors.org</a></p>
<h3 id="server-alias">Server Alias<a class="headerlink" href="#server-alias" title="Permanent link">&para;</a></h3>
<p>To add Server Aliases to an Ingress rule add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/server-alias: &quot;&lt;alias&gt;&quot;</code>.
This will create a server with the same configuration, but a different server_name as the provided host.</p>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
<p>A server-alias name cannot conflict with the hostname of an existing server. If it does the server-alias annotation will be ignored. If a server-alias is created and later a new server with the same hostname is created the new server configuration will take place over the alias configuration.</p> <p>For more information please see <a href="https://enable-cors.org/server_nginx.html">https://enable-cors.org</a></p>
</div> </div>
<p>For more information please see <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#server_name">http://nginx.org</a></p> <h3 id="server-alias">Server Alias<a class="headerlink" href="#server-alias" title="Permanent link">&para;</a></h3>
<p>To add Server Aliases to an Ingress rule add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/server-alias: &quot;&lt;alias&gt;&quot;</code>.
This will create a server with the same configuration, but a different <code class="codehilite">server_name</code> as the provided host.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>A server-alias name cannot conflict with the hostname of an existing server. If it does the server-alias annotation will be ignored.
If a server-alias is created and later a new server with the same hostname is created,
the new server configuration will take place over the alias configuration.</p>
</div>
<p>For more information please see <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#server_name">the <code class="codehilite">server_name</code> documentation</a>.</p>
<h3 id="server-snippet">Server snippet<a class="headerlink" href="#server-snippet" title="Permanent link">&para;</a></h3> <h3 id="server-snippet">Server snippet<a class="headerlink" href="#server-snippet" title="Permanent link">&para;</a></h3>
<p>Using the annotation <code class="codehilite">nginx.ingress.kubernetes.io/server-snippet</code> it is possible to add custom configuration in the server configuration block.</p> <p>Using the annotation <code class="codehilite">nginx.ingress.kubernetes.io/server-snippet</code> it is possible to add custom configuration in the server configuration block.</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">apiVersion</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">extensions/v1beta1</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">apiVersion</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">extensions/v1beta1</span>
@ -1973,17 +2047,21 @@ This will create a server with the same configuration, but a different server_na
</pre></div> </pre></div>
<div class="admonition important"> <div class="admonition attention">
<p class="admonition-title">Important</p> <p class="admonition-title">Attention</p>
<p>This annotation can be used only once per host</p> <p>This annotation can be used only once per host.</p>
</div> </div>
<h3 id="client-body-buffer-size">Client Body Buffer Size<a class="headerlink" href="#client-body-buffer-size" title="Permanent link">&para;</a></h3> <h3 id="client-body-buffer-size">Client Body Buffer Size<a class="headerlink" href="#client-body-buffer-size" title="Permanent link">&para;</a></h3>
<p>Sets buffer size for reading client request body per location. In case the request body is larger than the buffer, <p>Sets buffer size for reading client request body per location. In case the request body is larger than the buffer,
the whole body or only its part is written to a temporary file. By default, buffer size is equal to two memory pages. the whole body or only its part is written to a temporary file. By default, buffer size is equal to two memory pages.
This is 8K on x86, other 32-bit platforms, and x86-64. It is usually 16K on other 64-bit platforms. This annotation is This is 8K on x86, other 32-bit platforms, and x86-64. It is usually 16K on other 64-bit platforms. This annotation is
applied to each location provided in the ingress rule.</p> applied to each location provided in the ingress rule.</p>
<p><strong>Note:</strong> The annotation value must be given in a valid format otherwise the <div class="admonition note">
For example to set the client-body-buffer-size the following can be done:</p> <p class="admonition-title">Note</p>
<p>The annotation value must be given in a format understood by Nginx.</p>
</div>
<div class="admonition example">
<p class="admonition-title">Example</p>
<ul> <ul>
<li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: &quot;1000&quot;</code> # 1000 bytes</li> <li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: &quot;1000&quot;</code> # 1000 bytes</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1k</code> # 1 kilobyte</li> <li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1k</code> # 1 kilobyte</li>
@ -1991,6 +2069,7 @@ For example to set the client-body-buffer-size the following can be done:</p>
<li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1m</code> # 1 megabyte</li> <li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1m</code> # 1 megabyte</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1M</code> # 1 megabyte</li> <li><code class="codehilite">nginx.ingress.kubernetes.io/client-body-buffer-size: 1M</code> # 1 megabyte</li>
</ul> </ul>
</div>
<p>For more information please see <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#client_body_buffer_size">http://nginx.org</a></p> <p>For more information please see <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#client_body_buffer_size">http://nginx.org</a></p>
<h3 id="external-authentication">External Authentication<a class="headerlink" href="#external-authentication" title="Permanent link">&para;</a></h3> <h3 id="external-authentication">External Authentication<a class="headerlink" href="#external-authentication" title="Permanent link">&para;</a></h3>
<p>To use an existing service that provides authentication the Ingress rule can be annotated with <code class="codehilite">nginx.ingress.kubernetes.io/auth-url</code> to indicate the URL where the HTTP request should be sent.</p> <p>To use an existing service that provides authentication the Ingress rule can be annotated with <code class="codehilite">nginx.ingress.kubernetes.io/auth-url</code> to indicate the URL where the HTTP request should be sent.</p>
@ -1999,45 +2078,63 @@ For example to set the client-body-buffer-size the following can be done:</p>
<p>Additionally it is possible to set:</p> <p>Additionally it is possible to set:</p>
<p><code class="codehilite">nginx.ingress.kubernetes.io/auth-method</code>: <code class="codehilite">&lt;Method&gt;</code> to specify the HTTP method to use.</p> <ul>
<p><code class="codehilite">nginx.ingress.kubernetes.io/auth-signin</code>: <code class="codehilite">&lt;SignIn_URL&gt;</code> to specify the location of the error page.</p> <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-method</code>:
<p><code class="codehilite">nginx.ingress.kubernetes.io/auth-response-headers</code>: <code class="codehilite">&lt;Response_Header_1, ..., Response_Header_n&gt;</code> to specify headers to pass to backend once authorization request completes.</p> <code class="codehilite">&lt;Method&gt;</code> to specify the HTTP method to use.</li>
<p><code class="codehilite">nginx.ingress.kubernetes.io/auth-request-redirect</code>: <code class="codehilite">&lt;Request_Redirect_URL&gt;</code> to specify the X-Auth-Request-Redirect header value.</p> <li><code class="codehilite">nginx.ingress.kubernetes.io/auth-signin</code>:
<code class="codehilite">&lt;SignIn_URL&gt;</code> to specify the location of the error page.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/auth-response-headers</code>:
<code class="codehilite">&lt;Response_Header_1, ..., Response_Header_n&gt;</code> to specify headers to pass to backend once authorization request completes.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/auth-request-redirect</code>:
<code class="codehilite">&lt;Request_Redirect_URL&gt;</code> to specify the X-Auth-Request-Redirect header value.</li>
</ul>
<div class="admonition example">
<p class="admonition-title">Example</p>
<p>Please check the <a href="../../../examples/auth/external-auth/README/">external-auth</a> example.</p> <p>Please check the <a href="../../../examples/auth/external-auth/README/">external-auth</a> example.</p>
</div>
<h3 id="rate-limiting">Rate limiting<a class="headerlink" href="#rate-limiting" title="Permanent link">&para;</a></h3> <h3 id="rate-limiting">Rate limiting<a class="headerlink" href="#rate-limiting" title="Permanent link">&para;</a></h3>
<p>The annotations <code class="codehilite">nginx.ingress.kubernetes.io/limit-connections</code>, <code class="codehilite">nginx.ingress.kubernetes.io/limit-rps</code>, and <code class="codehilite">nginx.ingress.kubernetes.io/limit-rpm</code> define a limit on the connections that can be opened by a single client IP address. This can be used to mitigate <a href="https://www.nginx.com/blog/mitigating-ddos-attacks-with-nginx-and-nginx-plus">DDoS Attacks</a>.</p> <p>These annotations define a limit on the connections that can be opened by a single client IP address.
<p><code class="codehilite">nginx.ingress.kubernetes.io/limit-connections</code>: number of concurrent connections allowed from a single IP address.</p> This can be used to mitigate <a href="https://www.nginx.com/blog/mitigating-ddos-attacks-with-nginx-and-nginx-plus">DDoS Attacks</a>.</p>
<p><code class="codehilite">nginx.ingress.kubernetes.io/limit-rps</code>: number of connections that may be accepted from a given IP each second.</p> <ul>
<p><code class="codehilite">nginx.ingress.kubernetes.io/limit-rpm</code>: number of connections that may be accepted from a given IP each minute.</p> <li><code class="codehilite">nginx.ingress.kubernetes.io/limit-connections</code>: number of concurrent connections allowed from a single IP address.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/limit-rps</code>: number of connections that may be accepted from a given IP each second.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/limit-rpm</code>: number of connections that may be accepted from a given IP each minute.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/limit-rate-after</code>: sets the initial amount after which the further transmission of a response to a client will be rate limited.</li>
<li><code class="codehilite">nginx.ingress.kubernetes.io/limit-rate</code>: rate of request that accepted from a client each second.</li>
</ul>
<p>You can specify the client IP source ranges to be excluded from rate-limiting through the <code class="codehilite">nginx.ingress.kubernetes.io/limit-whitelist</code> annotation. The value is a comma separated list of CIDRs.</p> <p>You can specify the client IP source ranges to be excluded from rate-limiting through the <code class="codehilite">nginx.ingress.kubernetes.io/limit-whitelist</code> annotation. The value is a comma separated list of CIDRs.</p>
<p>If you specify multiple annotations in a single Ingress rule, <code class="codehilite">limit-rpm</code>, and then <code class="codehilite">limit-rps</code> takes precedence.</p> <p>If you specify multiple annotations in a single Ingress rule, <code class="codehilite">limit-rpm</code>, and then <code class="codehilite">limit-rps</code> takes precedence.</p>
<p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/limit-rate</code>, <code class="codehilite">nginx.ingress.kubernetes.io/limit-rate-after</code> define a limit the rate of response transmission to a client. The rate is specified in bytes per second. The zero value disables rate limiting. The limit is set per a request, and so if a client simultaneously opens two connections, the overall rate will be twice as much as the specified limit.</p> <p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/limit-rate</code>, <code class="codehilite">nginx.ingress.kubernetes.io/limit-rate-after</code> define a limit the rate of response transmission to a client. The rate is specified in bytes per second. The zero value disables rate limiting. The limit is set per a request, and so if a client simultaneously opens two connections, the overall rate will be twice as much as the specified limit.</p>
<p><code class="codehilite">nginx.ingress.kubernetes.io/limit-rate-after</code>: sets the initial amount after which the further transmission of a response to a client will be rate limited.</p> <p>To configure this setting globally for all Ingress rules, the <code class="codehilite">limit-rate-after</code> and <code class="codehilite">limit-rate</code> value may be set in the <a href="../configmap/">NGINX ConfigMap</a>. if you set the value in ingress annotation will cover global setting.</p>
<p><code class="codehilite">nginx.ingress.kubernetes.io/limit-rate</code>: rate of request that accepted from a client each second.</p>
<p>To configure this setting globally for all Ingress rules, the <code class="codehilite">limit-rate-after</code> and <code class="codehilite">limit-rate</code> value may be set in the NGINX ConfigMap. if you set the value in ingress annotation will cover global setting.</p>
<h3 id="permanent-redirect">Permanent Redirect<a class="headerlink" href="#permanent-redirect" title="Permanent link">&para;</a></h3> <h3 id="permanent-redirect">Permanent Redirect<a class="headerlink" href="#permanent-redirect" title="Permanent link">&para;</a></h3>
<p>This annotation allows to return a permanent redirect instead of sending data to the upstream. For example <code class="codehilite">nginx.ingress.kubernetes.io/permanent-redirect: https://www.google.com</code> would redirect everything to Google.</p> <p>This annotation allows to return a permanent redirect instead of sending data to the upstream. For example <code class="codehilite">nginx.ingress.kubernetes.io/permanent-redirect: https://www.google.com</code> would redirect everything to Google.</p>
<h3 id="ssl-passthrough">SSL Passthrough<a class="headerlink" href="#ssl-passthrough" title="Permanent link">&para;</a></h3> <h3 id="ssl-passthrough">SSL Passthrough<a class="headerlink" href="#ssl-passthrough" title="Permanent link">&para;</a></h3>
<p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/ssl-passthrough</code> allows to configure TLS termination in the pod and not in NGINX.</p> <p>The annotation <code class="codehilite">nginx.ingress.kubernetes.io/ssl-passthrough</code> allows to configure TLS termination in the pod and not in NGINX.</p>
<div class="admonition important"> <div class="admonition attention">
<p class="admonition-title">Important</p> <p class="admonition-title">Attention</p>
<ul> <p>Using the annotation <code class="codehilite">nginx.ingress.kubernetes.io/ssl-passthrough</code> invalidates all the other available annotations.
<li> This is because SSL Passthrough works on level 4 of the OSI stack (TCP), not on the HTTP/HTTPS level.</p>
<p>Using the annotation <code class="codehilite">nginx.ingress.kubernetes.io/ssl-passthrough</code> invalidates all the other available annotations. This is because SSL Passthrough works in L4 (TCP).</p> </div>
</li> <div class="admonition attention">
<li> <p class="admonition-title">Attention</p>
<p>The use of this annotation requires Proxy Protocol to be enabled in the load-balancer. For example enabling Proxy Protocol for AWS ELB is described <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-proxy-protocol.html">here</a>. If you're using ingress-controller without load balancer then the flag <code class="codehilite">--enable-ssl-passthrough</code> is required (by default it is disabled).</p> <p>The use of this annotation requires the Proxy Protocol to be enabled in the front-end load-balancer.
</li> For example enabling Proxy Protocol for AWS ELB is described <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-proxy-protocol.html">here</a>.
</ul> If you're using ingress-controller without load balancer then the flag
<code class="codehilite">--enable-ssl-passthrough</code> is required (by default it is disabled).</p>
</div> </div>
<h3 id="secure-backends">Secure backends<a class="headerlink" href="#secure-backends" title="Permanent link">&para;</a></h3> <h3 id="secure-backends">Secure backends<a class="headerlink" href="#secure-backends" title="Permanent link">&para;</a></h3>
<p>By default NGINX uses <code class="codehilite">http</code> to reach the services. Adding the annotation <code class="codehilite">nginx.ingress.kubernetes.io/secure-backends: &quot;true&quot;</code> in the Ingress rule changes the protocol to <code class="codehilite">https</code>. <p>By default NGINX uses plain HTTP to reach the services.
Adding the annotation <code class="codehilite">nginx.ingress.kubernetes.io/secure-backends: &quot;true&quot;</code> in the Ingress rule changes the protocol to HTTPS.
If you want to validate the upstream against a specific certificate, you can create a secret with it and reference the secret with the annotation <code class="codehilite">nginx.ingress.kubernetes.io/secure-verify-ca-secret</code>.</p> If you want to validate the upstream against a specific certificate, you can create a secret with it and reference the secret with the annotation <code class="codehilite">nginx.ingress.kubernetes.io/secure-verify-ca-secret</code>.</p>
<blockquote> <div class="admonition attention">
<p>Note that if an invalid or non-existent secret is given, the NGINX ingress controller will ignore the <code class="codehilite">secure-backends</code> annotation.</p> <p class="admonition-title">Attention</p>
</blockquote> <p>Note that if an invalid or non-existent secret is given,
the ingress controller will ignore the <code class="codehilite">secure-backends</code> annotation.</p>
</div>
<h3 id="service-upstream">Service Upstream<a class="headerlink" href="#service-upstream" title="Permanent link">&para;</a></h3> <h3 id="service-upstream">Service Upstream<a class="headerlink" href="#service-upstream" title="Permanent link">&para;</a></h3>
<p>By default the NGINX ingress controller uses a list of all endpoints (Pod IP/port) in the NGINX upstream configuration. This annotation disables that behavior and instead uses a single upstream in NGINX, the service's Cluster IP and port. This can be desirable for things like zero-downtime deployments as it reduces the need to reload NGINX configuration when Pods come up and down. See issue <a href="https://github.com/kubernetes/ingress-nginx/issues/257">#257</a>.</p> <p>By default the NGINX ingress controller uses a list of all endpoints (Pod IP/port) in the NGINX upstream configuration.</p>
<p>The <code class="codehilite">nginx.ingress.kubernetes.io/service-upstream</code> annotation disables that behavior and instead uses a single upstream in NGINX, the service's Cluster IP and port.</p>
<p>This can be desirable for things like zero-downtime deployments as it reduces the need to reload NGINX configuration when Pods come up and down. See issue <a href="https://github.com/kubernetes/ingress-nginx/issues/257">#257</a>.</p>
<h4 id="known-issues">Known Issues<a class="headerlink" href="#known-issues" title="Permanent link">&para;</a></h4> <h4 id="known-issues">Known Issues<a class="headerlink" href="#known-issues" title="Permanent link">&para;</a></h4>
<p>If the <code class="codehilite">service-upstream</code> annotation is specified the following things should be taken into consideration:</p> <p>If the <code class="codehilite">service-upstream</code> annotation is specified the following things should be taken into consideration:</p>
<ul> <ul>
@ -2045,25 +2142,28 @@ If you want to validate the upstream against a specific certificate, you can cre
<li>The <code class="codehilite">proxy_next_upstream</code> directive will not have any effect meaning on error the request will not be dispatched to another upstream.</li> <li>The <code class="codehilite">proxy_next_upstream</code> directive will not have any effect meaning on error the request will not be dispatched to another upstream.</li>
</ul> </ul>
<h3 id="server-side-https-enforcement-through-redirect">Server-side HTTPS enforcement through redirect<a class="headerlink" href="#server-side-https-enforcement-through-redirect" title="Permanent link">&para;</a></h3> <h3 id="server-side-https-enforcement-through-redirect">Server-side HTTPS enforcement through redirect<a class="headerlink" href="#server-side-https-enforcement-through-redirect" title="Permanent link">&para;</a></h3>
<p>By default the controller redirects (301) to <code class="codehilite">HTTPS</code> if TLS is enabled for that ingress. If you want to disable that behavior globally, you can use <code class="codehilite">ssl-redirect: &quot;false&quot;</code> in the NGINX config map.</p> <p>By default the controller redirects (308) to HTTPS if TLS is enabled for that ingress.
<p>To configure this feature for specific ingress resources, you can use the <code class="codehilite">nginx.ingress.kubernetes.io/ssl-redirect: &quot;false&quot;</code> annotation in the particular resource.</p> If you want to disable this behavior globally, you can use <code class="codehilite">ssl-redirect: &quot;false&quot;</code> in the NGINX <a href="../configmap/">config map</a>.</p>
<p>When using SSL offloading outside of cluster (e.g. AWS ELB) it may be useful to enforce a redirect to <code class="codehilite">HTTPS</code> even when there is not TLS cert available. This can be achieved by using the <code class="codehilite">nginx.ingress.kubernetes.io/force-ssl-redirect: &quot;true&quot;</code> annotation in the particular resource.</p> <p>To configure this feature for specific ingress resources, you can use the <code class="codehilite">nginx.ingress.kubernetes.io/ssl-redirect: &quot;false&quot;</code>
<h3 id="redirect-from-to-www">Redirect from to www<a class="headerlink" href="#redirect-from-to-www" title="Permanent link">&para;</a></h3> annotation in the particular resource.</p>
<p>In some scenarios is required to redirect from <code class="codehilite">www.domain.com</code> to <code class="codehilite">domain.com</code> or viceversa. <p>When using SSL offloading outside of cluster (e.g. AWS ELB) it may be useful to enforce a redirect to HTTPS
even when there is no TLS certificate available.
This can be achieved by using the <code class="codehilite">nginx.ingress.kubernetes.io/force-ssl-redirect: &quot;true&quot;</code> annotation in the particular resource.</p>
<h3 id="redirect-fromto-www">Redirect from/to www.<a class="headerlink" href="#redirect-fromto-www" title="Permanent link">&para;</a></h3>
<p>In some scenarios is required to redirect from <code class="codehilite">www.domain.com</code> to <code class="codehilite">domain.com</code> or vice versa.
To enable this feature use the annotation <code class="codehilite">nginx.ingress.kubernetes.io/from-to-www-redirect: &quot;true&quot;</code></p> To enable this feature use the annotation <code class="codehilite">nginx.ingress.kubernetes.io/from-to-www-redirect: &quot;true&quot;</code></p>
<div class="admonition important"> <div class="admonition attention">
<p class="admonition-title">Important</p> <p class="admonition-title">Attention</p>
<p>If at some point a new Ingress is created with a host equal to one of the options (like <code class="codehilite">domain.com</code>) the annotation will be omitted.</p> <p>If at some point a new Ingress is created with a host equal to one of the options (like <code class="codehilite">domain.com</code>) the annotation will be omitted.</p>
</div> </div>
<h3 id="whitelist-source-range">Whitelist source range<a class="headerlink" href="#whitelist-source-range" title="Permanent link">&para;</a></h3> <h3 id="whitelist-source-range">Whitelist source range<a class="headerlink" href="#whitelist-source-range" title="Permanent link">&para;</a></h3>
<p>You can specify the allowed client IP source ranges through the <code class="codehilite">nginx.ingress.kubernetes.io/whitelist-source-range</code> annotation. The value is a comma separated list of <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">CIDRs</a>, e.g. <code class="codehilite">10.0.0.0/24,172.10.0.1</code>.</p> <p>You can specify allowed client IP source ranges through the <code class="codehilite">nginx.ingress.kubernetes.io/whitelist-source-range</code> annotation.
<p>To configure this setting globally for all Ingress rules, the <code class="codehilite">whitelist-source-range</code> value may be set in the NGINX ConfigMap.</p> The value is a comma separated list of <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">CIDRs</a>, e.g. <code class="codehilite">10.0.0.0/24,172.10.0.1</code>.</p>
<p><strong>Note:</strong> Adding an annotation to an Ingress rule overrides any global restriction.</p> <p>To configure this setting globally for all Ingress rules, the <code class="codehilite">whitelist-source-range</code> value may be set in the <a href="../configmap/">NGINX ConfigMap</a>.</p>
<h3 id="cookie-affinity">Cookie affinity<a class="headerlink" href="#cookie-affinity" title="Permanent link">&para;</a></h3> <div class="admonition note">
<p>If you use the <code class="codehilite">cookie</code> type you can also specify the name of the cookie that will be used to route the requests with the annotation <code class="codehilite">nginx.ingress.kubernetes.io/session-cookie-name</code>. The default is to create a cookie named 'INGRESSCOOKIE'.</p> <p class="admonition-title">Note</p>
<p>In case of NGINX the annotation <code class="codehilite">nginx.ingress.kubernetes.io/session-cookie-hash</code> defines which algorithm will be used to 'hash' the used upstream. Default value is <code class="codehilite">md5</code> and possible values are <code class="codehilite">md5</code>, <code class="codehilite">sha1</code> and <code class="codehilite">index</code>. <p>Adding an annotation to an Ingress rule overrides any global restriction.</p>
The <code class="codehilite">index</code> option is not hashed, an in-memory index is used instead, it's quicker and the overhead is shorter Warning: the matching against upstream servers list is inconsistent. So, at reload, if upstreams servers has changed, index values are not guaranteed to correspond to the same server as before! <strong>USE IT WITH CAUTION</strong> and only if you need to!</p> </div>
<p>In NGINX this feature is implemented by the third party module <a href="https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng">nginx-sticky-module-ng</a>. The workflow used to define which upstream server will be used is explained <a href="https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/raw/08a395c66e425540982c00482f55034e1fee67b6/docs/sticky.pdf">here</a></p>
<h3 id="custom-timeouts">Custom timeouts<a class="headerlink" href="#custom-timeouts" title="Permanent link">&para;</a></h3> <h3 id="custom-timeouts">Custom timeouts<a class="headerlink" href="#custom-timeouts" title="Permanent link">&para;</a></h3>
<p>Using the configuration configmap it is possible to set the default global timeout for connections to the upstream servers. <p>Using the configuration configmap it is possible to set the default global timeout for connections to the upstream servers.
In some scenarios is required to have different values. To allow this we provide annotations that allows this customization:</p> In some scenarios is required to have different values. To allow this we provide annotations that allows this customization:</p>
@ -2076,13 +2176,12 @@ In some scenarios is required to have different values. To allow this we provide
<li><code class="codehilite">nginx.ingress.kubernetes.io/proxy-request-buffering</code></li> <li><code class="codehilite">nginx.ingress.kubernetes.io/proxy-request-buffering</code></li>
</ul> </ul>
<h3 id="proxy-redirect">Proxy redirect<a class="headerlink" href="#proxy-redirect" title="Permanent link">&para;</a></h3> <h3 id="proxy-redirect">Proxy redirect<a class="headerlink" href="#proxy-redirect" title="Permanent link">&para;</a></h3>
<p>With the annotations <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-from</code> and <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-to</code> it is possible to set the text that should be changed in the <code class="codehilite">Location</code> and <code class="codehilite">Refresh</code> header fields of a proxied server response (http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_redirect) <p>With the annotations <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-from</code> and <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-to</code> it is possible to set the text that should be changed in the <code class="codehilite">Location</code> and <code class="codehilite">Refresh</code> header fields of a proxied server response (http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_redirect)</p>
Setting "off" or "default" in the annotation <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-from</code> disables <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-to</code> <p>Setting "off" or "default" in the annotation <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-from</code> disables <code class="codehilite">nginx.ingress.kubernetes.io/proxy-redirect-to</code>.</p>
Both annotations will be used in any other case <p>Both annotations will be used in any other case. By default the value is "off".</p>
By default the value is "off".</p>
<h3 id="custom-max-body-size">Custom max body size<a class="headerlink" href="#custom-max-body-size" title="Permanent link">&para;</a></h3> <h3 id="custom-max-body-size">Custom max body size<a class="headerlink" href="#custom-max-body-size" title="Permanent link">&para;</a></h3>
<p>For NGINX, 413 error will be returned to the client when the size in a request exceeds the maximum allowed size of the client request body. This size can be configured by the parameter <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size"><code class="codehilite">client_max_body_size</code></a>.</p> <p>For NGINX, an 413 error will be returned to the client when the size in a request exceeds the maximum allowed size of the client request body. This size can be configured by the parameter <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size"><code class="codehilite">client_max_body_size</code></a>.</p>
<p>To configure this setting globally for all Ingress rules, the <code class="codehilite">proxy-body-size</code> value may be set in the NGINX ConfigMap. <p>To configure this setting globally for all Ingress rules, the <code class="codehilite">proxy-body-size</code> value may be set in the <a href="../configmap/">NGINX ConfigMap</a>.
To use custom values in an Ingress rule define these annotation:</p> To use custom values in an Ingress rule define these annotation:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/proxy-body-size</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">8m</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/proxy-body-size</span><span class="p p-Indicator">:</span> <span class="l l-Scalar l-Scalar-Plain">8m</span>
</pre></div> </pre></div>
@ -2090,8 +2189,8 @@ To use custom values in an Ingress rule define these annotation:</p>
<h3 id="proxy-buffering">Proxy buffering<a class="headerlink" href="#proxy-buffering" title="Permanent link">&para;</a></h3> <h3 id="proxy-buffering">Proxy buffering<a class="headerlink" href="#proxy-buffering" title="Permanent link">&para;</a></h3>
<p>Enable or disable proxy buffering <a href="http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffering"><code class="codehilite">proxy_buffering</code></a>. <p>Enable or disable proxy buffering <a href="http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffering"><code class="codehilite">proxy_buffering</code></a>.
By default proxy buffering is disabled in the nginx config.</p> By default proxy buffering is disabled in the NGINX config.</p>
<p>To configure this setting globally for all Ingress rules, the <code class="codehilite">proxy-buffering</code> value may be set in the NGINX ConfigMap. <p>To configure this setting globally for all Ingress rules, the <code class="codehilite">proxy-buffering</code> value may be set in the <a href="../configmap/">NGINX ConfigMap</a>.
To use custom values in an Ingress rule define these annotation:</p> To use custom values in an Ingress rule define these annotation:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/proxy-buffering</span><span class="p p-Indicator">:</span> <span class="s">&quot;on&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/proxy-buffering</span><span class="p p-Indicator">:</span> <span class="s">&quot;on&quot;</span>
</pre></div> </pre></div>
@ -2105,42 +2204,45 @@ To use custom values in an Ingress rule define these annotation:</p>
<h3 id="connection-proxy-header">Connection proxy header<a class="headerlink" href="#connection-proxy-header" title="Permanent link">&para;</a></h3> <h3 id="connection-proxy-header">Connection proxy header<a class="headerlink" href="#connection-proxy-header" title="Permanent link">&para;</a></h3>
<p>Using this annotation will override the default connection header set by nginx. To use custom values in an Ingress rule, define the annotation:</p> <p>Using this annotation will override the default connection header set by NGINX.
To use custom values in an Ingress rule, define the annotation:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/connection-proxy-header</span><span class="p p-Indicator">:</span> <span class="s">&quot;keep-alive&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/connection-proxy-header</span><span class="p p-Indicator">:</span> <span class="s">&quot;keep-alive&quot;</span>
</pre></div> </pre></div>
<h3 id="enable-access-log">Enable Access Log<a class="headerlink" href="#enable-access-log" title="Permanent link">&para;</a></h3> <h3 id="enable-access-log">Enable Access Log<a class="headerlink" href="#enable-access-log" title="Permanent link">&para;</a></h3>
<p>In some scenarios could be required to disable NGINX access logs. To enable this feature use the annotation:</p> <p>Access logs are enabled by default, but in some scenarios access logs might be required to be disabled for a given
ingress. To do this, use the annotation:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/enable-access-log</span><span class="p p-Indicator">:</span> <span class="s">&quot;false&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/enable-access-log</span><span class="p p-Indicator">:</span> <span class="s">&quot;false&quot;</span>
</pre></div> </pre></div>
<h3 id="enable-rewrite-log">Enable Rewrite Log<a class="headerlink" href="#enable-rewrite-log" title="Permanent link">&para;</a></h3> <h3 id="enable-rewrite-log">Enable Rewrite Log<a class="headerlink" href="#enable-rewrite-log" title="Permanent link">&para;</a></h3>
<p>In some scenarios it could be required to enable NGINX rewrite logs. Note that rewrite logs are sent to the error_log file at the notice level. To enable this feature use the annotation:</p> <p>Rewrite logs are not enabled by default. In some scenarios it could be required to enable NGINX rewrite logs.
Note that rewrite logs are sent to the error_log file at the notice level. To enable this feature use the annotation:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/enable-rewrite-log</span><span class="p p-Indicator">:</span> <span class="s">&quot;true&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/enable-rewrite-log</span><span class="p p-Indicator">:</span> <span class="s">&quot;true&quot;</span>
</pre></div> </pre></div>
<h3 id="lua-resty-waf">Lua Resty WAF<a class="headerlink" href="#lua-resty-waf" title="Permanent link">&para;</a></h3> <h3 id="lua-resty-waf">Lua Resty WAF<a class="headerlink" href="#lua-resty-waf" title="Permanent link">&para;</a></h3>
<p>Using <code class="codehilite">lua-resty-waf-*</code> annotations we can enable and control <a href="https://github.com/p0pr0ck5/lua-resty-waf">lua-resty-waf</a> per location. <p>Using <code class="codehilite">lua-resty-waf-*</code> annotations we can enable and control the <a href="https://github.com/p0pr0ck5/lua-resty-waf">lua-resty-waf</a>
Following configuration will enable WAF for the paths defined in the corresponding ingress:</p> Web Application Firewall per location.</p>
<p>Following configuration will enable the WAF for the paths defined in the corresponding ingress:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf</span><span class="p p-Indicator">:</span> <span class="s">&quot;active&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf</span><span class="p p-Indicator">:</span> <span class="s">&quot;active&quot;</span>
</pre></div> </pre></div>
<p>In order to run it in debugging mode you can set <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-debug</code> to <code class="codehilite">&quot;true&quot;</code> in addition to the above configuration. <p>In order to run it in debugging mode you can set <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-debug</code> to <code class="codehilite">&quot;true&quot;</code> in addition to the above configuration.
The other possible values for <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf</code> are <code class="codehilite">inactive</code> and <code class="codehilite">simulate</code>. In <code class="codehilite">inactive</code> mode WAF won't do anything, whereas The other possible values for <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf</code> are <code class="codehilite">inactive</code> and <code class="codehilite">simulate</code>.
in <code class="codehilite">simulate</code> mode it will log a warning message if there's a matching WAF rule for given request. This is useful to debug a rule and eliminate possible false positives before fully deploying it.</p> In <code class="codehilite">inactive</code> mode WAF won't do anything, whereas in <code class="codehilite">simulate</code> mode it will log a warning message if there's a matching WAF rule for given request. This is useful to debug a rule and eliminate possible false positives before fully deploying it.</p>
<p><code class="codehilite">lua-resty-waf</code> comes with predefined set of rules <a href="https://github.com/p0pr0ck5/lua-resty-waf/tree/84b4f40362500dd0cb98b9e71b5875cb1a40f1ad/rules">https://github.com/p0pr0ck5/lua-resty-waf/tree/84b4f40362500dd0cb98b9e71b5875cb1a40f1ad/rules</a> that covers ModSecurity CRS. <p><code class="codehilite">lua-resty-waf</code> comes with predefined set of rules <a href="https://github.com/p0pr0ck5/lua-resty-waf/tree/84b4f40362500dd0cb98b9e71b5875cb1a40f1ad/rules">https://github.com/p0pr0ck5/lua-resty-waf/tree/84b4f40362500dd0cb98b9e71b5875cb1a40f1ad/rules</a> that covers ModSecurity CRS.
You can use <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-ignore-rulesets</code> to ignore subset of those rulesets. For an example:</p> You can use <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-ignore-rulesets</code> to ignore a subset of those rulesets. For an example:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf-ignore-rulesets</span><span class="p p-Indicator">:</span> <span class="s">&quot;41000_sqli,</span><span class="nv"> </span><span class="s">42000_xss&quot;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf-ignore-rulesets</span><span class="p p-Indicator">:</span> <span class="s">&quot;41000_sqli,</span><span class="nv"> </span><span class="s">42000_xss&quot;</span>
</pre></div> </pre></div>
<p>will ignore the two mentioned rulesets.</p> <p>will ignore the two mentioned rulesets.</p>
<p>It is also possible to configure custom WAF rules per ingress using <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-extra-rules</code> annotation. For an example the following snippet will <p>It is also possible to configure custom WAF rules per ingress using the <code class="codehilite">nginx.ingress.kubernetes.io/lua-resty-waf-extra-rules</code> annotation. For an example the following snippet will configure a WAF rule to deny requests with query string value that contains word <code class="codehilite">foo</code>:</p>
configure a WAF rule to deny requests with query string value that contains word <code class="codehilite">foo</code>:</p>
<div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf-extra-rules</span><span class="p p-Indicator">:</span> <span class="s">&#39;[=[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;access&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;actions&quot;:</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;disrupt&quot;</span><span class="nv"> </span><span class="s">:</span><span class="nv"> </span><span class="s">&quot;DENY&quot;</span><span class="nv"> </span><span class="s">},</span><span class="nv"> </span><span class="s">&quot;id&quot;:</span><span class="nv"> </span><span class="s">10001,</span><span class="nv"> </span><span class="s">&quot;msg&quot;:</span><span class="nv"> </span><span class="s">&quot;my</span><span class="nv"> </span><span class="s">custom</span><span class="nv"> </span><span class="s">rule&quot;,</span><span class="nv"> </span><span class="s">&quot;operator&quot;:</span><span class="nv"> </span><span class="s">&quot;STR_CONTAINS&quot;,</span><span class="nv"> </span><span class="s">&quot;pattern&quot;:</span><span class="nv"> </span><span class="s">&quot;foo&quot;,</span><span class="nv"> </span><span class="s">&quot;vars&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;parse&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">&quot;values&quot;,</span><span class="nv"> </span><span class="s">1</span><span class="nv"> </span><span class="s">],</span><span class="nv"> </span><span class="s">&quot;type&quot;:</span><span class="nv"> </span><span class="s">&quot;REQUEST_ARGS&quot;</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">]</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">],</span><span class="nv"> </span><span class="s">&quot;body_filter&quot;:</span><span class="nv"> </span><span class="s">[],</span><span class="nv"> </span><span class="s">&quot;header_filter&quot;:[]</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">]=]&#39;</span> <div class="codehilite"><pre><span></span><span class="l l-Scalar l-Scalar-Plain">nginx.ingress.kubernetes.io/lua-resty-waf-extra-rules</span><span class="p p-Indicator">:</span> <span class="s">&#39;[=[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;access&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;actions&quot;:</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;disrupt&quot;</span><span class="nv"> </span><span class="s">:</span><span class="nv"> </span><span class="s">&quot;DENY&quot;</span><span class="nv"> </span><span class="s">},</span><span class="nv"> </span><span class="s">&quot;id&quot;:</span><span class="nv"> </span><span class="s">10001,</span><span class="nv"> </span><span class="s">&quot;msg&quot;:</span><span class="nv"> </span><span class="s">&quot;my</span><span class="nv"> </span><span class="s">custom</span><span class="nv"> </span><span class="s">rule&quot;,</span><span class="nv"> </span><span class="s">&quot;operator&quot;:</span><span class="nv"> </span><span class="s">&quot;STR_CONTAINS&quot;,</span><span class="nv"> </span><span class="s">&quot;pattern&quot;:</span><span class="nv"> </span><span class="s">&quot;foo&quot;,</span><span class="nv"> </span><span class="s">&quot;vars&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">{</span><span class="nv"> </span><span class="s">&quot;parse&quot;:</span><span class="nv"> </span><span class="s">[</span><span class="nv"> </span><span class="s">&quot;values&quot;,</span><span class="nv"> </span><span class="s">1</span><span class="nv"> </span><span class="s">],</span><span class="nv"> </span><span class="s">&quot;type&quot;:</span><span class="nv"> </span><span class="s">&quot;REQUEST_ARGS&quot;</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">]</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">],</span><span class="nv"> </span><span class="s">&quot;body_filter&quot;:</span><span class="nv"> </span><span class="s">[],</span><span class="nv"> </span><span class="s">&quot;header_filter&quot;:[]</span><span class="nv"> </span><span class="s">}</span><span class="nv"> </span><span class="s">]=]&#39;</span>
</pre></div> </pre></div>
@ -2148,12 +2250,13 @@ configure a WAF rule to deny requests with query string value that contains word
<p>For details on how to write WAF rules, please refer to <a href="https://github.com/p0pr0ck5/lua-resty-waf">https://github.com/p0pr0ck5/lua-resty-waf</a>.</p> <p>For details on how to write WAF rules, please refer to <a href="https://github.com/p0pr0ck5/lua-resty-waf">https://github.com/p0pr0ck5/lua-resty-waf</a>.</p>
<h3 id="grpc-backend">gRPC backend<a class="headerlink" href="#grpc-backend" title="Permanent link">&para;</a></h3> <h3 id="grpc-backend">gRPC backend<a class="headerlink" href="#grpc-backend" title="Permanent link">&para;</a></h3>
<p>Since NGINX 1.13.10 it is possible to expose <a href="http://nginx.org/en/docs/http/ngx_http_grpc_module.html">gRPC services natively</a></p> <p>Since NGINX 1.13.10 it is possible to expose <a href="http://nginx.org/en/docs/http/ngx_http_grpc_module.html">gRPC services natively</a></p>
<p>You only need to add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/grpc-backend: &quot;true&quot;</code> to enable this feature. Additionally, if the gRPC service requires TLS <code class="codehilite">nginx.ingress.kubernetes.io/secure-backends: &quot;true&quot;</code></p> <p>You only need to add the annotation <code class="codehilite">nginx.ingress.kubernetes.io/grpc-backend: &quot;true&quot;</code> to enable this feature.
<div class="admonition important"> Additionally, if the gRPC service requires TLS, add <code class="codehilite">nginx.ingress.kubernetes.io/secure-backends: &quot;true&quot;</code>.</p>
<p class="admonition-title">Important</p> <div class="admonition attention">
<p>This feature requires HTTP2 to work which means we need to expose this service using HTTPS.</p> <p class="admonition-title">Attention</p>
<p>This feature requires HTTP2 to work which means we need to expose this service using HTTPS.
Exposing a gRPC service using HTTP is not supported.</p>
</div> </div>
<p>Exposing a gRPC service using HTTP is not supported.</p>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -1316,6 +1328,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -1353,8 +1377,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -1377,8 +1401,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -1390,13 +1414,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -1461,8 +1485,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -1473,8 +1497,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -1546,6 +1570,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -1636,8 +1672,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -1660,8 +1696,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -1700,18 +1736,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -510,6 +522,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -547,8 +571,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -571,8 +595,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -584,13 +608,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -655,8 +679,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -667,8 +691,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -510,6 +522,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -547,8 +571,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -571,8 +595,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -584,13 +608,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -655,8 +679,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -667,8 +691,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1047,7 +1071,7 @@
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../deploy/rbac/" title="Role Based Access Control (RBAC)" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../deploy/upgrade/" title="Upgrading" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1056,7 +1080,7 @@
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Role Based Access Control (RBAC) Upgrading
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -510,6 +522,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -547,8 +571,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -571,8 +595,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -584,13 +608,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -655,8 +679,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -667,8 +691,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1021,37 +1045,98 @@
<h1 id="log-format">Log format<a class="headerlink" href="#log-format" title="Permanent link">&para;</a></h1> <h1 id="log-format">Log format<a class="headerlink" href="#log-format" title="Permanent link">&para;</a></h1>
<p>The default configuration uses a custom logging format to add additional information about upstreams, response time and status</p> <p>The default configuration uses a custom logging format to add additional information about upstreams, response time and status.</p>
<div class="codehilite"><pre><span></span><span class="x"> log_format upstreaminfo &#39;</span><span class="cp">{{</span> <span class="k">if</span> <span class="err">$</span><span class="nv">cfg.useProxyProtocol</span> <span class="cp">}}</span><span class="x">$proxy_protocol_addr</span><span class="cp">{{</span> <span class="k">else</span> <span class="cp">}}</span><span class="x">$remote_addr</span><span class="cp">{{</span> <span class="nv">end</span> <span class="cp">}}</span><span class="x"> - &#39;</span> <div class="codehilite"><pre><span></span><span class="x">log_format upstreaminfo</span>
<span class="x"> &#39;[$the_real_ip] - $remote_user [$time_local] &quot;$request&quot; $status $body_bytes_sent &quot;$http_referer&quot; &quot;$http_user_agent&quot; &#39;</span> <span class="x"> &#39;</span><span class="cp">{{</span> <span class="k">if</span> <span class="err">$</span><span class="nv">cfg.useProxyProtocol</span> <span class="cp">}}</span><span class="x">$proxy_protocol_addr</span><span class="cp">{{</span> <span class="k">else</span> <span class="cp">}}</span><span class="x">$remote_addr</span><span class="cp">{{</span> <span class="nv">end</span> <span class="cp">}}</span><span class="x"> - &#39;</span>
<span class="x"> &#39;$request_length $request_time [$proxy_upstream_name] $upstream_addr $upstream_response_length $upstream_response_time $upstream_status&#39;;</span> <span class="x"> &#39;[$the_real_ip] - $remote_user [$time_local] &quot;$request&quot; &#39;</span>
<span class="x"> &#39;$status $body_bytes_sent &quot;$http_referer&quot; &quot;$http_user_agent&quot; &#39;</span>
<span class="x"> &#39;$request_length $request_time [$proxy_upstream_name] $upstream_addr &#39;</span>
<span class="x"> &#39;$upstream_response_length $upstream_response_time $upstream_status&#39;;</span>
</pre></div> </pre></div>
<table>
<thead>
<tr>
<th>Placeholder</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code class="codehilite">$proxy_protocol_addr</code></td>
<td>remote address if proxy protocol is enabled</td>
</tr>
<tr>
<td><code class="codehilite">$remote_addr</code></td>
<td>remote address if proxy protocol is disabled (default)</td>
</tr>
<tr>
<td><code class="codehilite">$the_real_ip</code></td>
<td>the source IP address of the client</td>
</tr>
<tr>
<td><code class="codehilite">$remote_user</code></td>
<td>user name supplied with the Basic authentication</td>
</tr>
<tr>
<td><code class="codehilite">$time_local</code></td>
<td>local time in the Common Log Format</td>
</tr>
<tr>
<td><code class="codehilite">$request</code></td>
<td>full original request line</td>
</tr>
<tr>
<td><code class="codehilite">$status</code></td>
<td>response status</td>
</tr>
<tr>
<td><code class="codehilite">$body_bytes_sent</code></td>
<td>number of bytes sent to a client, not counting the response header</td>
</tr>
<tr>
<td><code class="codehilite">$http_referer</code></td>
<td>value of the Referer header</td>
</tr>
<tr>
<td><code class="codehilite">$http_user_agent</code></td>
<td>value of User-Agent header</td>
</tr>
<tr>
<td><code class="codehilite">$request_length</code></td>
<td>request length (including request line, header, and request body)</td>
</tr>
<tr>
<td><code class="codehilite">$request_time</code></td>
<td>time elapsed since the first bytes were read from the client</td>
</tr>
<tr>
<td><code class="codehilite">$proxy_upstream_name</code></td>
<td>name of the upstream. The format is <code class="codehilite">upstream-&lt;namespace&gt;-&lt;service name&gt;-&lt;service port&gt;</code></td>
</tr>
<tr>
<td><code class="codehilite">$upstream_addr</code></td>
<td>the IP address and port (or the path to the domain socket) of the upstream server. If several servers were contacted during request processing, their addresses are separated by commas.</td>
</tr>
<tr>
<td><code class="codehilite">$upstream_response_length</code></td>
<td>the length of the response obtained from the upstream server</td>
</tr>
<tr>
<td><code class="codehilite">$upstream_response_time</code></td>
<td>time spent on receiving the response from the upstream server as seconds with millisecond resolution</td>
</tr>
<tr>
<td><code class="codehilite">$upstream_status</code></td>
<td>status code of the response obtained from the upstream server</td>
</tr>
</tbody>
</table>
<p>Sources:</p> <p>Sources:</p>
<ul> <ul>
<li><a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#variables">upstream variables</a></li> <li><a href="http://nginx.org/en/docs/http/ngx_http_upstream_module.html#variables">Upstream variables</a></li>
<li><a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#variables">embedded variables</a></li> <li><a href="http://nginx.org/en/docs/http/ngx_http_core_module.html#variables">Embedded variables</a></li>
</ul>
<p>Description:</p>
<ul>
<li><code class="codehilite">$proxy_protocol_addr</code>: if PROXY protocol is enabled</li>
<li><code class="codehilite">$remote_addr</code>: if PROXY protocol is disabled (default)</li>
<li><code class="codehilite">$the_real_ip</code>: the source IP address of the client</li>
<li><code class="codehilite">$remote_user</code>: user name supplied with the Basic authentication</li>
<li><code class="codehilite">$time_local</code>: local time in the Common Log Format</li>
<li><code class="codehilite">$request</code>: full original request line</li>
<li><code class="codehilite">$status</code>: response status</li>
<li><code class="codehilite">$body_bytes_sent</code>: number of bytes sent to a client, not counting the response header</li>
<li><code class="codehilite">$http_referer</code>: value of the Referer header</li>
<li><code class="codehilite">$http_user_agent</code>: value of User-Agent header</li>
<li><code class="codehilite">$request_length</code>: request length (including request line, header, and request body)</li>
<li><code class="codehilite">$request_time</code>: time elapsed since the first bytes were read from the client</li>
<li><code class="codehilite">$proxy_upstream_name</code>: name of the upstream. The format is <code class="codehilite">upstream-&lt;namespace&gt;-&lt;service name&gt;-&lt;service port&gt;</code></li>
<li><code class="codehilite">$upstream_addr</code>: keeps the IP address and port, or the path to the UNIX-domain socket of the upstream server. If several servers were contacted during request processing, their addresses are separated by commas</li>
<li><code class="codehilite">$upstream_response_length</code>: keeps the length of the response obtained from the upstream server</li>
<li><code class="codehilite">$upstream_response_time</code>: keeps time spent on receiving the response from the upstream server; the time is kept in seconds with millisecond resolution</li>
<li><code class="codehilite">$upstream_status</code>: keeps status code of the response obtained from the upstream server</li>
</ul> </ul>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -536,8 +560,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,8 +593,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../tls/" title="TLS" class="md-nav__link"> <a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -582,13 +606,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -653,8 +677,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -665,8 +689,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -738,6 +762,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -828,8 +864,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -852,8 +888,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -892,18 +928,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1045,7 +1069,7 @@ To use this module just set in the configuration configmap <code class="codehili
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1054,19 +1078,19 @@ To use this module just set in the configuration configmap <code class="codehili
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
Multiple ingress controllers Multiple Ingress controllers
</span> </span>
</div> </div>
</a> </a>
<a href="../tls/" title="TLS" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../tls/" title="TLS/HTTPS" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
TLS TLS/HTTPS
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -536,8 +560,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -560,8 +584,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -575,13 +599,13 @@
<li class="md-nav__item md-nav__item--active md-nav__item--nested"> <li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10" checked> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11" checked>
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -655,8 +679,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -667,8 +691,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1052,7 +1076,7 @@ Using <code class="codehilite">enable-owasp-modsecurity-crs: &quot;true&quot;</c
<div class="md-footer-nav"> <div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid"> <nav class="md-footer-nav__inner md-grid">
<a href="../../tls/" title="TLS" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> <a href="../../tls/" title="TLS/HTTPS" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div> </div>
@ -1061,7 +1085,7 @@ Using <code class="codehilite">enable-owasp-modsecurity-crs: &quot;true&quot;</c
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Previous Previous
</span> </span>
TLS TLS/HTTPS
</span> </span>
</div> </div>
</a> </a>

View file

@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -536,8 +560,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -560,8 +584,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../tls/" title="TLS" class="md-nav__link"> <a href="../../tls/" title="TLS/HTTPS" class="md-nav__link">
TLS TLS/HTTPS
</a> </a>
</li> </li>
@ -575,13 +599,13 @@
<li class="md-nav__item md-nav__item--active md-nav__item--nested"> <li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10" checked> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11" checked>
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -655,8 +679,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -667,8 +691,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -740,6 +764,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -830,8 +866,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -854,8 +890,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -894,18 +930,6 @@
<li class="md-nav__item">
<a href="../../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1090,13 +1114,13 @@ kubectl create -f https://raw.githubusercontent.com/rnburn/zipkin-date-server/ma
</a> </a>
<a href="../../../examples/PREREQUISITES/" title="Prerequisites" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> <a href="../../../examples/" title="Ingress examples" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis"> <span class="md-flex__ellipsis">
<span class="md-footer-nav__direction"> <span class="md-footer-nav__direction">
Next Next
</span> </span>
Prerequisites Ingress examples
</span> </span>
</div> </div>
<div class="md-flex__cell md-flex__cell--shrink"> <div class="md-flex__cell md-flex__cell--shrink">

View file

@ -36,7 +36,7 @@
<title>TLS - NGINX Ingress Controller</title> <title>TLS/HTTPS - NGINX Ingress Controller</title>
@ -95,7 +95,7 @@
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off"> <input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label> <label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<a href="#tls" tabindex="1" class="md-skip"> <a href="#tlshttps" tabindex="1" class="md-skip">
Skip to content Skip to content
</a> </a>
@ -121,7 +121,7 @@
NGINX Ingress Controller NGINX Ingress Controller
</span> </span>
<span class="md-header-nav__topic"> <span class="md-header-nav__topic">
TLS TLS/HTTPS
</span> </span>
@ -246,7 +246,7 @@
<li class="md-tabs__item"> <li class="md-tabs__item">
<a href="../../examples/PREREQUISITES/" title="Examples" class="md-tabs__link"> <a href="../../examples/" title="Examples" class="md-tabs__link">
Examples Examples
</a> </a>
@ -360,6 +360,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
Upgrading
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -499,6 +511,18 @@
<li class="md-nav__item">
<a href="../default-backend/" title="Default backend" class="md-nav__link">
Default backend
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link"> <a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
Exposing TCP and UDP services Exposing TCP and UDP services
@ -536,8 +560,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link"> <a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple ingress controllers Multiple Ingress controllers
</a> </a>
</li> </li>
@ -569,11 +593,11 @@
<label class="md-nav__link md-nav__link--active" for="toc"> <label class="md-nav__link md-nav__link--active" for="toc">
TLS TLS/HTTPS
</label> </label>
<a href="./" title="TLS" class="md-nav__link md-nav__link--active"> <a href="./" title="TLS/HTTPS" class="md-nav__link md-nav__link--active">
TLS TLS/HTTPS
</a> </a>
@ -586,6 +610,13 @@
<label class="md-nav__title" for="toc">Table of contents</label> <label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#tls-secrets" title="TLS Secrets" class="md-nav__link">
TLS Secrets
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#default-ssl-certificate" title="Default SSL Certificate" class="md-nav__link"> <a href="#default-ssl-certificate" title="Default SSL Certificate" class="md-nav__link">
Default SSL Certificate Default SSL Certificate
@ -626,14 +657,20 @@
Default TLS Version and Ciphers Default TLS Version and Ciphers
</a> </a>
</li> <nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<li class="md-nav__item">
<a href="#legacy-tls" title="Legacy TLS" class="md-nav__link"> <a href="#legacy-tls" title="Legacy TLS" class="md-nav__link">
Legacy TLS Legacy TLS
</a> </a>
</li> </li>
</ul>
</nav>
</li>
@ -653,13 +690,13 @@
<li class="md-nav__item md-nav__item--nested"> <li class="md-nav__item md-nav__item--nested">
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-10" type="checkbox" id="nav-3-10"> <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3-11" type="checkbox" id="nav-3-11">
<label class="md-nav__link" for="nav-3-10"> <label class="md-nav__link" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<nav class="md-nav" data-md-component="collapsible" data-md-level="2"> <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
<label class="md-nav__title" for="nav-3-10"> <label class="md-nav__title" for="nav-3-11">
Third party addons Third party addons
</label> </label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
@ -724,8 +761,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link"> <a href="../../examples/" title="Ingress examples" class="md-nav__link">
Prerequisites Ingress examples
</a> </a>
</li> </li>
@ -736,8 +773,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link"> <a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
Ingress examples Prerequisites
</a> </a>
</li> </li>
@ -809,6 +846,18 @@
</li> </li>
<li class="md-nav__item">
<a href="../../examples/auth/oauth-external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
</ul> </ul>
</nav> </nav>
</li> </li>
@ -899,8 +948,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
Deploying the Nginx Ingress controller Custom VTS metrics with Prometheus
</a> </a>
</li> </li>
@ -923,8 +972,8 @@
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link"> <a href="../../examples/customization/ssl-dh-param/README/" title="Custom DH parameters for perfect forward secrecy" class="md-nav__link">
Deploying the Nginx Ingress controller Custom DH parameters for perfect forward secrecy
</a> </a>
</li> </li>
@ -963,18 +1012,6 @@
<li class="md-nav__item">
<a href="../../examples/external-auth/README/" title="External Authentication" class="md-nav__link">
External Authentication
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link"> <a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination Multi TLS certificate termination
@ -1079,6 +1116,13 @@
<label class="md-nav__title" for="toc">Table of contents</label> <label class="md-nav__title" for="toc">Table of contents</label>
<ul class="md-nav__list" data-md-scrollfix> <ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="#tls-secrets" title="TLS Secrets" class="md-nav__link">
TLS Secrets
</a>
</li>
<li class="md-nav__item"> <li class="md-nav__item">
<a href="#default-ssl-certificate" title="Default SSL Certificate" class="md-nav__link"> <a href="#default-ssl-certificate" title="Default SSL Certificate" class="md-nav__link">
Default SSL Certificate Default SSL Certificate
@ -1119,14 +1163,20 @@
Default TLS Version and Ciphers Default TLS Version and Ciphers
</a> </a>
</li> <nav class="md-nav">
<ul class="md-nav__list">
<li class="md-nav__item">
<li class="md-nav__item">
<a href="#legacy-tls" title="Legacy TLS" class="md-nav__link"> <a href="#legacy-tls" title="Legacy TLS" class="md-nav__link">
Legacy TLS Legacy TLS
</a> </a>
</li> </li>
</ul>
</nav>
</li>
@ -1147,141 +1197,82 @@
<a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/user-guide/tls.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a> <a href="https://github.com/kubernetes/ingress-nginx/edit/master/docs/user-guide/tls.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
<h1 id="tls">TLS<a class="headerlink" href="#tls" title="Permanent link">&para;</a></h1> <h1 id="tlshttps">TLS/HTTPS<a class="headerlink" href="#tlshttps" title="Permanent link">&para;</a></h1>
<ul> <h2 id="tls-secrets">TLS Secrets<a class="headerlink" href="#tls-secrets" title="Permanent link">&para;</a></h2>
<li><a href="#default-ssl-certificate">Default SSL Certificate</a></li> <p>Anytime we reference a TLS secret, we mean a PEM-encoded X.509, RSA (2048) secret.</p>
<li><a href="#ssl-passthrough">SSL Passthrough</a></li> <p>You can generate a self-signed certificate and private key with with:</p>
<li><a href="#server-side-https-enforcement">HTTPS enforcement</a></li> <div class="codehilite"><pre><span></span>$ openssl req -x509 -nodes -days <span class="m">365</span> -newkey rsa:2048 -keyout <span class="si">${</span><span class="nv">KEY_FILE</span><span class="si">}</span> -out <span class="si">${</span><span class="nv">CERT_FILE</span><span class="si">}</span> -subj <span class="s2">&quot;/CN=</span><span class="si">${</span><span class="nv">HOST</span><span class="si">}</span><span class="s2">/O=</span><span class="si">${</span><span class="nv">HOST</span><span class="si">}</span><span class="s2">&quot;</span><span class="sb">`</span>
<li><a href="#http-strict-transport-security">HSTS</a></li> </pre></div>
<li><a href="#server-side-https-enforcement-through-redirect">Server-side HTTPS enforcement through redirect</a> </li>
<li><a href="#automated-certificate-management-with-kube-lego">Kube-Lego</a></li>
<li><a href="#default-tls-version-and-ciphers">Default TLS Version and Ciphers</a></li> <p>Then create the secret in the cluster via:</p>
<li><a href="#legacy-tls">Legacy TLS</a></li> <div class="codehilite"><pre><span></span>kubectl create secret tls <span class="si">${</span><span class="nv">CERT_NAME</span><span class="si">}</span> --key <span class="si">${</span><span class="nv">KEY_FILE</span><span class="si">}</span> --cert <span class="si">${</span><span class="nv">CERT_FILE</span><span class="si">}</span>
</ul> </pre></div>
<p>The resulting secret will be of type <code class="codehilite">kubernetes.io/tls</code>.</p>
<h2 id="default-ssl-certificate">Default SSL Certificate<a class="headerlink" href="#default-ssl-certificate" title="Permanent link">&para;</a></h2> <h2 id="default-ssl-certificate">Default SSL Certificate<a class="headerlink" href="#default-ssl-certificate" title="Permanent link">&para;</a></h2>
<p>NGINX provides the option to configure a server as a catch-all with <a href="http://nginx.org/en/docs/http/server_names.html">server_name</a> for requests that do not match any of the configured server names. This configuration works without issues for HTTP traffic. <p>NGINX provides the option to configure a server as a catch-all with
In case of HTTPS, NGINX requires a certificate. <a href="http://nginx.org/en/docs/http/server_names.html">server_name</a>
For this reason the Ingress controller provides the flag <code class="codehilite">--default-ssl-certificate</code>. The secret behind this flag contains the default certificate to be used in the mentioned scenario. If this flag is not provided NGINX will use a self signed certificate.</p> for requests that do not match any of the configured server names.
<p>Running without the flag <code class="codehilite">--default-ssl-certificate</code>:</p> This configuration works without out-of-the-box for HTTP traffic.
<div class="codehilite"><pre><span></span><span class="gp">$</span> curl -v https://10.2.78.7:443 -k For HTTPS, a certificate is naturally required.</p>
<span class="go">* Rebuilt URL to: https://10.2.78.7:443/</span> <p>For this reason the Ingress controller provides the flag <code class="codehilite">--default-ssl-certificate</code>.
<span class="go">* Trying 10.2.78.4...</span> The secret referred to by this flag contains the default certificate to be used when
<span class="go">* Connected to 10.2.78.7 (10.2.78.7) port 443 (#0)</span> accessing the catch-all server.
<span class="go">* ALPN, offering http/1.1</span> If this flag is not provided NGINX will use a self-signed certificate.</p>
<span class="go">* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH</span> <p>For instance, if you have a TLS secret <code class="codehilite">foo-tls</code> in the <code class="codehilite">default</code> namespace,
<span class="go">* successfully set certificate verify locations:</span> add <code class="codehilite">--default-ssl-certificate=default/foo-tls</code> in the <code class="codehilite">nginx-controller</code> deployment.</p>
<span class="go">* CAfile: /etc/ssl/certs/ca-certificates.crt</span>
<span class="go"> CApath: /etc/ssl/certs</span>
<span class="go">* TLSv1.2 (OUT), TLS header, Certificate Status (22):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Client hello (1):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server hello (2):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Certificate (11):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server key exchange (12):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server finished (14):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):</span>
<span class="go">* TLSv1.2 (OUT), TLS change cipher, Client hello (1):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Finished (20):</span>
<span class="go">* TLSv1.2 (IN), TLS change cipher, Client hello (1):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Finished (20):</span>
<span class="go">* SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256</span>
<span class="go">* ALPN, server accepted to use http/1.1</span>
<span class="go">* Server certificate:</span>
<span class="go">* subject: CN=foo.bar.com</span>
<span class="go">* start date: Apr 13 00:50:56 2016 GMT</span>
<span class="go">* expire date: Apr 13 00:50:56 2017 GMT</span>
<span class="go">* issuer: CN=foo.bar.com</span>
<span class="go">* SSL certificate verify result: self signed certificate (18), continuing anyway.</span>
<span class="gp">&gt;</span> GET / HTTP/1.1
<span class="gp">&gt;</span> Host: <span class="m">10</span>.2.78.7
<span class="gp">&gt;</span> User-Agent: curl/7.47.1
<span class="gp">&gt;</span> Accept: */*
<span class="gp">&gt;</span>
<span class="go">&lt; HTTP/1.1 404 Not Found</span>
<span class="go">&lt; Server: nginx/1.11.1</span>
<span class="go">&lt; Date: Thu, 21 Jul 2016 15:38:46 GMT</span>
<span class="go">&lt; Content-Type: text/html</span>
<span class="go">&lt; Transfer-Encoding: chunked</span>
<span class="go">&lt; Connection: keep-alive</span>
<span class="go">&lt; Strict-Transport-Security: max-age=15724800; includeSubDomains; preload</span>
<span class="go">&lt;</span>
<span class="go">&lt;span&gt;The page you&#39;re looking for could not be found.&lt;/span&gt;</span>
<span class="go">* Connection #0 to host 10.2.78.7 left intact</span>
</pre></div>
<p>Specifying <code class="codehilite">--default-ssl-certificate=default/foo-tls</code>:</p>
<div class="codehilite"><pre><span></span><span class="gp">core@localhost ~ $</span> curl -v https://10.2.78.7:443 -k
<span class="go">* Rebuilt URL to: https://10.2.78.7:443/</span>
<span class="go">* Trying 10.2.78.7...</span>
<span class="go">* Connected to 10.2.78.7 (10.2.78.7) port 443 (#0)</span>
<span class="go">* ALPN, offering http/1.1</span>
<span class="go">* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH</span>
<span class="go">* successfully set certificate verify locations:</span>
<span class="go">* CAfile: /etc/ssl/certs/ca-certificates.crt</span>
<span class="go"> CApath: /etc/ssl/certs</span>
<span class="go">* TLSv1.2 (OUT), TLS header, Certificate Status (22):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Client hello (1):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server hello (2):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Certificate (11):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server key exchange (12):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Server finished (14):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):</span>
<span class="go">* TLSv1.2 (OUT), TLS change cipher, Client hello (1):</span>
<span class="go">* TLSv1.2 (OUT), TLS handshake, Finished (20):</span>
<span class="go">* TLSv1.2 (IN), TLS change cipher, Client hello (1):</span>
<span class="go">* TLSv1.2 (IN), TLS handshake, Finished (20):</span>
<span class="go">* SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256</span>
<span class="go">* ALPN, server accepted to use http/1.1</span>
<span class="go">* Server certificate:</span>
<span class="go">* subject: CN=foo.bar.com</span>
<span class="go">* start date: Apr 13 00:50:56 2016 GMT</span>
<span class="go">* expire date: Apr 13 00:50:56 2017 GMT</span>
<span class="go">* issuer: CN=foo.bar.com</span>
<span class="go">* SSL certificate verify result: self signed certificate (18), continuing anyway.</span>
<span class="gp">&gt;</span> GET / HTTP/1.1
<span class="gp">&gt;</span> Host: <span class="m">10</span>.2.78.7
<span class="gp">&gt;</span> User-Agent: curl/7.47.1
<span class="gp">&gt;</span> Accept: */*
<span class="gp">&gt;</span>
<span class="go">&lt; HTTP/1.1 404 Not Found</span>
<span class="go">&lt; Server: nginx/1.11.1</span>
<span class="go">&lt; Date: Mon, 18 Jul 2016 21:02:59 GMT</span>
<span class="go">&lt; Content-Type: text/html</span>
<span class="go">&lt; Transfer-Encoding: chunked</span>
<span class="go">&lt; Connection: keep-alive</span>
<span class="go">&lt; Strict-Transport-Security: max-age=15724800; includeSubDomains; preload</span>
<span class="go">&lt;</span>
<span class="go">&lt;span&gt;The page you&#39;re looking for could not be found.&lt;/span&gt;</span>
<span class="go">* Connection #0 to host 10.2.78.7 left intact</span>
</pre></div>
<h2 id="ssl-passthrough">SSL Passthrough<a class="headerlink" href="#ssl-passthrough" title="Permanent link">&para;</a></h2> <h2 id="ssl-passthrough">SSL Passthrough<a class="headerlink" href="#ssl-passthrough" title="Permanent link">&para;</a></h2>
<p>The flag <code class="codehilite">--enable-ssl-passthrough</code> enables SSL passthrough feature. <p>The flag <code class="codehilite">--enable-ssl-passthrough</code> enables the SSL passthrough feature.
By default this feature is disabled</p> By default this feature is disabled.</p>
<p>This is required to enable passthrough backends in Ingress configurations.</p>
<p>TODO: Improve this documentation.</p>
<h2 id="http-strict-transport-security">HTTP Strict Transport Security<a class="headerlink" href="#http-strict-transport-security" title="Permanent link">&para;</a></h2> <h2 id="http-strict-transport-security">HTTP Strict Transport Security<a class="headerlink" href="#http-strict-transport-security" title="Permanent link">&para;</a></h2>
<p>HTTP Strict Transport Security (HSTS) is an opt-in security enhancement specified through the use of a special response header. Once a supported browser receives this header that browser will prevent any communications from being sent over HTTP to the specified domain and will instead send all communications over HTTPS.</p> <p>HTTP Strict Transport Security (HSTS) is an opt-in security enhancement specified
<p>By default the controller redirects (301) to HTTPS if there is a TLS Ingress rule.</p> through the use of a special response header. Once a supported browser receives
<p>To disable this behavior use <code class="codehilite">hsts: &quot;false&quot;</code> in the configuration ConfigMap.</p> this header that browser will prevent any communications from being sent over
HTTP to the specified domain and will instead send all communications over HTTPS.</p>
<p>HSTS is enabled by default.</p>
<p>To disable this behavior use <code class="codehilite">hsts: &quot;false&quot;</code> in the configuration <a href="../nginx-configuration/configmap/">ConfigMap</a>.</p>
<h2 id="server-side-https-enforcement-through-redirect">Server-side HTTPS enforcement through redirect<a class="headerlink" href="#server-side-https-enforcement-through-redirect" title="Permanent link">&para;</a></h2> <h2 id="server-side-https-enforcement-through-redirect">Server-side HTTPS enforcement through redirect<a class="headerlink" href="#server-side-https-enforcement-through-redirect" title="Permanent link">&para;</a></h2>
<p>By default the controller redirects (301) to <code class="codehilite">HTTPS</code> if TLS is enabled for that ingress. If you want to disable that behavior globally, you can use <code class="codehilite">ssl-redirect: &quot;false&quot;</code> in the NGINX config map.</p> <p>By default the controller redirects HTTP clients to the HTTPS port
<p>To configure this feature for specific ingress resources, you can use the <code class="codehilite">nginx.ingress.kubernetes.io/ssl-redirect: &quot;false&quot;</code> annotation in the particular resource.</p> 443 using a 308 Permanent Redirect response if TLS is enabled for that Ingress.</p>
<p>When using SSL offloading outside of cluster (e.g. AWS ELB) it may be useful to enforce a redirect to <code class="codehilite">HTTPS</code> even when there is not TLS cert available. This can be achieved by using the <code class="codehilite">nginx.ingress.kubernetes.io/force-ssl-redirect: &quot;true&quot;</code> annotation in the particular resource.</p> <p>This can be disabled globally using <code class="codehilite">ssl-redirect: &quot;false&quot;</code> in the NGINX <a href="../nginx-configuration/configmap/">config map</a>,
or per-Ingress with the <code class="codehilite">nginx.ingress.kubernetes.io/ssl-redirect: &quot;false&quot;</code>
annotation in the particular resource.</p>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>When using SSL offloading outside of cluster (e.g. AWS ELB) it may be useful to enforce a
redirect to HTTPS even when there is no TLS certificate available.
This can be achieved by using the <code class="codehilite">nginx.ingress.kubernetes.io/force-ssl-redirect: &quot;true&quot;</code>
annotation in the particular resource.</p>
</div>
<h2 id="automated-certificate-management-with-kube-lego">Automated Certificate Management with Kube-Lego<a class="headerlink" href="#automated-certificate-management-with-kube-lego" title="Permanent link">&para;</a></h2> <h2 id="automated-certificate-management-with-kube-lego">Automated Certificate Management with Kube-Lego<a class="headerlink" href="#automated-certificate-management-with-kube-lego" title="Permanent link">&para;</a></h2>
<p><a href="https://github.com/jetstack/kube-lego">Kube-Lego</a> automatically requests missing or expired certificates from <a href="https://letsencrypt.org">Let's Encrypt</a> by monitoring ingress resources and their referenced secrets. To enable this for an ingress resource you have to add an annotation:</p> <div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>Kube-Lego has reached end-of-life and is being
replaced by <a href="https://github.com/jetstack/cert-manager/">cert-manager</a>.</p>
</div>
<p><a href="https://github.com/jetstack/kube-lego">Kube-Lego</a> automatically requests missing or expired certificates from <a href="https://letsencrypt.org">Let's Encrypt</a>
by monitoring ingress resources and their referenced secrets.</p>
<p>To enable this for an ingress resource you have to add an annotation:</p>
<div class="codehilite"><pre><span></span><span class="go">kubectl annotate ing ingress-demo kubernetes.io/tls-acme=&quot;true&quot;</span> <div class="codehilite"><pre><span></span><span class="go">kubectl annotate ing ingress-demo kubernetes.io/tls-acme=&quot;true&quot;</span>
</pre></div> </pre></div>
<p>To setup Kube-Lego you can take a look at this <a href="https://github.com/jetstack/kube-lego/tree/master/examples">full example</a>. The first <p>To setup Kube-Lego you can take a look at this <a href="https://github.com/jetstack/kube-lego/tree/master/examples">full example</a>.
version to fully support Kube-Lego is nginx Ingress controller 0.8.</p> The first version to fully support Kube-Lego is Nginx Ingress controller 0.8.</p>
<h2 id="default-tls-version-and-ciphers">Default TLS Version and Ciphers<a class="headerlink" href="#default-tls-version-and-ciphers" title="Permanent link">&para;</a></h2> <h2 id="default-tls-version-and-ciphers">Default TLS Version and Ciphers<a class="headerlink" href="#default-tls-version-and-ciphers" title="Permanent link">&para;</a></h2>
<p>To provide the most secure baseline configuration possible, nginx-ingress defaults to using TLS 1.2 and a <a href="https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/configmap.md#ssl-ciphers">secure set of TLS ciphers</a></p> <p>To provide the most secure baseline configuration possible,</p>
<h2 id="legacy-tls">Legacy TLS<a class="headerlink" href="#legacy-tls" title="Permanent link">&para;</a></h2> <p>nginx-ingress defaults to using TLS 1.2 only and a <a href="../nginx-configuration/configmap/#ssl-ciphers">secure set of TLS ciphers</a>.</p>
<p>The default configuration, though secure, does not support some older browsers and operating systems. For instance, 20% of Android phones in use today are not compatible with nginx-ingress's default configuration. To change this default behavior, use a <a href="https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/configmap.md#ssl-ciphers">ConfigMap</a>.</p> <h3 id="legacy-tls">Legacy TLS<a class="headerlink" href="#legacy-tls" title="Permanent link">&para;</a></h3>
<p>A sample ConfigMap to allow these older clients connect could look something like the following:</p> <p>The default configuration, though secure, does not support some older browsers and operating systems.</p>
<p>For instance, TLS 1.1+ is only enabled by default from Android 5.0 on. At the time of writing,
May 2018, <a href="https://developer.android.com/about/dashboards/#Platform">approximately 15% of Android devices</a>
are not compatible with nginx-ingress's default configuration.</p>
<p>To change this default behavior, use a <a href="../nginx-configuration/configmap/">ConfigMap</a>.</p>
<p>A sample ConfigMap fragment to allow these older clients to connect could look something like the following:</p>
<div class="codehilite"><pre><span></span><span class="n">kind</span><span class="o">:</span> <span class="n">ConfigMap</span> <div class="codehilite"><pre><span></span><span class="n">kind</span><span class="o">:</span> <span class="n">ConfigMap</span>
<span class="n">apiVersion</span><span class="o">:</span> <span class="n">v1</span> <span class="n">apiVersion</span><span class="o">:</span> <span class="n">v1</span>
<span class="n">metadata</span><span class="o">:</span> <span class="n">metadata</span><span class="o">:</span>