Instruction file imported from pavanthakur/XYDataLabs.OrderProcessingSystem (.github/instructions/bicep.instructions.md). Copyright stays with the author.

Bicep / IaC Conventions — XYDataLabs.OrderProcessingSystem

Name: bicep
Author: pavanthakur

Two IaC Folders

Folder	Scope	Deploy command
`infra/`	Subscription (`targetScope = 'subscription'`)	`az deployment sub create`
`bicep/`	Resource Group	`az deployment group create`

CRITICAL: infra/main.bicep uses subscription scope

Always use az deployment sub create for the infra/ folder — NOT az deployment group create.

# Correct — subscription scope
az deployment sub create \
  --location centralindia \
  --template-file infra/main.bicep \
  --parameters infra/parameters/dev.json

# Wrong — do not use for infra/
# az deployment group create ...

infra/ Module Structure

infra/
  main.bicep          ← orchestrates all modules
  modules/
    hosting.bicep     ← App Service Plan + Web Apps
    sql.bicep         ← SQL Server + database
    keyvault.bicep    ← Key Vault + managed identity
    insights.bicep    ← Application Insights
    identity.bicep    ← User-assigned managed identity

Parameter Files

infra/parameters/dev.json — environment: dev, appServiceSku: F1, databaseServiceObjective: Basic, location: centralindia
infra/parameters/staging.json — suffix stg (not staging)
infra/parameters/prod.json

Resource Naming Convention

Resource Group: rg-orderprocessing-{env}
App Service Plan: asp-orderprocessing-{env}
API Web App: pavanthakur-orderprocessing-api-xyapp-{env}
UI Web App: pavanthakur-orderprocessing-ui-xyapp-{env}
SQL Server: orderprocessing-sql-{env}
Key Vault: kv-orderprocessing-{env}
App Insights: ai-orderprocessing-{env}

Note: staging uses stg suffix in Azure resource names but staging as the workflow environment name.

What-If (Dry Run)

az deployment sub what-if \
  --location centralindia \
  --template-file infra/main.bicep \
  --parameters infra/parameters/dev.json

{ "ocm": "1", "id": "pavanthakur-xydatalabs-orderprocessingsystem-bicep-instructions", "kind": "skill", "name": "bicep", "description": "Note: staging uses `stg` suffix in Azure resource names but `staging` as the workflow environment name.", "publisher": "pavanthakur", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Note: staging uses `stg` suffix in Azure resource names but `staging` as the workflow environment name." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/pavanthakur/XYDataLabs.OrderProcessingSystem", "path": ".github/instructions/bicep.instructions.md", "ref": "ffec5d1e2382a0dbc96be4fad0d01af52dfc706d", "url": "https://github.com/pavanthakur/XYDataLabs.OrderProcessingSystem/blob/ffec5d1e2382a0dbc96be4fad0d01af52dfc706d/.github/instructions/bicep.instructions.md", "key": "pavanthakur/XYDataLabs.OrderProcessingSystem/.github/instructions/bicep.instructions.md" }, "applies_to": "**/infra/**,**/bicep/**,**/*.bicep" }, "instructions": "# Bicep / IaC Conventions — XYDataLabs.OrderProcessingSystem\n\n## Two IaC Folders\n| Folder | Scope | Deploy command |\n|--------|-------|----------------|\n| `infra/` | Subscription (`targetScope = 'subscription'`) | `az deployment sub create` |\n| `bicep/` | Resource Group | `az deployment group create` |\n\n## CRITICAL: infra/main.bicep uses subscription scope\nAlways use `az deployment sub create` for the `infra/` folder — NOT `az deployment group create`.\n\n```powershell\n# Correct — subscription scope\naz deployment sub create \\\n --location centralindia \\\n --template-file infra/main.bicep \\\n --p", "cost": { "context_tokens": 489 } }

bicep

About

Bicep / IaC Conventions — XYDataLabs.OrderProcessingSystem

Two IaC Folders

CRITICAL: infra/main.bicep uses subscription scope

infra/ Module Structure

Parameter Files

Resource Naming Convention

What-If (Dry Run)

Use it

Manifest

Reviews