A resposta curta

Docker Compose em produção, nos termos do próprio Docker, é um único servidor. A mesma documentação diz que escalar esse esquema é Swarm. O arquivo compose continua descrevendo o stack. O que muda é o inventário: o que é público, onde os dados ficam e o que acontece quando um contêiner é trocado.

Separe o processo web, os workers e os dados. Tire os bind mounts do código. Coloque healthchecks. Deixe os segredos fora da imagem. Decida se cada banco continua um contêiner que você opera. Para colocar Docker Compose em produção numa plataforma, crie um serviço por peça. Um único contêiner está em Docker na Unbroker. Um frontend e uma API no mesmo projeto estão em frontend e API. Se o stack precisa continuar numa máquina que você atualiza, rode o Compose num servidor Linux que você opera. Se você está saindo do Railway, a alternativa ao Railway é a comparação.

O que o Docker recomenda para produção

A nota de produção do Docker lista as mudanças que costumam importar. Remova os bind mounts do código da aplicação, para o código ficar dentro da imagem e não poder ser alterado de fora. Publique outras portas no host. Defina as variáveis de ambiente de outro jeito. Defina uma política de restart como restart: always. Você pode somar um serviço, por exemplo um agregador de logs.

As diferenças ficam num segundo arquivo, compose.production.yaml. Ele só precisa trazer as mudanças. Ele é aplicado por cima do arquivo base:

docker compose -f compose.yaml -f compose.production.yaml up -d
services:
  web:
    ports:
      - "80:3000"
    environment:
      LOG_LEVEL: info
    restart: always

Esse arquivo tem a forma de três mudanças que o Docker nomeia: outra porta no host, outras variáveis de ambiente e restart: always. Tirar o bind mount do código é a outra mudança, e ela tem que valer na configuração que você roda. As regras de merge do Docker decidem se uma chave do segundo arquivo substitui a do base ou se combina com ela. Leia essas regras antes de depender de uma mudança de porta ou de volume. A fonte é Use Compose in production e vários arquivos Compose.

Para fazer deploy de novo de um serviço chamado web, reconstrua a imagem e recrie só esse serviço:

docker compose build web
docker compose up --no-deps -d web

--no-deps deixa quietos os serviços dos quais web depende.

O que cada serviço do compose é

O arquivo é uma lista. Em produção cada linha é uma decisão. Esta tabela vai de um elemento do compose ao que ele significa quando outra coisa está rodando, e ao serviço da Unbroker que corresponde.

Elemento do composeEm produçãoNa Unbroker
Serviço HTTP com buildO código fica na imagem. Tire o bind mount do fonte.Serviço de repositório: Railpack, ou um Dockerfile no repositório.
imageRode um artefato que você consiga nomear depois.Serviço de imagem. A Unbroker baixa a imagem e não reconstrói o fonte. Prefira uma tag de release ou um digest. Uma réplica.
Processo sem portas publicadasNão há HTTP de entrada.Worker. Sem URL pública. Uma réplica.
Postgres, Redis, MySQL, MongoDBAlguém responde por upgrades, backups e restores.Nó de banco no Apps, ou um banco gerenciado.
nginx ou outro proxy reversoNum host ele costuma publicar o app e terminar TLS.Um serviço público já tem URL. Deixe o proxy só se você ainda precisa do roteamento dele.
portsO host publica essa porta.Só um serviço público tem URL. O resto fica privado.
Volume de códigoTire.A imagem guarda o código.
Volume de dadosUm caminho que sobrevive a um contêiner novo.Um volume, um caminho absoluto, até 50 GB, não encolhe. Uma réplica. Apagar o serviço apaga o volume.
environment ou env_fileValores diferentes por ambiente. Segredos ficam fora da imagem.Production, Preview ou All. Colar um .env importa as variáveis. Previews novos copiam All e Preview, nunca Production.
depends_onRunning não é pronto. Use service_healthy e um healthcheck.O app ainda tenta de novo depois da primeira subida.
restartrestart: always num único servidor.Um serviço caído ou um crash-loop dispara um alerta embutido. As métricas incluem restarts.
networksOs contêineres daquele host compartilham uma rede.O mesmo ambiente: host e porta privados. Previews não alcançam produção.

