mcpField
A
azure-env-builder

azure-env-builder

github.com/aktsmmCloud & DevOps2661 installsUpdated 1d ago
Repository

About azure-env-builder

Azure Environment Builder is a skill for planning and scaffolding enterprise Azure environments with Bicep. It gathers requirements, uses Azure Verified Modules and service schemas, and covers deployment pipelines and low-cost operations demos.

Key features

  1. 01Select from architecture patterns
  2. 02Use Azure Verified Modules
  3. 03Generate Bicep environment scaffolds
  4. 04Link service configuration and Managed ID RBAC
  5. 05Create CI/CD pipeline templates
  6. 06Plan low-cost operations demos

Use cases

  1. 01Design a Hub-Spoke or web-and-database environment
  2. 02Deploy apps to App Service, AKS, or Container Apps
  3. 03Create an Azure AI Foundry workload environment
  4. 04Build a low-cost operations demo with alerts and logs

MCP support

The workflow requires MCP tools to retrieve current Azure Verified Module metadata, Bicep best practices, and resource schemas before generating Bicep. It also uses Microsoft Docs search for relevant documentation.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aktsmm/agent-skills --skill azure-env-builder

After installing, type/azure-env-builderin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE.txt
references/
app-deploy-patterns.md
architecture-patterns.md
avm-modules.md
environment-template.md
hearing-checklist.md
low-cost-ops-demo.md
resource-patterns.md
review-checklist.md
service-config-templates.md
vm-app-scripts.md
references/cicd-templates/
azure-pipelines.yml
github-actions.yml
README.md
scripts/
preview_cli.ps1
scaffold_environment.ps1
validate_bicep.ps1

Details

From the project README

Azure Environment Builder

Enterprise Azure environment builder skill.

When to Use

  • Azure, Bicep, infrastructure, deploy app
  • Building enterprise Azure environments
  • Deploying apps to App Service, AKS, or Container Apps
  • Designing Hub-Spoke, AKS, or AI Foundry architectures
  • Creating low-cost Azure operations demos with alerts, logs, portal steps, and minimal always-on resources

When NOT to Use

  • 使い捨ての検証 lab を作って機能・制約・route 挙動を試し、cleanup まで回したいとき(対象外)
  • 本番障害を read-only で切り分けたいとき(対象外)

Features

CategoryCapabilities
ArchitectureHub-Spoke, Web+DB, AKS, AI Foundry
AVM Modules200+ Azure Verified Modules
VM InitSquid, Nginx, Docker, IIS setup
Config LinkingSQL/Storage/Redis, Managed ID RBAC
CI/CDGitHub Actions / Azure Pipelines
Ops DemoLow-cost app, alert, log, and control-plane failure patterns

Workflow

  1. Interview - Gather requirements + select architecture pattern
  2. MCP Tools - Fetch latest AVM/schema info
  3. Scaffold - Generate environment folder via scripts/scaffold_environment.ps1
  4. Implement - Write Bicep with AVM modules + VM init
  5. CI/CD - Generate pipeline templates
  6. Deploy - what-if → execute

Required: MCP Tools

Run before generating Bicep code:

mcp_bicep_experim_get_bicep_best_practices
mcp_bicep_experim_list_avm_metadata
mcp_bicep_experim_get_az_resource_type_schema(azResourceType, apiVersion)
microsoft_docs_search(query: "Private Endpoint Bicep")

Interview Checklist

→ references/hearing-checklist.md

ItemDetails
SubscriptionID or az account show
Environmentdev / staging / prod
Regionjapaneast / japanwest
Deploy TypeAzure CLI / Bicep

Architecture Patterns

→ references/architecture-patterns.md

PatternUse Case
Hub-SpokeLarge enterprise
Web + DBStandard web applications
AKSContainer microservices
AI FoundryAI/ML workloads
Proxy VMPrivate network egress control

Commands

# Scaffold environment folder
pwsh scripts/scaffold_environment.ps1 -Environment <env> -Location <region> -DeploymentMode <CLI|Bicep|Both>

# Validate
az deployment group what-if --resource-group <rg> --template-file main.bicep

# Deploy
az deployment group create --resource-group <rg> --template-file main.bicep

Key References

FilePurpose
architecture-patterns.mdArchitecture patterns
avm-modules.mdAVM module catalog
vm-app-scripts.mdVM init scripts
app-deploy-patterns.mdApp deploy patterns
low-cost-ops-demo.mdLow-cost operations demos
service-config-templates.mdService config linking
cicd-templates/CI/CD templates

Done Criteria

  • Interview checklist completed
  • MCP tools fetched latest info
  • Bicep files generated
  • az deployment group what-if succeeded

Comments

Markdown supported