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/services/app-service/templates/recipes/cosmos/README.md

Cosmos DB Recipe — REFERENCE ONLY

Adds Azure Cosmos DB (NoSQL) integration to an App Service base template.

Overview

This recipe composes with a Web API or Web App base template to add Cosmos DB data access. It provides the IaC delta (Cosmos account, database, container, RBAC) and per-language source code using the Cosmos DB SDK.

Integration Type

| Aspect | Value | |--------|-------| | Database | Azure Cosmos DB for NoSQL | | Auth | Managed identity (DefaultAzureCredential) | | SDK | Microsoft.Azure.Cosmos (.NET), @azure/cosmos (Node.js), azure-cosmos (Python) | | Hosting | App Service (from base template) | | Local Auth | Disabled (disableLocalAuth: true) — RBAC-only |

Composition Steps

Apply these steps AFTER azd init -t <base-template>:

| # | Step | Details | |---|------|---------| | 1 | Add IaC module | Add Cosmos DB Bicep module to infra/app/ | | 2 | Wire into main | Add module reference in main.bicep | | 3 | Add app settings | Add Cosmos endpoint + database + container settings | | 4 | Add source code | Add Cosmos client setup from source/{lang}.md | | 5 | Add packages | Add Cosmos SDK + Azure Identity packages |

App Settings

| Setting | Value | Purpose | |---------|-------|---------| | COSMOS_ENDPOINT | https://{account}.documents.azure.com:443/ | Cosmos account endpoint | | COSMOS_DATABASE_NAME | app-db | Target database | | COSMOS_CONTAINER_NAME | items | Target container |

Bicep App Settings Block

appSettings: [
  { name: 'COSMOS_ENDPOINT', value: cosmos.outputs.endpoint }
  { name: 'COSMOS_DATABASE_NAME', value: cosmos.outputs.databaseName }
  { name: 'COSMOS_CONTAINER_NAME', value: cosmos.outputs.containerName }
]

Note: No connection string or key is needed. The SDK uses DefaultAzureCredential which automatically resolves to the app's managed identity in Azure.

RBAC Roles Required

| Role | GUID | Scope | Purpose | |------|------|-------|---------| | Cosmos DB Account Reader | fbdf93bf-df7d-467e-a4d2-9458aa1360c8 | Cosmos account | Read account metadata | | Cosmos DB Built-in Data Contributor | 00000000-0000-0000-0000-000000000002 | Cosmos account (SQL role) | Read/write data |

Important: Cosmos DB uses its own SQL RBAC system (sqlRoleAssignments) for data plane operations, not standard Azure RBAC.

Networking (when VNET_ENABLED=true)

| Component | Details | |-----------|---------| | Private endpoint | Cosmos account → App Service VNet subnet | | Private DNS zone | privatelink.documents.azure.com |

Resources Created

| Resource | Type | Purpose | |----------|------|---------| | Cosmos DB Account | Microsoft.DocumentDB/databaseAccounts | Serverless NoSQL database | | SQL Database | databaseAccounts/sqlDatabases | Application database | | Container | sqlDatabases/containers | Data container with partition key | | Role Assignment | Microsoft.Authorization/roleAssignments | Control plane access | | SQL Role Assignment | databaseAccounts/sqlRoleAssignments | Data plane access |

Source Code Examples

| Language | Source File | |----------|-------------| | C# (.NET) | source/dotnet.md | | Python | source/python.md | | Node.js | source/nodejs.md |

References