Um frontend que é só HTML, CSS e JavaScript, sem processo de servidor, é um upload estático. É um serviço diferente de um contêiner. Os tipos estão no guia de serviços.

A linha do nginx é um critério, não uma regra. Se o proxy só existe para publicar o app e terminar TLS, um serviço público já tem URL. Domínios próprios e TLS gerenciado exigem Pro. Se o proxy ainda roteia de um jeito que você precisa, essa decisão fica separada.

depends_on não espera o banco ficar pronto

O Compose espera a dependência estar rodando. Ele não espera ela aceitar trabalho. O processo do banco pode estar no ar e ainda estar subindo.

depends_on aceita uma de três condições:

  • service_started significa que o contêiner está rodando.
  • service_healthy significa que o healthcheck passa. O serviço precisa de um healthcheck.
  • service_completed_successfully significa que uma dependência de uso único terminou com sucesso.

A página de ordem de subida do Docker usa Postgres e pg_isready para o caso healthy. $$ é o escape do Compose, então o shell dentro do contêiner vê $POSTGRES_USER. Essa página também define restart: true nessa dependência, o que reinicia web quando uma operação do Compose reinicia db, e mostra o Redis com service_started. O bloco abaixo é esse healthcheck, reduzido ao banco:

services:
  web:
    build: .
    depends_on:
      db:
        condition: service_healthy
        restart: true
  db:
    image: postgres:18
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s
      retries: 5
      start_period: 30s
      timeout: 10s

A fonte é Control startup and shutdown order. postgres:18 é a tag desse exemplo. Não é um pin de imagem da Unbroker.

Um healthcheck segura a primeira subida. A aplicação ainda precisa tentar a conexão de novo, porque o banco pode sair do ar depois.

Portas e rede privada

ports publica uma porta do contêiner no host. Num servidor, é assim que o tráfego chega ao processo. Os outros contêineres da rede do Compose usam o nome do serviço.

Publique só o que deve ter URL. Um serviço privado não tem URL pública, nem Ingress, nem certificado. Outro serviço do mesmo ambiente se conecta com o host e a porta privados:

${{services.api.host}}:${{services.api.port}}

Um ambiente de preview não alcança produção. Um worker já não tem URL pública, e não dá para marcá-lo como privado por cima disso. Não crie um serviço web público só para um processo sem listener passar num health check HTTP. O comando de start tem que lançar o consumidor. Workers com Dockerfile rodam sem URL pública, sem serviço de entrada e sem sonda de readiness HTTP. Veja workers em segundo plano e o guia do worker.

Volumes: código fora, dado decidido

Um bind mount da árvore do código é uma comodidade de desenvolvimento. A nota de produção do Docker manda tirar, para o código que roda ser o da imagem.

Um volume de dados é outra escolha. Na Unbroker um volume pertence a um serviço e é montado num caminho absoluto. Ele pode crescer, até 50 GB, e não encolhe. Crescer não reinicia o serviço. Apagar o serviço apaga o volume e os dados dele. Reset e detach também apagam esses dados. Arquivos escritos fora do volume são temporários: um deploy, um restart ou um reagendamento podem trocar o contêiner.

Um serviço com volume persistente sempre roda uma réplica. Serviços de imagem e workers sempre rodam uma. Serviços de repositório e de upload podem rodar várias, até 3 na célula compartilhada. Células dedicadas permitem mais. Como definir o mínimo, o máximo e o gatilho está em escala automática de réplicas.

Os backups vão para um destino compatível com S3 que você controla. Um volume não é, por si, um backup. O caminho está em armazenamento persistente e no guia de storage. Como confirmar um registro de teste depois de um redeploy está em Volumes persistentes.

Variáveis de ambiente e segredos

