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

O Cloud Code para Cloud Shell foi projetado para facilitar a configuração do Kubernetes e do Cloud Build, inspecionando o esquema para 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) do Kubernetes, como o 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ê muda para um cluster que executa o Kubernetes v1.16 e versões posteriores 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

Concluir com contexto

Com base no esquema atual, o Cloud Code fornece conclusões contextuais e documentações 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 indica: "Tipo incorreto". String esperada.

Descobrir a documentação ao passar o cursor do mouse

O Cloud Code mostra a documentação relevante quando você mantém o cursor sobre um valor no esquema.

Informações de documentação ao passar o cursor sobre um valor no esquema

Acessar definições de recursos

Para conferir as definições de um recurso, clique com o botão direito do mouse e escolha Acessar definições ou Ver 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.

As linhas onduladas amarelas aparecem quando o servidor considera uma parte do código como um erro com base no resultado de um teste de 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 é 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 conferir o contexto de um secret base64 com o Cloud Code, mantenha o ponteiro sobre o secret para decodificá-lo.

Decodificar o secret mantendo o ponteiro sobre ele

A seguir