En esta página se explica cómo inspeccionar las cargas de trabajo con estado que se ejecutan en un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). Las cargas de trabajo con reconocimiento del estado te permiten ejecutar tu aplicación con almacenamiento de contenedores persistente. Puedes ver tus cargas de trabajo con estado con la consola de GDC o la CLI de kubectl para monitorizar el uso de recursos y el estado de las cargas de trabajo.
Esta página está dirigida a los desarrolladores del grupo de operadores de aplicaciones, que son responsables de gestionar las cargas de trabajo de las aplicaciones de su organización. Para obtener más información, consulta Audiencias de la documentación aislada de GDC.
Antes de empezar
Para ejecutar comandos en un clúster de Kubernetes, asegúrate de que tienes los siguientes recursos:
Busca el nombre del clúster de Kubernetes o pregunta a tu administrador de la plataforma cuál es.
Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes si no tienes uno.
Usa la ruta kubeconfig del clúster de Kubernetes para sustituir
KUBERNETES_CLUSTER_KUBECONFIGen estas instrucciones.
Para obtener los permisos necesarios para ver todas las cargas de trabajo implementadas en un proyecto, pide al administrador de gestión de identidades y accesos de tu organización que te conceda el rol Lector 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, pide a tu administrador de gestión de identidades y accesos de la organización que te conceda el rol Administrador de espacio de nombres (namespace-admin) en el espacio de nombres de tu proyecto.
Ver las cargas de trabajo de contenedor de un proyecto
Para ver las cargas de trabajo de los contenedores de tu proyecto, haz lo siguiente:
Consola
En el menú de navegación, selecciona Kubernetes Engine > Cargas de trabajo.
Puedes ver los detalles de tus cargas de trabajo de contenedor, como los siguientes:
- Nombre
- Tipo
- Número de pods
- Clúster de Kubernetes
- Fecha de última modificación
Las cargas de trabajo de los contenedores se organizan según el clúster de Kubernetes al que pertenecen. Selecciona el menú desplegable Clúster para cambiar el contexto del clúster.
CLI
Ejecuta el siguiente comando para enumerar todos los pods de tu proyecto:
kubectl get pods -n PROJECT_NAMESPACEEl resultado debería ser similar al siguiente:
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
Inspeccionar un recurso StatefulSet
Para solicitar información más detallada sobre los componentes de un StatefulSet
recurso, ejecuta comandos que se dirijan directamente a la entidad que quieras
inspeccionar.
Obtener información de objetos StatefulSet
Para obtener información detallada sobre el objeto StatefulSet, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe statefulset STATEFULSET_NAME
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el objetoStatefulSet.NAMESPACE: el espacio de nombres del proyecto.STATEFULSET_NAME: el nombre del objetoStatefulSet.
Mostrar 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get statefulset STATEFULSET_NAME -o yaml
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el objetoStatefulSet.NAMESPACE: el espacio de nombres del proyecto.STATEFULSET_NAME: el nombre del objetoStatefulSet.
Mostrar pods
Para enumerar los objetos Pod creados por StatefulSet, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get pods -l app=APP_NAME
En este comando, la marca -l muestra todos los objetos Pod etiquetados con APP_NAME.
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el objetoStatefulSet.NAMESPACE: el espacio de nombres del proyecto.APP_NAME: el nombre de la aplicación con estado gestionada por el objetoStatefulSet.
Obtener información específica sobre un pod
Para obtener información sobre un Pod específico del clúster, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe pod POD_NAME
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el pod.NAMESPACE: el espacio de nombres del proyecto.POD_NAME: el nombre del pod gestionado por el objetoStatefulSet.
Mostrar PVCs
Para enumerar los objetos PersistentVolumeClaim (PVC) del clúster, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get pvc
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta los PVCs.NAMESPACE: el espacio de nombres del proyecto.
Obtener información específica sobre PVC
Para obtener información sobre un PersistentVolumeClaim (PVC) específico del clúster, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe pvc PVC_NAME
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el PVC.NAMESPACE: el espacio de nombres del proyecto.PVC_NAME: el nombre del PVC configurado para el objetoStatefulSet.
Obtener información sobre la PV
Para obtener información sobre un PersistentVolume (PV) específico del clúster, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe pv PV_NAME
Haz los cambios siguientes:
KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta el PV.NAMESPACE: el espacio de nombres del proyecto.PV_NAME: el nombre del PV configurado para el objetoStatefulSet.