Inspecciona cargas de trabajo sin estado

En esta página, se explica cómo inspeccionar las cargas de trabajo sin estado existentes 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 o 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 supervisar el uso de recursos y el estado de la carga de trabajo.

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

Antes de comenzar

Para completar las tareas de este documento, debes solicitar los permisos necesarios y preparar tu entorno.

Solicita roles de IAM

Pídele a tu administrador de IAM de la organización que te otorgue los siguientes roles en el espacio de nombres de tu proyecto según la tarea que deseas realizar:

  • Visualizador de cargas de trabajo (workload-viewer): Permite ver todas las cargas de trabajo implementadas en un clúster.
  • Administrador de espacios de nombres (namespace-admin): Permite crear, borrar, editar o ver cargas de trabajo en un espacio de nombres del proyecto del clúster.

Prepara el entorno

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

  1. Ubica el nombre del clúster de Kubernetes o pregúntale a tu 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 kubeconfig del clúster de Kubernetes para reemplazar CLUSTER_KUBECONFIG en estas instrucciones.

Visualiza 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 la implementación

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

Obtén información del objeto Deployment

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

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

Reemplaza lo siguiente:

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

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • DEPLOYMENT_NAME: Es el nombre del objeto Deployment.

Muestra la configuración activa en formato YAML

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

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

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

Mostrar lista de pods

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

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

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

Reemplaza lo siguiente:

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

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • KEY: Es la clave para la etiqueta de par clave-valor establecida en la implementación. Por ejemplo, si el campo .template.metadata.labels tiene configurada la etiqueta app: myapp, la clave es app.

  • VALUE: Es el valor para la etiqueta de par clave-valor establecida 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 etiquetaste el objeto Deployment como app: my-app, ejecutarías 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

Obtén información específica del pod

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

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 la implementación.

  • NAMESPACE: Es el espacio de nombres del proyecto.

  • POD_NAME: Es el nombre del pod que administra la implementación.