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

[Aleksey Novodvorsky <aen@basealt.ru>]

чт, 11 апр. 2024 г. в 23:50, Alexey Shabalin <a.shabalin@gmail.com>:
>
> Всем привет.
> Уже не первый раз обращаются с вопросом об организации на ресурсах
> Альт сервиса, похожего на Github.
> В основном хотят увидеть возможность хранения git + PR/MR. Дальше идут
> Action (CI/CD), и как ниже в письме, например аналог Github Pages.
>
> Да, я тоже поддерживаю создание такого сервиса, и готов принять
> участие в его создании.
> Из наиболее популярных решений, предлагаю остановиться на gitea.
> Gitlab слишком тяжелый как по используемым ресурсам, так и с точки
> зрения администратора.
> Не говоря уже о том, что опакетить его в сизиф практически нереально.
> В этом смысле gitea (или её форки/предки) поддерживает большинство
> запрашиваемых функций, при этом она остается удобной в
> администрировании, и присутствует в сизифе.
>
> Так же перед созданием такого сервиса, надо будет решить несколько
> организационно-технических вопросов:
> - кого и как пускаем в этот сервис? только членов Team? всех? если
> люди хотят сделать PR в какие-то проекты на gitea, то получается надо
> дать возможность регистрации всем желающим.

Ресурсы?
Помимо материальных (обрудование, канал, администрирование) надо, по
нынешним временам, учитывать контроль информации
Возможно, стоит ограничиться теми, кого рекомендуют и обязуются
контролировать члены тим.

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

Мне это нравится.

Прошу держать в cc: Олега Щавелева, автора исходного письма в
community@, он не член тим

Rgrds, Алексей

>
>
> ---------- 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
> _______________________________________________
> Devel mailing list
> Devel@lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/devel