Managing and documenting Azure Resource Groups (RGs) in large-scale environments can be time-consuming and complicated.
A Python script can leverage LLMs (Large Language Models) like OpenAI or Azure OpenAI to automate the creation of comprehensive markdown documentation from ARM templates.
The script uses simple tools like Python, Azure CLI, and LLM APIs to generate human-readable documentation in markdown format.
The script sends the ARM template to OpenAI (or Azure OpenAI) for summarization and generates structured documentation without needing any fancy orchestration.
This script is flexible, customizable, and can generate documentation that explains resources, relationships, networking, purpose, and potential security issues.
The final output is readable, concise, and can easily integrate into documentation systems or knowledge management systems.
Using this tool, anyone with basic scripting skills can leverage AI to automate cloud documentation for DevOps and infrastructure teams.
The source code is available on Github and may be updated with additional tools to automate other tasks.
Setting up and running the script is straightforward and generates a markdown file in the output directory.
This article demonstrates how with the right prompts and a solid structure, simple scripts can leverage AI to automate cloud documentation.