Небольшая компания. У нас есть довольно надежное приложение, которое работает на AWS и обслуживает множество клиентов. Наш системный администратор / ведущий разработчик покинул компанию и забрал с собой знания, которыми мы не все делились.
Остальные наши разработчики легко подхватили кодировку. Как менеджер проекта я понял, как в целом управлять развертыванием серверов, используя Laravel Forge и AWS по мере необходимости. Проработав несколько лет на общем уровне в AWS, я знаю основы.
У меня высокий уровень понимания архитектуры, но я не полностью понимаю все взаимосвязи между элементами.
Я хочу задокументировать используемые экземпляры, IP-адреса, тома, группы безопасности, КЛЮЧИ и т. Д., А также их взаимосвязь. Если возможно, визуально или хотя бы в виде таблицы.
Я медленно выясняю, как все найти.
Есть ли у кого-нибудь предложения по созданию удобной для понимания документации для системы?
Я занимаюсь этим в Excel и Powerpoint, Gliphy и т. Д., И я начинаю заново и переделываю макеты, поскольку вижу, что есть новые отношения, которых я раньше не понимал.
Любые советы будут оценены.
Я еще не нашел инструмента, который бы автоматически создавал хорошие и полезные диаграммы AWS. У меня есть несколько инструментов, которые я использую, если мне нужен список ресурсов:
Я нахожу draw.io или их офлайн-клиент очень эффективен для создания диаграмм AWS.