Desenvolver código usando os 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 às versões mais recentes e anteriores versão, de Ambientes de desenvolvimento integrado da JetBrains e Gateway da JetBrains (link em inglês). Quando uma nova versão principal do ambiente de desenvolvimento integrado do JetBrains for lançada, a próxima A versão do plug-in Cloud Workstations oferece suporte à nova versão e não oferece mais suporte a a versão mais antiga com suporte.

Observação: suporte ao plug-in Cloud Workstations para Programa de acesso antecipado da JetBrains (link em inglês) (EAP) é realizado 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 do JetBrains, você também pode instalar 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 a solicitação Configuration, 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, o Cloud Workstations aparece na Execute 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 seletor de projetos e selecionar um projeto na nuvem.

   

5. Selecione uma estação de trabalho no projeto de nuvem, clique em Próxima e aguarde a estação de trabalho selecionada para iniciar.

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 para o 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 de 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 nas estações de trabalho do Cloud.

   

3. Aguarde o ambiente de desenvolvimento integrado e o projeto abrirem.

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: ao executar um servidor Python na estação de trabalho, python -m SimpleHTTPServer 8080. Em certos casos, o JetBrains Gateway executa automaticamente as e encaminhamento para que você possa acessar projetos executados remotamente por meio da navegador local.

Também é possível fazer o encaminhamento manual de portas do Cloud Workstations para sua máquina local da seguinte forma:

1. Para Windows e Linux, selecione File > Settings em 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, você poderá acessar a porta 8080 das estações de trabalho do Google Cloud 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 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 configurações Menu "Opções" > Configurações.

   

   No macOS, clique em configurações Menu "Opções" > Preferências.

   

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 de endpoint da API.

   Observação: use os nomes 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 alternativa para usuários de 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 sua 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 na 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 versão 387.0.0 ou mais recente da CLI gcloud para isso suporte. 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 Connect to SSH, clique em . Configurações para configurar uma nova conexão.

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

   1. Clique em AdicionarAdicionar 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 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 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 seu projeto clicando em more_horiz Mais. Não é possível criar um projeto usando esse menu. Você pode apenas abre um projeto. Para criar um novo projeto, selecione Abra um terminal SSH e execute comandos para criar um diretório para sua da 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. Após selecionar o diretório do projeto, clique em Download and Inicie o ambiente de desenvolvimento integrado.

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.