DevFW-CICD/ingress-nginx-helm
6
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Deploy GitHub Pages

Browse source
This commit is contained in:
k8s-ci-robot 2021-11-02 00:13:54 +00:00
parent fae0dc0303
commit e73476191a
23 changed files with 248 additions and 152 deletions
Download patch file Download diff file Expand all files Collapse all files

10
user-guide/fcgi-services/index.html
View file

@ -48,9 +48,13 @@
<span class="p p-Indicator">-</span> <span class=nt>host</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">app.example.com</span>
<span class=nt>http</span><span class=p>:</span>
<span class=nt>paths</span><span class=p>:</span>
<span class="p p-Indicator">-</span> <span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">example-service</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">fastcgi</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">example-service</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">fastcgi</span>
</code></pre></div> <h2 id=fastcgi-ingress-annotations>FastCGI Ingress Annotations<a class=headerlink href=#fastcgi-ingress-annotations title="Permanent link"></a></h2> <p>To enable FastCGI, the <code>nginx.ingress.kubernetes.io/backend-protocol</code> annotation needs to be set to <code>FCGI</code>, which overrides the default <code>HTTP</code> value.</p> <blockquote> <p><code>nginx.ingress.kubernetes.io/backend-protocol: "FCGI"</code></p> </blockquote> <p><strong>This enables the <em>FastCGI</em> mode for all paths defined in the <em>Ingress</em> object</strong></p> <h3 id=the-nginxingresskubernetesiofastcgi-index-annotation>The <code>nginx.ingress.kubernetes.io/fastcgi-index</code> Annotation<a class=headerlink href=#the-nginxingresskubernetesiofastcgi-index-annotation title="Permanent link"></a></h3> <p>To specify an index file, the <code>fastcgi-index</code> annotation value can optionally be set. In the example below, the value is set to <code>index.php</code>. This annotation corresponds to <a href=http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_index>the <em>NGINX</em> <code>fastcgi_index</code> directive</a>.</p> <blockquote> <p><code>nginx.ingress.kubernetes.io/fastcgi-index: "index.php"</code></p> </blockquote> <h3 id=the-nginxingresskubernetesiofastcgi-params-configmap-annotation>The <code>nginx.ingress.kubernetes.io/fastcgi-params-configmap</code> Annotation<a class=headerlink href=#the-nginxingresskubernetesiofastcgi-params-configmap-annotation title="Permanent link"></a></h3> <p>To specify <a href=http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_param><em>NGINX</em> <code>fastcgi_param</code> directives</a>, the <code>fastcgi-params-configmap</code> annotation is used, which in turn must lead to a <em>ConfigMap</em> object containing the <em>NGINX</em> <code>fastcgi_param</code> directives as key/values.</p> <blockquote> <p><code>nginx.ingress.kubernetes.io/fastcgi-params-configmap: "example-configmap"</code></p> </blockquote> <p>And the <em>ConfigMap</em> object to specify the <code>SCRIPT_FILENAME</code> and <code>HTTP_PROXY</code> <em>NGINX's</em> <code>fastcgi_param</code> directives will look like the following:</p> <p><div class=highlight><pre><span></span><code><span class=nt>apiVersion</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">v1</span>
<span class=nt>kind</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">ConfigMap</span>
<span class=nt>metadata</span><span class=p>:</span>

42
user-guide/ingress-path-matching/index.html
View file

@ -10,9 +10,12 @@
<span class=nt>http</span><span class=p>:</span>
<span class=nt>paths</span><span class=p>:</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/.*</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
</code></pre></div> <p>The preceding ingress definition would translate to the following location block within the NGINX configuration for the <code>test.com</code> server:</p> <div class=highlight><pre><span></span><code>location ~* &quot;^/foo/.*&quot; {
...
}
@ -26,13 +29,19 @@
<span class=nt>http</span><span class=p>:</span>
<span class=nt>paths</span><span class=p>:</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/bar</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service1</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service1</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/bar/</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service2</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service2</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
</code></pre></div> <div class=highlight><pre><span></span><code><span class=nt>apiVersion</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">networking.k8s.io/v1</span>
<span class=nt>kind</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Ingress</span>
<span class=nt>metadata</span><span class=p>:</span>
@ -45,9 +54,12 @@
<span class=nt>http</span><span class=p>:</span>
<span class=nt>paths</span><span class=p>:</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/bar/(.+)</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service3</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">service3</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
</code></pre></div> <p>The ingress controller would define the following location blocks, in order of descending length, within the NGINX template for the <code>test.com</code> server:</p> <div class=highlight><pre><span></span><code>location ~* ^/foo/bar/.+ {
...
}
@ -71,13 +83,19 @@ location ~* &quot;^/foo/bar&quot; {
<span class=nt>http</span><span class=p>:</span>
<span class=nt>paths</span><span class=p>:</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/bar/bar</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class="p p-Indicator">-</span> <span class=nt>path</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">/foo/bar/[A-Z0-9]{3}</span>
<span class=nt>pathType</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">Prefix</span>
<span class=nt>backend</span><span class=p>:</span>
<span class=nt>serviceName</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>servicePort</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
<span class=nt>service</span><span class=p>:</span>
<span class=nt>name</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">test</span>
<span class=nt>port</span><span class=p>:</span>
<span class=nt>number</span><span class=p>:</span> <span class="l l-Scalar l-Scalar-Plain">80</span>
</code></pre></div> <p>The ingress controller would define the following location blocks (in this order) within the NGINX template for the <code>test.com</code> server:</p> <div class=highlight><pre><span></span><code>location ~* &quot;^/foo/bar/[A-Z0-9]{3}&quot; {
...
}

11
user-guide/third-party-addons/opentracing/index.html
View file

@ -115,10 +115,13 @@ $ echo &#39;
- host: example.com
http:
paths:
- backend:
serviceName: echoheaders-x
servicePort: 80
path: /echo
- path: /echo
pathType: Prefix
backend:
service:
name: echoheaders-x
port:
number: 80
&#39; | kubectl apply -f -
</code></pre></div></p> </li> <li> <p>Enable OpenTracing and set the jaeger-collector-host: <div class=highlight><pre><span></span><code>$ echo &#39;
apiVersion: v1