Новое в 0.4.22
Настроить CI для репозитория
Откройте CI/CD на панели навигации. Эта версия настраивает непрерывную интеграцию; развёртывание приложения она не выполняет.
Ниже указаны названия элементов английского интерфейса.
Перед началом
Платный тариф и репозиторий с коммитами
Войдите через Account с платным тарифом; место в оплаченной команде Team, Business или Enterprise подходит, а пробный период — нет. Для настройки нужен доступный сервер Termiyo с шаблонами CI версии 0.4.22. Отправьте первый коммит в репозиторий перед настройкой CI.
11 типов проектов
В Build it as доступны Node.js, Python, Go, Rust, Java (Maven), Java (Gradle), Ruby, PHP, .NET, Docker image и A blank starting point. Для GitHub и GitLab тип определяется по именам файлов в корне репозитория; проверьте выбор и выберите один тип, если найдено несколько. Пустая заготовка содержит шаг-заполнитель, который нужно заменить.
GitHub
1. Подготовить токен
Выберите GitHub и нажмите Open GitHub’s token page. Используйте личный токен с детальными правами, ограниченный этим репозиторием: для Contents, Workflows и Pull requests нужны Read and write, для Actions и Metadata — Read. Установите срок действия не более 90 дней. Поддерживается только github.com через api.github.com; GitHub Enterprise не поддерживается.
2. Сохранить и проверить
Выберите Saved token или нажмите Save a new token, заполните Name и Paste the token, затем нажмите Save to key box. В Repository введите owner/name или ссылку на github.com и нажмите Check. Также можно использовать List repositories this token can see.
3. Проверить файл и открыть pull request
Выберите Build it as, нажмите Show the file, проверьте файл и нажмите Set up CI. Termiyo создаёт коммит .github/workflows/termiyo-ci.yml в termiyo/ci-setup и открывает pull request. Нажмите Open in browser для проверки и слияния. CI может запускаться для pull request; ветка по умолчанию остаётся неизменной до слияния.
GitLab
1. Указать проект и подготовить токен
Выберите GitLab. В Project введите group/project для gitlab.com или полный HTTPS-адрес проекта в собственном GitLab, затем нажмите Open GitLab’s token page. Используйте личный или проектный токен с областью api; она разрешает всё, что может делать владелец токена, поэтому задайте короткий срок действия и отзовите токен после настройки.
2. Проверить проект и runner
Выберите Saved token или используйте Save a new token → Save to key box, затем нажмите Check. Выберите Build it as. Если нет доступного runner, включите общие runner или зарегистрируйте runner проекта перед слиянием; панель также сообщает, когда токен не позволяет определить, доступен ли runner.
3. Проверить файл и открыть merge request
Нажмите Show the file, проверьте файл и нажмите Set up CI. Termiyo создаёт коммит .gitlab-ci.yml в termiyo/ci-setup и открывает merge request. Используйте Open in browser для проверки и слияния; ветка по умолчанию остаётся неизменной до слияния.
Giti: Repos on a host
1. Проверить хост
Подключитесь к SSH-хосту с репозиторием Giti и выберите Repos on a host. Этому runner нужны Linux на x86_64 или ARM64, git и Docker, доступный SSH-аккаунту, а также curl или wget, tar, sha256sum или shasum и timeout. Termiyo не устанавливает Docker; обратитесь к администратору хоста или используйте Docker без root.
2. Установить и включить
Нажмите Install the CI runner. Termiyo загружает nektos/act 0.2.89 в ~/.termiyo/bin и проверяет SHA-256 перед распаковкой или запуском. Для репозитория выберите Build it as и нажмите Turn CI on. Существующий хук post-receive другого инструмента остаётся нетронутым и препятствует автоматической настройке.
3. Слить ветку, отправить изменения и прочитать результат
Если Termiyo создал ветку процесса termiyo/ci, скопируйте показанные команды кнопкой Copy и выполните их в своём клоне на ветке по умолчанию для слияния и отправки изменений. Затем хост запускает .github/workflows/termiyo-ci.yml через act в Docker после push владельца; push коллег с предоставленным доступом никогда не запускает CI. Используйте Refresh и Log для просмотра результатов, а Turn CI off — для отключения хука.
Ресурсы хоста
Время каждого запуска ограничено 30 минутами. Termiyo запрашивает у Docker сеть bridge, отсутствие сокета Docker внутри задания, запрет новых привилегий и ограничения в 2 CPU, 4 ГБ памяти и 512 процессов; соблюдение зависит от Docker на хосте. При первом запуске загружается образ размером 2,3 ГБ.
Ограничения и проверка
Существующие процессы CI и тарифы
В GitHub и GitLab Termiyo никогда не перезаписывает целевой файл процесса CI; если .gitlab-ci.yml уже существует, он предлагает шаблон для ручного объединения. Платный тариф покрывает настройку из Termiyo: просмотр запусков не зависит от тарифа, а уже настроенная CI продолжает работать после его окончания. Шаблоны поступают с сервера Termiyo и должны совпадать с отпечатками, закреплёнными в приложении.
Что проверено на данный момент
Настройка GitHub и GitLab проверялась с имитациями сервисов, а не с настоящими аккаунтами. Giti CI завершила один настоящий запуск на одном хосте x86_64. Развёртывание в этой версии не реализовано.