Vista geral do Cloud Code para Kubernetes no Cloud Shell

Esta página oferece uma vista geral do desenvolvimento do Kubernetes no Cloud Code.

Use o Explorador do Kubernetes no Cloud Code

O explorador do Kubernetes permite-lhe aceder a informações sobre os seus clusters, nós, cargas de trabalho e muito mais, diretamente a partir do IDE. Também pode definir um contexto atual, transmitir e ver registos, abrir um terminal interativo e procurar descrições de recursos com o Kubernetes Explorer.

Explorador do Kubernetes do Cloud Code

O Cloud Code usa o ficheiro kubeconfig predefinido, localizado no diretório $HOME/.kube no MacOS/Linux ou %USERPROFILE%\.kube no Windows, para obter recursos do Kubernetes. Pode mudar ou adicionar novos ficheiros Kubeconfig no Explorador do Kubernetes. Os ficheiros Kubeconfig são ficheiros YAML que contêm os detalhes do cluster Kubernetes, o certificado e o token secreto para autenticação no cluster.

Para usar um ficheiro kubeconfig que não seja o kubeconfig predefinido, consulte o guia Trabalhar com ficheiros kubeconfig.

Aceda ao Explorador do Kubernetes

Para ver e gerir os seus recursos do Kubernetes, aceda ao Kubernetes Explorer clicando em Cloud Code e expandindo a secção Kubernetes. Para ver sessões de depuração ou criar uma app de exemplo, expanda a secção Sessões de desenvolvimento.

Aceda à secção Sessões de desenvolvimento

Use as sessões de desenvolvimento para executar ou depurar a sua aplicação Kubernetes ou criar uma aplicação de exemplo com um modelo.

Quando inicia uma sessão de desenvolvimento ou depuração, a secção Sessões de desenvolvimento apresenta a vista de registo estruturado.

Painel de sessões de desenvolvimento

Para aceder às sessões de desenvolvimento, clique em Cloud Code e expanda a secção Sessões de desenvolvimento.

Ações básicas

O explorador do Kubernetes é fornecido pela kubectl. Desde que tenha configurado o ficheiro de configuração kubectl para aceder aos seus clusters, pode usar o Explorador do Kubernetes para adicionar clusters, procurar todos os namespaces, recursos e nós disponíveis para os seus clusters, independentemente de estarem no contexto ativo ou inativo.

Secção Clusters

As ações gerais do Kubernetes disponíveis, acessíveis através dos respetivos ícones na secção Clusters do Kubernetes Explorer, são:

  • add Adicione um cluster ao KubeConfig
  • atualizar Atualize o Explorador do Kubernetes
  • question_mark Abra a documentação do Kubernetes do Cloud Code num navegador de Internet

Secção de sessões de desenvolvimento

As ações do Kubernetes disponíveis, acessíveis através dos respetivos ícones na secção Sessões de desenvolvimento do Kubernetes, são:

  • Ícone de exemplo do Kubernetes aberto Abra uma aplicação de amostra do Kubernetes
  • play_arrow Execute a sua aplicação
  • Ícone de depuração Depure a sua aplicação

Copie um nome do recurso

Pode copiar qualquer nome de recurso do Kubernetes para a área de transferência (incluindo nomes de contentores e clusters). Para copiar o nome de um recurso, clique com o botão direito do rato no recurso e escolha Copiar nome do recurso.

Copie o nome do recurso através do menu de contexto

Atualize os recursos

O explorador do Kubernetes monitoriza as alterações e é atualizado automaticamente para refletir as atualizações. Para forçar uma atualização de qualquer recurso do Kubernetes para obter as informações mais recentes, clique com o botão direito do rato no recurso e escolha Atualizar.

Atualize os pods através do menu de contexto

Também pode forçar uma atualização de toda a secção Clusters do explorador do Kubernetes através do botão de atualização da secção Clusters.

Botão de atualização da secção Clusters

Descreva os recursos

Para apresentar os detalhes de qualquer recurso que não seja de cluster, clique com o botão direito do rato no recurso e, de seguida, selecione Descrever. É aberto um terminal que apresenta as informações do recurso. Descreva os detalhes dos recursos no menu de clique com o botão direito do rato

Personalize a configuração de lançamento

Para configurar a forma como a sua aplicação é executada, pode personalizar o ficheiro skaffold.yaml.

Veja o YAML remoto

Para ver o YAML de um recurso no seu cluster, selecione ou passe o cursor do rato sobre o recurso para mostrar os ícones Editar YAML e Ver YAML. Selecione o botão Ver YAML para abrir o ficheiro YAML correspondente ao recurso especificado num novo separador do editor.

