Перейти к основному содержимому

Деплой из GitHub

Подключите репозиторий — и каждый git push будет публиковать новую версию.

Подключение​

  1. Залогиньтесь в app.layero.ru через GitHub. На этапе OAuth-разрешений Layero запросит доступ к репозиториям — вы можете выбрать, к каким именно.
  2. Нажмите «Создать проект» → «Импортировать из GitHub».
  3. Выберите репозиторий и ветку. По умолчанию production-веткой становится main.
  4. Нажмите Deploy. Layero склонирует код, прогонит сборку и опубликует артефакты.

Что происходит на push​

git push  →  GitHub webhook  →  POST /webhook/{project_id}
              │
              ▼
        Layero создаёт деплой со SHA текущего коммита
              │
              ▼
        Builder клонирует, ставит зависимости, собирает,
        загружает артефакты в S3, переключает окружение.

Webhook регистрируется автоматически при создании проекта. Для каждого проекта используется индивидуальный webhook_secret, подпись HMAC-SHA256 проверяется в заголовке X-Hub-Signature-256.

Push в default-ветку — auto-promote в production​

По умолчанию успешный билд default-ветки автоматически становится production: production_deploy_id переключается на новый деплой, и production-адрес проекта начинает отдавать свежий артефакт.

Для команд этот toggle лучше выключить (Settings → «Auto-promote default branch» → off): тогда каждый relaese — явный клик «Promote» в UI или layero promote из CLI. Защищает от случайных production-релизов после merge'а в main.

Push в другую ветку — preview, не production​

Push в любую другую ветку создаст preview-окружение с собственным URL — <project>-<branch>.layero.app или, в прежней схеме, <метка-проекта>-<branch>.layero.app. Apex не трогается — production продолжает отдавать ровно тот деплой, на который указывает pointer.

Чтобы выкатить feature-ветку в production без коммита в main — жмите «Promote» на её свежем деплое (или layero promote <sha>).

Подробнее про модель доменов — Окружения, preview и production.

Multi-provider: что если я залогинен через Яндекс ID?​

OAuth Layero поддерживает GitHub и Яндекс ID. Импорт репозиториев работает только для GitHub-аккаунтов. Если вы залогинены через Яндекс — добавьте GitHub-identity (UI: «Настройки» → «Подключённые аккаунты»), и в проекте появится возможность создать GitHub-источник.

Альтернатива — деплоить из CLI: layero deploy.

Первый деплой и обещание hostname​

После первого ready-деплоя в default-ветке и preview-URL ветки, и production-адрес проекта работают сразу — оба покрыты wildcard-сертификатом своей зоны и не требуют регистрации хоста. Ожидания на 5–15 минут, которое было во времена CDN перед сайтами, больше нет (см. Окружения, preview и production).

Пока успешного деплоя нет вообще, на адресе показывается страница «Сайт скоро появится» — чтобы зашаренная ссылка не отдавала 404.