Instale a extensão Cloud Code para VS Code

A extensão Cloud Code para VS Code adiciona suporte para Google Cloud desenvolvimento ao VS Code.

Antes de começar

Antes de instalar o Cloud Code, confirme que 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 de idiomas.

   A extensão Cloud Code funciona melhor com os seguintes idiomas:

   • NodeJS (apoio técnico integrado; não é necessária nenhuma ação)
   • Go
   • Python
   • Java
   • .NET

3. Instale o Git. O Git é necessário para copiar exemplos para o seu computador.

4. Instale o cliente Docker e adicione-o à variável de ambiente PATH:

   • Se estiver a criar exclusivamente com o Cloud Build ou o Jib, pode ignorar a instalação do Docker.
   • Se estiver a usar o WSL, mas não conseguir instalar o Docker for Desktop, use o minikube para o desenvolvimento local com o Cloud Code.

5. Se estiver a usar Google Cloud, crie um Google Cloud projeto e, em seguida, ative a faturação.

   Os projetos permitem-lhe recolher os recursos relacionados para uma única aplicação num único local, gerir APIs, ativar serviços Google Cloud , adicionar e remover colaboradores, e gerir autorizações para Google Cloud recursos.

Instale o Cloud Code

Nota: quando instala o Cloud Code, a extensão Gemini Code Assist também é instalada por predefinição.

Instale a extensão Google Cloud Code a partir do Visual Studio Code Marketplace.

Em alternativa, abra a vista Extensões no VS Code:

1. Clique em Extensões ou prima Ctrl/Cmd+Shift+X.

2. Pesquise Google Cloud Code.

   

3. Clique em Instalar.

4. Se lhe for pedido, reinicie o VS Code.

   Depois de a extensão ser instalada com êxito, o ícone do Cloud Code é adicionado à barra de atividade e fica pronto a ser usado. Pode configurar ainda mais a instalação do Cloud Code especificando as suas preferências através da barra de tarefas da aplicação de nível superior: navegue para Código > Definições > Definições > Extensões e pesquise Gemini Code Assist + Google Cloud Code.

Versões personalizadas de dependências

Por predefinição, o Cloud Code tem a opção Auto dependencies ativada e instala automaticamente algumas dependências da linha de comandos. Se desativar as dependências automáticas, pode usar versões personalizadas das dependências, mas tem de as instalar manualmente para que o Cloud Code funcione.

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

1. Clique em definições Gerir > Definições e, de seguida, defina Dependências automáticas (cloudcode.autoDependencies) como off.

2. Instale as seguintes dependências no seu dispositivo PATH:

   • kubectl
   • Skaffold
   • minikube para desenvolvimento local

Instale a CLI Google Cloud

A primeira vez que usa uma funcionalidade que requer a CLI gcloud, tem a opção de saber como instalar a CLI a partir do IDE, usar uma instalação existente ou continuar com dependências geridas. Se preferir instalar a CLI gcloud manualmente, consulte o artigo Instale a CLI gcloud.

Opcional: valide o VSIX do Cloud Code com o VsixSignTool

Para validar o ficheiro .vsix do Cloud Code com o VsixSignTool, siga os seguintes passos:

1. Certifique-se de que está a usar o seguinte:

   • Gestor de pacotes NuGet
   • SO Windows
   • Um lançamento de produção do Cloud Code

2. Instale o Microsoft VsixSignTool e tome nota do caminho de instalação.

3. Abra o VS Code e navegue para Extensões > Cloud Code.

4. No separador Detalhes, em Recursos de extensões, clique em Marketplace.

5. Na página do Marketplace no seu navegador, em Recursos, clique em Transferir extensão para transferir a versão em pacote do Cloud Code. Esta ação transfere a versão em pacote do Cloud Code, que tem uma extensão de ficheiro .vsix, para o diretório de transferência predefinido.

6. Se preferir validar uma versão diferente da mais recente, clique no separador Histórico de versões e selecione uma versão diferente para transferir.

   Nota: a versão mais antiga do Cloud Code que pode validar com o VsixSignTool é a 1.20.2.

7. Quando a transferência estiver concluída, abra uma janela de terminal e execute o seguinte:

   PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
   

8. Confirme que o resultado corresponde ao seguinte:

   VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Autentique as credenciais de Google Cloud

Para ajudar no desenvolvimento de aplicações com APIs, quando inicia sessão na CLI gcloud, as Credenciais padrão da aplicação são atualizadas. Google Cloud

Inicie sessão em Google Cloud

Se não tiver sessão iniciada no Google Cloud, siga estes passos para iniciar sessão:

1. Na barra de estado do Cloud Code, clique em Cloud Code – Iniciar sessão.

2. Se for a primeira vez que se liga ao Google Cloud no seu IDE, é-lhe pedido que adicione https://accounts.google.com ao domínio fidedigno. Clique em Configurar domínios fidedignos na caixa de diálogo apresentada:

   

3. Siga as instruções para iniciar sessão através do navegador de Internet.

4. Quando lhe for pedido para permitir que o Cloud Code aceda à sua Conta Google, clique em Permitir.

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

Quando usa o navegador Microsoft Edge para autenticar as suas credenciais, pode reparar que o navegador Edge redireciona o URL http://localhost:3000 para https://localhost:3000. Isto 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 este problema, pode excluir localhost do redirecionamento:

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

2. Aceda à secção Eliminar políticas de segurança de domínio.

3. Introduza localhost e, de seguida, clique em Eliminar.

Termine sessão no Google Cloud

1. Clique em Cloud Code e, de seguida, expanda Ajuda e feedback.
2. Clique em Terminar sessão no Google Cloud e, quando lhe for pedido, selecione Terminar sessão.
3. Em alternativa, pode terminar sessão através da paleta de comandos. Prima Ctrl/Cmd+Shift+P ou clique em Ver > Paleta de comandos, e, de seguida, clique em Terminar sessão em todas as contas no SDK do Google Cloud.

Altere o Google Cloud projeto Google Cloud ativo

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

   

2. No menu de seleção rápida apresentado, selecione sync_alt Mudar de projeto.

3. Selecione um projeto ou introduza palavras-chave na barra de pesquisa para filtrar projetos.

Autentique credenciais para depurar aplicações localmente

Além dos passos de autenticação na secção Inicie sessão em Google Cloud, tem de autenticar as suas credenciais para depurar uma aplicação localmente no seu IDE que faça chamadas à API Google.

Se não autenticar as suas credenciais para depurar aplicações, é apresentada uma mensagem de erro no IDE quando tenta executar/depurar uma aplicação local que tenta fazer uma chamada a uma API Google.

Para autenticar as suas credenciais para depurar aplicações localmente, siga os passos seguintes:

1. Instale o gcloud no seu computador, se ainda não o tiver feito.

2. Execute o seguinte comando:

   gcloud auth application-default login
   

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

   gcloud auth application-default revoke
   

Para saber mais sobre as Credenciais padrão da aplicação e as APIs Google, consulte o artigo Autentique-se nos serviços na nuvem através de bibliotecas cliente.

O que se segue?

• Criar uma aplicação
• Crie e configure um cluster do GKE
• Desenvolver APIs com o Apigee

Obter apoio técnico

Para enviar feedback, comunicar problemas no GitHub ou fazer uma pergunta no Stack Overflow.