Una risorsa di ingresso Kubernetes fornisce il routing HTTP o HTTPS dall'esterno del cluster a uno o più servizi all'interno del cluster. I cluster di Tanzu Kubernetes supportano l'ingresso tramite controller di terze parti, ad esempio Nginx.

In questo tutorial viene illustrato come distribuire un servizio di ingresso Kubernetes basato su NGINX per il routing del traffico esterno ai servizi nel cluster di Tanzu Kubernetes. Un servizio in ingresso richiede un controller in ingresso. NGINX Ingress Controller viene installato utilizzando Helm. Helm è un gestore di pacchetti per Kubernetes.

Nota: Esistono diversi modi per eseguire questa attività. I passaggi descritti di seguito offrono un approccio. In base all'ambiente specifico, l'utente potrebbe ritenere altri approcci più adatti.

Prerequisiti

Procedura

  1. Installare Helm facendo riferimento alla documentazione.
  2. Installare NGINX Ingress Controller utilizzando Helm. 
    helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm install ingress-nginx ingress-nginx/ingress-nginx
  3. Verificare che Nginx Ingresso Controller sia distribuito come servizio di tipo LoadBalancer. 
    kubectl get services
    NAME                                 TYPE           CLUSTER-IP     EXTERNAL-IP   PORT(S)                      AGE
ingress-nginx-controller             LoadBalancer   10.16.18.20    10.19.14.76   80:30635/TCP,443:30873/TCP   59m
ingress-nginx-controller-admission   ClusterIP      10.87.41.25    <none>        443/TCP                      59m
  4. Eseguire un ping al bilanciamento del carico utilizzando l'indirizzo IP esterno. 
    ping 10.19.14.76
    Pinging 10.19.14.76 with 32 bytes of data:
Reply from 10.19.14.76: bytes=32 time<1ms TTL=62
Reply from 10.19.14.76: bytes=32 time=1ms TTL=62
  5. Verificare che Nginx Ingress Controller sia in esecuzione. 
    kubectl get pods
    NAME                                        READY   STATUS    RESTARTS   AGE
ingress-nginx-controller-7c6c46898c-v6blt   1/1     Running   0          76m
  6. Creare una risorsa di ingresso con una regola di ingresso e un percorso denominati ingress-hello.yaml. 
    apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: ingress-hello
spec:
  rules:
  - http:
      paths:
      - path: /hello
        backend:
          serviceName: hello
          servicePort: 80
  7. Distribuire la risorsa ingress-hello. 
    kubectl apply -f ingress-hello.yaml
    ingress.networking.k8s.io/ingress-hello created
  8. Verificare che la risorsa in ingresso sia distribuita.
    Si noti che l'indirizzo IP viene mappato all'IP esterno del controller in ingresso. 
    kubectl get ingress
    NAME            CLASS    HOSTS   ADDRESS         PORTS   AGE
ingress-hello   <none>   *       10.19.14.76     80      51m
  9. Creare un'app e un servizio di test Hello denominato ingress-hello-test.yaml. 
    kind: Service
apiVersion: v1
metadata:
  name: hello
spec:
  selector:
    app: hello
    tier: backend
  ports:
  - protocol: TCP
    port: 80
    targetPort: http
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello
spec:
  replicas: 3
  selector:
    matchLabels:
      app: hello
      tier: backend
      track: stable
  template:
    metadata:
      labels:
        app: hello
        tier: backend
        track: stable
    spec:
      containers:
        - name: hello
          image: "gcr.io/google-samples/hello-go-gke:1.0"
          ports:
            - name: http
              containerPort: 80
  10. Distribuire la risorsa ingress-hello-test. 
    kubectl apply -f ingress-hello-test.yaml
    service/hello created
deployment.apps/hello created
  11. Verificare che la distribuzione di hello sia disponibile. 
    kubectl get deployments
    NAME                       READY   UP-TO-DATE   AVAILABLE   AGE
hello                      3/3     3            3           4m59s
ingress-nginx-controller   1/1     1            1           3h39m
  12. Recuperare l'indirizzo IP pubblico del bilanciamento del carico utilizzato da Nginx Ingress Controller. 
    kubectl get ingress
    NAME            CLASS    HOSTS   ADDRESS         PORTS   AGE
ingress-hello   <none>   *       10.19.14.76     80      13m
  13. Utilizzando un browser, passare all'IP pubblico e includere il percorso di ingresso. 
    http://10.19.14.76/hello
    Viene restituito il messaggio "hello". 
    {"message":"Hello"}

risultati

Il browser accede esternamente all'app di back-end, avente come fron-end il servizio in esecuzione all'interno del cluster, tramite il controller di ingresso utilizzando l'indirizzo IP esterno del bilanciamento del carico.