YAML do serviço Kubernetes aberto através do ícone Ver YAML

Ver registos

Pode fazer stream e ver registos de recursos do Kubernetes na consola do Kubernetes Explorer para monitorizar o respetivo progresso.

Para abrir o visualizador de registos, abra a paleta de comandos premindo Ctrl/Cmd+Shift+P ou clicando em Ver > Paleta de comandos e, de seguida, selecione Cloud Code: Ver registos.

Caixa de diálogo Ver registos na paleta de comandos

O visualizador de registos é aberto num novo separador do editor.

Visualizador de registos Para ver os registos de um pod ou um contentor, clique com o botão direito do rato no recurso e selecione Ver registos.

Ver registos de um pod

Inicie um terminal

Para pods e contentores, pode abrir um terminal interativo clicando com o botão direito do rato no pod ou no contentor e selecionando Obter terminal.

Abrir um terminal interativo

Ações específicas de recursos

O Kubernetes Explorer apresenta clusters, espaços de nomes, nós, cargas de trabalho (como implementações, conjuntos de réplicas, pods e contentores), serviços e entradas, configurações (como segredos e mapas de configuração) e armazenamento (como volumes). Com o explorador do Kubernetes, pode realizar ações únicas em alguns destes recursos.

Clusters

  • Adicione um cluster ao Kubeconfig: adicione um cluster do GKE ou minikube existente ou crie um novo.

A caixa de diálogo Adicionar cluster é apresentada e pode escolher o projeto e o cluster que quer usar ou criar um novo cluster.

Escolher a plataforma de cluster

Crie ou escolha um cluster do GKE

  • Definir como cluster ativo: defina o cluster especificado como ativo para que o contexto kubectl configurado aceda a este cluster por predefinição.

    Defina o cluster como ativo através do menu de contexto

O Kubernetes Explorer é atualizado automaticamente e é apresentado o símbolo do Kubernetes junto ao cluster adequado.

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

Espaços de nomes

  • Definir como espaço de nomes ativo: defina um espaço de nomes como ativo para que o contexto kubectl configurado aceda a este espaço de nomes por predefinição.

    Clique com o botão direito do rato no espaço de nomes que quer definir como ativo.

    Defina o espaço de nomes como o contexto atual através do menu de contexto

Se esta ação for bem-sucedida, o Kubernetes Explorer é atualizado automaticamente e é apresentado um asterisco junto ao espaço de nomes para indicar que faz parte do contexto atual.

Tenha em atenção que um contexto do Kubernetes é um atalho que lhe dá acesso rápido a um espaço de nomes no seu cluster. Normalmente, os contextos são criados automaticamente quando inicia um cluster do minikube ou do GKE. Se não vir a opção Definir como contexto atual para um determinado espaço de nomes e quiser criar um contexto para o mesmo, use o comando kubectl config set-context no seu terminal para definir um contexto com o cluster, o utilizador e o espaço de nomes preferenciais.

Agrupamentos

  • Ver registos: veja os registos de um pod na consola do Kubernetes Explorer.
  • Obter terminal: obtenha um terminal para um pod na consola do Kubernetes Explorer.

    Além disso, os pods em execução têm marcas de estado coloridas junto às respetivas etiquetas:

    • Vermelho: o agrupamento está num estado de falha
    • Amarelo: o pod está a iniciar ou a terminar
    • Verde: o pod está em bom estado e em execução
Marca de verificação verde junto ao pod a indicar um estado de funcionamento

Contentores

  • Ver registos: veja registos de um contentor na consola do Kubernetes Explorer.
  • Get Terminal: Get terminal para um contentor na consola do Kubernetes Explorer.

Implementações

  • Ver registos: ver registos de uma implementação na consola do Kubernetes Explorer.

    As implementações em direto têm marcas de estado coloridas junto às respetivas etiquetas e contagens de réplicas atuais/totais:

    • Amarelo: a implementação não tem a disponibilidade mínima ou tem problemas com imagens.
    • Verde: a implementação está em bom estado e teve a disponibilidade mínima.
Ícones de implementação verdes que indicam um estado normal

Nós

Os nós do cluster têm marcas de estado coloridas junto aos respetivos nomes:

  • Amarelo: o nó tem um problema de recursos, como a disponibilidade de memória ou disco.
  • Verde: o nó não tem problemas.

Definições de recursos personalizados (CRDs)

O Kubernetes Explorer apresenta todas as definições de recursos personalizados (CRDs) instaladas e disponíveis no seu cluster:

Lista de definições de recursos personalizados no explorador

O que se segue?