azb

Opinionated Azure infrastructure tooling — deploy resources, generate pipelines, manage environments.

Install

pip install -e tools/azb     # editable (dev)
pipx install tools/azb       # global

Quick Start

# List what's available
azb list resources
azb list environments
azb list templates

# Predict a deployment (no Azure calls)
azb predict resource keyvault --domain platform

# Plan a deployment (Azure what-if)
azb plan template cdn --environment demo

# Deploy for real
azb deploy template cdn --environment demo --commit

# Post-deployment configuration
azb configure keyvault set-secret --secret-name API_KEY --secret-value s3cret --domain platform --commit

# Pipeline generation
azb pipelines discover
azb pipelines generate cdn --commit

Architecture

azb splits into tool (installed globally) and repo config (per-project).

Tool (bundled)

Resources (.azr), environments (.aze), templates (.azt), pipeline nodes (.azpn + .azpn.yml), and work templates — shipped with the package.

Repo ({git-root}/.cloud/azure/)

Project-specific azb.config, plus optional local overrides for any bundled artifact. Pipeline definitions (.azp) live with the source code they deploy.

Layered Resolution

Every artifact type merges bundled defaults with local overrides. Same id in the repo wins.

File Extensions

Extension	What
.azr	Resource manifest
.azr.bicep	Resource Bicep template
.azr.py	Resource behaviour hooks
.aze	Environment manifest
.aze.py	Environment behaviour hooks
.azt	Template (resource group)
.azp	Pipeline definition
.azpn	Pipeline node manifest
.azpn.yml	Pipeline node YAML template

---

azb — Contents

Commands

help · list · describe · predict · plan · deploy · configure

Pipeline Commands

pipelines help · pipelines list · pipelines describe · pipelines predict · pipelines plan · pipelines generate · pipelines discover

Bundled Resources (.azr)

appservice (app-service, app, as) · frontdoor (front-door, fd) · keyvault (kv) · resourcegroup (resource-group, rg) · staticwebapp (static-web-app, swa) · storageaccount (storage-account, storage, sa)

Bundled Environments (.aze)

dev · demo

Bundled Templates (.azt)

cdn · edge · test

Bundled Pipeline Nodes (.azpn)

build-workspace (workspace) · deploy-docker (docker) · deploy-net (net) · deploy-swa (swa) · deploy-swa-standalone (swa-standalone) · deploy-swa-workspace (swa-workspace) · deploy-vue (vue) · generate-semver (semver) · pipeline-run-complete · pipeline-run-platform-ready · pipeline-run-start · publish-net-blob (blob)

Bundled Work Templates (.yml)

build-net · build-vue · deploy-appservice-net · deploy-appservice-vue · deploy-azure-docker · package-server

Config Tokens (azb.config naming)

{prefix} · {workload} · {region} · {npmFeed} · {env} (runtime — resolved by Azure DevOps)