Deploy GitHub Pages
This commit is contained in:
Travis Bot
parent
a078100980
commit
467b6d7499
54 changed files with 5641 additions and 2237 deletions
|
|
@ -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
|
||||
</span>
|
||||
<span class="md-header-nav__topic">
|
||||
Multiple ingress controllers
|
||||
Multiple Ingress controllers
|
||||
</span>
|
||||
|
||||
|
||||
|
|
@ -246,7 +246,7 @@
|
|||
|
||||
<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
|
||||
</a>
|
||||
|
||||
|
|
@ -360,6 +360,18 @@
|
|||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../../deploy/upgrade/" title="Upgrading" class="md-nav__link">
|
||||
Upgrading
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
</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">
|
||||
<a href="../exposing-tcp-udp-services/" title="Exposing TCP and UDP services" class="md-nav__link">
|
||||
Exposing TCP and UDP services
|
||||
|
|
@ -545,11 +569,11 @@
|
|||
|
||||
|
||||
<label class="md-nav__link md-nav__link--active" for="toc">
|
||||
Multiple ingress controllers
|
||||
Multiple Ingress controllers
|
||||
</label>
|
||||
|
||||
<a href="./" title="Multiple ingress controllers" class="md-nav__link md-nav__link--active">
|
||||
Multiple ingress controllers
|
||||
<a href="./" title="Multiple Ingress controllers" class="md-nav__link md-nav__link--active">
|
||||
Multiple Ingress controllers
|
||||
</a>
|
||||
|
||||
|
||||
|
|
@ -563,22 +587,8 @@
|
|||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#running-multiple-ingress-controllers" title="Running multiple ingress controllers" class="md-nav__link">
|
||||
Running multiple ingress 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 href="#multiple-ingress-nginx-controllers" title="Multiple ingress-nginx controllers" class="md-nav__link">
|
||||
Multiple ingress-nginx controllers
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
|
@ -612,8 +622,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../tls/" title="TLS" class="md-nav__link">
|
||||
TLS
|
||||
<a href="../tls/" title="TLS/HTTPS" class="md-nav__link">
|
||||
TLS/HTTPS
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -625,13 +635,13 @@
|
|||
|
||||
<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
|
||||
</label>
|
||||
<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
|
||||
</label>
|
||||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
|
@ -696,8 +706,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
|
||||
Prerequisites
|
||||
<a href="../../examples/" title="Ingress examples" class="md-nav__link">
|
||||
Ingress examples
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -708,8 +718,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../../examples/README/" title="Ingress examples" class="md-nav__link">
|
||||
Ingress examples
|
||||
<a href="../../examples/PREREQUISITES/" title="Prerequisites" class="md-nav__link">
|
||||
Prerequisites
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -781,6 +791,18 @@
|
|||
</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>
|
||||
</nav>
|
||||
</li>
|
||||
|
|
@ -871,8 +893,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link">
|
||||
Deploying the Nginx Ingress controller
|
||||
<a href="../../examples/customization/custom-vts-metrics-prometheus/README/" title="Custom VTS metrics with Prometheus" class="md-nav__link">
|
||||
Custom VTS metrics with Prometheus
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
|
@ -895,8 +917,8 @@
|
|||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../../examples/customization/ssl-dh-param/README/" title="Deploying the Nginx Ingress controller" class="md-nav__link">
|
||||
Deploying the Nginx Ingress controller
|
||||
<a href="../../examples/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>
|
||||
|
||||
|
|
@ -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">
|
||||
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
|
||||
Multi TLS certificate termination
|
||||
|
|
@ -1052,22 +1062,8 @@
|
|||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#running-multiple-ingress-controllers" title="Running multiple ingress controllers" class="md-nav__link">
|
||||
Running multiple ingress 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 href="#multiple-ingress-nginx-controllers" title="Multiple ingress-nginx controllers" class="md-nav__link">
|
||||
Multiple ingress-nginx controllers
|
||||
</a>
|
||||
|
||||
</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"></a>
|
||||
|
||||
|
||||
<h1 id="multiple-ingress-controllers">Multiple ingress controllers<a class="headerlink" href="#multiple-ingress-controllers" title="Permanent link">¶</a></h1>
|
||||
<h2 id="running-multiple-ingress-controllers">Running multiple ingress controllers<a class="headerlink" href="#running-multiple-ingress-controllers" title="Permanent link">¶</a></h2>
|
||||
<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: "nginx"</code> in all ingresses that you would like this 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>
|
||||
<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">'--default-backend-service=ingress/nginx-ingress-default-backend'</span>
|
||||
<span class="o">-</span> <span class="s1">'--election-id=ingress-controller-leader-internal'</span>
|
||||
<span class="o">-</span> <span class="s1">'--ingress-class=nginx-internal'</span>
|
||||
<span class="o">-</span> <span class="s1">'--configmap=ingress/nginx-ingress-internal-controller'</span>
|
||||
</pre></div>
|
||||
|
||||
|
||||
<h2 id="annotation-ingressclass">Annotation ingress.class<a class="headerlink" href="#annotation-ingressclass" title="Permanent link">¶</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>
|
||||
<h1 id="multiple-ingress-controllers">Multiple Ingress controllers<a class="headerlink" href="#multiple-ingress-controllers" title="Permanent link">¶</a></h1>
|
||||
<p>If you're running multiple ingress controllers, or running on a cloud provider that natively handles ingress such as GKE,
|
||||
you need to specify the annotation <code class="codehilite">kubernetes.io/ingress.class: "nginx"</code> in all ingresses that you would like the ingress-nginx controller to claim.</p>
|
||||
<p>For instance,</p>
|
||||
<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">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><strong>Note</strong>: Deploying multiple ingress controller and not specifying the annotation will result in both controllers fighting to satisfy the Ingress.</p>
|
||||
<h2 id="disabling-nginx-ingress-controller">Disabling NGINX ingress controller<a class="headerlink" href="#disabling-nginx-ingress-controller" title="Permanent link">¶</a></h2>
|
||||
<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>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.
|
||||
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>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">¶</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">'--default-backend-service=ingress/nginx-ingress-default-backend'</span>
|
||||
<span class="p p-Indicator">-</span> <span class="s">'--election-id=ingress-controller-leader-internal'</span>
|
||||
<span class="p p-Indicator">-</span> <span class="s">'--ingress-class=nginx-internal'</span>
|
||||
<span class="p p-Indicator">-</span> <span class="s">'--configmap=ingress/nginx-ingress-internal-controller'</span>
|
||||
</pre></div>
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue