Começar a usar o Cloud Code para Cloud Shell no Kubernetes

O Cloud Code permite criar um aplicativo do Kubernetes com base em uma amostra ou de um projeto atual.

Criar um aplicativo usando um modelo

O Cloud Code vem com uma coleção de modelos de exemplo de código para você começar rapidamente. Para criar um aplicativo do Kubernetes usando uma amostra, siga estas etapas:

  1. Inicie a paleta de comandos (pressione Ctrl/Cmd+Shift+P ou clique em View > Command Palette) e execute Cloud Code: New Application.
  2. Selecione Aplicativo do Kubernetes como o tipo de amostra.
  3. Selecione um modelo baseado na linguagem que você quer usar dentre as opções disponíveis: Node.js, Go, Python e Java.

  4. Escolha um local de aplicativo de sua preferência na máquina local e clique em Criar novo aplicativo para salvar.

    O Cloud Code clona a amostra que você escolheu e abre seu novo projeto para uso.

Usar seu próprio aplicativo

Para saber como usar um projeto, consulte Usar o Cloud Code com um aplicativo do Kubernetes.

Definir o contexto do Kubernetes

Antes de executar o aplicativo, verifique se você está configurado para implantar o aplicativo no contexto de sua preferência. É possível especificar isso na configuração.

Configuração

Ao usar a configuração de execução Cloud Code: desenvolver no Kubernetes, é possível personalizar a implantação definindo as configurações disponíveis.

Para adicionar ou editar configurações, acesse Run > Open Configurations e edite ou adicione configurações.

Configurações da versão

O Cloud Code é compatível com tipos de artefato do Docker, Jib e Buildpacks. Consulte Como configurar o guia de preferências de criação de imagens de contêiner para saber como definir o builder preferencial e as configurações relevantes.

Personalizar a configuração de inicialização

Para configurar a execução do aplicativo, personalize o arquivo skaffold.yaml.

Para mais informações sobre como personalizar a configuração de inicialização, consulte Kubernetes no Cloud Code.

Execute o aplicativo

Depois de configurar um aplicativo, você pode executá-lo em um cluster do Kubernetes e visualizá-lo ao vivo, usando skaffold dev. É possível executar o aplicativo em um cluster local (como Minikube ou Docker Desktop), Google Kubernetes Engine ou qualquer outro provedor de nuvem.

  1. Abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P) e execute o comando Cloud Code: Run on Kubernetes.
  2. Confirme se você quer usar o contexto do Kubernetes atual para executar o aplicativo (ou alternar para um preferido). Para mais informações sobre como configurar um contexto do Kubernetes, consulte Como configurar.

  3. Se você escolheu um cluster remoto como contexto, quando solicitado, escolha um registro de imagem para enviar as imagens. Se o projeto tiver a API Artifact Registry ativada e pelo menos um repositório do Artifact Registry, é possível navegar e selecionar um repositório do Artifact Registry.

    Os exemplos a seguir demonstram como especificar onde as imagens de contêiner são armazenadas para alguns registros comuns:

    Artifact Registry REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME
    Docker Hub docker.io/ACCOUNT
    Verifique se você tem a autenticação correta se estiver usando um repositório particular do Docker Hub.

    O Cloud Code concatena esse registro de imagem com o nome da imagem especificado nos manifestos do Kubernetes para gerar o nome final do repositório de imagens.

    Para mais informações, consulte o guia de processamento de registros de imagem.

    Essa escolha é armazenada em sua configuração de inicialização cloudcode.kubernetes (encontrada em .vscode/launch.json)

    O Cloud Code, em seguida, cria os contêineres, os envia para o registro, aplica as configurações do Kubernetes ao cluster e aguarda o lançamento.

Ver registros

Além de ver os registros de pods em execução como uma transmissão ao vivo na saída do terminal enquanto você está desenvolvendo e executando o aplicativo, é possível ver os registros de um pod específico navegando até o Kubernetes Explorer.

Para ver os registros de um pod específico, siga estas etapas:

  1. No Kubernetes Explorer, expanda Deployments.

  2. Clique com o botão direito do mouse no pod do qual você quer ver os registros e clique em Ver registros.

    O Visualizador de registros é aberto.

Fazer mudanças, recriar e limpar

Se você definiu o modo de exibição como false na configuração de inicialização e quer fazer alterações no aplicativo e recriá-lo e reimplantá-lo:

  1. Faça e salve as mudanças.

  2. Na barra de depuração, clique em Pausar (F6) e em Reiniciar (Ctrl/Cmd + Shift + F5) para recriar e implantar novamente o aplicativo.

  3. Para interromper a execução do aplicativo, na barra de ferramentas de depuração, clique em Stop.

Depois que você interrompe o aplicativo, todos os recursos implantados do Kubernetes são excluídos do cluster. É possível mudar esse comportamento usando a flag cleanUp na configuração de inicialização.

Armazenar secrets

Se o código inclui dados possivelmente confidenciais, como chaves de API, senhas e certificados, é recomendável armazená-los como secrets. O Cloud Code permite armazenar esses secrets com segurança no Gerenciador de secrets e buscá-los de maneira programática quando precisar deles.

Para uma visão detalhada de como criar e gerenciar secrets com o Cloud Code, consulte o guia do Gerenciador de secrets.

Conferir detalhes do recurso

O Kubernetes Explorer exibe clusters, namespaces, nós, 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). Com o Kubernetes Explorer, é possível executar ações exclusivas em alguns desses recursos.

Consulte a Visão geral do Kubernetes para mais informações sobre como conferir os detalhes do recurso.

A seguir