Informações gerais do Cloud Code para VS Code Kubernetes

Nesta página, você encontra uma visão geral do desenvolvimento do Kubernetes no Cloud Code.

Usar a seção Kubernetes no Cloud Code

Na seção Kubernetes é possível acessar informações sobre os clusters, nós, cargas de trabalho e muito mais, diretamente do seu ambiente de desenvolvimento integrado. Também é possível definir um contexto atual, fazer streaming e visualizar registros, abra um terminal interativo e procurar descrições de recursos com a biblioteca nesta seção.

Seção do Kubernetes no Cloud Code

O Cloud Code usa o arquivo kubeconfig padrão, localizado em no diretório $HOME/.kube no MacOS/Linux ou %USERPROFILE%\.kube no Windows; para recuperar recursos do Kubernetes. É possível alternar ou adicionar novos arquivos Kubeconfig na seção do Kubernetes. Os arquivos Kubeconfig são arquivos YAML contendo os detalhes do cluster, o certificado e o token secreto do cluster do Kubernetes para autenticando no cluster.

Para usar um arquivo kubeconfig diferente do kubeconfig padrão, consulte a Guia Trabalhar com arquivos kubeconfig.

Acesse a seção do Kubernetes

Para visualizar e gerenciar seus recursos do Kubernetes, acesse a API Kubernetes clicando em Cloud Code e expandindo a seção Kubernetes. Para acessar as sessões de depuração ou criar uma app de exemplo, abra a seção Sessões de desenvolvimento.

Ao tentar depurar, pode ser necessário autenticar suas credenciais. para executar e depurar um aplicativo localmente.

Acessar a seção de Sessões de desenvolvimento

Use as sessões de desenvolvimento para executar ou depurar seu aplicativo do Kubernetes ou criar um aplicativo de amostra usando um modelo.

Ao iniciar uma sessão de desenvolvimento ou depuração, a A seção Sessões de desenvolvimento exibe a visualização da geração de registros estruturada.

Painel de sessões de desenvolvimento

Para acessar as sessões de desenvolvimento, clique em Cloud Code e expanda a seção Sessões de desenvolvimento.

Ações básicas

A seção Kubernetes usa a tecnologia do kubectl. Contanto que você configurou seu arquivo de configuração kubectl para acessar seus clusters, é possível usar o seção Kubernetes para adicionar clusters, procure todas as opções namespaces, recursos e nós dos clusters, independentemente de estarem o contexto ativo ou inativo.

Seção do Kubernetes

As ações gerais do Kubernetes disponíveis, acessíveis por meio de seus ícones na seção Kubernetes, são:

  • adicionar KubeConfig
  • refresh Atualize o Seção Kubernetes
  • question_mark Abra o Documentação do Kubernetes do Cloud Code em um navegador da Web

Seção de sessões de desenvolvimento

As ações disponíveis do Kubernetes, que podem ser acessadas pelos ícones na seção de Sessões de desenvolvimento do Kubernetes, são:

  • Ícone "Abrir amostra do Kubernetes" Abrir um aplicativo de amostra do Kubernetes
  • play_arrow Execute seu aplicativo
  • Ícone de depuração Depure seu aplicativo

Copiar um nome de recurso

É possível copiar qualquer nome de recurso do Kubernetes para a área de transferência (inclusive nomes de e nomes de cluster). Para copiar um nome de recurso, clique com o botão direito do mouse no recurso e selecione Copiar nome do recurso.

Copiar o nome do recurso usando o menu do botão direito do mouse

Atualizar recursos

A seção Kubernetes observa as alterações e automaticamente é atualizado para refletir as atualizações. Para forçar uma atualização de qualquer recurso do Kubernetes a buscar as informações mais recentes, clique com o botão direito do mouse no recurso e selecione Atualizar.

Atualizar pods usando o menu do botão direito do mouse

Também é possível forçar uma atualização de toda a seção do Kubernetes. usando o botão de atualização da seção Kubernetes. Botão de atualização da seção do Kubernetes

Descrever recursos

Para exibir os detalhes de qualquer recurso que não seja de cluster, clique com o botão direito do mouse no recurso. e selecione Descrever. Um terminal é aberto e exibe o recurso. informações imprecisas ou inadequadas. Descreva os detalhes do recurso no menu do botão direito do mouse

Personalizar a configuração de inicialização

Para configurar como o aplicativo é executado, personalize o skaffold.yaml.

Também é possível configurar a inicialização especificando os seguintes campos na configuração cloudcode.kubernetes no seu arquivo .vscode/launch.json:

  • skaffoldConfig: especifica o arquivo de configuração do skaffold que contém as definições de compilação e implantação.
  • profile: especifica seu perfil skaffold preferido. Se não for definido, o perfil padrão será usado.
  • imageRegistry: especifica o registro de imagens para onde as imagens serão enviadas.
  • watch: especifique se é preciso acompanhar as alterações no espaço de trabalho e execute novamente o aplicativo. A menos que seja explicitamente definido como falso, verdadeiro por padrão.
  • cleanUp: especificar se os recursos implantados do Kubernetes serão excluídos no cluster após o encerramento do aplicativo. A menos que seja explicitamente definido como falso, verdadeiro por padrão.
  • portForward: especifique se quer encaminhar portas para os recursos expostos do Kubernetes no cluster para a máquina local. A menos que seja explicitamente definido como falso, verdadeiro por padrão.

