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 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:
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.
Depois de inserir o nome da estação de trabalho, clique em Criar.
Clique na página Estações de trabalho e aguarde a conclusão da criação da estação de trabalho.
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:
Abra o JetBrains Gateway.
Selecione Todos os provedores.
Na seção Instalar mais provedores, encontre Google Cloud 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 Conectar ao Google Cloud.
Clique em Fazer login para entrar na sua Conta do Google.
Siga as instruções para conceder ao plug-in do Cloud Workstations acesso ao Google Cloud.
Clique em Continuar para concluir o login.
Clique em Procurar para abrir uma caixa de diálogo de seletor de projetos e selecionar um projeto na nuvem.
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:
Selecione uma versão do ambiente de desenvolvimento integrado no host remoto.
Insira um caminho para o projeto do ambiente de desenvolvimento integrado no host remoto.
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:
Abra o painel Conexões recentes.
Clique em um caminho de projeto para abrir um ambiente de desenvolvimento integrado nas estações de trabalho do Cloud.
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:
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 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:
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 configurar as configurações do projeto.
Acesse Ferramentas > Google Cloud Workstations > Avançado.
Adicionar URLs de substituição de endpoint da API.
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:
- Siga as instruções na seção "Antes de começar".
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
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 Connect to SSH, clique em . Configurações para configurar uma nova conexão.
Na página de configuração do SSH:
- Clique em AdicionarAdicionar uma nova conexão.
- 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. - Defina o Tipo de autenticação como Senha e deixe o campo de senha em branco.
- Limpe a opção Parse config file ~/.ssh/config.
- Clique em OK para criar a conexão.
- Clique em Verificar conexão e continuar.
Na página Choose IDE and Project, selecione o seguinte:
- Selecione o ambiente de desenvolvimento integrado que você quer usar.
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
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, 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.