Skip to content

Início rápido

Do zero a app no ar em três comandos. Sem Dockerfile, sem YAML.

Pré-requisitos

  • Convite para o beta fechado — peça na lista de espera ou ative o seu em goship.sh/invite
  • No primeiro acesso ao painel, o guia cria sua organização e seu primeiro projeto (Crie sua conta → Primeiro acesso)
  • bash ou zsh num Mac, Linux ou WSL
  • Código pronto no seu repositório local — qualquer plataforma suportada (go, python, nodejs, static)

1. Instale o CLI

Mac, Linux ou WSL — o script baixa a versão mais recente, confere o checksum e instala em /usr/local/bin (Windows e outras opções em Instalação):

curl -fsSL https://goship.sh/install.sh | sh
goship version

2. Faça login e escolha a organização 

goship login
goship org use minha-org

3. Deploye

Do diretório do seu projeto, um comando só. Não precisa criar a app antes nem escrever arquivo de configuração:

goship deploy

A app leva o nome do diretório e a plataforma sai dos arquivos que já estão lá — go.mod, pyproject.toml, requirements.txt, package.json ou index.html. A saída diz o que ele deduziu e onde o deploy vai agir (organização/projeto/ambiente):

Deploying meu-app · go
Deploying to minha-org/default/development

  ✓ Create   go, detected from go.mod
  …

Se a dedução não for a que você quer, passe na mão:

goship deploy --platform python --plan app-small-sandboxed

goship plans lista os planos do ambiente; os -sandboxed não existem num Kubernetes conectado.

O GoShip faz o build, sobe a imagem e te devolve a URL pública. No cluster GoShip e nos clusters que ele monta, a URL é *.apps.goship.sh e a imagem roda isolada num sandbox de segurança (opcional nos clusters seus).

O deploy vai para o ambiente padrão da organização, desenvolvimento. A homologação fica desativada até um administrador ativá-la: abra Environments (grupo Infrastructure da barra lateral) e clique em Enable (ou use goship environment enable staging); depois, goship deploy --environment staging publica nela, e --environment production publica em produção (Ambientes).

E agora?

  • Ver logs: goship logs -a meu-app -f
  • Configurar variáveis: goship env set KEY=value -a meu-app
  • Conectar um banco gerenciado: veja Bancos → Provisionar
  • Adicionar domínio próprio: goship domain add meu-app.com.br -a meu-app

Dica pra agentes de IA

O CLI serve tudo o que faz como ferramentas MCP. No Claude Code, um comando instala o servidor, uma skill de deploy e o /goship:deploy:

/plugin install goship --marketplace coffeece/goship

Outros clientes rodam goship mcp como servidor stdio — veja Agentes de IA. No cluster GoShip o sandbox é a sua rede de proteção: qualquer código que o agente escrever roda isolado.