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 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 estados 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á dirigida 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 Audiences for GDC air-gapped documentation.
Antes de comenzar
Para ejecutar comandos en un clúster de Kubernetes, asegúrate de tener los siguientes recursos:
Ubica el nombre del clúster de Kubernetes o pregúntale al administrador de la plataforma cuál es el nombre del clúster.
Accede y genera el archivo kubeconfig para el clúster de Kubernetes si no tienes uno.
Usa la ruta de acceso de kubeconfig del clúster de Kubernetes para reemplazar
KUBERNETES_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 sin 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
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 detalles de tus cargas de trabajo en contenedores, como los siguientes:
- Nombre
- Tipo
- Cantidad de cápsulas
- 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.
CLI
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 dirijan directamente a la entidad que deseas inspeccionar.
Obtén información del objeto Deployment
Para obtener información detallada sobre el objeto Deployment
, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
describe deployment DEPLOYMENT_NAME
Reemplaza lo siguiente:
KUBERNETES_CLUSTER_KUBECONFIG
: Es el archivo kubeconfig del clúster que ejecuta la implementación.NAMESPACE
: Es el espacio de nombres del proyecto.DEPLOYMENT_NAME
: el nombre del objetoDeployment
.
Muestra la configuración activa en formato YAML
Para ver el manifiesto de un objeto Deployment
, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
get deployments DEPLOYMENT_NAME -o yaml
Este comando muestra la configuración activa del objeto Deployment
en formato YAML.
Mostrar lista de pods
Para enumerar los objetos Pod
creados por la implementación, ejecuta el siguiente comando:
kubectl --kubeconfig KUBERNETES_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 en el clúster especificado.
Reemplaza lo siguiente:
KUBERNETES_CLUSTER_KUBECONFIG
: Es el archivo kubeconfig del clúster que ejecuta la implementación.NAMESPACE
: Es el espacio de nombres del proyecto.KEY
: Es la clave del par clave-valor de la etiqueta establecida en la implementación. Por ejemplo, si el campo.template.metadata.labels
tiene configurada la etiquetaapp: myapp
, la clave esapp
.VALUE
: Es el valor del par clave-valor de la etiqueta establecida en la implementación. Por ejemplo, si el campo.template.metadata.labels
tiene configurada la etiquetaapp: myapp
, el valor esmy-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 sobre un pod
Para obtener información sobre un objeto Pod
específico, 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 la implementación.NAMESPACE
: Es el espacio de nombres del proyecto.POD_NAME
: Es el nombre del Pod que administra la implementación.