Inspecciona las cargas de trabajo con estado

En esta página, se explica cómo inspeccionar las cargas de trabajo con estado existentes que se ejecutan en un clúster de Kubernetes del dispositivo aislado de Google Distributed Cloud (GDC). Las cargas de trabajo con estado te permiten ejecutar tu aplicación con almacenamiento persistente de contenedores. Puedes ver tus cargas de trabajo con estado con la consola de GDC o la CLI de kubectl para supervisar el uso de recursos y el estado de la carga de trabajo.

Esta página está dirigida a los desarrolladores que forman parte del grupo de operadores de aplicaciones y que son responsables de administrar las cargas de trabajo de las aplicaciones de su organización.

Antes de comenzar

Para ejecutar comandos en el clúster de Kubernetes en equipos físicos preconfigurado, asegúrate de tener los siguientes recursos:

  1. Ubica el nombre del clúster de Kubernetes o pregúntale al administrador de la plataforma cuál es el nombre del clúster.

  2. Accede y genera el archivo kubeconfig para el clúster de Kubernetes si no tienes uno.

  3. Usa la ruta de acceso de kubeconfig del clúster de Kubernetes para reemplazar CLUSTER_KUBECONFIG en estas instrucciones.

Para obtener los permisos necesarios para ver todas las cargas de trabajo implementadas en un proyecto, pídele a tu administrador de IAM de la organización que te otorgue el rol de Visualizador de cargas de trabajo (workload-viewer) en el espacio de nombres de tu proyecto.

Para obtener los permisos necesarios para inspeccionar cargas de trabajo con estado, pídele al administrador de IAM de tu organización que te otorgue el rol de administrador de espacio de nombres (namespace-admin) en el espacio de nombres de tu proyecto.

Cómo ver las cargas de trabajo de contenedores de un proyecto

Ejecuta el siguiente comando para enumerar todos los Pods de tu proyecto:

kubectl get pods -n PROJECT_NAMESPACE

El resultado es similar a este:

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

Inspecciona un recurso StatefulSet

Para solicitar información más detallada sobre los componentes de un recurso StatefulSet, ejecuta comandos que se dirijan directamente a la entidad que deseas inspeccionar.

Obtén información del objeto StatefulSet

Para obtener información detallada sobre el objeto StatefulSet, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el objeto StatefulSet.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • STATEFULSET_NAME: Es el nombre del objeto StatefulSet.

Muestra la configuración activa en formato YAML

Para mostrar la configuración activa del recurso StatefulSet en formato YAML, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el objeto StatefulSet.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • STATEFULSET_NAME: Es el nombre del objeto StatefulSet.

Mostrar lista de pods

Para enumerar los objetos Pod creados por el StatefulSet, ejecuta el siguiente comando:

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

En este comando, la marca -l enumera todos los objetos Pod etiquetados con APP_NAME.

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el objeto StatefulSet.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • APP_NAME: Es el nombre de la aplicación con estado administrada por el objeto StatefulSet.

Obtén información específica sobre un pod

Para obtener información sobre un objeto Pod específico en el clúster, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el Pod.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • POD_NAME: Es el nombre del pod que administra el objeto StatefulSet.

Enumera los PVC

Para enumerar los objetos PersistentVolumeClaim (PVC) en el clúster, ejecuta el siguiente comando:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta los PVC.

  • NAMESPACE: Es el espacio de nombres del proyecto.

Obtén información específica sobre el PVC

Para obtener información sobre un PersistentVolumeClaim (PVC) específico en el clúster, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el PVC.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • PVC_NAME: Es el nombre de la PVC configurada para el objeto StatefulSet.

Obtén información sobre las PV

Para obtener información sobre un PersistentVolume (PV) específico en el clúster, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster de Kubernetes que ejecuta el PV.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • PV_NAME: Es el nombre del PV configurado para el objeto StatefulSet.