Гайд по деплою · Docker

Разверните Docker за считанные минуты.

Подключите репозиторий, Railpack соберёт его, сервис получит домен с TLS. Базы данных из шаблонов, потребление списывается поминутно с предоплаченного баланса, всё на нодах в ЕС.

Начать с GitHub Открыть гайд по CLI

terminal

$ 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

Что распознаёт Railpack

Railpack изучает репозиторий и подбирает сборку для Docker; большинству проектов настройка не нужна. Dockerfile в репозитории всегда имеет приоритет.

Dockerfile in the repository root (or dockerfilePath)
or: any public / private registry image
EXPOSE is a hint; the port comes from the service settings

Сборщик: Dockerfile из репозитория
Команда запуска: CMD from the image (override in Settings → Deploy)

Порт и $PORT

Skiffly прокидывает PORT в каждый сервис и направляет на него публичный домен. Укажите порт в настройках сервиса, если приложение слушает фиксированный; по умолчанию для Docker это 8080, а если ничего не задано — 8080.

Слушать $PORT

CMD ["sh", "-c", "./server --port $PORT"]

PORT: 8080
SKIFFLY_PUBLIC_DOMAIN: <service>.skiffly.cloud

Из терминала

Установите CLI, привяжите директорию, разверните. skiffly up собирает запушенный HEAD текущей ветки и стримит логи сборки; skiffly domain выдаёт сервису адрес *.skiffly.cloud.

Или опишите один раз

.skiffly/skiffly.ts объявляет сервис, его базы данных и ссылки между ними. skiffly config plan показывает diff, skiffly config apply применяет его. API повторяет 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] });
});

Работает с нужными вам шаблонами

Разверните базу данных рядом с сервисом Docker и сошлитесь на её переменные: ${{Postgres.DATABASE_URL}} работает по приватной сети, без публичного порта.

Все шаблоны

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).

Docker на Skiffly: частые вопросы

Как задать переменные окружения для Docker?

На вкладке «Переменные» сервиса, командой skiffly variables set KEY=value или в .skiffly/skiffly.ts. Ссылайтесь на другие сервисы через ${{Postgres.DATABASE_URL}}, а на общие значения окружения — через ${{shared.NAME}}. Секреты шифруются при хранении.

Можно ли изменить команду сборки или запуска?

Да. Настройки → Сборка → Команда сборки переопределяет шаг сборки Railpack; Настройки → Деплой → Команда запуска заменяет команду запуска. Для монорепозитория задаётся корневая директория, чтобы сборка шла внутри неё.

Как добавить Postgres или Redis?

Разверните шаблон в то же окружение. Он появится с томом, сгенерированными учётными данными и URL подключения, на который вы ссылаетесь из сервиса Docker. Подключайтесь с ноутбука через skiffly connect postgres.

Будут ли preview-окружения для каждого pull request?

Включите PR-превью в проекте: каждый pull request получит собственную копию окружения на своём домене, которая удаляется, когда PR слит или закрыт. Форки игнорируются.

Сколько стоит небольшое приложение на Docker?

Сервис 512 МБ / 0.25 vCPU обходится примерно в $7.75 в месяц, списание поминутно с баланса. Добавьте Postgres с 512 МБ / 0.25 vCPU и томом 10 ГБ примерно за $9 сверху. Бесплатный тариф запускает один сервис 512 МБ с App Sleeping без оплаты.

Может ли сервис Docker засыпать при простое?

Включите App Sleeping: примерно через 10 минут без запросов сервис масштабируется до нуля и просыпается на следующем запросе (2–10 с). CPU и память во сне не тарифицируются; том — тарифицируется.

Разверните своё приложение на Docker сегодня

Бесплатный тариф без карты. Hobby от $5, из них $5 потребления включено.

Начать с GitHub