Course Content

Building custom Bicep Local Deploy extensions From fundamentals to publishing your first custom-ready extension 4 Lessons

Introduction to Bicep Local Deploy extensions 20 min
Creating your first Bicep Local Deploy extension 45 min
Testing your Bicep Local Deploy extension 60 min
Documentation and publishing Bicep Local Deploy extension 35 min

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.

Getting started Learn the fundamentals and set up your development environment 4 Lessons

Introduction to Microsoft Desired State Configuration (DSC) 5 min
Installing Microsoft Desired State Configuration (DSC) 10 min
Your first resource invocation 10 min
Practicing and exploring 20 min

Course content

This course takes you from the Microsoft DSC fundamentals to practical implementation. The getting started module introduces Microsoft's Desired State Configuration (DSC) cross-platform command-line tool for declarative configuration management. You'll learn the core concepts that differentiate DSC from traditional configuration management approaches, install Microsoft DSC on your system, and get hands-on experience by invoking your first DSC resource. At the end, there's room for practical exercises and a knowledge check.

What you'll learn

Understand Microsoft's DSC architecture: Learn what Desired State Configuration is, how it's different from imperative tools, and why idempotency matters.
Install and configure Microsoft DSC: Set up Microsoft DSC on Windows, Linux, or macOS, including PATH configuration and installation.
Work with DSC resources: Discover how to explore resource schemas, understand property requirements, and invoke the core resource operations (get, set, test, and delete).
Configure your registry: Gain practical experience with the Microsoft.Windows/Registry DSC resource.

-/-

Testing your Bicep Local Deploy extension