Inspecionar cargas de trabalho sem estado

Nesta página, explicamos como inspecionar cargas de trabalho sem estado em execução em um cluster do Kubernetes isolado do Google Distributed Cloud (GDC). Com as cargas de trabalho sem estado, é possível executar a implantação do aplicativo sem armazenar dados ou o estado do aplicativo. É possível conferir as cargas de trabalho sem estado com 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. Para mais informações, consulte Públicos-alvo para documentação isolada do GDC.

Antes de começar

Para executar comandos em um cluster do Kubernetes, 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 KUBERNETES_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 sem 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

Para ver as cargas de trabalho de contêiner do seu projeto, faça o seguinte:

Console

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

    É possível conferir detalhes das cargas de trabalho de contêineres, como:

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

    As cargas de trabalho de contêineres são organizadas de acordo com o cluster do Kubernetes a que pertencem. Selecione o menu suspenso 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 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 a implantação

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

Receber informações do objeto Deployment

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

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    describe deployment DEPLOYMENT_NAME

Substitua:

  • KUBERNETES_CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster que executa a implantação.

  • NAMESPACE: o namespace do projeto.

  • DEPLOYMENT_NAME: o nome do objeto Deployment.

Mostrar a configuração ativa no formato YAML

Para ver o manifesto de um objeto Deployment, execute:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get deployments DEPLOYMENT_NAME -o yaml

Esse comando exibe a configuração ativa do objeto Deployment no formato YAML.

Listar pods

Para listar os objetos Pod criados pela implantação, execute:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l KEY=VALUE

Neste comando, a flag -l lista todos os objetos Pod com o rótulo de par de chave-valor especificado no cluster especificado.

Substitua:

  • KUBERNETES_CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster que executa a implantação.

  • NAMESPACE: o namespace do projeto.

  • KEY: a chave do conjunto de rótulos de par de chave-valor definido na implantação. Por exemplo, se o campo .template.metadata.labels tiver o rótulo app: myapp configurado, a chave será app.

  • VALUE: o valor do conjunto de rótulos de par de chave-valor definido na implantação. Por exemplo, se o campo .template.metadata.labels tiver o rótulo app: myapp configurado, o valor será my-app.

Por exemplo, se você rotulou o objeto Deployment como app: my-app, execute o comando a seguir para ver os objetos Pod com esse rótulo:

kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
    get pods -l app=my-app

Receber informações específicas sobre um pod

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

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

Substitua:

  • KUBERNETES_CLUSTER_KUBECONFIG: o arquivo kubeconfig do cluster que executa a implantação.

  • NAMESPACE: o namespace do projeto.

  • POD_NAME: o nome do pod gerenciado pela implantação.