This repository contains the documentation for Contoso's bespoke Terraform modules and best practices for managing Azure resources. The documentation provides detailed information on how to use each module, including examples, input variables, and outputs.
This repository usecase is to demonstrate how you can leverage Generative AI to accelerate the development of bespoke IaC (Infrastructure as Code) Data and Documentation for Terraform modules and best practises for a fictional company called Contoso. The repository contains detailed documentation for each of Contoso's bespoke Terraform modules, including input arguments, outputs, naming conventions, security considerations, and examples of usage. It also provides guidelines and best practices for managing Azure resources using Terraform.
By integrating the documentation with Azure AI Studio, we aim to boost Infrastructure as Code (IaC) productivity and streamline your documentation process. Also helps in understanding the Terraform configurations better and generate examples of usage based on the bespoke IaC data and documentation.
In this demo, you will see how non-Terraform users of the modules can use an AI assistant in this way to help them interpretate the code and documentation. The AI assistant can provide detailed explanations, generate examples of usage, and offer insights into the Terraform configurations. This makes it easier for users of all skill levels to understand and utilise the Terraform modules effectively.
By harnessing the power of Azure AI Studio and private IaC data and documentation, we can create comprehensive and user-friendly AI assistants, ensuring that everyone can benefit, learn and understand private custom-created Terraform modules.
In this demo, you will learn how to:
- How to get started with Azure AI Studio using your own data and documentation (Specifically IaC).
- How to create an AI assistant to interpretate and explain Terraform modules and documentation.
- Use Generative AI as assistant to interpretate, create and manage Terraform modules from bespoke IaC data and documentation.
- Innovatively use AI to boost IaC productivity and streamline processes.
- How to use AI to help users understand and utilise Terraform modules effectively and generate examples of usage based on the bespoke IaC data and documentation.
Explore each of Constoso's bespoke modules and detailed documentation on usage including examples and explanations:
- Module 1: Azure Resource Group
- Module 2: Azure API Management
- Module 3: Azure Application Gateway
- Module 4: Azure Key Vault
- Module 5: Azure Role Assignment
Check out Contoso's GitHub tutorials to learn more about best practices and guidelines for using GitHub at Contoso:
- GitHub CI/CD deployment guidelines for Terraform
- GitHub Security Best Practices
- GitHub Repository Best Practices
- GitHub Collaboration Guidelines
Check out Contoso's Terraform tutorials to learn more about best practices and guidelines for using Terraform at Contoso:
Explore additional resources and best practices guides for building and managing Azure resources:
AI Prompt and Context Examples to learn more about how to give context for better AI assistant responses for IaC used in this demo:
For any questions or feedback, please open an issue or contact us at Contoso punny.panda@example.com