Abrir um projeto em outra máquina
Crie um projeto ou um workspace apontando para uma pasta que existe num host SSH.
Este tutorial leva você do host cadastrado até um workspace rodando num host SSH. O projeto não é copiado: o app registra um caminho que existe na máquina remota, e o trabalho passa a acontecer lá.
Pré-requisitos
- Um host SSH já cadastrado e conectado. Se ainda não tem, comece em Hosts SSH.
- O caminho da pasta do projeto no host. Você vai escolhê-lo pelo navegador de pastas remoto.
- Git instalado no host, se o projeto for um repositório.
Passo 1 — Adicionar o projeto
- Abra o fluxo de Adicionar projeto.
- Escolha Outra máquina (SSH).
- Selecione o host na lista.
- Escolha o caminho da pasta do projeto.
Se o host estiver desconectado, a tela mostra Conectar. Conecte antes de escolher o caminho — o navegador de pastas precisa da conexão para listar o que existe do outro lado.
O navegador de pastas é o do host, não o do seu computador. Ele lista diretórios que existem na máquina remota. Se você espera ver a sua pasta pessoal, está na tela errada.
Passo 2 — Confirmar a criação
Ao confirmar, o app registra o projeto apontando para a pasta remota. Nada é baixado para o seu computador, e nenhum arquivo é enviado para o host.
Passo 3 — Criar um workspace
- Abra Novo workspace.
- Escolha o host SSH como destino.
- Se o host não estiver conectado, use Conectar.
- Informe o caminho do workspace e confirme.
O workspace passa a existir dentro do projeto, com os arquivos resolvidos na pasta do host.
Resultado
- O projeto aparece na lista, marcado como remoto.
- O terminal do workspace roda no host.
- As operações de Git resolvem o repositório que está no host.
- Nenhum arquivo do projeto foi copiado para a sua máquina.
Limites
- A conexão precisa estar de pé antes de prometer a criação. Se a conexão falhar, o erro precisa aparecer — um projeto apontando para um caminho inalcançável não é útil e não deve parecer criado.
- Não escolha um caminho local para um host remoto. O navegador de pastas remoto existe exatamente para evitar esse engano.
- O caminho remoto precisa existir no host. O app aponta para uma pasta; ele não cria o repositório por você.
- Git no host depende do host. Versão, configuração e credenciais são as da máquina remota.
Se algo não funcionar
- Host desconectado. Use Conectar na própria tela e tente de novo.
- Pasta não aparece no navegador. Confirme que o caminho existe no host e que a sua conta tem permissão de leitura nele.
- Erro de conexão na hora de criar. Resolva a conexão primeiro — veja a seção de diagnóstico em Hosts SSH.
- Projeto criado apontando para o lugar errado. Corrija pelo cadastro do projeto; nada foi copiado, então não há arquivos a limpar.
Limpeza segura
Remover o projeto ou o workspace do app não apaga a pasta no host. Nada nesta página autoriza apagar arquivos na máquina remota.