Railway Deploy
Fazer deploy de código do diretório atual para Railway usando railway up.
Quando Usar
- Usuário pede para "fazer deploy", "enviar", "fazer push do código"
- Usuário diz "railway up" ou "fazer deploy para Railway"
- Usuário quer fazer deploy de mudanças de código local
- Usuário diz "fazer deploy e corrigir qualquer problema" (use modo --ci)
Modos
Modo Detach (padrão)
Inicia o deploy e retorna imediatamente. Use para a maioria dos deploys.
railway up --detach
Modo CI
Transmite os logs de build até completar. Use quando o usuário quer acompanhar o build ou precisa debugar problemas.
railway up --ci
Quando usar modo CI:
- Usuário diz "fazer deploy e acompanhar", "fazer deploy e corrigir problemas"
- Usuário está debugando falhas de build
- Usuário quer ver a saída do build
Fazer Deploy de Serviço Específico
O padrão é o serviço vinculado. Para fazer deploy em um serviço diferente:
railway up --detach --service backend
Fazer Deploy em Projeto Não Vinculado
Fazer deploy em um projeto sem vincular primeiro:
railway up --project <project-id> --environment production --detach
Requer ambas as flags --project e --environment.
Opções de CLI
| Flag | Descrição |
|---|---|
-d, --detach |
Não anexar aos logs (padrão) |
-c, --ci |
Transmitir logs de build, sair quando concluído |
-s, --service <NAME> |
Serviço alvo (padrão é o vinculado) |
-e, --environment <NAME> |
Ambiente alvo (padrão é o vinculado) |
-p, --project <ID> |
Projeto alvo (requer --environment) |
[PATH] |
Caminho para fazer deploy (padrão é o diretório atual) |
Vinculação de Diretório
O Railway CLI percorre PARA CIMA a árvore de diretórios para encontrar um projeto vinculado. Se você estiver em um subdiretório de um projeto vinculado, não precisa vincular novamente.
Para deploys em subdiretório, prefira definir rootDirectory via a skill railway-environment e depois fazer deploy normalmente com railway up.
Após o Deploy
Modo detach
Deploying to <service>...
Use a skill railway-deployment para verificar o status do build (com a flag --lines).
Modo CI
Os logs de build são transmitidos inline. Se o build falhar, o erro estará na saída.
NÃO execute railway logs --build após modo CI - os logs já foram transmitidos. Se precisar de mais contexto, use a skill railway-deployment com a flag --lines (nunca transmita).
Composição
- Verificar status após deploy: Use a skill railway-service
- Ver logs: Use a skill railway-deployment
- Corrigir problemas de configuração: Use a skill railway-environment
- Fazer redeploy após corrigir configuração: Use a skill railway-environment
Tratamento de Erros
Nenhum Projeto Vinculado
No Railway project linked. Run `railway link` first.
Nenhum Serviço Vinculado
No service linked. Use --service flag or run `railway service` to select one.
Falha de Build (modo CI)
Os logs de build já foram transmitidos - analise-os diretamente da saída do railway up --ci.
NÃO execute railway logs após modo CI (transmite indefinidamente sem --lines).
Problemas comuns:
- Dependências ausentes → verifique package.json/requirements.txt
- Comando de build incorreto → use a skill railway-environment para corrigir
- Problemas com Dockerfile → verifique o caminho do dockerfile