From: Alexey Shabalin <a.shabalin@gmail.com> To: ALT Linux Team development discussions <devel@lists.altlinux.org> Subject: [devel] Fwd: [Comm] Gitea + VitePress = ? Date: Thu, 11 Apr 2024 23:49:41 +0300 Message-ID: <CAEdvWkRKqXLAhf_tBRjJfKF9H61r=6233fNipW_BsTycJxnG0w@mail.gmail.com> (raw) In-Reply-To: <f5d1bf99-d84f-45a7-8e85-00ad9eb949b4@alt-gnome.ru> Всем привет. Уже не первый раз обращаются с вопросом об организации на ресурсах Альт сервиса, похожего на 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
next parent reply other threads:[~2024-04-11 20:49 UTC|newest] Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top 2024-04-11 20:49 ` Alexey Shabalin [this message] 2024-04-11 21:27 ` Aleksey Novodvorsky 2024-04-12 10:05 ` Evgeny Sinelnikov 2024-04-12 7:13 ` Anton Farygin 2024-04-12 7:19 ` Vitaly Lipatov 2024-04-12 9:05 ` Sergey Bolshakov 2024-04-12 9:53 ` Paul Wolneykien 2024-04-12 11:29 ` Anton Farygin 2024-04-12 11:35 ` Denis Medvedev 2024-04-12 11:38 ` Anton Farygin 2024-04-12 13:26 ` Denis Medvedev 2024-04-16 14:51 ` Andrey Savchenko
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to='CAEdvWkRKqXLAhf_tBRjJfKF9H61r=6233fNipW_BsTycJxnG0w@mail.gmail.com' \ --to=a.shabalin@gmail.com \ --cc=devel@lists.altlinux.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: link
ALT Linux Team development discussions This inbox may be cloned and mirrored by anyone: git clone --mirror http://lore.altlinux.org/devel/0 devel/git/0.git # If you have public-inbox 1.1+ installed, you may # initialize and index your mirror using the following commands: public-inbox-init -V2 devel devel/ http://lore.altlinux.org/devel \ devel@altlinux.org devel@altlinux.ru devel@lists.altlinux.org devel@lists.altlinux.ru devel@linux.iplabs.ru mandrake-russian@linuxteam.iplabs.ru sisyphus@linuxteam.iplabs.ru public-inbox-index devel Example config snippet for mirrors. Newsgroup available over NNTP: nntp://lore.altlinux.org/org.altlinux.lists.devel AGPL code for this site: git clone https://public-inbox.org/public-inbox.git