Skip to content

Conectar um servidor

My server é o jeito de trazer uma máquina que você já tem: qualquer VPS Linux, de qualquer provedor, sem precisar conectar uma conta de nuvem. O GoShip entra por SSH, instala o k3s nela e a registra como um cluster seu. Piso mínimo: 2 vCPU, 4 GB de RAM e 30 GB de disco.

Acesso necessário: IP público (não hostname), porta 22, usuário root, chave privada SSH.

Firewall do provedor

Se a máquina fica atrás de um firewall do provedor (grupo de segurança na AWS, regra de firewall no Google Cloud, Cloud Firewall na DigitalOcean ou na Hetzner), libere a entrada TCP nestas portas antes de conectar:

PortaPara quê
22SSH: o GoShip instala e mede o cluster
80, 443tráfego dos seus apps
6443API do Kubernetes do cluster
30000–32767NodePorts
20443, 20500build e registry: o GoShip constrói a imagem no seu cluster a cada deploy

São as mesmas portas que o GoShip abre quando ele mesmo cria a máquina numa conta de nuvem. Na 20443 e na 20500 a própria máquina só aceita conexões vindas do GoShip.

Com a 20443 ou a 20500 fechadas o cluster conecta e fica active, mas o primeiro deploy para ele falha — veja Deploy falhou.

Pelo painel

  1. Em Clusters, no grupo Infrastructure da barra lateral, clique em Add cluster e escolha My server (“Any VPS with SSH”) em Where. (Sem nenhuma conta de nuvem conectada, a página já te manda direto pra cá.)
  2. Preencha Access: Host (o IP), Port (22), SSH user (root) e SSH private key.
  3. Dê um nome ao cluster em Name.
  4. Clique em Add cluster.

A página do cluster passa a acompanhar as etapas: Waiting for SSH · Installing k3s · Registering with GoShip · Measuring capacity. A cobrança só é conhecida depois de medida; até lá o resumo (Summary) mostra “medido após conectar”.

Pela CLI 

goship cluster create meu-servidor --host 203.0.113.10 --ssh-key ~/.ssh/id_ed25519

Flags opcionais: --port (padrão 22), --ssh-user (padrão root). Sem --no-wait, o comando acompanha as mesmas etapas até o cluster ficar active, ou sai com código 1 se alguma etapa falhar. Com --no-wait ele devolve na hora, e -o json imprime o cluster.

Depois de conectar

O cluster é da organização e ainda não roda nada: um ambiente precisa apontar para ele. Para apontar ambientes que já existem na mesma hora, passe --environment <slug> ao conectar (--environment development --environment production): eles passam a rodar nele assim que ficar active.

goship environment create qa --cluster meu-servidor

Para tirar o servidor do GoShip, goship cluster rm meu-servidor (Visão geral → Remover um cluster).

Volumes

Um servidor conectado passa a oferecer disco local para volumes assim que entra no ar, sem nada a configurar. Block storage da nuvem só existe em clusters que o GoShip criou na sua conta (Criar na sua nuvem). Veja Apps → Volumes.

Veja também: