Trabalhar com o Google Cloud e o YAML do Kubernetes no Cloud Code para VS Code

O Cloud Code para VS Code foi projetado para facilitar a configuração do Kubernetes e do Cloud Build, inspecionando o esquema dos valores de estrutura e válidos e fornecendo erros descritivos. O Cloud Code também inclui soluções prontas para uso relacionadas a esquemas comuns, conclusões inteligentes e documentação ao passar o cursor do mouse.

Arquivos de configuração YAML compatíveis

O Cloud Code também é compatível com definições de recursos personalizados (CRDs, na sigla em inglês) conhecidas do Kubernetes, como o Kubeflow, prontas para uso.

Usar esquema personalizado

Com o Cloud Code, é possível fornecer seu próprio esquema de CRD com a configuração cloudcode.yaml.crdSchemaLocations no arquivo settings.json. É possível apontar para um arquivo local ou um URL. Os URLs que direcionam o usuário para github.com são convertidos automaticamente em raw.githubusercontent.com.

Extrair esquema de um cluster

Quando você alterna para um cluster que executa o Kubernetes v1.16 e posterior na visualização do Kubernetes, o Cloud Code extrai automaticamente o esquema de todos os CRDs instalados.

Configurar com snippets

Os snippets prontos para uso no esquema YAML comum (usando Command/Ctrl+Space para visualizar opções) tornam mais fácil iniciar um novo arquivo YAML ou adicionar um arquivo existente sem erros, basta seguir as práticas recomendadas. O Cloud Code facilita o trabalho com campos repetitivos, preenchendo as instâncias restantes depois de preencher o primeiro campo.

O Cloud Code oferece os seguintes snippets:

  • Anthos Config Management - Cluster
  • Anthos Config Management - Cluster Selector
  • Anthos Config Management - Config Management
  • Anthos Config Management - Namespace Selector
  • Cloud Build - Cloud Run deployment
  • Cloud Build - Docker container build
  • Cloud Build - GKE deployment
  • Cloud Build - GKE Skaffold deployment
  • Cloud Build - Go build
  • Cloud Build - Terraform plan + apply
  • Config Connector - BigQueryDataset
  • Config Connector - BigQueryTable
  • Config Connector - BigtableCluster
  • Config Connector - BigtableInstance
  • Config Connector - PubSubSubscription
  • Config Connector - PubSubTopic
  • Config Connector - RedisInstance
  • Config Connector - SpannerInstance
  • Kubernetes - ConfigMap
  • Kubernetes - Deployment
  • Kubernetes - Ingress
  • Kubernetes - Pod
  • Kubernetes - Secret
  • Kubernetes - Service
  • Migrate to Containers - Export
  • Migrate to Containers - PersistentVolumeClaim
  • Migrate to Containers - StatefulSet
  • Skaffold - Bazel
  • Skaffold - Getting-started
  • Skaffold - Helm deployment
  • Skaffold - Kaniko

Completar com contexto

Com base no esquema atual, o Cloud Code fornece preenchimentos contextuais e documentos relevantes para ajudar você a escolher a opção certa.

Conclusões contextuais do esquema do Kubernetes

Validar esquema YAML

O Cloud Code é compatível com a validação de esquema sinalizando tags e valores inválidos nos arquivos YAML e sugerindo correções, quando possível.

Valor do campo de nome sublinhado em vermelho para destacar um valor inválido de 1234; o texto flutuante diz: Tipo incorreto. String esperada.

Descubra a documentação ao passar o cursor

O Cloud Code mostra documentos relevantes quando você mantém o ponteiro sobre um valor no esquema.

Informações de documentação ao manter o ponteiro sobre um valor no esquema

Acessar definições de recursos

Para ver as definições de um recurso, clique com o botão direito do mouse nele e escolha Acessar definição ou Ver definição.

Aplicar um arquivo YAML

Para aplicar uma alteração de configuração usando o arquivo atual, abra a paleta de comando (pressione Ctrl/Cmd+Shift+P ou clique em Ver > Paleta de comandos) e execute Cloud Code: Aplicar arquivo JSON/YAML atual no recurso implantado do K8s.

Esse comando exibe uma visualização de diferença para você revisar as alterações. Clique em Aplicar quando solicitado a aplicar essa alteração. Isso executa kubectl apply -f.

Conferir diferenças entre arquivos YAML

Para conferir as diferenças entre um arquivo YAML no controle de origem e um arquivo YAML implantado, abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P ou clique em Visualizar > Paleta de comandos) e execute Cloud Code: comparação do arquivo JSON/YAML atual com o recurso implantado do K8s.

Executar uma simulação de um arquivo YAML

O Cloud Code faz simulações automáticas conforme você digita informações no arquivo YAML e sublinha os erros com uma linha amarela sinuosa.

Linhas amarelas onduladas aparecem quando o servidor considera uma parte do código como um erro com base no resultado de uma simulação. Isso pode incluir violações de políticas, nomes duplicados ou validações que o Cloud Code não executa no lado do cliente (como números máximos de portas).

Para conferir a descrição do erro no arquivo YAML, mantenha o ponteiro do mouse sobre o código com um sublinhado amarelo.

A validação de simulação no servidor falha em "hello.deployment.yaml" com uma mensagem de erro exibida como um aviso. Os detalhes do erro são encontrados no canal de saída. O namespace "random-namespace" não existe

Linhas vermelhas sinuosas aparecem para os erros detectados antes da verificação do Cloud Code com o servidor do Kubernetes. Por exemplo, colocar um número em que uma string é esperada aciona uma linha ondulada vermelha.

Trabalhar com secrets

Usar mapas de configuração e secrets é uma parte fundamental de trabalhar com o Kubernetes. Para ver o contexto de um secret base64 com o Cloud Code, mantenha o ponteiro do secret no secret para decodificá-lo.

Decodificar o secret segurando o ponteiro sobre ele

A seguir

Receber suporte

Acesse o GitHub (em inglês) para enviar feedback e informar problemas ou o Stack Overflow (em inglês) para fazer perguntas.