Desenvolver códigos usando ambientes de desenvolvimento integrado locais do JetBrains

O plug-in do Cloud Workstations permite iniciar sessões de desenvolvimento remoto para Cloud Workstations usando ambientes de desenvolvimento integrado do JetBrains, como IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm e WebStorm.

Sistemas operacionais compatíveis

O plug-in do Cloud Workstations é compatível com os seguintes sistemas operacionais:

• Windows
• macOS (Intel e Apple Silicon)
• Linux

Versões compatíveis

O plug-in do Cloud Workstations oferece suporte à versão mais recente e a uma versão anterior dos ambientes de desenvolvimento integrados do JetBrains e do JetBrains Gateway. Quando uma nova versão principal do JetBrains IDE é lançada, a próxima versão do plug-in do Cloud Workstations oferece suporte à nova versão e deixa de oferecer suporte à versão mais antiga.

Observação: o suporte do plug-in do Cloud Workstations para o Programa de acesso antecipado do JetBrains (EAP, na sigla em inglês) é feito com base no melhor esforço. O EAP às vezes introduz mudanças importantes, e elas podem levar algum tempo para serem resolvidas.

Para facilitar a atualização dos apps da JetBrains, você também pode instalar o JetBrains Toolbox.

Para mais informações sobre as versões do ambiente de desenvolvimento integrado do JetBrains em imagens de base pré-configuradas, consulte as notas da versão das estações de trabalho do Google Cloud.

Antes de começar

Siga estas etapas antes de instalar o plug-in do Cloud Workstations:

1. Siga as etapas para criar uma estação de trabalho. Quando solicitado, escolha a imagem que corresponde ao ambiente de desenvolvimento integrado do JetBrains que você quer usar.

2. Depois de inserir o nome da estação de trabalho, clique em Criar.

3. Clique na página Estações de trabalho e aguarde a conclusão da criação da estação de trabalho.

4. Faça o download e instale uma versão com suporte do JetBrains Gateway.

Instalar o plug-in do Cloud Workstations

Observação: se você for um usuário do BYOID, pule para a seção Instruções de conexão alternativas para usuários do BYOID.

1. Instale o plug-in do Cloud Workstations:

   1. Abra o JetBrains Gateway.

   2. Selecione Todos os provedores.

   3. Na seção Instalar mais provedores, encontre Google Cloud e clique em Instalar para fazer o download do plug-in do Cloud Workstations.

      

2. Após a instalação, Estações de trabalho do Cloud vai aparecer na seção Executar o ambiente de desenvolvimento integrado remotamente.

Conectar usando o plug-in do Cloud Workstations

Para se conectar a uma estação de trabalho usando o plug-in, siga estas etapas:

1. Abra o JetBrains Gateway.

2. Na seção Executar o ambiente de desenvolvimento integrado remotamente, clique em Conectar ao Google Cloud.

3. Clique em Fazer login para acessar sua Conta do Google.

   1. Siga as instruções para conceder ao plug-in do Cloud Workstations acesso ao Google Cloud.

   2. Clique em Continuar para concluir o login.

4. Clique em Procurar para abrir uma caixa de diálogo de seletor de projetos e selecionar um projeto do Cloud.

   

5. Selecione uma estação de trabalho no projeto do Cloud, clique em Next e aguarde a estação de trabalho selecionada ser iniciada.

6. Selecione o ambiente de desenvolvimento integrado e o projeto:

   1. Selecione uma versão do ambiente de desenvolvimento integrado no host remoto.

   2. Insira um caminho de projeto do ambiente de desenvolvimento integrado no host remoto.

      

   Observação: lembre-se de que apenas os arquivos armazenados no diretório /home são preservados entre as sessões.

7. Clique em Conectar e aguarde a abertura do ambiente de desenvolvimento integrado e do projeto.

Reconectar a uma estação de trabalho

Para se reconectar rapidamente a uma estação de trabalho e a um projeto do ambiente de desenvolvimento integrado:

1. Abra o painel Conexões recentes.

2. Clique em um caminho de projeto para abrir um ambiente de desenvolvimento integrado nos Cloud Workstations.

   

3. Aguarde o ambiente de desenvolvimento integrado e o projeto serem abertos.

Usar o encaminhamento de portas

Depois que o cliente da JetBrains for aberto com o ambiente de desenvolvimento integrado e o projeto, você poderá acessar portas remotas no Cloud Workstations usando a máquina local. Por exemplo, quando você executa um servidor Python na estação de trabalho, python -m SimpleHTTPServer 8080. Em alguns casos, o JetBrains Gateway realiza o encaminhamento de portas automaticamente para que você possa acessar projetos executados remotamente pelo seu navegador local.

