Как правильно вести "документацию"/ заметки сис админу?

Question

[Павел]

Есть маленькая фирма которая развивается быстрее чем я все успеваю делать, я работаю один, у меня уже штук 10 серверов, один из них proxmox на нем еще штук 5
3 офиса в каждом по 15-30 человек
по 10 принтеров в каждом офисе

Эта вся предыстория к тому что я не могу держать все в голове, логины/пароли ip mac адреса и т.п

Я начал вести заметки сперва просто в txt , затем в екселе, теперь вот веду в markdown(obsidian) , делаю маркировки провода хоть как то делаю карты сети но я начинаю во всем этом путатся и долго искать, хоть и линкую заметки между собой для ускорения поиска

как правильно и удобно все хранить? Самое что хочется, что бы было доступно удобно с телефона, в том числа и добавления информации

Answer 1

[Максим К]

Есть движок docuwiki гляньте, может понравится . Сам использовал - очень удобно.

Answer 2

[Ивор Барханский]

Раз в несколько лет вы будете кочевать туда сюда. Блокнот, Обсидиан, Ноушен, Докувики, Эксель\Ворд, Блокнот в клеточку. Постоянно мигрируешь туда-сюда потому что задачи меняются, старые записи устаревают и удаляются, новые записи подпадают под новые требования - что-то для себя, что-то на отдел расшарить итд. Были пароли в Кипасс, не хватало шашечек, переехал на битварден, пока переезжал и привыкал, за пару тройку лет шашешчки подъехали и в кипасс, теперь думаешь про обратный переезд.

Это я к чему, серебрянной пули нет, а с опытом меняются привычки. Просто ведите там где удобно и наплюйте на наши мнения.

Answer 3

[Alexey Dmitriev]

Пароли - в хранилке паролей, например Keepass.
Остальное - в OneNote\Evernote, потом переносить в документацию.

Comments

[Павел]

ну пароли так совпало что уже я храню в keepass уже лет эдак 12-15
заносить допустим можно, но куда переносить? Как ее смотреть? Можно подробнее о самой документации?

[Alexey Dmitriev]

Павел, на вкус и цвет - wiki, confluence, папка с доковскими файлами

Answer 4

[Дмитрий]

Правильно так, как удобно именно тебе.
Я, сейчас, держу в экселе. Раньше в ворде заполнял.
разницы нет, в чём держать. Разница в том, что бы они были "под рукой".
Или в облаке держи (тот же гугл-докс), или бекапь на флешку после каждого изменения.

Comments

[Павел]

может поделитесь практикой заполнения? Может у вас перейму опыт

[Дмитрий]

Павел, Просто в виде таблицы, всё что нужно именно тебе.
Для меня это лицухи, доступы на серверы и ЛК (провайдер, моб. оператор, 1С портал и т.д.), электронки сотрудников и номера телефонов. Больше мне не надо.
P.S. для остального поднял GLPI, что бы видеть железки.

Answer 5

[Ингвар]

Советую пользоваться гугл доками (https://docs.google.com/)
В Exel удобно хранить всё что связано с паролями и просто ссылками
В Word удобно хранить полезную информацию по типу кусков конфигураций, просто длинных текстах о проблемах и их решении, вести какие то свои списки, как пример добавлю скрин лишнее замажу, лично для меня удобно.
По мимо этого на основном пк удобно держать Notepad++ где тоже куча информации, зачастую той которую будешь (у коллег встречается по 20-50к+ строк).
Для паролей к примеру своим подданным можешь использовать syspass, если не ошибаюсь на бесплатной основе, там можно разделять пользователей на группы и они будут видеть только те пароли которые им необходимы.

Как пример самой простой exel таблицы, 10 принтеров к каждому несколько колонок, его ip локальный, модель, расположение и всё в таком духе

Сори скрин на скорую руку шакально замазал

Comments

[CityCat4]

Угу, особенно будет здорово, когда гугл отключит доступ к своим сервисам :) В нынешние дикие времена лучше чтобы ключевые данные лежали там, где до них не дотянуться (это я еще не упомянул, что гугл читает все документы - это, по-моему все знают и забивают на это)

[Ингвар]

CityCat4, Естественно ключевые данные лучше хранить в оффлаине, на каком-нибудь носителе к примеру, либо в голове так еще надежнее, а вот всякий хлам по типу локальных ip компов офисных и принтеров можно и в гугл доке, пусть читают если так интересно))
А вот про доступ к докам сомнительно, в любом случае если закроют, под VPN зайдем и скачаем, потом перенесем куда надо.
xwiki и redmine это круто, но замароченно если смотреть в рамках использования для данного кейса, ему же просто заметки делать в основном.

[Павел]

Ингвар, согласен, но кроме текста не хватает чего то типа mindmap и его негде в удобном виде для телефона нет, так что пока так, в обсидиан есть mermaid очень клевая штука, простой синтаксис пишешь и получаешь карту сети в атоматическом режиме + ссылки на нужные заметки, например один из офисов выглядит так:

а написано в тексте это вот так


почему я собственно начал эту тему, потому что с телефона эту карту не видно ну или неудобно ее "листать" туда сюда , а зумить нельзя
зато все жирным синим это ссылки на маленькие заметки с подробными данными

[CityCat4]

Ингвар,

под VPN зайдем и скачаем,

Не так давно проведенные учения по блокировке IKEv2 показывают, что северокорейский "Кванмен Россия" куда ближе, чем хотелось бы... При белом списке не больно-то куда зайдешь... Дело даже не в том, что пусть гугл читает - ему конечно мало интересны IP Вашего офиса, но вот лишиться доступа к этой инфе может оказаться не особо хорошо.

Answer 6

[CityCat4]

XWiki, Redmine
Если вести в вики то лучше конечно полноценный вики-движок типа xwiki, потому что в redmine он довольно скромный.
Но в redmine я обычно сам себе "ставлю" задачи и сам их "решаю".

Answer 7

[ky0]

Netbox.

Comments

[Павел]

вот это монстр

Answer 8

[loderunner84]

пароли в vaultwarden, адреса в netbox или phpipam, инвентаризация в glpi, документация в dokuwiki, но я все больше посматриваю в сторону markdown в git

Comments

[Павел]

я вот в markdown веду но читать не удобно, с поиском тоже трудновато, если на ПК то да, идеально, а на мобилке увы
если вдруг найдете приложение удобное для мобилки, аля obsidian для ПК , то дайте знать)

Answer 9

[Overtus]

В hesk я работаю, есть и helpdesk и wiki, шаблоны долго настраивать, чтобы было красиво, зато бесплатно и мощьно в итоге. В принципе и стандартные html годные, если сразу оформлять текста в wiki нормально.

Comments

[Павел]

с мобилки по прежнему не удобно доабвлять/обновлять информацию, в гугл документах проще, но в них нет чего то типа mind map (