AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

azure-prepare

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.

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--azure-prepare at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 164

references/scan.md

Codebase Scan

Analyze workspace to identify components, technologies, and dependencies.

Detection Patterns

Languages & Frameworks

| File | Indicates | |------|-----------| | package.json | Node.js | | requirements.txt, pyproject.toml | Python | | *.csproj, *.sln | .NET | | pom.xml, build.gradle | Java | | go.mod | Go |

Component Types

| Pattern | Component Type | |---------|----------------| | React/Vue/Angular in package.json | SPA Frontend | | Only .html/.css/.js files, no package.json | Pure Static Site | | Express/Fastify/Koa | API Service | | Flask/FastAPI/Django | API Service | | Next.js/Nuxt | SSR Web App | | Celery/Bull/Agenda | Background Worker | | azure-functions SDK | Azure Function | | .AppHost.csproj or Aspire.Hosting package | .NET Aspire App |

Pure Static Site Detection:

  • No package.json, requirements.txt, or build configuration
  • Contains only HTML, CSS, JavaScript, and asset files
  • No framework dependencies (React, Vue, Angular, etc.)
  • ⚠️ For pure static sites, do NOT add language field to azure.yaml to avoid triggering build steps

Existing Tooling

| Found | Tooling | |-------|---------| | azure.yaml | AZD configured | | infra/*.bicep | Bicep IaC | | infra/*.tf | Terraform IaC | | Dockerfile | Containerized | | .github/workflows/ | GitHub Actions CI/CD | | azure-pipelines.yml | Azure DevOps CI/CD |

.NET Aspire Detection

.NET Aspire projects are identified by:

  • A project ending with .AppHost.csproj (e.g., OrleansVoting.AppHost.csproj)
  • Reference to Aspire.Hosting or Aspire.Hosting.AppHost package in .csproj files
  • Multiple .NET projects in a solution, typically including an AppHost orchestrator

When Aspire is detected:

  • Use azd init --from-code -e <environment-name> instead of manual azure.yaml creation
  • The --from-code flag automatically detects the AppHost and generates appropriate configuration
  • The -e flag is required for non-interactive environments (agents, CI/CD)
  • ⚠️ CRITICAL: If the AppHost contains AddAzureFunctionsProject, you MUST add .WithEnvironment("AzureWebJobsSecretStorageType", "Files") to the Functions builder chain BEFORE deployment. Without this, Functions will fail at startup with Secret initialization from Blob storage failed. See aspire.md Step 4b for the complete detection and fix procedure.
  • See aspire.md for detailed Aspire-specific guidance

Output

Document findings:

## Components

| Component | Type | Technology | Path |
|-----------|------|------------|------|
| api | API Service | Node.js/Express | src/api |
| web | SPA | React | src/web |
| worker | Background | Python | src/worker |

## Dependencies

| Component | Depends On | Type |
|-----------|-----------|------|
| api | PostgreSQL | Database |
| web | api | HTTP |
| worker | Service Bus | Queue |

## Existing Infrastructure

| Item | Status |
|------|--------|
| azure.yaml | Not found |
| infra/ | Not found |
| Dockerfiles | Found: src/api/Dockerfile |