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

@ -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
@ -550,20 +574,6 @@
<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="#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">
<a href="#source-ip-address" title="Source IP address" class="md-nav__link">
Source IP address
@ -630,8 +640,8 @@
<li class="md-nav__item">
<a href="../multiple-ingress/" title="Multiple ingress controllers" class="md-nav__link">
Multiple ingress controllers
<a href="../multiple-ingress/" title="Multiple Ingress controllers" class="md-nav__link">
Multiple Ingress controllers
</a>
</li>
@ -654,8 +664,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>
@ -667,13 +677,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>
@ -738,8 +748,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>
@ -750,8 +760,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>
@ -823,6 +833,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>
@ -913,8 +935,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>
@ -937,8 +959,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>
@ -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">
<a href="../../examples/multi-tls/README/" title="Multi TLS certificate termination" class="md-nav__link">
Multi TLS certificate termination
@ -1093,20 +1103,6 @@
<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="#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">
<a href="#source-ip-address" title="Source IP address" class="md-nav__link">
Source IP address
@ -1176,18 +1172,6 @@
<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>
<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>
@ -1253,13 +1237,13 @@ The previous behavior can be restored using <code class="codehilite">retry-non-i
</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">
<span class="md-flex__ellipsis">
<span class="md-footer-nav__direction">
Next
</span>
Multiple ingress controllers
Multiple Ingress controllers
</span>
</div>
<div class="md-flex__cell md-flex__cell--shrink">