Pular para o conteúdo

Guia de deploy · Docker

DockerFaça deploy de Docker em minutos.

Conecte o repositório, o Railpack faz o build e o serviço recebe um domínio com TLS. Bancos de dados a partir de templates, uso descontado por minuto de um saldo pré-pago, tudo em nós na UE.

Começar grátisVer o guia da CLI
Um guindaste do cais baixa uma caixa luminosa em um pequeno barco atracado em um píer à noite
$ npm i -g skiffly && skiffly login
$ cd my-repo && skiffly init            # repo with a Dockerfile
$ skiffly up
$ skiffly deploy --image ghcr.io/acme/api:1.4 --name api --port 8080
01Build

O que o Railpack detecta

O Railpack inspeciona o repositório e escolhe o build para Docker; a maioria dos projetos não precisa de configuração. Um Dockerfile no repositório sempre tem prioridade.

  • Dockerfile in the repository root (or dockerfilePath)
  • or: any public / private registry image
  • EXPOSE is a hint; the port comes from the service settings
Builder
Dockerfile do repositório
Comando de inicialização
CMD from the image (override in Settings → Deploy)

Derivado pelo Railpack; substitua em Configurações → Deploy → Comando de inicialização.

02Porta

Porta e $PORT

A Skiffly injeta PORT em todos os serviços e roteia o domínio público para ela. Defina a porta nas configurações do serviço quando seu app escutar em uma porta fixa; o padrão é 8080 para Docker, 8080 quando nada é definido.

Escutar em $PORT
CMD ["sh", "-c", "./server --port $PORT"]
PORT
8080
SKIFFLY_PUBLIC_DOMAIN
<service>.skiffly.cloud
Terminal

A partir de um terminal

Instale a CLI, vincule o diretório, faça o deploy. skiffly up faz o build do HEAD enviado da branch atual e transmite os logs do build; skiffly domain dá ao serviço um endereço *.skiffly.cloud.

Configuração como código

Ou descreva uma vez só

.skiffly/skiffly.ts declara o serviço, seus bancos de dados e as referências entre eles. skiffly config plan mostra o diff, skiffly config apply aplica. A API espelha railway/iac.

Config as code
.skiffly/skiffly.ts
// .skiffly/skiffly.ts
import { defineSkiffly, github, postgres, project, service } from "@skiffly/config";

export default defineSkiffly(() => {
  const db = postgres("db");

  const web = service("api", {
    source: github("acme/api"),
    build: { builder: "DOCKERFILE", dockerfilePath: "Dockerfile" },
    port: 8080,
    healthcheck: "/",
    env: {
      DATABASE_URL: db.env.DATABASE_URL,
    },
  });

  return project("api", { resources: [web, db] });
});
Templates

Funciona com os templates de que você precisa

Faça deploy de um banco de dados ao lado do serviço Docker e referencie suas variáveis: ${{Postgres.DATABASE_URL}} é conectada pela rede privada, sem porta pública.

Ver todos os templates
PostgreSQL 17The world's most advanced open-source relational database, with a persistent volume and DATABASE_URL pre-wired.Redis 7In-memory data store for caching, sessions and queues with append-only persistence.Nginx staticStatic files served by Nginx from a repository (Dockerfile build).
FAQ

Docker na Skiffly: perguntas frequentes

Como defino variáveis de ambiente para Docker?
Na aba Variáveis do serviço, com skiffly variables set KEY=value ou em .skiffly/skiffly.ts. Referencie outros serviços com ${{Postgres.DATABASE_URL}} e valores de todo o ambiente com ${{shared.NAME}}. Os segredos são criptografados em repouso.
Posso alterar o comando de build ou de inicialização?
Sim. Configurações → Origem → Comando de build substitui a etapa de build do Railpack; Configurações → Deploy → Comando de inicialização substitui o comando de inicialização. Em um monorepo, defina um diretório raiz para que o build rode dentro dele.
Como adiciono Postgres ou Redis?
Faça deploy do template no mesmo ambiente. Ele chega com um volume, credenciais geradas e uma URL de conexão que você referencia no serviço Docker. Conecte-se do seu computador com skiffly connect postgres.
Tenho ambientes de pré-visualização por pull request?
Ative as pré-visualizações de PR no projeto: cada pull request ganha sua própria cópia do ambiente em um domínio próprio, removida quando o PR é mesclado ou fechado. Forks são ignorados.
Quanto custa um app Docker pequeno?
Um serviço de 512 MB / 0.25 vCPU custa cerca de $7.75 por mês, descontados por minuto do seu saldo. Adicione Postgres com 512 MB / 0.25 vCPU e um volume de 10 GB por cerca de $9 a mais. O plano Free roda um app de 512 MB com App Sleeping e um banco de dados de 512 MB sem custo.
O serviço Docker pode entrar em repouso quando ocioso?
Ative o App Sleeping: após cerca de 10 minutos sem requisições, ele escala para zero e acorda na próxima (2–10 s). CPU e memória não são cobradas durante o repouso; o volume é.
Amanhecer em mar aberto: um barco de vela turquesa segue para o horizonte por uma linha tracejada de carta náutica desenhada sobre o mar

Faça deploy do seu app Docker hoje

Plano Free sem cartão. Hobby a partir de $5 com $5 de uso incluídos.

Começar grátis