Deployment di un'applicazione Linux stateless

Autopilot Standard

---

Questa pagina spiega come eseguire il deployment di un'applicazione Linux stateless utilizzando Google Kubernetes Engine (GKE). Puoi anche scoprire come eseguire il deployment di un'applicazione Windows stateless.

Panoramica

Le applicazioni stateless sono applicazioni che non archiviano i dati o lo stato dell'applicazione nel cluster o in uno spazio di archiviazione permanente. I dati e lo stato dell'applicazione rimangono invece nel client, il che rende le applicazioni stateless più scalabili. Ad esempio, un'applicazione frontend è senza stato: esegui il deployment di più repliche per aumentarne la disponibilità e fare lo scale down quando la domanda è bassa e le repliche non hanno bisogno di identità univoche.

Kubernetes utilizza il controllore Deployment per eseguire il deployment di applicazioni stateless come pod uniformi e non univoci. I deployment gestiscono lo stato desiderato della tua applicazione: quanti pod devono eseguire l'applicazione, quale versione dell'immagine del container deve essere eseguita, come devono essere etichettati i pod e così via. Lo stato preferito può essere modificato in modo dinamico tramite gli aggiornamenti della specifica del pod del deployment.

Le applicazioni stateless sono diverse dalle applicazioni stateful, che utilizzano spazio di archiviazione permanente per salvare i dati e che utilizzano StatefulSets per eseguire il deployment di pod con identità univoche.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

• Attiva l'API Google Kubernetes Engine.
Attiva l'API Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.
  Nota: per le installazioni esistenti di gcloud CLI, assicurati di impostare le proprietà compute/region e compute/zone. Se imposti le posizioni predefinite, puoi evitare errori in gcloud CLI come il seguente: One of [--zone, --region] must be supplied: Please specify location.

• Assicurati che l'applicazione containerizzata sia archiviata in un registry delle immagini, ad esempio Artifact Registry.

• Se non hai mai utilizzato GKE, ti consigliamo di completare la guida rapida, in cui attiverai l'API GKE e scoprirai come funziona il prodotto.

Anatomia di un deployment

Di seguito è riportato un esempio di un semplice file manifest di Deployment. Questo deployment crea tre pod replicati etichettati come run=my-app che eseguono l'immaginehello-app archiviata in Artifact Registry:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      run: my-app
  template:
    metadata:
      labels:
        run: my-app
    spec:
      containers:
      - name: hello-app
        image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

In questo esempio:

• .spec.replicas: è il numero di pod replicati gestiti dal deployment.
• .spec.template.metadata.labels: è l'etichetta assegnata a ciascun pod, che il deployment utilizza per gestirli.
• .spec.template.spec: è la specifica del pod, che definisce la modalità di esecuzione di ciascun pod. spec.containers include il nome del contenitore da eseguire in ogni pod e l'immagine del contenitore da eseguire.

Per ulteriori informazioni sulla specifica di Deployment, consulta la documentazione di riferimento dell'API Deployment.

Creazione di un deployment

Puoi creare un deployment utilizzando uno dei seguenti metodi:

• Puoi utilizzare la funzionalità di deployment nel menu Workload della console Google Cloud per creare un semplice deployment da un'immagine container archiviata in Artifact Registry.

• Puoi scrivere un manifest di deployment ed eseguire kubectl apply per creare la risorsa

kubectl apply

Puoi creare e aggiornare in modo dichiarativo i deployment dai file manifest utilizzando kubectl apply. Questo metodo conserva anche gli aggiornamenti apportati alle risorse pubblicate senza unire nuovamente le modifiche ai file manifest.

Per creare un deployment dal relativo file manifest, esegui questo comando:

kubectl apply -f DEPLOYMENT_FILE

Sostituisci DEPLOYMENT_FILE con il file manifest, ad esempio config.yaml.

Puoi anche utilizzare kubectl apply -f DIRECTORY/ per creare tutti gli oggetti (tranne quelli esistenti) definiti nei file manifest archiviati in una directory.

Nota: kubectl apply non va a buon fine se non hai un cluster attivo.

