Esta página foi traduzida pela API Cloud Translation.

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.

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

Para saber mais sobre as versões do ambiente de desenvolvimento integrado do JetBrains, consulte imagens de base pré-configuradas, consulte as Notas de lançamento do Cloud Workstations.

Antes de começar

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

Siga as etapas para Criar um estação de trabalho. Quando o Configuration, escolha a imagem que corresponde ao ambiente de desenvolvimento integrado do JetBrains. que você quer usar.
Depois de inserir o nome da estação de trabalho, clique em Criar.
Clique na página Estações de trabalho e aguarde a estação de trabalho ser terminar de criar.
Faça o download e instale uma versão com suporte do JetBrains Gateway.

Instalar o plug-in do Cloud Workstations

Instale o plug-in do Cloud Workstations:
1. Abra o JetBrains Gateway.
2. Selecione Todos os provedores.
3. Na seção Instalar mais provedores, localize Google Cloud e e clique em Instalar para fazer o download do plug-in do Cloud Workstations.
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:

Abra o JetBrains Gateway.
Na seção Executar o ambiente de desenvolvimento integrado remotamente, clique em Conecte-se ao Google Cloud.
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 Google Cloud.
2. Clique em Continuar para concluir o login.
Clique em Procurar para abrir uma caixa de diálogo de seleção de projetos e escolher um projeto do Cloud.
Selecione uma estação de trabalho no projeto de nuvem, clique em Próxima e aguarde a estação de trabalho selecionada para iniciar.
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.
Clique em Connect e aguarde até que o ambiente de desenvolvimento integrado e o projeto sejam abertos.

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:

Abra o painel Conexões recentes.
Clique em um caminho de projeto para abrir um ambiente de desenvolvimento integrado no Cloud Workstations.
Aguarde o ambiente de desenvolvimento integrado e o projeto abrirem.

Usar encaminhamento de portas

Depois que o cliente JetBrains for aberto com o ambiente de desenvolvimento integrado e o projeto, talvez seja preciso acessar portas remotas no Cloud Workstations pela sua máquina local. Por exemplo, quando você executa 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 do seu navegador local.

Também é possível encaminhar manualmente a porta das estações de trabalho do Cloud para a máquina local da seguinte maneira:

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

No macOS, selecione IntelliJ IDEA > Preferences no menu principal.
Acesse Ferramentas > Encaminhamento de portas e adicione uma nova regra. para encaminhar TCP para a porta 8080.
Depois de definir esta regra, é 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 plug-in pode se conectar aos seus serviços de nuvem. Para substituir os endpoints da API, siga estas etapas:

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.
Opcional: para acessar as Configurações do JetBrains para IntelliJ e outros ambientes de desenvolvimento integrado, consulte defina as configurações do projeto.
Acesse Ferramentas > Google Cloud Workstations > Avançado.
Adicione 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.
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ê usa o BYOID, outras etapas são necessárias para se conectar ao Jetbrains Gateway. Siga estas etapas:

Inicie sua 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:

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

Verifique se a estação de trabalho está em execução. Você pode usar as seguintes opções: gcloud para iniciá-lo.

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

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

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

Abrir o Jetbrains Gateway

Depois de iniciar o Jetbrains Gateway, selecione Conectar via SSH.
Na página Conectar-se ao SSH, clique em . Configurações para configurar uma nova conexão.

Na página Configuração de SSH:
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 adequados à sua para o host, a porta e o nome de usuário locais.
3. Defina o Tipo de autenticação como Senha e não mude a senha. em branco.
4. Desmarque a opção Analisar arquivo de configuração ~/.ssh/config.
5. Clique em OK para criar a conexão.
6. Clique em Verificar conexão e continuar.
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 seu da JetBrains.
  
  Se preferir, clique em Abrir um terminal SSH para executar git dentro das estações de trabalho. Por exemplo, os seguintes clona o projeto de amostras do Cloud Code na sua página inicial diretório:
```
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.
Depois que o ambiente de desenvolvimento integrado se conectar, será possível acessar arquivos na estação de trabalho diretamente do ambiente de desenvolvimento integrado do Jetbrains, que também pode usar a Cloud Workstations para ajudar a criar e executar seu código.