Inspecione cargas de trabalho com estado

Este documento 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.

Este documento 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 concluir as tarefas neste documento, tem de ter os seguintes recursos e funções:

  • Para executar comandos num cluster do Kubernetes, certifique-se de que tem os seguintes recursos:

    • Localize o nome do cluster do Kubernetes ou pergunte a um membro do grupo de administradores da plataforma qual é o nome do cluster.

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

    • 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 cluster partilhado, peça ao administrador de IAM da organização para lhe conceder a função de visualizador de cargas de trabalho (workload-viewer) no espaço de nomes do seu projeto.

  • Para receber as autorizações necessárias para inspecionar cargas de trabalho com estado num cluster partilhado, 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.

  • Para receber as autorizações necessárias para ver e inspecionar cargas de trabalho com estado num cluster padrão, peça ao administrador de IAM da sua organização para lhe conceder a função de programador de cluster (cluster-developer) num cluster padrão.

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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

  • 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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

  • 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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

  • 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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

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

Apresentar PVCs

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

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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

Obtenha informações específicas sobre PVCs

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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

  • 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. Para clusters partilhados, tem de ser um espaço de nomes do projeto. Para clusters padrão, pode ser qualquer espaço de nomes.

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

O que se segue?