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