Configurazione dei nomi di dominio con indirizzi IP statici

Autopilota Standard

---

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

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

Nota: questo tutorial utilizza il controller GKE Ingress integrato e non si applica al controller Ingress NGINX.

Obiettivi

Questo tutorial illustra i seguenti passaggi:

• Prenotare un indirizzo IP esterno statico per l'applicazione
• Configura Servizio o Risorse in entrata per utilizzare indirizzo IP statico
• Aggiorna i record DNS del tuo nome di dominio in modo che puntino alla tua applicazione

Costi

In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:

• GKE

Per generare una stima dei costi basata sull'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina Pulizia.

Prima di iniziare

Per abilitare l'API Kubernetes Engine, segui questi passaggi:

1. Visita la pagina di Kubernetes Engine nella console Google Cloud.
2. Crea o seleziona un progetto.
3. Attendi che l'API e i relativi servizi siano abilitati. L'operazione può richiedere diversi minuti.

4. Make sure that billing is enabled for your Google Cloud project.

Installa i seguenti strumenti a riga di comando usati in questo tutorial:

• gcloud viene utilizzato per creare ed eliminare i cluster Kubernetes Engine. gcloud è incluso nell'interfaccia a riga di comando gcloud.
• kubectl viene utilizzato per gestire Kubernetes, il sistema di orchestrazione dei cluster utilizzato in Kubernetes Engine. Puoi installare kubectl utilizzando gcloud:

  gcloud components install kubectl

Clona il codice di esempio da GitHub:

git clone https://github.com/GoogleCloudPlatform/kubernetes-engine-samples
cd kubernetes-engine-samples/quickstarts/hello-app/manifests

Configura valori predefiniti per lo strumento a riga di comando gcloud

Per risparmiare tempo, digita il tuo ID progetto e le opzioni per la zona di Compute Engine in gcloud a strumento a riga di comando, puoi configurare i valori predefiniti:

gcloud config set project project-id
gcloud config set compute/zone compute-zone

Crea un cluster

Crea un cluster:

gcloud container clusters create-auto domain-test

Esegui il deployment della tua applicazione web

Il manifest seguente 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:

• Utilizza un servizio, che crea un bilanciatore del carico di rete passthrough esterno che funziona con gli indirizzi IP a livello di regione.

• Utilizza una risorsa Ingress, che crea un Bilanciatore del carico delle applicazioni e supporta indirizzi IP globali.

Per saperne di più sui vantaggi e sugli svantaggi di ciascun metodo, vedi 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.

Nota: gli indirizzi IP statici non hanno costi se utilizzati da un bilanciatore del carico. Se prenoti un indirizzo IP statico e non lo utilizzi, ti viene addebitato un costo in base ai prezzi degli indirizzi IP inutilizzati.

Se scegli di esporre l'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 nel cluster.

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

Salva il file 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 servizio 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

Nota: il provisioning e la configurazione del bilanciatore del carico potrebbero richiedere alcuni minuti.

Utilizza un traffico Ingress

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

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

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

Nota: gli indirizzi IP statici non hanno costi se utilizzati da un bilanciatore del carico. Se prenoti un indirizzo IP statico e non lo utilizzi, ti viene addebitato un costo in base ai prezzi degli indirizzi IP inutilizzati.

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 Connettore di configurazione. Segui le istruzioni per l'installazione per installare Config Connector sul tuo 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 indirizzo IP statico con due risorse:

• Un Service con type:NodePort
• Un elemento 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

Nota: il provisioning e la configurazione del bilanciatore del carico potrebbero richiedere alcune minuti.

Visualizza il tuo 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 curl:

curl http://203.0.113.32/

L'output è simile al seguente:

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

Nota: potresti ricevere errori HTTP 404 e HTTP 500 per alcuni minuti se hai utilizzato un Ingress per configurare un bilanciatore del carico. La configurazione richiede tempo cambiamenti da propagarsi alle regioni di tutto il mondo.

Configurare i record dei nomi di dominio

Per fare in modo che i browser eseguano query sul tuo nome di dominio, ad esempio example.com o sul sottodominio qualsiasi nome, ad esempio blog.example.com, punta 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 dominio o sottodominio nome e hanno il suo valore configurato con l'indirizzo IP riservato

I record DNS del tuo dominio sono gestiti dal tuo server dei nomi. Il tuo server dei nomi potrebbe essere il "registrar" presso cui hai registrato il tuo 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 di �

• Se il server dei nomi è un altro provider: fai riferimento alle istruzioni del DNS della documentazione dei provider sull'impostazione dei record DNS A per configurare il nome di dominio. Se invece scegli di utilizzare Cloud DNS, consulta la sezione Eseguire la migrazione a Cloud DNS.

Visita il tuo nome di dominio

Per verificare che i record A del DNS del tuo nome di dominio corrispondano all'indirizzo IP che riservato, visita il tuo nome di dominio.

Nota: la propagazione dei record DNS può richiedere alcune ore. Questo periodo di tempo potrebbe dipendere sui tuoi server dei nomi, sul provider di servizi internet (ISP) locale e su molti altri e altri fattori.

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 puntare il browser web sul tuo nome di dominio e visitare sito web.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

1. Elimina il servizio e l'Ingress:

   kubectl delete ingress,service -l app=hello
   

2. Rilascia l'IP statico riservato. Una volta eliminato il bilanciatore del carico, Gli indirizzi IP inutilizzati ma riservati vengono fatturati in base al prezzo degli indirizzi IP inutilizzati.

   • Se hai utilizzato un Servizio:

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

   • Se hai utilizzato una risorsa Ingress:

     gcloud compute addresses delete helloweb-ip --global
     

3. Elimina l'applicazione di esempio:

   kubectl delete -f helloweb-deployment.yaml
   

4. Elimina il cluster:

   gcloud container clusters delete domain-test
   

Passaggi successivi

• Esplora altri tutorial su Kubernetes Engine.
• Esplora architetture di riferimento, diagrammi e best practice su Google Cloud. Consulta il nostro Cloud Architecture Center.