Console

Per creare un deployment, svolgi i seguenti passaggi:

1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

   Vai a Carichi di lavoro

2. Fai clic su Esegui il deployment.

3. In Specifica contenitore, seleziona una delle seguenti opzioni:

   • Immagine container esistente per scegliere un'immagine container disponibile su Artifact Registry o Docker Hub. In Percorso immagine, inserisci il percorso dell'immagine del contenitore e la versione.

   • Nuova immagine container per utilizzare un'immagine creata con Cloud Source Repositories e Cloud Build.

4. Se vuoi, configura il deployment con:

   • Variabili di ambiente da passare al container.
   • Comandi iniziali per personalizzare il punto di ingresso del container in fase di esecuzione.

5. Fai clic su Fine, quindi su Continua.

6. Nella sezione Configurazione, assegna al deployment un nome dell'applicazione e specifica lo spazio dei nomi Kubernetes in cui eseguirlo.

7. Se vuoi, in Etichette puoi aggiungere Etichette Kubernetes al deployment.

8. Per salvare il file YAML che crea questo deployment per aggiornarlo in un secondo momento, fai clic su Visualizza YAML. Copia e incolla il codice YAML in un file, quindi salvalo e fai clic su Chiudi nella finestra di dialogo Output YAML.

9. Dal menu a discesa Cluster Kubernetes, scegli il cluster che ti interessa.

10. Fai clic su Esegui il deployment.

Ispezione del deployment

Dopo aver creato un deployment, puoi utilizzarne uno dei seguenti metodi per esaminarlo:

• Puoi utilizzare il menu Carichi di lavoro

• Puoi utilizzare kubectl describe e kubectl get

kubectl

Per ottenere informazioni dettagliate sul deployment, esegui il seguente comando:

kubectl describe deployment DEPLOYMENT_NAME

Sostituisci DEPLOYMENT_NAME con il nome del deployment.

Per elencare i pod creati dal deployment, esegui il seguente comando:

kubectl get pods -l KEY=VALUE

In questo comando, il flag -l indica a kubectl di recuperare tutti i pod con un'etichetta chiave-valore. Ad esempio, se hai etichettato il deployment run: my-app, dovresti eseguire kubectl get pods -l run=my-app per visualizzare i pod con quell'etichetta.

Per ottenere informazioni su un pod specifico:

kubectl describe pod POD_NAME

Per visualizzare il manifest di un deployment, esegui il seguente comando:

kubectl get deployments DEPLOYMENT_NAME -o yaml

Questo comando mostra la configurazione attiva del deployment in formato YAML.

Console

Per ispezionare un deployment, svolgi i seguenti passaggi:

1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

   Vai a Carichi di lavoro

2. Nell'elenco dei workload, fai clic sul nome del deployment da ispezionare.

3. Nella pagina Dettagli di implementazione, esegui una delle seguenti operazioni:

   • Fai clic sulla scheda Cronologia delle revisioni per visualizzare la cronologia delle revisioni del deployment.
   • Fai clic sulla scheda Eventi per visualizzare tutti gli eventi relativi al deployment.
   • Fai clic sulla scheda Log per visualizzare i log delle attività dei container nel deployment.
   • Fai clic sulla scheda YAML per visualizzare, copiare e scaricare il manifest YAML per il deployment.

Aggiornamento del deployment

Puoi implementare gli aggiornamenti della specifica del pod di un deployment, ad esempio l'immagine, l'utilizzo/le richieste di risorse o la configurazione.

Puoi aggiornare un deployment utilizzando i seguenti metodi:

• Puoi utilizzare il menu Aggiornamento in sequenza e l'editor YAML dal menu Carichi di lavoro della console Google Cloud.
• Puoi apportare modifiche a un file manifest e applicarle con kubectl apply.
• Puoi aggiornare i campi image, resources o selector della specifica pod utilizzando kubectl set.

• Puoi aggiornare un deployment direttamente dalla shell o in un editor preferito utilizzando kubectl edit.

kubectl apply

