Inspecionar cargas de trabalho com estado

Nesta página, explicamos como inspecionar cargas de trabalho com estado em execução em um cluster do Kubernetes de um appliance isolado do Google Distributed Cloud (GDC). Com as cargas de trabalho com estado, é possível executar seu aplicativo com armazenamento permanente de contêineres. É possível conferir suas cargas de trabalho com estado usando o console do GDC ou a CLI kubectl para monitorar o uso de recursos e a integridade da carga de trabalho.

Esta página é destinada a desenvolvedores do grupo de operadores de aplicativos, que são responsáveis por gerenciar cargas de trabalho de aplicativos na organização.

Antes de começar

Para executar comandos no cluster do Kubernetes em bare metal pré-configurado, verifique se você tem os seguintes recursos:

  1. Localize o nome do cluster do Kubernetes ou pergunte ao administrador da plataforma.

  2. Faça login e gere o arquivo kubeconfig para o cluster do Kubernetes, se você não tiver um.

  3. Use o caminho kubeconfig do cluster do Kubernetes para substituir CLUSTER_KUBECONFIG nestas instruções.

Para receber as permissões necessárias para visualizar todas as cargas de trabalho implantadas em um projeto, peça ao administrador do IAM da organização para conceder a você o papel de Leitor de carga de trabalho (workload-viewer) no namespace do projeto.

Para receber as permissões necessárias para inspecionar cargas de trabalho com estado, peça ao administrador do IAM da organização para conceder a você o papel de administrador do namespace (namespace-admin) no namespace do projeto.

Ver as cargas de trabalho de contêiner de um projeto

Execute o seguinte comando para listar todos os pods no seu projeto:

kubectl get pods -n PROJECT_NAMESPACE

O resultado será assim:

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

Inspecionar um recurso StatefulSet

Para solicitar informações mais detalhadas sobre os componentes de um recurso StatefulSet, execute comandos que segmentam diretamente a entidade que você quer inspecionar.

Receber informações do objeto StatefulSet

Para informações detalhadas sobre o objeto StatefulSet, execute:

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

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o namespace do projeto.

  • STATEFULSET_NAME: o nome do objeto StatefulSet.

Mostrar a configuração ativa no formato YAML

Para mostrar a configuração ativa do recurso StatefulSet no formato YAML, execute:

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

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o namespace do projeto.

  • STATEFULSET_NAME: o nome do objeto StatefulSet.

Listar pods

Para listar os objetos Pod criados pelo StatefulSet, execute:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l app=APP_NAME

Neste comando, a flag -l lista todos os objetos Pod rotulados com APP_NAME.

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o namespace do projeto.

  • APP_NAME: o nome do aplicativo com estado gerenciado pelo objeto StatefulSet.

Receber informações específicas sobre um pod

Para ver informações sobre um Pod específico no cluster, execute:

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

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa o pod.

  • NAMESPACE: o namespace do projeto.

  • POD_NAME: o nome do pod gerenciado pelo objeto StatefulSet.

Listar PVCs

Para listar os objetos PersistentVolumeClaim (PVC) no cluster, execute:

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa os PVCs.

  • NAMESPACE: o namespace do projeto.

Receber informações específicas do PVC

Para receber informações sobre um PersistentVolumeClaim (PVC) específico no cluster, execute:

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

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa a PVC.

  • NAMESPACE: o namespace do projeto.

  • PVC_NAME: o nome do PVC configurado para o objeto StatefulSet.

Receber informações de PV

Para ver informações sobre um PersistentVolume (PV) específico no cluster, execute:

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

Substitua:

  • CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster do Kubernetes que executa o PV.

  • NAMESPACE: o namespace do projeto.

  • PV_NAME: o nome do PV configurado para o objeto StatefulSet.