Inspecione cargas de trabalho com estado

Esta página explica como inspecionar cargas de trabalho com estado existentes em execução num cluster do Kubernetes de um dispositivo isolado do ar do Google Distributed Cloud (GDC). As cargas de trabalho com estado permitem-lhe executar a sua aplicação com armazenamento de contentores persistente. Pode ver as suas cargas de trabalho com estado com a consola do GDC ou a CLI kubectl para monitorizar a utilização de recursos e o estado das cargas de trabalho.

Esta página destina-se a programadores no grupo de operadores de aplicações, que são responsáveis por gerir cargas de trabalho de aplicações para a respetiva organização.

Antes de começar

Para executar comandos no cluster do Kubernetes bare metal pré-configurado, certifique-se de que tem os seguintes recursos:

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

  2. Inicie sessão e gere o ficheiro kubeconfig para o cluster do Kubernetes, se não tiver um.

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

Para receber as autorizações necessárias para ver todas as cargas de trabalho implementadas num projeto, peça ao administrador da IAM da sua organização para lhe conceder a função de leitor de cargas de trabalho (workload-viewer) no seu espaço de nomes do projeto.

Para receber as autorizações necessárias para inspecionar cargas de trabalho com estado, peça ao administrador de IAM da organização que lhe conceda a função de administrador do espaço de nomes (namespace-admin) no espaço de nomes do seu projeto.

Veja as cargas de trabalho de contentores de um projeto

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

kubectl get pods -n PROJECT_NAMESPACE

O resultado é semelhante ao seguinte:

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

Inspecione um recurso StatefulSet

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

Obtenha informações do objeto StatefulSet

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

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

Substitua o seguinte:

  • CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o espaço de nomes do projeto.

  • STATEFULSET_NAME: o nome do objeto StatefulSet

Apresente a configuração em direto no formato YAML

Para apresentar a configuração em direto do recurso StatefulSet no formato YAML, execute:

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

Substitua o seguinte:

  • CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o espaço de nomes do projeto.

  • STATEFULSET_NAME: o nome do objeto StatefulSet

Listar agrupamentos

Para listar os objetos Pod criados pelo StatefulSet, execute o seguinte comando:

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

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

Substitua o seguinte:

  • CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster Kubernetes que executa o objeto StatefulSet.

  • NAMESPACE: o espaço de nomes do projeto.

  • APP_NAME: o nome da aplicação com estado gerida pelo objeto StatefulSet.

Obtenha informações específicas do pod

Para obter informações sobre um Pod específico no cluster, execute o seguinte comando:

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

Substitua o seguinte:

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

  • NAMESPACE: o espaço de nomes do projeto.

  • POD_NAME: o nome do agrupamento gerido pelo objeto StatefulSet.

Apresentar PVCs

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

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Substitua o seguinte:

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

  • NAMESPACE: o espaço de nomes do projeto.

Obtenha informações específicas sobre o PVC

Para obter informações sobre um PersistentVolumeClaim específico (PVC) no cluster, execute o seguinte comando:

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

Substitua o seguinte:

  • CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster do Kubernetes que executa o PVC.

  • NAMESPACE: o espaço de nomes do projeto.

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

Obtenha informações sobre a energia fotovoltaica

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

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

Substitua o seguinte:

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

  • NAMESPACE: o espaço de nomes do projeto.

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