Esegui il deployment di un'app in un cluster GKE

Esegui il deployment di un'app in un cluster GKE

Autopilot Standard

---

In questa guida rapida, eseguirai il deployment di una semplice applicazione containerizzata del server web in un cluster Google Kubernetes Engine (GKE). Imparerai a creare un cluster e a eseguire il deployment dell'applicazione nel cluster in modo che gli utenti possano accedervi.

Questa guida rapida presuppone una conoscenza di base di Kubernetes.

Prima di iniziare

Segui questi passaggi per abilitare l'API Kubernetes Engine:

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API Artifact Registry and Google Kubernetes Engine.

   Abilita le API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Abilita le API Artifact Registry and Google Kubernetes Engine.

   Abilita le API

Avvia Cloud Shell

In questo tutorial utilizzerai Cloud Shell, un ambiente shell per la gestione delle risorse ospitate su Google Cloud.

In Cloud Shell sono preinstallati lo strumento a riga di comando Google Cloud CLI e kubectl. gcloud CLI fornisce l'interfaccia a riga di comando principale per Google Cloud, mentre kubectl fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.

Avvia Cloud Shell:

1. Vai alla console Google Cloud.

   Console Google Cloud

2. Nell'angolo in alto a destra della console, fai clic sul pulsante Attiva Cloud Shell:

Si apre una sessione di Cloud Shell all'interno di un frame più in basso nella console. Utilizza questa shell per eseguire i comandi gcloud e kubectl. Prima di eseguire i comandi, imposta il progetto predefinito in Google Cloud CLI utilizzando questo comando:

gcloud config set project PROJECT_ID

Sostituisci PROJECT_ID con il tuo ID progetto.

crea un cluster GKE

Un cluster è costituito da almeno una macchina del piano di controllo del cluster e da più macchine worker denominate nodi. I nodi sono istanze di macchine virtuali (VM) Compute Engine che eseguono i processi Kubernetes necessari per renderle parte del cluster. Puoi eseguire il deployment delle applicazioni sui cluster e le applicazioni vengono eseguite sui nodi.

Crea un cluster Autopilot denominato hello-cluster:

gcloud container clusters create-auto hello-cluster \
    --location=us-central1

Nota: potrebbero essere necessari diversi minuti per completare la creazione del cluster.

recupera le credenziali di autenticazione per il cluster

Dopo aver creato il cluster, devi ottenere le credenziali di autenticazione per interagire con il cluster:

gcloud container clusters get-credentials hello-cluster \
    --location us-central1

Questo comando configura kubectl in modo che utilizzi il cluster che hai creato.

esegui il deployment di un'applicazione nel cluster

Ora che hai creato un cluster, puoi eseguire il deployment di un'applicazione containerizzata al suo interno. Per questa guida rapida, puoi eseguire il deployment della nostra applicazione web di esempio, hello-app.

GKE usa gli oggetti Kubernetes per creare e gestire le risorse del cluster. Kubernetes fornisce l'oggetto Deployment per eseguire il deployment di applicazioni stateless come i server web. Gli oggetti Service definiscono le regole e il bilanciamento del carico per l'accesso all'applicazione da internet.

Crea il deployment

Per eseguire hello-app nel cluster, devi eseguire il deployment dell'applicazione eseguendo questo comando:

kubectl create deployment hello-server \
    --image=us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Questo comando di Kubernetes, kubectl create deployment, crea un deployment denominato hello-server. Il pod del deployment esegue l'immagine container hello-app.

In questo comando:

• --image specifica l'immagine del container di cui eseguire il deployment. In questo caso, il comando estrae l'immagine di esempio da un repository Artifact Registry, us-docker.pkg.dev/google-samples/containers/gke/hello-app. :1.0 indica la versione specifica dell'immagine di cui eseguire il pull. Se non specifichi una versione, viene utilizzata l'immagine con il tag predefinito latest.

Esponi il deployment

Dopo aver eseguito il deployment dell'applicazione, devi esporla a internet in modo che gli utenti possano accedervi. Puoi esporre la tua applicazione creando un servizio, una risorsa Kubernetes che espone la tua applicazione al traffico esterno.

Per esporre la tua applicazione, esegui questo comando kubectl expose:

kubectl expose deployment hello-server \
    --type LoadBalancer \
    --port 80 \
    --target-port 8080

