[devel] Fwd: [Comm] Gitea + VitePress = ?

[Alexey Shabalin]

Всем привет.
Уже не первый раз обращаются с вопросом об организации на ресурсах
Альт сервиса, похожего на Github.
В основном хотят увидеть возможность хранения git + PR/MR. Дальше идут
Action (CI/CD), и как ниже в письме, например аналог Github Pages.

Да, я тоже поддерживаю создание такого сервиса, и готов принять
участие в его создании.
Из наиболее популярных решений, предлагаю остановиться на gitea.
Gitlab слишком тяжелый как по используемым ресурсам, так и с точки
зрения администратора.
Не говоря уже о том, что опакетить его в сизиф практически нереально.
В этом смысле gitea (или её форки/предки) поддерживает большинство
запрашиваемых функций, при этом она остается удобной в
администрировании, и присутствует в сизифе.

Так же перед созданием такого сервиса, надо будет решить несколько
организационно-технических вопросов:
- кого и как пускаем в этот сервис? только членов Team? всех? если
люди хотят сделать PR в какие-то проекты на gitea, то получается надо
дать возможность регистрации всем желающим.
  в принципе неактивных можно удалять по крону :)
- Я бы предпочел в качестве сервиса аутентификации использовать
внешний сервис, а не внутреннюю базу пользователей gitea (наш сервис,
внешний для gitea :)
  Этот наш новый сервис аутентификации позволит в дальнейшем
подключать наши новые сервисы для Team или сторонних пользователей, и
иметь единую учетку для доступа ко всем сервисам.
- Доменное имя для Pages (это уже решили, тут проблем нет).
- по остальному у меня есть представление, будут спорные вопросы,
попрошу помощи у аудитории.


---------- Forwarded message ---------
От: Олег Щавелев <oleg на alt-gnome.ru>
Date: вт, 9 апр. 2024 г. в 17:26
Subject: [Comm] Gitea + VitePress = ?
To: <community на lists.altlinux.org>


Случайная находка в глубинах интернета, VitePress — отличная история
для создания библиотеки знаний. Давайте по порядку!

VitePress — это генератор статических сайтов (SSG), предназначенный
для быстрого создания веб-сайтов, ориентированных на контент. В двух
словах, VitePress берет ваш исходный контент, написанный в Markdown,
применяет к нему тему и создает статические HTML-страницы, которые
можно легко развернуть где угодно.

Первой пробой пера стал ресурс ALT Gnome Wiki, и хочется поделиться
результатами работы данной библиотеки знаний:

Количество авторов: 25 участников.

Количество визитов за текущий квартал: 19,2 тыс.

Количество пользователей за последний квартал: 10,4 тыс.

Количество просмотров за последний квартал: 72,4 тыс.

Мы предполагали, что внесение изменений в библиотеку знаний вызовут
сложности у активных участников, но это оказалось ошибочным суждением,
за полгода было отправлено 239 PR, что является, на мой взгляд,
отличным результатом. А общее количество изменений составляет 1262
изменения.

Теперь о технических сладостях, и по порядку, как это все работает.

Все содержание проекта — это md-файлы, участник может написать статью
или ее изменить, а именно добавить файл или его редактировать и
отправить PR в наш адрес, используя сервис GitHub. Если сомневаетесь,
что это просто, отправьте небольшой PR и самостоятельно оцените,
посмотрите, пощупаете.

Далее мы принимаем PR и добавляем в основную ветку, и начинается самое
интересное, срабатывает автоматизация и запускается сервис GitHub
Actions, а после — GitHub Pages, а если проще, то GitHub Actions
запускают контейнер, который скачивает и запускает Linux-среду,
устанавливается окружение Node с утилитой npm и в данной среде
собирается проект, используя возможности Vitepress. Результат —
статические файлы, которые отправляются в сервис GitHub Pages и уже
доступны пользователям.

К сожалению, от знакомых, сообществ и коллег иногда приходят тревожные
новости, что тот или иной аккаунт на GitHub заблокирован, как правило,
это временная история, но вы поняли, о чем идет речь. GitLab имеет
региональные ограничения по регистрациям определенных почтовых
провайдеров, а о точечных блокировках не слышно, хотя, может быть, они
и есть. А GitFlic не имеет таких возможностей по работе со
статическими сайтами.

А вот Gitea...

Как минимум умеет работать аналогично GitHub Actions, так еще
полностью открытый, но нужен сервер и умелые руки системных
администраторов. Сделать небольшое пространство для сообщества Альта и
клипать интересные проекты совместно с дружным сообществом. К примеру
мы остановиться не можем и уже начали ALT KDE Wiki, но это отдельная
история.

А кто хочет подробности, несколько ссылок:

https://gittea.dev/

https://packages.altlinux.org/ru/sisyphus/srpms/gitea/

https://docs.gitea.com/next/usage/actions/overview/

И, если нас услышат, будем делать совместные проекты в зоне
altlinux.org, в крайнем случае — нет)

_______________________________________________
community mailing list
community на lists.altlinux.org
https://lists.altlinux.org/mailman/listinfo/community


-- 
Alexey Shabalin