Как пушить на прод без секретов: подключаем готовый 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
