Ispeziona i carichi di lavoro stateful

Questa pagina spiega come ispezionare i carichi di lavoro stateful esistenti in esecuzione in un cluster Kubernetes dell'appliance air-gapped Google Distributed Cloud (GDC). I carichi di lavoro stateful ti consentono di eseguire l'applicazione con l'archiviazione container persistente. Puoi visualizzare i carichi di lavoro stateful con la console GDC o l'interfaccia a riga di comando kubectl per monitorare l'utilizzo delle risorse e l'integrità dei carichi di lavoro.

Questa pagina è rivolta agli sviluppatori del gruppo di operatori di applicazioni, responsabili della gestione dei carichi di lavoro delle applicazioni per la loro organizzazione.

Prima di iniziare

Per completare le attività descritte in questo documento, devi richiedere le autorizzazioni necessarie e preparare l'ambiente.

Richiedi ruoli IAM

Chiedi all'amministratore IAM dell'organizzazione di concederti i seguenti ruoli nello spazio dei nomi del progetto in base all'attività da eseguire:

  • Visualizzatore carichi di lavoro (workload-viewer): visualizza tutti i carichi di lavoro di cui è stato eseguito il deployment in un cluster.
  • Amministratore dello spazio dei nomi (namespace-admin): crea, elimina, modifica o visualizza i carichi di lavoro nello spazio dei nomi del progetto di un cluster.

Prepara l'ambiente

Per eseguire i comandi sul cluster Kubernetes bare metal preconfigurato, assicurati di disporre delle seguenti risorse:

  1. Individua il nome del cluster Kubernetes o chiedi all'amministratore della piattaforma qual è il nome del cluster.

  2. Accedi e genera il file kubeconfig per il cluster Kubernetes, se non ne hai uno.

  3. Utilizza il percorso kubeconfig del cluster Kubernetes per sostituire CLUSTER_KUBECONFIG in queste istruzioni.

Visualizza i carichi di lavoro dei container di un progetto

Esegui il comando seguente per elencare tutti i pod nel tuo progetto:

kubectl get pods -n PROJECT_NAMESPACE

L'output è simile al seguente:

NAME                        READY   STATUS    RESTARTS   AGE
nginx-workload-ah-aa-1228   1/1     Running   0          12h
nginx-workload-ah-ab-6784   1/1     Running   0          11h
nginx-workload-ah-ac-0045   1/1     Running   0          12h

Ispeziona una risorsa StatefulSet

Per richiedere informazioni più dettagliate sui componenti di una risorsa StatefulSet, esegui i comandi che hanno come target diretto l'entità che vuoi ispezionare.

Ottieni informazioni sull'oggetto StatefulSet

Per ottenere informazioni dettagliate sull'oggetto StatefulSet, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe statefulset STATEFULSET_NAME

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue l'oggetto StatefulSet.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • STATEFULSET_NAME: il nome dell'oggetto StatefulSet.

Visualizza la configurazione live in formato YAML

Per visualizzare la configurazione live della risorsa StatefulSet in formato YAML, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get statefulset STATEFULSET_NAME -o yaml

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue l'oggetto StatefulSet.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • STATEFULSET_NAME: il nome dell'oggetto StatefulSet.

Elenca pod

Per elencare gli oggetti Pod creati da StatefulSet, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l app=APP_NAME

In questo comando, il flag -l elenca tutti gli oggetti Pod etichettati con APP_NAME.

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue l'oggetto StatefulSet.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • APP_NAME: il nome dell'applicazione stateful gestita dall'oggetto StatefulSet.

Ottieni informazioni specifiche sui pod

Per ottenere informazioni su un Pod specifico nel cluster, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pod POD_NAME

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue il pod.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • POD_NAME: il nome del pod gestito dall'oggetto StatefulSet.

Elenca PVC

Per elencare gli oggetti PersistentVolumeClaim (PVC) nel cluster, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig del cluster Kubernetes che esegue i PVC.

  • NAMESPACE: lo spazio dei nomi del progetto.

Ottieni informazioni specifiche sui PVC

Per ottenere informazioni su un PersistentVolumeClaim (PVC) specifico nel cluster, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pvc PVC_NAME

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue il PVC.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • PVC_NAME: il nome del PVC configurato per l'oggetto StatefulSet.

Ottieni informazioni sui PV

Per ottenere informazioni su un PersistentVolume (PV) specifico nel cluster, esegui:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pv PV_NAME

Sostituisci quanto segue:

  • CLUSTER_KUBECONFIG: il file kubeconfig per il cluster Kubernetes che esegue il PV.

  • NAMESPACE: lo spazio dei nomi del progetto.

  • PV_NAME: il nome del PV configurato per l'oggetto StatefulSet.