Opensophy Hub в архиве, да здравствует os.docs
Ранее, когда я создавал проект Hub, это была статическая платформа для документации и контента с админ-панелью. От этой идеи пришлось отказаться по следующим причинам:
-
Проект ради эксперимента. Изначально он создавался не для использования другими пользователями, а в целом для моих целей и эксперимента (статья на Хабре).
-
UI-треш и неопределённость. Я долго думал над дизайном, никак не мог определиться, вечно экспериментировал — и получил хорошую критику от пользователей, в том числе от Хабра 🙂
ну ведь реально не оч
-
Не docs-as-code, а бургер. Админ-панель плюс сама философия проекта — то, что он должен быть docs-as-code, — плохо сочетались.
Что из этого вышло?
Поскольку мне всё же нужна была норм платформа для документации — чтобы она имела больше автоматизации, была по-настоящему docs-as-code, да ещё и с сохранением системы [N];[C];[A] (быстрое создание путей / название и slug страницы), — я создал на базе этого минимальный шаблон os.docs, взяв всё самое лучшее.
Намного лучше теперь
-
Я сменил стек с React на Svelte в пользу того, что он, по моему мнению, проще и оказался производительнее.
-
Единый красивый дизайн UI (скрин). Прокачал в этом навыки, вдохновляясь системами документации других проектов, — думаю, получилось идеально!)
-
Автоматизация SEO/GEO — в отличие от Hub, где приходилось делать это вручную, теперь всё на автомате.
-
Отказался от админ-панели в пользу docs-as-code — решил, что она вообще не нужна в моём случае, т. к. раньше она была доступна только через IDE. Поэтому для упрощения работы и безопасности сделал всё «правильно» с точки зрения современных проектов.
Шаблон доступен в open-source. Ссылка: github.com/opensophy-projects/docs
Сам проект hub больше не поддерживается и в архиве.
UI Библиотека
Когда-то я хотел сделать реестр библиотек (статья на Хабре), но ещё раз подтвердил своё «одно но».
Несмотря на то что многие сервисы предоставляют компоненты как open-source, у некоторых из них есть платные компоненты (что можно понять — таким образом авторы получают доход от сервиса). Однако есть один момент, из-за которого я в ближайшее время верну свою UI-библиотеку в интернет (она будет доступна по адресу ui.opensophy.com).
В чём проблема и зачем я хочу это сделать? В первую очередь это будет архив компонентов, который всегда будет открыт и бесплатен. Возможно, возникнет вопрос: зачем? Дело в том, что я начал замечать, как некоторые компоненты, которые раньше были бесплатными и считались open-source, теперь требуют либо регистрации в системе автора, либо покупки. Поэтому иметь собственный реестр, где все эти компоненты будут сохранены и всегда доступны другим, кажется мне хорошей идеей — даже если эти компоненты уже где-то встречались.
И вашему вниманию я представляю open-source библиотеку Svelte-компонентов (под React их и так много, а вот под Svelte — мало!). На данный момент доступно 40+ компонентов, планируется пополнять до 50–100. Сама библиотека на момент написания новости доступна на главном сайте: opensophy.com/components/overview
Пара примеров как это выглядит
Обновление os.mtls — инструмент для быстрого создания и управления mTLS-сертификатами для Traefik
Не так давно я открыл для себя технологию mTLS, и знаете, это оч крутая вещь для homelab! Но есть проблемы.
-
Не все прокси поддерживают полное управление mTLS. И так случилось, что именно под мой стек с Traefik нет полноценной поддержки.
-
Не всегда это удобно и просто.
На эту тему я писал 2 статьи про mTLS: «Руководство» и «mTLS на практике», где обсуждались его применение и модели атак, которые я нашёл на сам протокол, а также моя проблема и решение. А решение было достаточно простеньким для моего сценария — один bash-скрипт для полноценного управления и решения проблемы Traefik (в Traefik из «коробки» действительно отсутствует проверка отзыва клиентских сертификатов — CRL или OCSP — для mTLS: если отозвать сертификат клиента, он продолжит успешно проходить аутентификацию, пока не истечёт его срок действия). Можно сказать, что стоило бы поставить Service Mesh, но мне это не особо подходило.
Так вот, что принесло само обновление:
В V2 я добавил много функций, которые потенциально могли нарушить безопасность, — от них я отказался и остановился на stable-версии (она же последняя), которая сильно улучшает безопасность скрипта: доступ только от root, бэкапы, аудит и небольшой функционал в CLI, включая создание своих пресетов путей. Проект тоже open-source и доступен каждому, кто занимается homelab’ом и хочет с минимальными усилиями получить крутую безопасность. Инфо на сайте opensophy.com/mtls либо в репозитории github.com/opensophy-projects/mtls. Буду рад идеям, как улучшить скрипт.
И один из главных проектов этого года для меня — форк Dokploy. Проект пока имеет закрытый репозиторий, но доступ к нему можно получить по запросу. ( Он скоро будет доступен в open-source формате просто на текущий момент я изучаю как мне его лучше открыть чтобы не упираться в Githubовские ограничения CI/CD.)
Что такое Dokploy и почему я решил его форкнуть?
Если вкратце — это платформа для управления серверами и деплоя приложений: развернуть можно почти всё что угодно — Docker Compose, Nixpacks, Buildpacks или свой Dockerfile. Она была идеальной, но многие пользователи, как и я, начали искать альтернативы после внедрения «enterprise»-функций, из-за чего open-source-версия начала захламляться функционалом, который недоступен, а заодно почему-то была удалена локализация на многие другие языки. Мой форк предоставляет полный доступ к этим «enterprise»-функциям, почти полностью русифицированный интерфейс, а самое главное — улучшение безопасности: я заметил, что в проекте достаточно много старых зависимостей, а также несколько багов, которые пришлось исправлять в достаточно зрелых функциях. Скрины того, как теперь выглядит интерфейс и вся система, можете посмотреть на сайте: opensophy.com/dokploy. При этом функционал всё ещё соответствует докам и обновляется из upstream, из-за чего кое-где можно увидеть текст на английском в интерфейсе — такое бывает, если я не до конца проследил за всеми изменениями. Начиная с v0.30.2 интерфейс был полностью русским, сейчас, на данный момент в v0.30.6, есть некоторые промахи в некритичных местах, где я забыл сделать перевод.
Поэтому если есть те, кто пользуется Dokploy и не хочет этих ограничений, — предлагаю оценить мою версию. Кстати, я планирую добавить туда и управление mTLS (хотя и сомневаюсь, делать это или нет — напишите в комментариях, стоит ли. Сомневаюсь из-за того, что это не относится к платформе, и, возможно, лучше оставить это отдельным проектом os.mtls в пользу безопасности).
На этом пока всё?
Не совсем. Я продолжаю вести открытый эксперимент по борьбе с псориазом и пока могу поделиться анонсом, что, кажется, нашёл причину появления этого псориаза(конкретно у меня). Свою позицию на этот счёт вы сможете прочитать во 2-й части статьи, которая по планам должна выйти в конце декабря (хоть и планировалось в конце осени, но мои гипотезы должны ещё подтвердиться, а лечение — довольно долгое, как и его изучение). Подробности о том, что за эксперимент — в статье на Хабре.
Источник: habr.com