Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
50 lines (37 sloc) 2.58 KB
The Ingress Resource specifies hostname(s) and path(s) mapping to a specific Service. The Ingress Controller uses Ingres Resources as a means of configuration.


{% hint style="info" %} Be careful when thinking about an "Ingress Resource"!

This should not be confused with the actual "Ingress Controller", which is just a pod running nginx that performs traffic routing as if you were performing a bunch of re-writes. {% endhint %}

Ingress with SSL & Basic Auth

Setting up Basic Auth is pretty straightforward as you only need to generate the htpasswd token and create the kubernetes secret before creating your ingress resource. If the htpasswd command isn't present on your machine you can install it with apt-get install apache2-utils.

Create credentials file & kubernetes secret

{% code-tabs %} {% code-tabs-item title="" %}

htpasswd -cb auth $(USERNAME) $(PASSWORD)kubectl create secret generic "nginx-ingress-basic-auth" --from-file="auth"The secret created will look like this:apiVersion: v1kind: Secretmetadata:  name: nginx-ingress-basic-authtype: Opaquedata:  auth: dXNlcjp5LWJhc2g1LkQuRlJTdDlvU0tieDByN2pFaXJiaHEuSmNLaUZScUJWRw==

{% endcode-tabs-item %} {% endcode-tabs %}

Create the ingress resource

{% code-tabs %} {% code-tabs-item title="ingress.yaml" %}

apiVersion: extensions/v1beta1kind: Ingressmetadata:  name: <hostname>  annotations: "nginx" basic nginx-ingress-basic-auth "Authentication Required - foo"spec:  tls:  - hosts:    - <hostname>    secretName: <tls secret name>  rules:  - host: $HOST    http:      paths:      - path: /service-a        backend:          serviceName: my-service-a          servicePort: 80      - path: /service-b        backend:          serviceName: my-service-b          servicePort: 80  

{% endcode-tabs-item %} {% endcode-tabs %}

Ingress with Sticky Sessions

{% code-tabs %} {% code-tabs-item title="ingress-sticky.yaml" %}

apiVersion: extensions/v1beta1  kind: Ingressmetadata:    name: nginx-test-sticky  annotations: "nginx" "cookie" "route" "sha1"spec:  rules:  - host: $HOST    http:      paths:      - path: /        backend:          serviceName: $SERVICE_NAME          servicePort: $SERVICE_PORT

{% endcode-tabs-item %} {% endcode-tabs %}

You can’t perform that action at this time.