Inspeccionar cargas de trabajo sin estado

En esta página se explica cómo inspeccionar las cargas de trabajo sin estado que se ejecutan en un clúster de Kubernetes de un dispositivo aislado de Google Distributed Cloud (GDC). Las cargas de trabajo sin estado te permiten ejecutar la implementación de tu aplicación sin tener que almacenar datos ni el estado de la aplicación. Puedes ver tus cargas de trabajo sin 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.

Antes de empezar

Para ejecutar comandos en el clúster de Kubernetes de Bare Metal preconfigurado, asegúrate de tener los siguientes recursos:

  1. Busca el nombre del clúster de Kubernetes o pregunta al administrador de la plataforma cuál es.

  2. Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes si no tienes uno.

  3. Usa la ruta kubeconfig del clúster de Kubernetes para sustituir CLUSTER_KUBECONFIG en 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 sin estado, pide a tu administrador de gestión de identidades y accesos de la organización que te conceda el rol de 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

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

kubectl get pods -n PROJECT_NAMESPACE

El 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 el despliegue

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

Obtener información de objetos Deployment

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

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe deployment DEPLOYMENT_NAME

Haz los cambios siguientes:

  • CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.

  • NAMESPACE: el espacio de nombres del proyecto.

  • DEPLOYMENT_NAME: el nombre del objeto Deployment.

Mostrar la configuración activa en formato YAML

Para ver el manifiesto de un objeto Deployment, ejecuta el siguiente comando:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get deployments DEPLOYMENT_NAME -o yaml

Este comando muestra la configuración activa del objeto Deployment en formato YAML.

Mostrar pods

Para enumerar los objetos Pod creados por la implementación, ejecuta el siguiente comando:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l KEY=VALUE

En este comando, la marca -l muestra todos los objetos Pod con la etiqueta de par clave-valor especificada.

Haz los cambios siguientes:

  • CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.

  • NAMESPACE: el espacio de nombres del proyecto.

  • KEY: la clave del conjunto de etiquetas de pares clave-valor definido en la implementación. Por ejemplo, si el campo .template.metadata.labels tiene configurada la etiqueta app: myapp, la clave es app.

  • VALUE: el valor de la etiqueta del par clave-valor definido en la implementación. Por ejemplo, si el campo .template.metadata.labels tiene configurada la etiqueta app: myapp, el valor es my-app.

Por ejemplo, si has etiquetado el objeto Deployment como app: my-app, puedes ejecutar el siguiente comando para ver los objetos Pod con esa etiqueta:

kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
    get pods -l app=my-app

Obtener información específica sobre un pod

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

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

Haz los cambios siguientes:

  • CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.

  • NAMESPACE: el espacio de nombres del proyecto.

  • POD_NAME: el nombre del pod gestionado por la implementación.