Ver YAML remoto

Para visualizar o YAML de um recurso no cluster, selecione ou passe o cursor sobre o recurso para mostrar o Editar YAML e Ícones View YAML. Selecione o botão Ver YAML para abrir o arquivo YAML. correspondente ao recurso especificado em uma nova guia do editor.

YAML do pod do Kubernetes aberto usando o ícone "Ver YAML"

Ver registros

É possível fazer streaming e visualizar registros de recursos do Kubernetes para a da seção "Detalhes do app" para monitorar o progresso.

Para abrir o visualizador de registros, abra a paleta de comandos pressionando Ctrl/Cmd+Shift+P ou clicando em Visualizar > Command Palette e, em seguida, selecione Cloud Code: visualizar registros.

Caixa de diálogo "View logs" na paleta de comandos

O visualizador de registros é aberto em uma nova guia do editor.

Visualizador de registros Para acessar os registros de um pod ou contêiner, clique com o botão direito do mouse no recurso e selecione Veja os registros.

Como visualizar registros de um pod

Iniciar um terminal

Para pods e contêineres, abra um terminal interativo clicando com o botão direito do mouse. pod ou contêiner e selecionando Ver terminal.

Como abrir um terminal interativo

Ações específicas de recursos

A seção Kubernetes mostra clusters, namespaces, nós e cargas de trabalho (como implantações, réplicas, pods e contêineres), serviços e entradas, configurações (como secrets e mapas de configuração) e armazenamento (como volumes). Na seção Kubernetes, é possível executar ações exclusivas em alguns esses recursos.

Clusters

  • Adicione um cluster ao Kubeconfig: adicione um cluster atual do GKE ou do minikube. ou criar uma nova.

A caixa de diálogo "Adicionar cluster" é exibida, e é possível escolher o projeto e o cluster que você quer usar ou criar um novo cluster.

Como escolher a plataforma de cluster

Criar ou escolher um cluster do GKE

  • Definir como cluster ativo: define o cluster especificado como ativo, de modo que o contexto kubectl configurado acessa esse cluster por padrão.

    Definir o cluster como ativo usando o menu do botão direito do mouse

A seção "Kubernetes" é atualizada automaticamente Símbolo do Kubernetes ao lado do cluster apropriado.

Se um cluster tiver vários contextos configurados, será possível para escolher um dos contextos disponíveis para definir como o contexto atual.

Namespaces

  • Definir como namespace ativo:defina um namespace como ativo de modo que seu kubectl configurado acessa esse namespace por padrão.

    Clique com o botão direito do mouse no namespace que você quer definir como ativo.

    Definir o namespace como o contexto atual usando o menu do botão direito do mouse

. Se essa ação for bem-sucedida, a seção do Kubernetes será atualizada automaticamente, e um asterisco vai aparecer ao lado do namespace para indicar que ele é parte do contexto atual.

O contexto do Kubernetes é um atalho que oferece acesso rápido a um namespace no cluster. Os contextos normalmente são criados automaticamente ao iniciar um minikube ou um cluster do GKE. Se você não vir a opção Definir como contexto atual para um determinado namespace e gostaria de criar um contexto para ela, use o Comando kubectl config set-context no terminal para definir um contexto com o cluster, o usuário e o .

Pods

  • Ver registros: visualize os registros de um pod no Console da seção do Kubernetes.
  • Receber terminal: acesse o terminal de um pod no Console da seção do Kubernetes.

    Além disso, os pods em execução terão marcas de status coloridas ao lado dos rótulos:

    • Vermelho: o pod está em estado de falha
    • Amarelo: o pod está sendo iniciado ou encerrado.
    • Verde: o pod está normal e em execução
Marca de seleção verde ao lado do pod indicando um status de integridade

Contêineres

Implantações

  • Ver registros: Ver registros de uma implantação no console da seção do Kubernetes.

    As implantações ativas têm marcas de status coloridas ao lado dos rótulos e contagens de réplicas atuais/totais:

    • Amarelo: a implantação não tem disponibilidade mínima nem problemas de imagem;
    • Verde: a implantação está normal e tem disponibilidade mínima.
Ícones de implantação verdes indicando status íntegro

Nós

Os nós do cluster terão marcas de status coloridas ao lado dos nomes:

  • Amarelo: o nó apresenta um problema de recurso, como disponibilidade de memória ou disco;
  • Verde: o nó está normal.

Definições de recursos personalizados (CRDs)

A seção do Kubernetes lista todas as definições de recursos personalizados (CRDs, na sigla em inglês) instalado e disponível no cluster:

Lista de definições de recursos personalizados na seção

A seguir