Também é possível encaminhar manualmente a porta dos Cloud Workstations para a máquina local da seguinte maneira:

1. Para Windows e Linux, selecione File > Settings no menu principal.

   No macOS, selecione IntelliJ IDEA > Preferences no menu principal.

2. Acesse Tools > Port Forwarding e adicione uma nova regra para encaminhar o TCP para a porta 8080.

3. Depois de definir essa regra, você poderá acessar a porta 8080 dos Cloud Workstations localmente em http://localhost:8080.

Substituir endpoints de API

Para usuários de nuvem privada virtual que precisam substituir endpoints de API, verifique se o plug-in pode se conectar aos seus serviços de nuvem. Para substituir os endpoints da API, siga estas etapas:

1. No Windows e no Linux, clique em settings Options menu > Settings.

   

   No macOS, clique em settings Options menu > Preferences.

   

2. Opcional: para acessar as Configurações do JetBrains para IntelliJ e outros ambientes de desenvolvimento integrado, consulte configurar as configurações do projeto.

3. Acesse Ferramentas > Google Cloud Workstations > Avançado.

4. Adicionar URLs de substituição endpoint de API.

   Observação: use os nomes de DNS p.googleapis.com da nuvem privada virtual. Não use endereços IP.

   

5. Clique em Aplicar.

Para mais informações sobre o uso de endpoints no Google Cloud, consulte a descrição da nuvem privada virtual sobre como acessar APIs do Google por endpoints.

Instruções de conexão alternativas para usuários BYOID

Se você usar o BYOID, precisará seguir outras etapas para se conectar ao gateway Jetbrains. Siga estas etapas:

Inicie a estação de trabalho e abra uma conexão TCP

As etapas a seguir iniciam a estação de trabalho e abrem uma conexão TCP:

1. Siga as instruções na seção "Antes de começar".

2. Verifique se a estação de trabalho está em execução. Use o seguinte comando da CLI gcloud para iniciá-lo.

   gcloud workstations start WORKSTATION_ID –-project=PROJECT \
     --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
     --region=WORKSTATION_CLUSTER_REGION
   

3. Inicie um túnel TCP para a estação de trabalho na porta 22:

   gcloud workstations start-tcp-tunnel --project=PROJECT \
       --cluster=WORKSTATION_CLUSTER_ID \
       --config=WORKSTATION_CONFIG_ID \
       --region=WORKSTATION_CLUSTER_REGION \
       WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222
   

Observação: é necessário ter a CLI gcloud versão 387.0.0 ou mais recente para que esse comando seja aceito. Para verificar a versão da CLI gcloud, execute o comando gcloud version. Se necessário, atualize com o comando gcloud components update.

Com a configuração e instalação iniciais concluídas, a próxima etapa é iniciar o Jetbrains Gateway.

Abrir o Jetbrains Gateway

1. Depois de iniciar o Jetbrains Gateway, selecione Conectar via SSH.

2. Na página Conectar ao SSH, clique em Configurações para configurar uma nova conexão.

   Na página de configuração do SSH:

   1. Clique em Adicionar uma nova conexão.
   2. Insira as informações de conexão. Por exemplo, Host local=127.0.0.1, Porta=2222 e Nome de usuário=user. Use valores adequados para a configuração do host local, da porta e do nome de usuário.
   3. Defina o Tipo de autenticação como Senha e deixe o campo de senha em branco.
   4. Limpe a opção Parse config file ~/.ssh/config.
   5. Clique em OK para criar a conexão.
   6. Clique em Verificar conexão e continuar.

3. Na página Escolher o ambiente de desenvolvimento integrado e o projeto, selecione o seguinte:

   1. Selecione o ambiente de desenvolvimento integrado que você quer usar.

   2. Selecione o diretório que contém seu projeto clicando em more_horiz Mais. Não é possível criar um projeto usando esse menu. Só é possível abrir um projeto. Para criar um novo projeto, selecione Open an SSH Terminal e execute comandos para criar um diretório para seu projeto do JetBrains.

      Como alternativa, clique em Abrir um terminal SSH para executar comandos git nas estações de trabalho. Por exemplo, o comando a seguir clona o projeto de exemplos do Cloud Code no diretório inicial:

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git
      

   3. Depois de selecionar o diretório do projeto, clique em Fazer o download e iniciar a IDE.

4. Depois que o ambiente de desenvolvimento integrado se conectar, você poderá acessar arquivos na estação de trabalho diretamente do ambiente de desenvolvimento integrado do Jetbrains, que também pode usar a extensão do Cloud Workstations para ajudar a criar e executar seu código.