Desenvolver código usando um editor local do VS Code

Aprenda a abrir um túnel SSH da sua máquina local para uma estação de trabalho e use o suporte de desenvolvimento remoto do VS Code para se conectar às estações de trabalho do Cloud no editor local do VS Code.

Antes de começar

Antes de começar, siga as etapas para estas tarefas:

1. Certifique-se de que alguém de sua equipe tenha criado um configuração da estação de trabalho.
2. Crie e inicie sua estação de trabalho.

3. Enquanto você estiver no console do Google Cloud, copie as seguintes informações:

   1. Nome e ID do projeto: clique no nome do projeto no Google Cloud barra de menus e copie o ID na caixa de diálogo Nome e ID do projeto que abre.
   2. Região
   3. Nome do cluster
   4. Nome da configuração

4. Na sua máquina local, instale a CLI gcloud.

   Ao executar a CLI gcloud pela primeira vez, também é possível executar gcloud auth login para receber credenciais gcloud config set project PROJECT_ID para definir o valor atual project para o ID do projeto que você copiou na etapa anterior.

5. Ao usar ssh pela primeira vez, instale uma extensão SSH remota para podem se conectar a uma estação de trabalho pelo editor do VS Code pela Marketplace de extensões ou pela paleta de comandos.

   Marketplace de extensões

   1. Abra o aplicativo de editor local do VS Code e, em seguida, abra o Extension Marketplace selecionando
      Extensions na barra de atividades.

   2. Clique em Install para instalar a extensão Remote - SSH.

   3. Digite remote ssh no campo de pesquisa, que abre a página da extensão. para Remote - SSH.

      

   Paleta de comandos

   1. Para abrir a paleta de comandos, pressione Ctrl + Shift + P (ou Command + Shift + P no macOS) ou clique em Ver > Paleta de comandos.

   2. Digite ext install ms-vscode-remote.remote-ssh para instalar o .

Abrir um túnel SSH

Abra um túnel SSH na máquina local para uma estação de trabalho usando o gcloud workstations start-tcp-tunnel comando:

1. No console do Google Cloud, Acesse a página Cloud Workstations > Workstations.

   Acessar a estação de trabalho

2. Clique no nome da estação de trabalho para abrir a página Detalhes da estação de trabalho.

3. No exemplo a seguir, substitua os espaços reservados para o nome da estação de trabalho, região (local), nome do cluster da estação de trabalho e nome da configuração da estação de trabalho. Copie os valores dos detalhes da estação de trabalho nos espaços reservados marcados com um editÍcone Editar.

   gcloud workstations start-tcp-tunnel \
     --project=PROJECT_ID \
     --region=REGION \
     --cluster=CLUSTER_NAME \
     --config=CONFIG_NAME \
     --local-host-port=:LOCAL_PORT \
     WORKSTATION_NAME 22
   

   Consulte a Antes de começar para encontrar o ID do projeto.

   A sinalização --local-host-port=:LOCAL_PORT é opcional. Se quiser especificar uma porta local, substitua LOCAL_PORT pelo número da porta local que você quer usar. Se você não especificar uma porta local, o sistema escolherá uma porta local arbitrária e não utilizada e gera uma mensagem com a porta para saber qual porta local ela usa.

4. Após preencher os marcadores de posição, clique em content_copy Copie o exemplo de código para copiar o comando gcloud da CLI.

5. Cole o comando na janela de terminal local e pressione Enter. para criar o túnel.

   Quando o comando é bem-sucedido, uma mensagem Listening on port aparece, seguida por o número da porta local.

Para mais detalhes sobre cada sinalização de configuração, consulte Túnel SSH ou start-tcp-tunnel.

Conectar-se a um host do Cloud Workstations

Siga estas etapas para se conectar a um host do Cloud Workstations:

1. Abra ou volte para o aplicativo VS Code.

2. Para iniciar Remote - SSH, clique em Abra uma janela remota na barra de status.

   

3. Selecione a opção Conectar ao host quando a paleta de comandos abrir.

   

4. Digite user@localhost:LOCAL_PORT, substituindo LOCAL_PORT pelo número da porta local.

   O exemplo a seguir se conecta à porta local 1025 especificando user@localhost:1025.

   

5. Se a conexão for solicitada depois que você receber a confirmação Host adicionado clique em Conectar.

   O sistema também pode solicitar que você confirme o hash. Se for solicitado, clique em Continuar.

6. Um novo editor do VS Code é aberto, e a barra de status do VS Code mostra SSH: localhost, seguido pelo número da porta.

   Agora você tem acesso aos arquivos e servidores de idioma na estação de trabalho remota e pode criar e executar processos na estação de trabalho.

   O exemplo a seguir mostra uma janela do editor do VS Code conectada a estações de trabalho do Cloud por SSH: localhost: 1025.

   

   Você também pode voltar ao Marketplace de extensões para instalar Cloud Code (link em inglês) e outras extensões locais do VS Code para ajudar você criar, executar e testar o código.