Inspecciona las cargas de trabajo con estado

En este documento, se explica cómo inspeccionar las cargas de trabajo con estado existentes que se ejecutan en un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). Las cargas de trabajo con 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 supervisar el uso de recursos y el estado de las cargas de trabajo.

Este documento está dirigido 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. Para obtener más información, consulta Públicos de la documentación de GDC aislado.

Antes de comenzar

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

Solicita roles de IAM

Debes tener roles específicos para obtener los permisos que necesitas para ver y, también, inspeccionar las cargas de trabajo con estado. Los roles que necesitas dependen de si trabajas en un clúster compartido con alcance de organización o en un clúster estándar con alcance de proyecto. Para obtener más información, consulta Configuraciones de clústeres de Kubernetes.

Roles de clúster compartidos

Pídele al administrador de proyectos de IAM que te otorgue los siguientes roles en el espacio de nombres de tu proyecto según la tarea que se realizará:

  • Visualizador de cargas de trabajo (workload-viewer): Permite ver todas las cargas de trabajo implementadas en un clúster compartido.
  • Administrador de espacio de nombres (namespace-admin): Crea, borra, edita o visualiza cargas de trabajo en un espacio de nombres de proyecto de clúster compartido.

Estos roles están vinculados al espacio de nombres de tu proyecto.

Roles de clúster estándar

Para crear, borrar, editar o ver cargas de trabajo en un clúster estándar, pídele a tu administrador de proyectos de IAM que te otorgue el rol de desarrollador de clústeres (cluster-developer). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara el entorno

Para ejecutar comandos en un clúster de Kubernetes con la API, asegúrate de tener los siguientes recursos:

  • Busca el nombre del clúster de Kubernetes o pregúntale a un miembro del grupo de administradores de la plataforma cuál es el nombre del clúster.

  • Accede y genera el archivo kubeconfig para el clúster de Kubernetes.

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

Visualiza las cargas de trabajo de contenedores de un proyecto

Para ver las cargas de trabajo de contenedores de tu proyecto, completa los siguientes pasos:

Console

  • En el menú de navegación, selecciona Kubernetes Engine > Cargas de trabajo.

    Puedes ver los detalles de tus cargas de trabajo en contenedores, como los siguientes:

    • Nombre
    • Tipo
    • Cantidad de Pods
    • Clúster de Kubernetes
    • Fecha de la última modificación

    Las cargas de trabajo de 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.

kubectl

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

    kubectl get pods -n PROJECT_NAMESPACE

    El resultado es similar a lo 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

Inspecciona un recurso StatefulSet

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

Obtén información del objeto StatefulSet

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

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

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta el objeto StatefulSet.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

  • 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 lo siguiente:

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

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta el objeto StatefulSet.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: Es el nombre del objeto StatefulSet.

Mostrar lista de pods

Para enumerar los objetos Pod que creó el StatefulSet, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_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:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta el objeto StatefulSet.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

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

Obtén información específica del Pod

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

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

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta el Pod.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

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

Enumera las PVC

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

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta las PVC.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

Obtén información específica de la PVC

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

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

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta la PVC.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

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

Obtén información del PV

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

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

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta el PV.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

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

¿Qué sigue?