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

O plug-in do Cloud Workstations permite iniciar sessões de desenvolvimento remotas para o 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 oferece suporte aos sistemas operacionais a seguir:

• 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 integrado JetBrains e do JetBrains Gateway. Quando uma nova versão principal do ambiente de desenvolvimento integrado do JetBrains é lançada, a próxima versão do plug-in do Cloud Workstations oferece suporte à nova versão e descarta a compatibilidade com a versão mais antiga e com suporte anterior.

Observação :o suporte ao plug-in do Cloud Workstations para o Programa de acesso antecipado da JetBrains (EAP) é feito com base no melhor esforço. Às vezes, o EAP apresenta alterações interruptivas, e elas podem levar algum tempo para serem resolvidas.

Para facilitar a manutenção dos apps JetBrains atualizados, você também pode instalar o JetBrains Toolbox (link em inglês).

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

Antes de começar

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

1. Siga as etapas em Criar uma estação de trabalho. Quando a solicitação Configuration for solicitada, 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 criação da estação de trabalho ser concluída.

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 BYOID, pule para a seção Instruções de conexão alternativa para usuários 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, o Cloud Workstations será exibido 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 entrar na 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 seleção de projetos e escolher um projeto na nuvem.

   

5. Selecione uma estação de trabalho no projeto da nuvem, clique em Próxima 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 do 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 até que o ambiente de desenvolvimento integrado e o projeto sejam abertos.

Reconectar-se a uma estação de trabalho

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

1. Abra o painel Conexões recente.

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

   

3. Aguarde a abertura do ambiente de desenvolvimento integrado e do projeto.

Usar o encaminhamento de portas

Depois que o cliente JetBrains for aberto com o ambiente de desenvolvimento integrado e o projeto, convém acessar portas remotas no Cloud Workstations pela sua máquina local. Por exemplo, ao executar um servidor Python na estação de trabalho, python -m SimpleHTTPServer 8080. Em alguns casos, o JetBrains Gateway executa automaticamente o encaminhamento de portas para que você possa acessar projetos em execução remotamente pelo navegador local.

Também é possível fazer o encaminhamento de portas manualmente do Cloud Workstations para sua 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 Ferramentas > Encaminhamento de portas e adicione uma nova regra para encaminhar TCP para a porta 8080.

3. Depois de definir essa regra, será possível acessar a porta 8080 do Cloud Workstations localmente em http://localhost:8080

Substituir endpoints da API

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

1. No Windows e no Linux, clique em configurações menu Opções > Configurações.

   

   No macOS, clique em settings menu Opções > Preferências.

   

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

3. Acesse Tools > Google Cloud Workstations > Advanced.

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

   Observação :use a nuvem privada virtual p.googleapis.com nomes DNS. 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 as APIs do Google por meio de endpoints.

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

Se você usa BYOID, precisará seguir outras etapas para se conectar ao Jetbrains Gateway. Siga estas etapas:

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

Siga estas etapas para iniciar a estação de trabalho e abrir 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 gcloud da CLI 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: você precisa ter a versão 387.0.0 ou mais recente da CLI gcloud para que esse comando seja compatível. Verifique a versão da CLI gcloud executando o comando gcloud version. Se necessário, atualize com o comando gcloud components update.

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

Iniciar o Jetbrains Gateway

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

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

   Na página de configuração do SSH, siga estas etapas:

   1. Clique em addAdicionar uma nova conexão.
   2. Insira suas informações de conexão. Por exemplo, Host local=127.0.0.1, Porta=2222 e Nome de usuário=user. Use valores apropriados 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. Apague a opção para Analisar arquivo de configuração ~/.ssh/config
   5. Clique em OK para criar a conexão.
   6. Clique em Verificar conexão e continuar.

3. Na página Choose IDE and Project, selecione o seguinte:

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

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

      Se preferir, também é possível clicar em Abrir um terminal SSH para executar comandos git dentro de suas estações de trabalho. Por exemplo, o comando a seguir clona o projeto de amostras do Cloud Code no seu diretório principal:

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

   3. Depois de selecionar o diretório do projeto, clique em Download and Start IDE.

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