gtcnsl
EN RU

Быстрый старт

От свежеустановленного бинарника до работающего Gitea с CI — три команды и пара проверок.

Актуально для v0.6.3

Перед началом

Нужны: gtcnsl в PATH (см. Установку), домен, указывающий на машину, и root. Остальное gtcnsl настроит сам.

Установить Gitea

gtcnsl gitea install --yes

Скачивает проверенный бинарь Gitea с официального зеркала, создаёт пользователя git, пишет дефолтный app.ini, разворачивает systemd-юнит и запускает Gitea — с авто-откатом, если health-check не прошёл. (--yes подтверждает разрушающую операцию без оператора.)

i
Задайте домен
install пишет дефолтный app.ini. Направьте его на ваш хост через gtcnsl config set server.DOMAIN git.example.com --yes — или примените целый шаблон (см. «Конфигурация»).

Установить раннер

gtcnsl runner install --executor=docker --yes

Ставит act_runner и его systemd-юнит gitea-runner с выбранным executor-ом (--executor обязателен: host, docker, docker-rootless, podman). Юнит включён, но остаётся остановленным — CI-задачи не запускаются, пока он не зарегистрирован.

Зарегистрировать раннер

gtcnsl runner register --instance https://git.example.com --token <fresh-token> --yes

Регистрирует раннер на вашем инстансе и запускает его. Токен возьмите в Gitea → Site Admin → Runners → Create new runner (токены обычно одноразовые).

Проверить результат

gtcnsl doctor

Докладывает PASS / WARN / FAIL по systemd, бинарникам, app.ini, секретам и обоим юнитам (gitea, gitea-runner). Откройте https://git.example.com, чтобы завершить веб-настройку.

!
Сначала DNS
Если домен ещё не резолвится на этот хост, регистрация упадёт. Настройте DNS и повторите шаг регистрации.

Что дальше

Держите app.ini в Git и дайте gtcnsl устранять дрейф. Доки по конфигурации скоро; пока смотрите декларативный пример на главной.