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

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

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

Главные точки входа — три: документация, GitHub и блог. Документация на docs.saltproject.io содержит справочник по всем модулям, туториалы и инструкции по установке. GitHub репозиторий saltstack/salt используется для отслеживания багов, исправлений и обсуждений. Там можно увидеть темп коммитов, план релизов и обсуждения изменений. Блог на 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'а.

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

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

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

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

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

🔤 Английские термины в этой теме