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 para estrutura e valores 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 dá suporte a recursos populares do Kubernetes (CRDs), como Kubeflow, pronto 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 apontam para github.com são convertidos automaticamente em raw.githubusercontent.com.

Extrair o esquema de um cluster

Quando você alterna para um cluster que executa o Kubernetes v1.16 e posteriores 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 que você 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 conclusões e documentos relevantes para ajudar você a escolher a opção certa.

Conclusões contextuais do esquema do Kubernetes

Validar o 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 ao passar o cursor afirma: Tipo incorreto. String esperada.

Descubra a documentação ao passar o cursor

O Cloud Code exibe documentações relevantes ao manter o cursor 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 Acesse a definição ou Veja a definição.

Aplicar um arquivo YAML

Para aplicar uma alteração de configuração usando o arquivo atual, abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P ou clique em View > Command Palette) e execute Cloud Code: Apply Current JSON/YAML File to K8s Deployed Resource.

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 as 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 View > Command Palette) e execute Cloud Code: diff the current JSON/YAML file with K8s deployed resource.

Executar uma simulação de um arquivo YAML

O Cloud Code executa simulações automaticamente conforme você digita informações no arquivo YAML e sublinhe os erros com uma linha ondulada amarela.

Linhas amarelas onduladas aparecem quando o servidor considera uma parte do seu código. 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 de porta máximos).

Para conferir a descrição do erro no arquivo YAML, mantenha o ponteiro sobre o código com 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 onduladas vermelhas aparecem para erros detectados antes que o Cloud Code verifique com o servidor do Kubernetes. Por exemplo, colocar um número onde uma string é esperado aciona uma linha ondulada vermelha.

trabalhar com secrets

O uso de mapas de configuração e segredos é uma parte fundamental de trabalhar com o Kubernetes. Para ver o contexto de uma base64 com o Cloud Code, mantenha o ponteiro do mouse sobre o secret para decodificar reimplantá-lo.

Decodificar o secret segurando o ponteiro sobre ele

A seguir

Receber suporte

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