All skills
microsoft avatar

/azure-prepare

@b8a1c66
by microsoftmicrosoft/skills3.1k stars
351

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-prepare

This session only. Nothing lands on disk.

referencesfunctional-verification.md

≈826 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Functional Verification

Verify that the application works correctly — both UI and backend — before proceeding to validation and deployment. This step prevents deploying broken or incomplete functionality to Azure.

When to Verify

After generating all artifacts (code, infrastructure, configuration) and applying security hardening — but before marking the plan as Ready for Validation.

Verification Checklist

Use ask_user to confirm functional testing with the user:

"Before we proceed to deploy, would you like to verify the app works as expected?
We can test both the UI and backend to catch issues before they reach Azure."

Backend Verification

Check How
App starts without errors Run the app and confirm no startup crashes or missing dependencies
API endpoints respond Test core routes (e.g., curl health, list, create endpoints)
Data operations work Verify CRUD operations against storage, database, or other services
Authentication flows Confirm auth works (tokens, managed identity fallback, login/logout)
Error handling Verify error responses are meaningful (not unhandled exceptions)

UI Verification

Check How
Page loads Open the app in a browser and confirm the UI renders
Interactive elements work Test buttons, forms, file inputs, navigation links
Data displays correctly Verify lists, images, and dynamic content render from the backend
User workflows complete Walk through the core user journey end-to-end (e.g., upload → view → delete)

Decision Tree

App artifacts generated?
├── Yes → Ask user: "Would you like to verify functionality?"
│   ├── User says yes
│   │   ├── App can run locally? → Run locally, verify backend + UI
│   │   ├── API-only / no UI? → Test endpoints with curl or similar
│   │   └── Static site? → Open in browser, verify rendering
│   │   Then:
│   │   ├── Works → Proceed to Update Plan (step 6)
│   │   └── Issues found → Fix issues, re-test
│   └── User says no / skip → Proceed to Update Plan (step 6)
└── No → Go back to Generate Artifacts (step 3)

Running Locally

For apps that can run locally, help the user start the app based on the detected runtime:

Runtime Command Notes
Node.js npm install && npm start Set PORT=3000 if not configured
Python pip install -r requirements.txt && python app.py Use virtual environment
.NET dotnet run Check launchSettings.json for port
Java mvn spring-boot:run or gradle bootRun Check application.properties

⚠️ Warning: For apps using Azure services (e.g., Blob Storage, Cosmos DB), local testing requires the user to be authenticated via az login with sufficient RBAC roles, or to have local emulators configured (e.g., Azurite for Storage).

Record in Plan

After functional verification, add a note to .azure/deployment-plan.md:

## Functional Verification
- Status: Verified / Skipped
- Backend: Tested / Not applicable
- UI: Tested / Not applicable
- Notes: <any issues found and resolved>

Source: SKILL.md on GitHub

2 warnings3d4 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    This skill includes security considerations related to the processing of untrusted project files and the retrieval of external development templates. While these operations are essential for modernizing and preparing Azure applications, they represent a surface area for indirect prompt injection and depend on the integrity of external template repositories.

  • Socket3d

    5 alerts: gptAnomaly, gptSecurity

  • Snyk3d

    Risk: LOW · No issues

  • Runlayer7mo

    86/87 files flagged

Signed by skilld at b8a1c66. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week
metadata
{
  "author": "Microsoft",
  "version": "1.3.4"
}

README badge

README badge for microsoft/skills/azure-prepare