Bicep CI/CD Handbook

This initiative is still in development!

This handbook is currently a work in process, and is not yet part of the official Azure documentation. See Contributing for information on how to contribute to this effort!

This site aims to provide a best-practices approach for anyone looking to configure a GitHub repository to deploy infrastructure-as-code on Azure. With any CI/CD pipeline, there are a lot of moving parts to understand. These moving parts are often well documented in isolation, however it can be a challenged to understand how to fit them together; we aim to help with that.

Goals include:

• Instructions on how to configure CI & CD with testing & validation to reduce risk when making infrastructure changes.
• Document the processes to follow when making infrastructure changes.
• Provide quickstart repositories which can be used to quickly set up a working solution.

Best practices are constantly evolving! We welcome and encourage both pull requests or issues via the GitHub repository to improve (or suggest improvements to) this documentation.

This handbook uses the following tooling choices because they provide a good balance of productivity and ease of adoption:

• GitHub Actions Workflows for CI/CD
• Azure CLI for interacting with Azure
• Bash on Linux for scripting
• OpenID Connect for authenticating with Azure

Although we focus on these tools, we are happy to take contributions with alternatives.