Какие методы/техники/инструменты вы рекомендуете для документирования систем и инфраструктуры (runbooks)?[закрыто]

Question

Фон

Недавно я присоединился к небольшому стартапу после работы в крупной компании.

Однако я не являюсь профессиональным системным администратором, поскольку благодаря моим знаниям в области программирования и систем я теперь являюсь внутренним человеком, управляющим нашими серверами и инфраструктурой.

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

Событие, вызвавшее срочность

Я немного небрежно относился к продвижению этого дела, пока не обнаружил, что не знаю где мой основной файл конфигурации Subversion находился в /etc/apache2 (не говоря уже о том, что файл конфигурации не находится под контролем версий и не имеет резервной копии!) Я понял, что эту проблему нужно решить быстро.

Следующий шаг

Теперь мне нужно придумать, как задокументировать все это в разумной, элегантной и контролируемой форме.

Я слышал о Runbook, но не знаю, как лучше всего ими управлять.Моей первой мыслью была электронная таблица Excel/openoffice под контролем версий.

Есть ли хорошее руководство по обслуживанию модулей Runbook?Хорошее программное обеспечение?Должно быть, это довольно распространенная проблема, как с ней справиться?

Answer 1

На самом деле я добился хорошего успеха с Wiki.Используйте что-нибудь, где вы можете легко контролировать вход в систему (Mediawiki подойдет, но требует некоторого взлома PHP) и создайте несколько шаблонов для процессов, инвентаризаций и т. д.

Обновлять

На самом деле, мне, должно быть, нужен был кофе. Трак почти идеален;лучший контроль доступа, интегрированное отслеживание проблем и несколько более сильная текстовая модель.Вы даже можете привязать его непосредственно к своему репозиторию Subversion, чтобы можно было подключать реальные сценарии к их страницам Runbook.

Answer 2

Вики действительно хороший подход.Вы можете настроить для этого SharePoint и получить такие полезные функции, как история обновлений, ссылки, которые всегда указывают на текущую информацию, и тому подобное.

Answer 3

Если вы используете что-то вроде Кукольный, (или Chef, или CFEngine и т. д.) для создания и управления вашими машинами, тогда большая часть содержимого runbook может находиться внутри конфигурации puppet, оставляя вам гораздо меньше вещей (только местоположение и пароль для puppetmaster, если вы доведите это до крайности!) и поместите в свою вики.