Configurazione dei nomi di dominio con indirizzi IP statici

Questo tutorial mostra come utilizzare Google Kubernetes Engine (GKE) per esporre la tua applicazione web su internet utilizzando un indirizzo IP esterno statico e configurare un nome di dominio in modo che punti alla tua applicazione.

Questo tutorial presuppone che tu sia proprietario di un nome di dominio registrato, ad esempio example.com.

Esegui il deployment dell'applicazione web

Il seguente manifest descrive un deployment che esegue un'immagine container di un'applicazione web di esempio:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: helloweb
  labels:
    app: hello
spec:
  selector:
    matchLabels:
      app: hello
      tier: web
  template:
    metadata:
      labels:
        app: hello
        tier: web
    spec:
      containers:
      - name: hello-app
        image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0
        ports:
        - containerPort: 8080
        resources:
          requests:
            cpu: 200m

Crea il deployment:

kubectl apply -f helloweb-deployment.yaml

Esporre l'applicazione

Puoi esporre la tua applicazione su GKE utilizzando uno dei seguenti metodi:

Per saperne di più sui vantaggi e gli svantaggi di ciascun metodo, consulta Configurazione di un bilanciatore del carico delle applicazioni esterno con Ingress.

Utilizzare un servizio

Per assicurarti che la tua applicazione abbia un indirizzo IP esterno statico, devi prenotare un indirizzo IP statico.

Se scegli di esporre la tua applicazione utilizzando un servizio, devi creare un indirizzo IP regionale. Gli indirizzi IP globali funzionano solo con il tipo di risorsa Ingress, come spiegato nella sezione successiva.

Per utilizzare un servizio, crea un indirizzo IP statico denominato helloweb-ip nella regione us-central1:

gcloud 

gcloud compute addresses create helloweb-ip --region us-central1

Trova l'indirizzo IP statico che hai creato:

gcloud compute addresses describe helloweb-ip --region us-central1

L'output è simile al seguente:

...
address: 203.0.113.32
...

Config Connector

Nota: questo passaggio richiede Config Connector. Segui le istruzioni di installazione per installare Config Connector sul cluster.

apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeAddress
metadata:
  name: helloweb-ip
spec:
  location: us-central1

Salva il manifest come compute-address-regional.yaml.

Applica il manifest al cluster:

  kubectl apply -f compute-address-regional.yaml

Trova l'indirizzo IP statico che hai creato:

  kubectl get computeaddress helloweb-ip -o jsonpath='{.spec.address}'

Il seguente manifest descrive un Service di tipo LoadBalancer, che crea un bilanciatore del carico di rete passthrough esterno per esporre i pod con un indirizzo IP esterno.

Sostituisci YOUR.IP.ADDRESS.HERE con l'indirizzo IP statico:

apiVersion: v1
kind: Service
metadata:
  name: helloweb
  labels:
    app: hello
spec:
  selector:
    app: hello
    tier: web
  ports:
  - port: 80
    targetPort: 8080
  type: LoadBalancer
  loadBalancerIP: "YOUR.IP.ADDRESS.HERE"

Crea il servizio:

kubectl apply -f helloweb-service-static-ip.yaml

Visualizza l'indirizzo IP riservato associato al bilanciatore del carico:

kubectl get service

L'output è simile al seguente:

NAME               CLUSTER-IP      EXTERNAL-IP      PORT(S)          AGE
helloweb           10.31.254.176   203.0.113.32     80:30690/TCP     54s

Utilizzare una risorsa Ingress

Se scegli di esporre la tua applicazione utilizzando un Ingress, devi prenotare un indirizzo IP statico globale. Utilizza l'annotazione kubernetes.io/ingress.global-static-ip-name per specificare un indirizzo IP globale.

Per esporre la tua applicazione a client e servizi in una regione, utilizza un indirizzo IP interno statico regionale durante il deployment di una risorsa Ingress interna per GKE insieme alle annotazioni richieste.