Puoi aggiornare il deployment applicando un file manifest nuovo o aggiornato. Questo è utile per apportare varie modifiche al deployment, ad esempio per il scaling o per specificare una nuova versione dell'applicazione.

Nota: per aggiornare una risorsa con kubectl apply, la risorsa deve essere stata creata utilizzando kubectl apply o kubectl create --save-config.

Per aggiornare un deployment, esegui il comando seguente:

kubectl apply -f DEPLOYMENT_FILE

Sostituisci DEPLOYMENT_FILE con il file manifest aggiornato.

Il comando kubectl apply applica un file manifest a una risorsa. Se la risorsa specificata non esiste, viene creata dal comando.

kubectl set

Puoi utilizzare kubectl set per modificare l'immagine, le risorse (richieste o limiti) o i campi del selettore di un deployment.

Per modificare l'immagine di un deployment, esegui il seguente comando:

kubectl set image deployment DEPLOYMENT_NAME IMAGE IMAGE:TAG

Ad esempio, per aggiornare un deployment dalla versione 1.7.9 di nginx alla versione 1.9.1, esegui il seguente comando:

kubectl set image deployment nginx nginx=nginx:1.9.1

Console

Per accedere al menu Aggiornamento in sequenza del deployment:

1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

   Vai a Carichi di lavoro

2. Nell'elenco dei workload, fai clic sul nome del deployment da modificare.

3. Fai clic su Azioni > Aggiornamento progressivo.

4. Configura i seguenti parametri facoltativi per la strategia di aggiornamento:

   • Numero minimo di secondi per essere pronto:specifica il numero minimo di secondi per cui i pod appena creati devono essere pronti per essere considerati disponibili.
   • Picco massimo:specifica il numero massimo di pod che possono essere creati rispetto al numero di pod desiderato. Il valore può essere un numero assoluto o una percentuale.
   • Numero massimo di istanze non disponibili:specifica il numero massimo di pod che possono non essere disponibili durante il processo di aggiornamento. Il valore può essere un numero assoluto o una percentuale.

5. In Immagini container, inserisci il percorso e la versione dell'immagine container aggiornata.

6. Fai clic su Aggiorna.

Eseguire il rollback di un aggiornamento

Puoi eseguire il rollback di un aggiornamento utilizzando kubectl rollout undo.

Puoi eseguire il rollback di un aggiornamento in corso o completato alla revisione precedente:

kubectl rollout undo deployment my-deployment

Puoi anche eseguire il rollback a una revisione specifica:

kubectl rollout undo deployment my-deployment --to-revision=3

Scalabilità di un deployment

Puoi scalare manualmente un deployment utilizzando la console Google Cloud o kubectl scale.

Puoi scoprire di più sui deployment con scalabilità automatica.

kubectl

kubectl scale può essere utilizzato in qualsiasi momento per scalare il deployment.

Per eseguire lo scaling manuale di un deployment, esegui il seguente comando:

kubectl scale deployment DEPLOYMENT_NAME --replicas NUMBER_OF_REPLICAS

Sostituisci NUMBER_OF_REPLICAS con il numero desiderato di pod replicati.

Console

Per eseguire il ridimensionamento di un deployment:

1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

   Vai a Carichi di lavoro

2. Nell'elenco dei workload, fai clic sul nome del deployment da modificare.

3. Fai clic su Azioni > Scala > Modifica repliche.

4. Inserisci il nuovo numero di Repliche per il deployment.

5. Fai clic su Scala.

Eliminazione di un deployment

Puoi eliminare un deployment utilizzando la console Google Cloud o kubectl delete.

kubectl

Per eliminare un deployment, esegui il seguente comando:

kubectl delete deployment DEPLOYMENT_NAME

Console

Per eliminare un deployment:

1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

   Vai a Carichi di lavoro

2. Nell'elenco dei carichi di lavoro, seleziona uno o più deployment da eliminare.

3. Fai clic su Elimina.

4. Quando ti viene richiesto di confermare, fai clic su Elimina.

Passaggi successivi

• Scopri di più sui deployment.
• Scopri di più sulle applicazioni con stato.