Lightning Talk Beginner MIT License

Diagram as Code - Automating Architecture Documentation with Open Source

Approved

Session Description

We often spend hours creating architecture diagrams, but after a few changes in the application or infrastructure, they become outdated.

Updating them manually is time-consuming, so many teams simply stop doing it.

In this session, I'll show how we can generate infrastructure and cloud architecture diagrams using code instead of drawing them manually.

Using the open-source Diagrams, we'll create AWS, Kubernetes, and microservice architecture diagrams that can be stored in Git, updated easily, and even generated automatically through CI/CD pipelines.

The session will include live demos, real examples, and a few best practices that you can start using in your own projects.

Key Takeaways

• Understand what Diagram as Code is and why it is useful.
• Learn how to generate cloud and infrastructure diagrams using diagrams.
• See how architecture diagrams can be stored and maintained in Git.
• Learn how to automate diagram generation using CI/CD.
• Take home practical ideas to keep architecture documentation up to date with open-source tools.

References

https://github.com/mingrammer/diagrams

https://diagrams.mingrammer.com/

Session Categories

Introducing a FOSS project or a new version of a popular project

Tutorial about using a FOSS project

Engineering practice - productivity, debugging

Talk License: MIT License

Speakers

Santhosh NC Lead Infrastructure Consultant | Thoughtworks

Seasoned, critical-thinking DevSecOps engineer with over 10 years of robust experience in designing, developing, building, testing, implementing, securing, operating, and monitoring applications and infrastructure across various domains.

Proficient in DevOps and Multi-Cloud technologies, demonstrating expertise in automated build and deployment tasks by creating comprehensive CI/CD/CT pipelines alongside infrastructure automation.

A talented performer driven by the pursuit of knowledge and adept at navigating and instructing others in emerging technologies.

Possesses a proven ability to collaborate effectively with excellent communication skills, autonomously and within diverse internal teams, to drive project success and innovation.