env_file e um .env no laptop não são o depósito de produção. Defina os valores de runtime no serviço. Um segredo copiado para uma camada da imagem fica no artefato mesmo se uma camada posterior apagar o arquivo. Coloque .env, credenciais locais e outros arquivos que você não quer no build no .dockerignore quando o Dockerfile copia um caminho amplo. Num serviço de imagem, prefira uma tag de release ou um digest, para poder nomear o artefato que você baixou. Os dois pontos estão no guia de Docker.

Na Unbroker uma variável é Production, Preview ou All. Colar um arquivo .env importa essas variáveis no ambiente que você selecionou. Um preview novo copia All e Preview, e nunca recebe Production. Coloque a senha do banco de produção em Production, a menos que você queira que os previews a vejam. A nota mais longa é ambientes de preview de pull request. As regras estão no guia de variáveis de ambiente.

Bancos: o contêiner ou um gerenciado

Um serviço de banco no arquivo compose é um engine que você opera: a imagem, o volume, upgrades, backups e restores. Declarar um contêiner não inclui alta disponibilidade.

A Unbroker tem dois modelos. Escolher um banco é a fonte dessa divisão.

Banco gerenciadoNó de banco no Apps
Roda comoCluster operado pelo provedorServiço privado a partir de uma imagem de banco
OperaçãoO provedor cuida do host e do ciclo do clusterVocê atualiza a imagem, testa backups e restaura
BackupsDependem do engine e do planoBackups do volume para um destino compatível com S3 que você controla
Serve paraDados importantes de produçãoA imagem, a versão e o volume ficam no projeto

Use um banco gerenciado para dados importantes de produção, a menos que tenha um motivo para operar o engine como serviço da aplicação. “Gerenciado” não significa que todo recurso de recuperação está no plano. Confirme o engine e o plano. Você continua dono do schema, das queries, das credenciais e de um restore que já testou. Operar o Postgres é a nota separada Postgres em produção.

Os nós de banco no Apps são PostgreSQL, Redis, MongoDB e MySQL. Cada um é privado por padrão, com a imagem oficial, um volume e uma senha gerada. Você escolhe quando atualizar, testa os backups e faz os restores. Alta disponibilidade não está implícita. O detalhe está em nós de banco.

A API de bancos gerenciados suporta PostgreSQL, MySQL, Redis, Valkey, MongoDB, Kafka e OpenSearch. A disponibilidade varia por provedor e região. O fluxo de criação mostra as combinações que aquele provedor e aquela região oferecem. PostgreSQL e MySQL gerenciados começam em $21.21 por mês em preços. O menor plano de Postgres gerenciado no catálogo atual é 1 vCPU, 1 GB de RAM e 10 GB de armazenamento. Esse preço é separado do Pro. O Pro custa $25 por mês com $25 de crédito de uso. Bancos gerenciados não estão no Free. As páginas de plano são bancos gerenciados, Postgres gerenciado e preços.

Restarts, saúde e logs

Num único servidor, restart: always é como o Docker sobe de novo um contêiner parado. A política não avisa se o processo entra em crash-loop.

Na Unbroker, um serviço que cai ou entra em crash-loop dispara um alerta embutido. Você não cria uma regra para isso. Ele fica ativo enquanto os alertas estão ligados na organização. As métricas incluem CPU, memória, restarts e réplicas ready. Métricas de recurso fazem parte do Pro. A lista está no guia de monitoramento.

A nota de produção do Docker também inclui somar um serviço como um agregador de logs. Os logs de runtime na Unbroker são o que o serviço escreve em stdout e stderr, guardados por 7 dias. Esse é o log que você lê no serviço. É outra coisa que um contêiner agregador de logs no arquivo compose.

Checklist para colocar em produção

Percorra o arquivo uma vez. Cada linha é uma decisão.

  1. Liste cada serviço e marque: app HTTP, worker, banco ou arquivos.
  2. Tire os bind mounts do código. Deixe os dados num volume ou num banco.
  3. Adicione um healthcheck e condition: service_healthy onde a ordem de subida importa. Deixe as novas tentativas no app.
  4. Publique só os serviços que devem ter URL. Aponte o resto para um host e uma porta privados.
  5. Coloque os segredos em variáveis de ambiente. Deixe os valores de Production fora do Preview.
  6. Escolha cada banco: um nó que você opera, ou um cluster gerenciado. Restaure um backup uma vez.
  7. Num único servidor, defina uma política de restart como restart: always. Onde a plataforma roda o processo, acompanhe restarts e crash-loops.
  8. Fixe cada serviço de imagem numa tag de release ou num digest.
  9. Crie um serviço por peça num projeto. Se você colar o arquivo compose, revise cada serviço criado contra esta lista.
  10. Confira o plano. Dockerfiles, imagens de contêiner, workers, volumes persistentes e bancos gerenciados exigem o Pro.

