Перейти к содержимому
SBER 288,30 ₽ 0,19% ростIMOEX 2 351,54 0,07% снижение
·Технологии·источник: Habr·2 мин

Как пушить на прод без секретов: подключаем готовый Github Action для деплоя на VPS

Недавно я опубликовал на Хабре разбор архитектуры своего open-source инструментspan_49span_49а cd (Dmitry-Fedotov-Dev/cd) — легковесной self-hosted системы доставки кода на свой VPS через OpenID Connect (OIDC). Вместо приватных SSH-ключей и статических токенов в настройках репозитория система использует одноразовые подписанные JWT от самой CI-платформы.

Сегодня практическое продолжение цикла: клиентская часть оформлена в официальный GitHub Action cd deploy (uses: Dmitry-Fedotov-Dev/cd@v1) в GitHub Marketplace. Под катом — воспроизводимая инструкция без лишней теории: паспорт экшена, быстрый старт (в одну команду или за 3 шага), требования к контейнеру, три готовых сценария (bundle со сборкой в CI, монорепозиторий и ручной откат через workflow_dispatch), а также таблица диагностики кодов CD-RESULT.

Паспорт инструмента и совместимость (TL;DR)

Параметр Значение / Спецификация Инструмент и репозиторий cd — github.com/Dmitry-Fedotov-Dev/cd (лицензия MIT) GitHub Action (Marketplace) Dmitry-Fedotov-Dev/cd@v1 (cd deploy); для фиксации версии используйте тег @vX.Y.Z Серверные компоненты Демон cdd (systemd, слушает 127.0.0.1 за reverse proxy) и CLI cdctl (Go, без внешних зависимостей) Протокол авторизации cd protocol v1 поверх HTTPS: OIDC JWT (RS256), проверка aud (CD_SERVER), repository, ref, environment Типы проектов (--type) node, static, dockerfile Другие поддерживаемые CI GitLab CI (gitlab/deploy.yml с id_tokens), любой shell-клиент (deploy.sh) Требования к серверу (VPS) Linux с Docker, systemd и reverse proxy (из коробки поддержаны Caddy и автоматизация DNS через Porkbun)

Предусловия: что должно быть готово на VPS и в приложении

Большинство ошибок первого запуска связано не с YAML в GitHub Actions, а с невыполнением контракта серверной части cdd и песочницы контейнера.

Установка демона cdd на сервер

Если управляющий демон cdd ещё не развёрнут на вашем VPS, установите cdd и cdctl от имени root (установщик проверяет контрольные суммы checksums.txt и затрагивает только /usr/local/bin/cd*, /etc/cdd и /var/lib/cdd):

curl -fsSLO https://raw.githubusercontent.com/Dmitry-Fedotov-Dev/cd/v1/install.sh sudo bash install.sh --public-url https://deploy.example.com

Значение --public-url (и будущая переменная CD_SERVER в GitHub) обязательно должно использовать HTTPS и записываться строго без завершающего слеша (https://deploy.example.com, а не https://deploy.example.com/). Сервер проверяет совпадение aud внутри OIDC-токена по точному строковому равенству.

Контракт запускаемого приложения в песочнице cdd

Отрывок из ленты источникаЧитать у источника: Habr

Как пушить на прод без секретов: подключаем готовый Github Action для деплоя на VPS