Build custom Bicep extensions with Bicep Local Deploy

Course content

This course takes you from Bicep Local Deploy fundamentals to publishing custom extensions that are production-ready. The getting started module starts with an introduction to the Bicep Local Deploy framework and its architecture. It covers how custom extensions work within Bicep's ecosystem. You'll set up your development environment and verify your installation using a quick-start project.

Next, you'll be building your first complete extension, expanding on the quick-start project. From looking at the project structure to defining type models with attributes, and lastly, implementing handlers that manage the resource lifecycle.

The advanced module lessons dive deeper into testing and documentation. You'll be using the bicep-local-docgen CLI tool to validate your documentation.

Prerequisites

Before starting this course, you should have:

• C# programming: Be familiar with C# syntax, classes, and properties.
• PowerShell basics: Understand PowerShell commands and scripting for running build scripts and tests.
• REST APIs: Basic understanding of HTTP methods (GET, POST, PUT, DELETE) and JSON.
• Command-line tools: Be comfortable running CLI utilities.

Don't worry if you're missing some recommended knowledge. The course provides explanations along the way. The required knowledge is mainly for following the code examples and completing the exercises.

What you'll learn

• Understand Bicep Local Deploy architecture: Learn what custom extensions are, how they extend Bicep's capabilities, and the role of Azure.Bicep.Local.Extension framework and documentation attributes.
• Build complete custom extensions: Create type models with documentation attributes, implement resource handlers, and test with Bicep files and Pester.
• Generate and publish documentation: Use bicep-local-docgen CLI to generate markdown documentation and validation.

By the end of this course, you'll have a production-ready Bicep Local Deploy extension, including:

• Documentation
• End-to-end tests
• Publishing workflow

You'll understand the complete lifecycle from initial concept to a published extension that users can consume in their Bicep templates.