Como isso fica na Unbroker

Crie um projeto e adicione um serviço por peça. Um serviço de repositório constrói o app HTTP com Railpack ou um Dockerfile. Um serviço FastAPI construído com esse Dockerfile é um contêiner que roda o Uvicorn. O que muda depois do fastapi dev está em FastAPI em produção. Um serviço de imagem baixa uma imagem OCI e não é reconstruído. Um worker roda um processo sem HTTP de entrada. Um banco é um nó do Apps ou um banco gerenciado. Um volume é só para arquivos que precisam sobreviver a um contêiner novo.

Serviços do mesmo ambiente alcançam um serviço privado em ${{services.api.host}}:${{services.api.port}}. Previews não alcançam produção.

O arquivo compose é o inventário. Ao criar um projeto você pode colá-lo, e a Unbroker cria um serviço por entrada para imagens, builds de repositório, environment, depends_on, portas, comandos e um volume persistente por serviço. Isso está na nota de importação do Compose. Depois revise cada serviço: colar o arquivo não decide o que é público, onde os dados ficam nem se o banco é um cluster gerenciado. Um arquivo de outra plataforma, como render.yaml, não é um formato de importação da Unbroker. O guia de migração do Render diz isso sobre esse arquivo.

O Free não inclui volumes persistentes, bancos gerenciados, Dockerfiles nem imagens de contêiner. O Pro custa $25 por mês com $25 de crédito de uso. O crédito reinicia a cada ciclo e não acumula. O uso acima do crédito é cobrado à parte. Um único contêiner começa em Docker na Unbroker. Os limites do plano estão em preços.

Perguntas frequentes

Dá para rodar Docker Compose em produção?

Sim, num único servidor. O Docker documenta isso como o deploy mais simples, e diz que escalar esse esquema é rodar apps Compose no Swarm. O limite é esse host. Numa plataforma o esquema é outro: um serviço por peça do arquivo.

O depends_on espera o banco ficar pronto?

Não. O Compose espera a dependência estar running, não pronta. condition: service_healthy espera um healthcheck. As outras condições são service_started e service_completed_successfully. O app ainda precisa tentar de novo a conexão, porque o banco pode reiniciar depois. O exemplo do Docker confere o Postgres com pg_isready.

Meu banco deve rodar no Compose em produção?

Depende de quem opera. Um contêiner de banco é um engine que você atualiza, faz backup e restaura. Um banco gerenciado é um cluster que o provedor opera. Você continua dono do schema, das queries, das credenciais e de um restore que já testou. Use um banco gerenciado para dados importantes de produção, a menos que tenha um motivo para operar o engine. Isto não é uma comparação de preço.

Posso enviar meu docker-compose.yml para a Unbroker?

Você pode colar um arquivo compose ao criar um projeto. A Unbroker cria um serviço por entrada. Esse caminho suporta imagens, builds de repositório, environment, depends_on, portas, comandos e um volume persistente por serviço. Ele não decide o que é público, onde os dados ficam nem se o banco deve ser um cluster gerenciado. Um arquivo de outra plataforma, como render.yaml, não é um formato de importação da Unbroker.

O que acontece com os meus volumes?

Na Unbroker um volume pertence a um serviço e é montado num caminho absoluto. Ele pode crescer até 50 GB e não encolhe. Apagar o serviço apaga o volume. Arquivos fora do volume são temporários, porque um deploy, um restart ou um reagendamento podem trocar o contêiner. Os backups vão para um destino compatível com S3 que você controla. O Free não inclui volumes persistentes.