Pequena companhia. Construímos um aplicativo bastante robusto que roda na AWS e atende muitos clientes. Nosso administrador de sistemas/desenvolvedor líder deixou a empresa e levou consigo conhecimentos que nem todos compartilhamos.
Nossos outros desenvolvedores aprenderam facilmente a codificação. Como gerente de projeto, aprendi como gerenciar de maneira geral as implantações de servidor usando Laravel Forge e AWS conforme necessário. Tendo trabalhado em nível geral na AWS por vários anos, conheço oFundamentos.
Tenho um conhecimento de alto nível da arquitetura, mas não entendo completamente todas as relações entre os elementos.
Quero documentar as instâncias, IP'S, volumes, grupos de segurança, CHAVES, etc, usados e como eles estão relacionados. Visualmente, se possível, ou pelo menos em forma de tabela.
Estou lentamente descobrindo como encontrar tudo.
Alguém tem alguma sugestão sobre uma boa maneira de criar documentação fácil de entender para um sistema?
Estou açoitando isso no Excel e Powerpoint, Gliphy etc. e me pego recomeçando e refazendo os layouts, pois vejo que há um novo relacionamento que eu não tinha entendido anteriormente.
Qualquer dica seria apreciada.
Responder1
Ainda não encontrei uma ferramenta que faça diagramas AWS bons e úteis automaticamente. Tenho algumas ferramentas que uso se quiser uma lista de recursos:
- Editor de tags AWS: integrado à AWS, apenas fornece uma lista que você pode exportar
- Cloudockit: não usei, mas parece que pode ser útil
- CloudCraft.co: útil para listas e diagramas, mas não tão bom em diagramas quanto eu esperava
- Recuperador AWS: fornece uma lista de recursos da AWS, mas parece um software beta
Eu acho draw.io ou o delescliente off-linemuito eficaz para criar diagramas AWS.