Passo 1: crea un servizio ClusterIP

Per ogni distribuzione di applicazione che vuoi esporre, crea un servizio ClusterIP Kubernetes. La tua applicazione deve essere esposta da un servizio Kubernetes per essere inclusa nel bilanciamento del carico Ingress.

kubectl expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

Passo 2: Impostare la terminazione di TLS con i certificati TLS e i segreti Kubernetes

Il certificato TLS deve essere memorizzato come segreto Kubernetes in ogni spazio dei nomi in cui sono presenti le applicazioni.

• Per utilizzare il sottodominio di Ingress fornito da IBM, vedere Impostazione dei segreti TLS per il sottodominio Ingress fornito da IBM.

• Per utilizzare un dominio personalizzato, vedere Impostazione dei segreti TLS per i sottodomini personalizzati.

Passo 3: Crea la risorsa Ingress

Crea la risorsa Ingress per definire le regole di instradamento che il controller Ingress utilizza per instradare il traffico verso il tuo servizio app.

1. Crea la risorsa Ingress in un file YAML.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: my-ingress-resource
   spec:
     ingressClassName: public-iks-k8s-nginx
     tls:
     - hosts:
       - <domain_name>
       secretName: <tls_secret_name>
     rules:
     - host: HOSTNAME
       http:
         paths:
         - path: <app_path_1>
           pathType: Prefix
           backend:
             service:
               name: <app_service_1>
               port:
                 number: 80
         - path: <app_path_2>
           pathType: Prefix
           backend:
             service:
               name: <app_service_2>
               port:
                 number: 80
   

Campi di risorse

ingressClassName

Il nome della classe Ingress. Le classi Ingress IBMfornite sono public-iks-k8s-nginx per gli ALB pubblici e private-iks-k8s-nginx per gli ALB privati.

tls.hosts

Per utilizzare TLS, sostituisci <domain> con il sottodominio Ingress fornito da IBM o con il tuo dominio personalizzato.

tls.secretName

Sostituire <tls_secret_name> con il nome del segreto Kubernetes in cui è memorizzato il certificato TLS.

host

Sostituisci <domain> con il sottodominio Ingress fornito da IBM o con il tuo dominio personalizzato.

path

Sostituisci " <app_path> " con una barra o con il percorso su cui la tua app è in ascolto. Il percorso viene aggiunto al dominio Ingress specificato per creare un percorso univoco verso la tua app. Quando immetti questa rotta in un browser web, il traffico di rete viene instradato all'ALB. L'ALB cerca il servizio associato e invia il traffico di rete al servizio. Il servizio inoltra quindi il traffico ai pod in cui è in esecuzione l'app.

pathType

Il metodo di corrispondenza dei percorsi URL. I valori supportati sono ImplementationSpecific, Exact o Prefix. Per maggiori informazioni ed esempi su ciascun tipo di percorso, consultare la documentazione della community Kubernetes.

service.name

Sostituisci app1_service e app2_service, e così via, con il nome dei servizi che hai creato per rendere accessibili le tue app. Assicurarsi che le app specificate si trovino nello stesso spazio dei nomi.

service.name

Sostituisci <app1_service> e <app2_service>, e così via, con il nome dei servizi che hai creato per rendere accessibili le tue app. Assicurarsi che le app specificate si trovino nello stesso spazio dei nomi.

service.port.number

La porta su cui è in ascolto il tuo servizio. Utilizza la stessa porta che hai definito quando hai creato il servizio Kubernetes per la tua applicazione.

2. Applica la risorsa Ingress al tuo cluster. Assicurati che la risorsa venga distribuita nello stesso spazio dei nomi dei servizi dell'applicazione che hai specificato nella risorsa.

   kubectl apply -f community-ingress-resource.yaml -n <namespace>
   

Passo 4: verifica la tua configurazione Ingress

1. Elenca i tuoi ALB e copia l'indirizzo IP (classico) o il nome host (VPC) per un ALB che esegue l'immagine Ingress Kubernetes. Nell'output, scegli un ALB che abbia un Build nel formato <community_version>_<ibm_build>_iks.

   ibmcloud ks ingress alb ls -c CLUSTER
   

2. Utilizza l'indirizzo IP dell'ALB (classico) o il nome host (VPC), il percorso dell'applicazione e il tuo dominio per verificare che puoi inviare correttamente il traffico alla tua applicazione tramite questo ALB.

   curl http://<ALB_IP>/<app_path> -H "Host: <ingress_subdomain>"
   

   Ad esempio, per inviare una richiesta a un'applicazione denominata myapp utilizzando un dominio secondario Ingress predefinito, immetti il seguente comando.

   curl http://169.X.X.X/myapp -H "Host: mycluster-a1b2cdef345678g9hi012j3kl4567890-0000.us-south.containers.appdomain.cloud"
   

Hai problemi a connetterti alla tua applicazione tramite Ingress? Consulta Risoluzione dei problemi relativi a Ingress. È possibile verificare lo stato di funzionamento e lo stato dei propri componenti Ingress eseguendo il comando ibmcloud ks ingress status-report get -c CLUSTER_NAME_OR_ID.

Creazione di domini personalizzati per ALB pubblici

Segui la procedura per creare un dominio personalizzato per gli ALB pubblici.

1. Crea un dominio personalizzato. Per registrare il tuo dominio personalizzato, opera con il provider DNS (Domain Name Service) o il DNS IBM Cloud. Se le applicazioni che vuoi che Ingress esponga si trovano in spazi dei nomi diversi in un cluster, registra il dominio personalizzato come dominio jolly, ad esempio *.custom_domain.net. Nota che i domini sono limitati a 130 caratteri o meno in Kubernetes versione 1.20 o successive.

2. Definisci un alias per il tuo dominio personalizzato specificando il dominio secondario fornito da IBM come record di nome canonico (CNAME). Per individuare il dominio Ingress fornito da IBM, esegui ibmcloud ks cluster get --cluster CLUSTER_NAME e cerca il campo " Ingress subdomain ".

   L'indicazione del sottodominio fornito da IBM come CNAME è necessaria per i controlli sanitari automatici che rimuovono eventuali IP non funzionanti dalla risposta DNS e per garantire che il dominio personalizzato si aggiorni quando si aggiungono o rimuovono gli ALB.

Creazione di domini personalizzati per ALB privati

Attieniti alla procedura per creare un dominio personalizzato per gli ALB privati. Tieni presente che i domini personalizzati sono richiesti per utilizzare Ingress con gli ALB privati.

Se hai un cluster classico con solo una VLAN privata, devi prima configurare il tuo servizio DNS disponibile sulla tua rete privata.

1. Crea un dominio personalizzato tramite il tuo provider di servizi DNS. Nota che gli URL Ingress devono avere una lunghezza massima di 130 caratteri.

2. Associa il tuo dominio personalizzato agli ALB privati aggiungendo i loro indirizzi IP come record A (cluster classici) o il loro nome host VPC come CNAME (cluster VPC). Per trovare gli indirizzi IP ALB (classico) o il nome host (VPC), esegui ibmcloud ks ingress alb ls -c CLUSTER_NAME_OR_ID.