Desenvolva código com um editor do VS Code local

Saiba como abrir um túnel SSH da sua máquina local para uma estação de trabalho e, em seguida, usar o suporte de desenvolvimento remoto do VS Code para se ligar às Cloud Workstations a partir do seu editor VS Code local.

Antes de começar

Antes de começar, certifique-se de que segue os passos destas tarefas:

1. Certifique-se de que alguém da sua equipa criou uma configuração da estação de trabalho.
2. Crie e inicie a sua estação de trabalho.

3. Enquanto estiver na Google Cloud consola, copie as seguintes informações:

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

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

   Se estiver a executar a gcloud CLI pela primeira vez, também pode ter de executar gcloud auth login para obter credenciais e gcloud config set project PROJECT_ID para definir o seu projeto atual como o ID do projeto que copiou no passo anterior.

5. Quando usar o ssh pela primeira vez, instale uma extensão SSH remota para poder ligar-se a uma estação de trabalho a partir do editor do VS Code através do Extension Marketplace ou da paleta de comandos.

   Mercado de extensões

   1. Abra a aplicação do editor VS Code local e, em seguida, abra o Extension Marketplace selecionando
      Extensões na barra de atividade.

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

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

      

   Paleta de comandos

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

   2. Introduza ext install ms-vscode-remote.remote-ssh para instalar a extensão.

Abra um túnel SSH

Abra um túnel SSH da sua máquina local para uma estação de trabalho através do comando gcloud workstations start-tcp-tunnel:

1. Na Google Cloud consola, aceda à página Cloud Workstations > Estações de trabalho.

   Aceda a Estações 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 seguinte, substitua os marcadores de posição pelo nome da estação de trabalho, pela região (localização), pelo nome do cluster da estação de trabalho e pelo nome da configuração da estação de trabalho. Copie os valores do painel Detalhes da estação de trabalho para os marcadores de posição marcados com um ícone de edição .

   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 secção Antes de começar para encontrar o ID do projeto.

   A flag --local-host-port=:LOCAL_PORT é opcional. Se quiser especificar uma porta local, substitua LOCAL_PORT pelo número da porta local que quer usar. Se não especificar uma porta local, o sistema escolhe uma porta local arbitrária e não utilizada para si e envia uma mensagem com o número da porta para que saiba qual porta local está a usar.

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

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

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

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

Estabeleça ligação a um anfitrião do Cloud Workstations

Siga estes passos para estabelecer ligação a um anfitrião do Cloud Workstations:

1. Abra ou regresse à aplicação VS Code.

2. Para iniciar o Remote - SSH, clique em Abrir uma janela remota na barra de estado.

   

3. Selecione a opção Associar ao anfitrião quando a paleta de comandos for aberta.

   

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

   O exemplo seguinte estabelece ligação à porta local 1025 especificando user@localhost:1025.

   

5. Se lhe for pedido que faça a associação depois de ver a mensagem de confirmação Anfitrião adicionado, clique em Associar.

   O sistema também pode pedir-lhe que confirme o hash. Se lhe for pedido, clique em Continuar.

6. É aberto um novo editor do VS Code e a barra de estado do VS Code mostra SSH: localhost: seguido do número da porta.

   Agora, tem acesso aos ficheiros e aos servidores de idiomas na sua estação de trabalho remota e pode criar e executar processos que são executados na sua estação de trabalho.

   O exemplo seguinte mostra uma janela do editor do VS Code ligada a estações de trabalho na nuvem através de SSH: localhost: 1025.

   

   Também pode voltar ao Extensions Marketplace para instalar o Cloud Code e outras extensões locais do VS Code que ajudam a criar, executar e testar o seu código.