Se passi il flag --type LoadBalancer, viene creato un bilanciatore del carico di Compute Engine per il container. Il flag --port inizializza la porta pubblica 80 su internet, mentre il flag --target-port instrada il traffico alla porta 8080 dell'applicazione.

I bilanciatori del carico sono fatturati in base ai prezzi del bilanciatore del carico di Compute Engine.

Ispeziona e visualizza l'applicazione

1. Ispeziona i pod in esecuzione utilizzando kubectl get pods:

   kubectl get pods
   

   Dovresti vedere un pod hello-server in esecuzione sul tuo cluster.

2. Ispeziona il servizio hello-server utilizzando kubectl get service:

   kubectl get service hello-server
   

   Dall'output di questo comando, copia l'indirizzo IP esterno del servizio dalla colonna EXTERNAL-IP.

   Nota: potrebbe essere necessario attendere diversi minuti prima che venga completato l'indirizzo IP esterno del servizio. Se l'IP esterno dell'applicazione è <pending>, esegui di nuovo kubectl get.

3. Visualizza l'applicazione dal tuo browser web utilizzando l'indirizzo IP esterno con la porta esposta:

   http://EXTERNAL_IP
   

Hai appena eseguito il deployment di un'applicazione web containerizzata in GKE.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi:

1. Elimina il servizio dell'applicazione eseguendo kubectl delete:

   kubectl delete service hello-server
   

   Questo comando elimina il bilanciatore del carico di Compute Engine che hai creato quando hai esposto il deployment.

2. Elimina il cluster eseguendo gcloud container clusters delete:

   gcloud container clusters delete hello-cluster \
       --location us-central1
   

Facoltativo: revisione del codice hello-app

hello-app è una semplice applicazione server web composta da due file: main.go e un Dockerfile.

hello-app viene pacchettizzato come immagine container Docker. Le immagini container sono archiviate in qualsiasi registro di immagini Docker, come Artifact Registry. Ospitiamo hello-app in un repository Artifact Registry all'indirizzo us-docker.pkg.dev/google-samples/containers/gke/hello-app.

main.go

main.go è un'implementazione del server web scritta nel linguaggio di programmazione Go. Il server risponde a qualsiasi richiesta HTTP con un messaggio "Hello world!".

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	// register hello function to handle all requests
	mux := http.NewServeMux()
	mux.HandleFunc("/", hello)

	// use PORT environment variable, or default to 8080
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}

	// start the web server on port and accept requests
	log.Printf("Server listening on port %s", port)
	log.Fatal(http.ListenAndServe(":"+port, mux))
}

// hello responds to the request with a plain-text "Hello, world" message.
func hello(w http.ResponseWriter, r *http.Request) {
	log.Printf("Serving request: %s", r.URL.Path)
	host, _ := os.Hostname()
	fmt.Fprintf(w, "Hello, world!\n")
	fmt.Fprintf(w, "Version: 1.0.0\n")
	fmt.Fprintf(w, "Hostname: %s\n", host)
}

Dockerfile

Dockerfile descrive l'immagine che vuoi creare con Docker, incluse tutte le risorse e le dipendenze e specifica la porta di rete che deve essere esposta dall'app. Per ulteriori informazioni su come funziona questo file, consulta il riferimento Dockerfile nella documentazione di Docker.

FROM golang:1.21.0 as builder
WORKDIR /app
RUN go mod init hello-app
COPY *.go ./
RUN CGO_ENABLED=0 GOOS=linux go build -o /hello-app

FROM gcr.io/distroless/base-debian11
WORKDIR /
COPY --from=builder /hello-app /hello-app
ENV PORT 8080
USER nonroot:nonroot
CMD ["/hello-app"]

Passaggi successivi

• Scopri di più sulla creazione dei cluster.
• Scopri di più su Kubernetes.
• Scopri come pacchettizzare, ospitare ed eseguire il deployment di una semplice applicazione server web.
• Esegui il deployment di un'applicazione Kubernetes con Cloud Code for VS Code o Cloud Code for IntelliJ.
• Scopri come eseguire il replatforming delle applicazioni Linux ai container.

Provalo

Se non hai mai utilizzato Google Cloud, crea un account per valutare le prestazioni di GKE in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova GKE gratuitamente