Per scoprire come utilizzare Ingress per esporre le tue applicazioni a internet, consulta Configurazione di un bilanciatore del carico delle applicazioni esterno con Ingress.

Per creare un indirizzo IP statico globale denominato helloweb-ip:

gcloud

gcloud compute addresses create helloweb-ip --global

Trova l'indirizzo IP statico che hai creato:

gcloud compute addresses describe helloweb-ip --global

L'output è simile al seguente:

...
address: 203.0.113.32
...

Config Connector

Nota: questo passaggio richiede Config Connector. Segui le istruzioni di installazione per installare Config Connector sul cluster.

apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeAddress
metadata:
  name: helloweb-ip
spec:
  location: global

Salva il manifest come compute-address-global.yaml.

Applica il manifest al cluster:

  kubectl apply -f compute-address-global.yaml

Il seguente manifest descrive un Ingress che espone un'applicazione web su un IP statico con due risorse:

  • Un Service con type:NodePort
  • Un Ingress configurato con il nome del servizio e l'annotazione IP statico
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: helloweb
  annotations:
    kubernetes.io/ingress.global-static-ip-name: helloweb-ip
  labels:
    app: hello
spec:
  defaultBackend:
    service:
      name: helloweb-backend
      port:
        number: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: helloweb-backend
  labels:
    app: hello
spec:
  type: NodePort
  selector:
    app: hello
    tier: web
  ports:
  - port: 8080
    targetPort: 8080

L'annotazione kubernetes.io/ingress.global-static-ip-name specifica il nome della risorsa indirizzo IP globale da associare al bilanciatore del carico.

Applica il manifest al cluster:

kubectl apply -f helloweb-ingress-static-ip.yaml

Visualizza l'indirizzo IP associato al bilanciatore del carico:

kubectl get ingress

L'output è simile al seguente:

NAME       HOSTS     ADDRESS          PORTS     AGE
helloweb   *         203.0.113.32     80        4m

Visualizzare l'indirizzo IP statico prenotato

Per verificare che il bilanciatore del carico sia configurato correttamente, puoi utilizzare un browser web per visitare l'indirizzo IP o utilizzare curl:

curl http://203.0.113.32/

L'output è simile al seguente:

Hello, world!
Hostname: helloweb-3766687455-8lvqv

Configurare i record del nome di dominio

Per fare in modo che i browser eseguano query sul tuo nome di dominio, ad esempio example.com, o sul nome del sottodominio, ad esempio blog.example.com, in modo che puntino all'indirizzo IP statico che hai prenotato, devi aggiornare i record DNS (Domain Name Server) del tuo nome di dominio.

Devi creare un record DNS di tipo A (indirizzo) per il tuo nome di dominio o sottodominio e configurarne il valore con l'indirizzo IP riservato.

I record DNS del tuo dominio sono gestiti dal server dei nomi. Il server dei nomi potrebbe essere il "registrar" presso cui hai registrato il dominio, un servizio DNS come Cloud DNS o un altro provider di terze parti.

  • Se il tuo server dei nomi è Cloud DNS:segui la guida rapida di Cloud DNS per configurare il record A DNS per il tuo nome di dominio con l'indirizzo IP riservato della tua applicazione.

  • Se il tuo server dei nomi è un altro provider: consulta la documentazione del tuo provider DNS per configurare il nome di dominio impostando i record A DNS. Se scegli di utilizzare Cloud DNS, consulta Migrazione a Cloud DNS.

Visita il tuo nome di dominio

Per verificare che i record A DNS del tuo nome di dominio vengano risolti nell'indirizzo IP che hai riservato, visita il tuo nome di dominio.

Per eseguire una query DNS per il record A del tuo nome di dominio, esegui il comando host:

host example.com

L'output è simile al seguente:

example.com has address 203.0.113.32

Ora puoi indirizzare il browser web al tuo nome di dominio e visitare il tuo sito web.