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 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. Para mais informações, consulte a documentação sobre públicos-alvo para GDC com isolamento de ar.

Antes de começar

Para executar comandos num cluster do Kubernetes, 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 Kubernetes, se não tiver um.

  3. Use o caminho kubeconfig do cluster Kubernetes para substituir KUBERNETES_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

Para ver as cargas de trabalho do contentor do seu projeto, conclua o seguinte:

Consola

  • No menu de navegação, selecione Kubernetes Engine > Workloads.

    Pode ver detalhes das cargas de trabalho do contentor, como os seguintes:

    • Nome
    • Tipo
    • Número de pods
    • Cluster do Kubernetes
    • Data da última modificação

    As cargas de trabalho de contentores estão organizadas por cluster do Kubernetes ao qual pertencem. Selecione o menu pendente Cluster para mudar o contexto do cluster.

CLI

  • 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe statefulset STATEFULSET_NAME

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get statefulset STATEFULSET_NAME -o yaml

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster 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 KUBERNETES_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:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pod POD_NAME

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig do cluster 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pvc PVC_NAME

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster 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 KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pv PV_NAME

Substitua o seguinte:

  • KUBERNETES_CLUSTER_KUBECONFIG: o ficheiro kubeconfig para o cluster que executa o PV.

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

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