AZD Environment Setup

⛔ MANDATORY: You MUST set up an AZD environment before running any deployment commands.

Step 1: Check Existing Environments

azd env list

If an environment is already selected (marked with *), check its current values:

azd env get-values

If AZURE_ENV_NAME, AZURE_SUBSCRIPTION_ID, and AZURE_LOCATION are already set, confirm with user:

Question: "An AZD environment is already configured. Would you like to use it?"

  Environment: \{env-name\}
  Subscription: \{subscription-id\}
  Location: \{location\}

Choices: [
  "Yes, use this environment (Recommended)",
  "No, create a new environment"
]

If user confirms → skip to Verify Configuration. Otherwise → continue to Step 2.

If NO environment exists or none is selected:

• Continue to Step 2

---

Step 2: Create New Environment

⛔ DO NOT use generic names like "dev", "prod", or "test"

These cause naming conflicts in Azure resource groups and resources. Always generate a unique name.

Generate Suggested Name

Use this pattern:

\{project-name\}-\{random-4-chars\}

Examples:

• dadjokes-x7k2
• todoapp-m3p9
• myapi-q5w8

Prompt User

You MUST use ask_user to confirm the environment name:

I need to create an AZD environment for this deployment.

Suggested name: \{project-name\}-\{random-4-chars\}

Would you like to use this name or enter a custom one?

Create Environment

After user confirms: