A extensão do Cloud Code para VS Code adiciona suporte para o desenvolvimento do Google Cloud ao VS Code.
Antes de começar
Antes de instalar o Cloud Code, confirme se as seguintes ferramentas estão instaladas e configuradas no seu sistema:
- Instale e configure o Visual Studio Code na sua máquina.
Instale e configure o suporte à linguagem.
A extensão do Cloud Code funciona melhor com as seguintes linguagens:
Instale o Git. O Git é necessário para copiar amostras na sua máquina.
Instale o cliente do Docker e adicione-o à variável de ambiente
PATH
:- Se você estiver criando apenas com o Cloud Build ou o Jib, será possível pular a instalação do Docker.
- Se você estiver usando o Windows Home, para ver as etapas de configuração do cliente Docker, consulte o Guia do Docker para Windows para computador.
- Se você usa o WSL, mas não consegue instalar o Docker para computadores, use o minikube em vez de desenvolvimento local com o Cloud Code.
Se você estiver usando o Google Cloud, crie um projeto do Google Cloud e ative o faturamento.
Com os projetos, é possível coletar os recursos relacionados de um único aplicativo em um só lugar, gerenciar APIs, ativar serviços do Google Cloud, adicionar e remover colaboradores e gerenciar permissões de recursos do Google Cloud.
Instalar o Cloud Code
Instale a extensão do Google Cloud Code do Visual Studio Code Marketplace.
Como alternativa, abra a visualização Extensions no VS Code:
Clique em Extensões ou pressione
Ctrl
/Cmd
+Shift
+X
.Pesquisar por
Google Cloud Code
.Clique em Install (Instalar).
Se solicitado, reinicie o VS Code.
Depois que a extensão for instalada, o ícone do Cloud Code será adicionado à barra de atividades e estará pronto para uso. É possível configurar melhor a instalação do Cloud Code especificando suas preferências na barra de tarefas do aplicativo de nível superior: Code > Preferences > Settings > Extensions > Cloud Code.
Versões personalizadas de dependências
Por padrão, o Cloud Code tem as dependências automáticas ativadas e instala algumas dependências da linha de comando automaticamente. Se você desativar as dependências automáticas, poderá usar versões personalizadas delas, mas precisará instalá-las para que o Cloud Code funcione.
Para usar versões personalizadas das dependências do Cloud Code, faça o seguinte:
- Clique em settings
Manage > Settings e defina Auto Dependencies
(
cloudcode.autoDependencies
) comooff
. Instale as seguintes dependências no
PATH
:- kubectl
- Skaffold
- minikube para desenvolvimento local
- Google Cloud CLI, se estiver desenvolvendo com o Google Cloud
Opcional: verifique o Cloud Code vsix usando a VsixSignTool
Para verificar o Cloud Code vsix com a VsixSignTool, siga estas etapas:
Verifique se você está usando o seguinte:
- Gerenciador de pacotes Nuget
- SO Windows
- Uma versão de produção do Cloud Code
Instale a Microsoft VsixSignTool e anote o caminho de instalação.
Abra o VS Code e navegue até Extensões > Cloud Code.
Na guia Details, em Extension Resources, clique em Marketplace.
Na página do Marketplace no navegador, em Recursos, clique em Fazer download da extensão para fazer o download da versão empacotada do Cloud Code. Isso faz o download da versão empacotada do Cloud Code, que tem uma extensão de arquivo
.vsix
, para o diretório de download padrão.Caso prefira verificar uma versão diferente da mais recente, clique na guia Histórico de versões e selecione uma versão diferente para fazer o download.
Quando o download for concluído, abra uma janela do terminal e execute o seguinte:
PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
Confirme se o resultado corresponde ao seguinte:
VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.
Autenticar credenciais para o Google Cloud
Para ajudar no desenvolvimento de aplicativos com as APIs do Google Cloud, ao fazer login na CLI gcloud, o Application Default Credentials será atualizado.
Faça login no Google Cloud
Se você não tiver feito login no Google Cloud, siga estas etapas:
- Na barra de status do Cloud Code, clique em Cloud Code - Fazer login.
Se esta for sua primeira conexão com o Google Cloud no seu ambiente de desenvolvimento integrado, você precisará adicionar
https://accounts.google.com
ao domínio confiável. Clique em Configurar domínios confiáveis na caixa de diálogo exibida:Siga as instruções para fazer login no navegador da Web.
Quando solicitado, permita que o Cloud Code acesse sua Conta do Google. Clique em Permitir.
Problema conhecido: o navegador Edge redireciona para HTTPS no callback de autenticação
Ao usar o navegador Microsoft Edge para autenticar suas credenciais, você pode
perceber que ele redireciona o URL http://localhost:3000
para
https://localhost:3000
. Isso leva à seguinte mensagem de falha:
The connection for this site is not secure. localhost sent an invalid response.
Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.
Para resolver esse problema, exclua localhost
do redirecionamento:
Na barra de endereço do navegador Edge, digite
edge://net-internals/#hsts
.Acesse a seção Excluir políticas de segurança do domínio.
Digite
localhost
e clique em Excluir.
Sair do Google Cloud
- Clique em Cloud Code e expanda Ajuda e feedback.
- Clique em Sair do Google Cloud e, quando solicitado, selecione Sair.
- Como alternativa, é possível sair usando a Paleta de comandos. Pressione
Ctrl
/Cmd
+Shift
+P
ou clique em Visualizar > Paleta de comandos e depois em Sair de todas as contas no SDK Google Cloud.
Alterar o projeto ativo do Google Cloud
Na barra de status do Cloud Code, clique no nome do projeto ativo.
No menu de escolha rápida exibido, selecione sync_alt Alternar projeto.
Selecione um projeto ou digite palavras-chave na barra de pesquisa para filtrar projetos.
Autentique credenciais para depurar aplicativos localmente
Além das etapas de autenticação na seção Fazer login no Google Cloud, você precisará autenticar suas credenciais para depurar um aplicativo localmente no seu ambiente de desenvolvimento integrado que faz chamadas de API do Google.
Se você não autenticar suas credenciais para a depuração de aplicativos, uma mensagem de erro vai aparecer no seu ambiente de desenvolvimento integrado quando você tentar executar/depurar um aplicativo local que tenta fazer uma chamada para uma API do Google.
Para autenticar suas credenciais para depurar aplicativos localmente, siga estas etapas:
Instale o gcloud na sua máquina, caso ainda não tenha feito isso.
Execute este comando:
gcloud auth application-default login
Quando terminar a depuração local, saia executando o seguinte comando:
gcloud auth application-default revoke
Para saber mais sobre o Application Default Credentials e as APIs do Google, consulte Autenticar nos serviços do Cloud usando bibliotecas de cliente.