Instale a extensão do Cloud Code para VS Code

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:

  1. Instale e configure o Visual Studio Code. na sua máquina.

  2. Instale e configure o suporte à linguagem.

    A extensão do Cloud Code funciona melhor com as seguintes linguagens:

  3. Instale o Git. O Git é necessário para copiar amostras na sua máquina.

  4. 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.

  5. 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 no Marketplace do Visual Studio Code.

Como alternativa, abra a visualização Extensões no VS Code:

  1. Clique em Ícone de extensão. Extensões ou pressione Ctrl/Cmd+Shift+X.

  2. Pesquise Google Cloud Code.

    Extensão do Cloud Code no VSC Marketplace

  3. Clique em Install (Instalar).

  4. Se solicitado, reinicie o VS Code.

    Após a instalação da extensão, o Cloud Code é adicionado à barra de atividades e pronto para uso. Você pode configure a instalação do Cloud Code especificando o preferências usando a barra de tarefas de nível superior do aplicativo: acesse Código > Configurações > Configurações > Extensões e pesquise por Gemini Code Assist + Google 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 de linha de comando automaticamente. Se você desativar dependências automáticas, é possível usar versões personalizadas das dependências, você precisa instalar as dependências para o Cloud Code funcionar.

Para usar versões personalizadas das dependências do Cloud Code:

  1. Clique em Configurações. Gerenciar > Configurações e defina Dependências automáticas (cloudcode.autoDependencies) para off.

  2. Instale as seguintes dependências no PATH:

Instale a CLI do Google Cloud

Ao usar um recurso que exige a CLI gcloud pela primeira vez, você vai se você tiver a opção de aprender a instalar a CLI pelo ambiente de desenvolvimento integrado, ou continue com as dependências gerenciadas. Se preferir instalar a CLI gcloud manualmente, consulte Instale a CLI gcloud.

Opcional: verificar o Cloud Code vsix usando o VsixSignTool

Para verificar o Cloud Code vsix com a VsixSignTool, execute a etapas a seguir:

  1. Verifique se você está usando o seguinte:

    • Gerenciador de pacotes Nuget
    • SO Windows
    • Uma versão de produção do Cloud Code

  2. Instale a Microsoft VsixSignTool. e anote o caminho da instalação.

  3. Abra o VS Code e navegue até Ícone de extensões no VSC Extensões > Cloud Code:

  4. Na guia Detalhes, em Recursos de extensão, clique em Marketplace.

  5. Na página do Marketplace no navegador, em Recursos, clique em Faça o download da extensão para fazer o download da versão empacotada do Cloud Code. Isso faz o download da versão empacotada do O Cloud Code, que tem uma extensão de arquivo .vsix, para a diretório de downloads.

  6. Se preferir verificar uma versão diferente da mais recente, clique no guia Histórico de versões e selecione uma versão diferente para fazer o download.

  7. Quando o download for concluído, abra uma janela do terminal e execute o seguinte:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Confirme se a saída corresponde a esta:

    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, faça login na CLI gcloud, seu Application Default Credentials sejam atualizados.

Faça login no Google Cloud

Se você não tiver feito login no Google Cloud, siga estas etapas:

  1. Na barra de status do Cloud Code, clique em Cloud Code - Fazer login.

  2. Se esta for a primeira vez que você se conecta ao Google Cloud no seu ambiente de desenvolvimento integrado, Você verá uma solicitação para adicionar https://accounts.google.com ao domínio confiável. Clique em Configurar domínios confiáveis na caixa de diálogo que aparece:

    Caixa de diálogo "Configurar domínio confiável"

  3. Siga as instruções para fazer login usando o navegador da Web.

  4. Quando você receber uma solicitação para permitir que o Cloud Code acesse seus serviços Conta, clique em Permitir.

Problema conhecido: o navegador de borda redireciona para HTTPS no callback de autenticação

Ao usar o navegador Microsoft Edge para autenticar suas credenciais, você pode: observe que o navegador Edge 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:

  1. Na barra de endereço do navegador Edge, digite edge://net-internals/#hsts.

  2. Acesse a seção Excluir políticas de segurança do domínio.

  3. Digite localhost e clique em Excluir.

Sair do Google Cloud

  1. Clique em Cloud Code e expanda Ajuda e feedback.
  2. Clique em Sair do Google Cloud e, quando solicitado, selecione Sair.
  3. Como alternativa, você pode fazer logout usando a Paleta de comandos. Pressione Ctrl/Cmd+Shift+P ou clique em Ver > Paleta de comandos, Depois clique em Sair de todas as contas no SDK Google Cloud.

Alterar o projeto ativo do Google Cloud

  1. Na barra de status do Cloud Code, clique no nome do projeto ativo.

    Nome do projeto ativo na barra de status

  2. No menu "Escolha rápida" que aparece, selecione sync_alt Mudar de projeto.

  3. Selecione um projeto ou digite palavras-chave na barra de pesquisa para filtrá-los.

Autenticar credenciais para depurar aplicativos localmente

Além das etapas de autenticação no Fazer login no Google Cloud, você precisará autenticar suas credenciais para depurar um aplicativo localmente em seu IDE que faz chamadas de API do Google.

Se você não autenticar suas credenciais para depurar aplicativos, uma mensagem de erro aparece no seu ambiente de desenvolvimento integrado quando você tenta executar/depurar um aplicativo local que tenta fazer uma chamada para uma API do Google.

Para autenticar suas credenciais e depurar aplicativos localmente, execute o etapas a seguir:

  1. Instale o gcloud na sua máquina, caso ainda não tenha feito isso já fez isso.

  2. Execute este comando:

    gcloud auth application-default login

  3. Quando terminar a depuração localmente, saia executando o seguinte comando:

    gcloud auth application-default revoke

Para saber mais sobre o Application Default Credentials e APIs do Google, consulte Faça a autenticação nos serviços do Cloud usando bibliotecas de cliente.

A seguir

Receber suporte

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