Веб-приложения в духе Rails, скомпилированные в один нативный бинарный файл.
CyberTrain — фреймворк для веб-приложений в духе Rails, написанный специально для Spinel, AOT-компилятора Ruby от matz. Привычный словарь остаётся с вами (resources, before_action, validates, form_with, скаффолды), а cybertrain build компилирует контроллеры, модели, представления и сам фреймворк в один нативный бинарный файл — без Rack, без гемов во время выполнения и без интерпретатора Ruby в артефакте.
gem install cybertraincybertrain new blog # при первом запуске устанавливает Spinel (несколько минут)cd blogcybertrain g scaffold article title:string body:textcybertrain db migratecybertrain server # http://127.0.0.1:3000cybertrain build # продакшен: dist/blog, dist/public/, dist/storage/, dist/tmp/
Нужен Ruby 3.2+ — для команды cybertrain и для CRuby-превью в режиме разработки (превью также загружает fiddle; в продакшене Ruby не нужен), а также git, make, curl, компилятор C и заголовки SQLite 3: см. перед началом. Запускайте сборку командой cd dist && ./blog migrate && ./blog с заданной переменной CYBERTRAIN_SECRET_KEY_BASE.
СерверHTTP/1.1, без Rack
ВыполнениеБез гемов и интерпретатора
База данныхSQLite через FFI Spinel
CILinux и macOS
Для кого это и чем это не является
Для Rails-разработчиков, которым нужен один нативный бинарный файл и которых не смущают молодой проект и подмножество Ruby.
Не совместим с Rails и Rack
Нет совместимости с Rack и нет гемов во время выполнения: только собственные пакеты Spinel из spin-index, которые компилируются в рамках его подмножества Ruby.
Не готов к продакшену
CyberTrain находится в стадии пре-альфа. Пример блога проверяется в CI на Linux и macOS.
01
Код, который вы пишете
Словарь Rails и записанные правила Spinel.
Контроллеры, модели, маршруты и представления читаются как Rails-приложение. Там, где AOT-компилятор вынуждает к отличиям, они небольшие, явные и задокументированные.
Маршруты
Вложенные блоки resources получают маппер явно: articles.resources :comments.
Контроллеры
new пишется как new_action: метод с именем new затенил бы Klass.new(ctx).
Представления
В режиме разработки шаблоны читаются с диска, поэтому правка представления не требует пересборки; cybertrain build встраивает их в бинарный файл. Это замкнутая грамматика, а не произвольный Ruby.
Модели
class Article объявляет валидации; столбцы, finder-методы и ассоциации генерируются из db/schema.rb.
config/routes.rbruby
Cybertrain::Routes.draw do root "articles#index"# A nested block takes the mapper explicitly (Spinel's instance_eval# trampoline only rewires `self` for the outermost block): `articles.resources`. resources :articlesdo |articles| articles.resources :comments, only: [:create, :destroy]endend
app/controllers/articles_controller.rbruby
# app/controllers/articles_controller.rb (index/show/edit are as plain as# Rails' own scaffold; update mirrors create)classArticlesController < ApplicationController before_action :set_article, only: [:show, :edit, :update, :destroy]def new_action # a `new` method would shadow ArticlesController.new@article = Article.newenddef create@article = Article.new(article_params)if@article.save flash[:notice] = "Article was successfully created." redirect_to article_path(@article), status::see_otherelse render :new, status::unprocessable_entityendendprivatedef set_article@article = Article.find(params[:id])enddef article_params params.require(:article).permit(:title, :body)endend
# app/models/article.rb -- only the first string field gets a default# presence validation; add anything past that yourself.classArticle validates :title, presence:true validates :body, presence:true, length: { minimum: 10 }end
02
Что работает сегодня
Та часть Rails, которая нужна в первую очередь, написанная специально для Spinel.
01
Нативный HTTP-сервер
HTTP/1.1-сервер на обычном Ruby: один зелёный поток на соединение, типизированные запросы и ответы. Слоя Rack нет; для TLS поставьте перед ним nginx или Caddy.
TCPServer#accept
02
Маршрутизация и контроллеры
resources, вложенные маршруты, before_action, after_action и rescue_from на этапе сборки генерируются в обычный Ruby. Strong params и связка «flash, затем редирект» работают как в Rails.
config/routes.rb
03
Сессии, flash, CSRF
Сессии в cookie с подписью HMAC, flash-сообщения и защита от CSRF включены по умолчанию. Формы передают токен автоматически; на поддельные POST-запросы приходит 403.
_cybertrain_session
04
Шаблоны в стиле ERB
Представления выглядят как Rails ERB: макеты, партиалы, form_with и link_to. В режиме разработки они читаются с диска, поэтому правки не требуют пересборки. cybertrain build встраивает их в бинарный файл.
app/views/**/*.html.erb
05
Модели на SQLite
Валидации, колбэки и ассоциации, выведенные из внешних ключей. Работа с SQLite идёт через FFI Spinel с пулом соединений; все запросы используют связанные параметры.
ffi_func · ffi_lib
06
Миграции и скаффолды
cybertrain generate scaffold создаёт миграцию, модель, контроллер и пять представлений. cybertrain db migrate выполняет генерацию, применяет миграции, перезаписывает db/schema.rb и генерирует снова.
db/migrate/*.rb
07
Живой цикл разработки
cybertrain server следит за вашим кодом: после правки Ruby быстрее чем за секунду отвечает CRuby-превью, пока Spinel собирает бинарный файл в фоне; затем скомпилированный бинарный файл забирает тот же порт. При неудачной сборке продолжает работать превью и показывает вывод компилятора.
X-Cybertrain-Runtime: cruby|spinel
08
Встроенное тестирование
Пишите тесты с Cybertrain::Test и прогоняйте всё приложение внутри процесса с помощью клиента с хранилищем cookie. cybertrain spin test компилирует каждый тест и сравнивает его вывод с эталоном.
test/<name>.rb.expected
03
Фреймворк и CLI
Одно имя, две части.
gem install cybertrain устанавливает команду, а не фреймворк. Фреймворк — это пакет Spinel, от которого зависит ваше приложение и который компилируется в него. Гем даёт вам команду cybertrain: она создаёт приложение, устанавливает Spinel и запускает инструменты Spinel за вас.
Пакет Spinel
Фреймворк
Библиотека, на которой построено ваше приложение.
Что внутри
HTTP-сервер, маршрутизация и контроллеры, сессии и защита от CSRF, интерпретатор шаблонов, модели и миграции SQLite, а также генератор кода, стоящий за spin run gen.
Как получить
Устанавливать его не нужно. В spin.toml вашего приложения указан релизный тег этого репозитория, соответствующий вашей команде cybertrain, а spin lock загружает его в кэш spin и фиксирует коммит в spin.lock. В ваше приложение ничего не копируется.
RubyGem
Команда cybertrain
Инструмент, который создаёт, собирает и запускает ваше приложение.
Что внутри
Только команда cybertrain: new, generate scaffold, db migrate, server, build, spin, setup и doctor. Ни фреймворка, ни Spinel в геме нет.
Как получить
gem install cybertrain. При первом использовании она собирает зафиксированный релиз Spinel в ~/.cybertrain, если этот релиз ещё не доступен в вашем PATH.
Метапрограммирование происходит один раз — при сборке.
Spinel компилирует заранее, и eval в нём нет. Поэтому там, где Rails во время выполнения прибегает к method_missing и define_method, spin run gen пишет обычный Ruby, который можно прочитать и закоммитить, а интерпретируются только представления.
шаг сборкитолько в разработке: чтение с диска / цикл разработкибинарный файлНомера соответствуют шагам ниже.
1
Генерация при сборке
spin run gen читает db/schema.rb и config/routes.rb, сканирует app/controllers и app/models и записывает обычный, читаемый Ruby в gen/. cybertrain db migrate, server и build запускают его за вас.
2
Коммитьте gen/
Каталог хранится в репозитории, потому что у spin build и spin test нет хука, чтобы сначала выполнить генерацию. CI заново запускает spin run gen и падает при наличии диффа, поэтому устаревший сгенерированный код не может попасть в ветку.
3
Интерпретация представлений
Интерпретатор, обходящий дерево, отображает app/views/**/*.html.erb: в режиме разработки они читаются с диска, а cybertrain build встраивает их в бинарный файл. В Spinel нет eval, поэтому это замкнутая грамматика, а не настоящий Ruby.
4
Обслуживание зелёными потоками, хранение в SQLite
HTTP/1.1-сервер на обычном Ruby запускает по одному зелёному потоку Spinel на соединение. Модели работают с SQLite через ffi_func/ffi_lib с пулом из 4 соединений.
5
Превью, затем компиляция, в режиме разработки
cybertrain server сразу отдаёт правку Ruby через CRuby-превью, собирает бинарный файл в фоне и передаёт ему порт, когда сборка завершится (около минуты на examples/blog). При неудачной сборке продолжает работать превью, а вывод компилятора показывается в баннере; cybertrain server --spinel запускает только скомпилированный цикл.
На одном ядре — в 2,2–8,8 раза больше запросов, чем у Rails.
examples/blog против того же блога на Rails 8.1: те же представления, маршруты, модели и схема SQLite. Оба работают в production-режиме на одних и тех же ядрах CPU одной машины, под одинаковой нагрузкой от wrk. Второе ядро больше помогает Rails: Puma добавляет целый процесс, а второй рабочий поток CyberTrain добавляет 0–19%, поэтому на двух ядрах разрыв — 1,1–4,4 раза.
Запросов в секунду при 16 соединенияхCyberTrainRails 8.1
Сервер на одном ядре CPUСервер на двух ядрах CPU
GET /articlesсписок, 30 статей
Одно ядро
CyberTrain: 3 218
Rails: 709
4,5×к Rails
Два ядра
CyberTrain: 3 294
Rails: 1 453
2,3×к Rails
GET /articles/1статья с 10 комментариями и 12 формами
Одно ядро
CyberTrain: 3 201
Rails: 364
8,8×к Rails
Два ядра
CyberTrain: 3 211
Rails: 735
4,4×к Rails
POST /articles/2/commentsвставка с валидацией и редирект
Одно ядро
CyberTrain: 2 081
Rails: 576
3,6×к Rails
Два ядра
CyberTrain: 2 478
Rails: 1 089
2,3×к Rails
GET /style.cssстатический файл из public/
Одно ядро
CyberTrain: 22 112
Rails: 10 144
2,2×к Rails
Два ядра
CyberTrain: 22 735
Rails: 20 105
1,1×к Rails
Память после нагрузки (меньше — лучше)CyberTrainRails 8.1
Сервер на одном ядре CPUСервер на двух ядрах CPU
Системный mallocаллокатор по умолчанию
Одно ядро
CyberTrain: 13,9 МБ
Rails: 132,8 МБ
9,6×меньше
Два ядра
CyberTrain: 16,0 МБ
Rails: 332,7 МБ
20,8×меньше
jemallocподгружен в оба
Одно ядро
CyberTrain: 17,4 МБ
Rails: 122,5 МБ
7,0×меньше
Два ядра
CyberTrain: 18,3 МБ
Rails: 312,7 МБ
17,1×меньше
Резидентная память (RSS из /proc) всех процессов сервера в сумме, считанная после всех прогонов нагрузки. Rails работает как один процесс Puma с 3 потоками на одном ядре и как два воркера на двух. RSS считает страницу, общую для воркеров Puma, по разу на каждый воркер; по PSS, который делит общие страницы между процессами, Rails на двух ядрах занимает 253,9 МБ (222,5 МБ с jemalloc) против 14,1 МБ (15,4 МБ) у CyberTrain.
Память под нагрузкой
13,9 МБ
Rails: 133 МБ, один процесс Puma с 3 потоками.
От запуска до первого ответа
0,015 с
Rails: 0,75 с.
Что нужно на сервере
4,0 МБ
Один бинарник. Rails: 121 МБ — Ruby, 69 gem-пакетов и приложение.
Цена: сборка
50 с
на компиляцию бинарника командой cybertrain build. Rails запускает исходники как есть.
Медианы трёх 10-секундных прогонов после разогрева на облачной ВМ с 4 vCPU: CyberTrain на коммите 0d8a942, собранный зафиксированным релизом Spinel, против Rails 8.1.4 на Ruby 3.4.6 с YJIT и Puma 8.0. Методика, все числа и как повторить замер: docs/benchmark.md.
Соберите блог из Rails Getting Started — нативно.
Статьи с комментариями, от cybertrain new до cybertrain build, за девятнадцать шагов.