Quickstart · 5 minutos
Do código ao ar com goship deploy.
Instale o CLI, faça login e implante sua primeira app. Você precisará de uma conta — se ainda não criou, faça isso primeiro.
Instale o CLI
O goship é um binário único, sem dependências. Durante o beta fechado ele vem no link do seu convite — baixe, torne executável e coloque no $PATH:
chmod +x goship && sudo mv goship /usr/local/bin/Verifique com goship version.
Faça login
Seu navegador abrirá este portal e voltará após você aprovar o acesso. Um login só vale para todos os comandos.
goship loginEm CI ou máquina sem navegador, defina GOSHIP_TOKEN e o CLI não pede login.
Crie uma organização
Organizações agrupam seus apps, bancos e colegas de time. Escolha um slug curto, em minúsculas.
Solicitar conviteEscolha a organização
Todo comando roda dentro de uma organização. Fixe a sua:
goship org use <seu-slug>Implante sua primeira app
Crie uma app Go hello-world, adicione um Procfile e implante. O GoShip compila a partir do código-fonte — sem Dockerfile.
mkdir hello && cd hello
cat > hello.go <<'EOF'
package main
import (
"fmt"
"net/http"
"os"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello from GoShip!")
})
port := os.Getenv("PORT")
if port == "" {
port = "8888"
}
http.ListenAndServe(":"+port, nil)
}
EOF
cat > Procfile <<'EOF'
web: /home/application/bin/hello
EOF
go mod init hello
goship app create hello --platform go
goship deploy -a helloQuando o deploy terminar, goship app info hello mostra a URL da app.
Próximos passos
- → Conectar um banco:
goship db create meudb --plan small && goship db bind meudb -a helloBancos → Provisionar → - → Definir variáveis de ambiente:
goship env set FOO=bar -a helloApps → Variáveis de ambiente → - → Escalar sob demanda:
goship app scale hello --units 3Apps → Escala → - → Domínio próprio + TLS:
goship domain add meu-app.com.br -a helloApps → Domínios e TLS → - → Documentação completa: docs.goship.sh cobre apps, bancos, sandbox de segurança, BYON e API.