Сообщество и ресурсы

Salt — open source проект с 2011 года: код под лицензией Apache 2.0, разработка идёт публично на GitHub. После покупки SaltStack Inc. компанией VMware (2020) и затем VMware компанией Broadcom (2023) ядро сопровождают инженеры Broadcom вместе с сообществом, а заметная часть экосистемы — организация salt-extensions, формулы — держится именно на сообществе. Для практикующего инженера это не абстракция, а рабочий вопрос: куда идти с багом, где следить за релизами, как отличить актуальный материал от устаревшего. У Salt длинная история, и в сети накопилось много статей, которые после переезда пакетного репозитория и Great Module Migration скорее вредят, чем помогают, — поэтому знание «официальных» точек входа экономит часы.

Как это работает

Главные точки входа три. Документация — docs.saltproject.io: справочник по всем модулям, туториалы и install-guide; это первоисточник, с которым стоит сверять любой сторонний материал. GitHub — saltstack/salt: issues для багов, pull request'ы для исправлений, дискуссии; там же видно, что реально происходит с проектом — темп коммитов, план релизов, обсуждения изменений. Блог — saltproject.io/blog: анонсы релизов, объявления о крупных изменениях вроде миграции модулей или переезда репозитория; именно из блога такие вещи узнают вовремя, а не постфактум из сломавшегося пайплайна. Помимо этого проект проводит регулярные открытые созвоны (community open hours), где можно задать вопрос мейнтейнерам напрямую, а вокруг ядра живут community-проекты — организация salt-extensions и коллекция формул, куда контрибуцию принять обычно проще, чем в ядро.

Когда применять

Ориентируйтесь по типу вопроса. Ошибка, похожая на баг, — поиск по issues в saltstack/salt: с высокой вероятностью её уже описали, вместе с обходным путём. Не нашли — заводите issue, приложив вывод salt --versions-report и минимальное воспроизведение. Вопрос «как сделать» — сперва документация и поиск по ней, затем обсуждения сообщества. Планирование обновлений — блог и release notes: там объявляются сроки поддержки веток LTS и STS. Пропал модуль после апгрейда — организация salt-extensions. Хотите влиять на проект — путь контрибуции обычный для GitHub: issue, обсуждение, pull request; начинать удобнее с расширений или формул, где цикл ревью короче.

Типичные ошибки

Учиться по старым статьям: материалы до 2024 года ссылаются на мёртвый repo.saltproject.io, старую схему пакетов и модули, которых нет в ядре 3008, — проверяйте дату и сверяйте с документацией. Заводить issue без salt --versions-report и шагов воспроизведения — такие тикеты закрываются вопросом «а какая у вас версия?» и висят неделями. Путать open source Salt с проприетарным GUI (SaltStack Config / Aria Automation Config): это отдельный коммерческий продукт, и вопросы по нему в community-каналах не по адресу. Наконец, ожидать от community-расширений SLA как от ядра: у нишевого saltext может быть один мейнтейнер, и починка бага — вопрос доброй воли или вашего pull request'а.

Как это работает

Когда применять

Типичные ошибки

Связанные понятия

Полезные ресурсы