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

Habr ·

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

Недавно я опубликовал на Хабре разбор архитектуры своего open-source инструмента 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