Skip to content

Azure Documentation -New Articles#562

Draft
paolosalvatori wants to merge 12 commits intomainfrom
docs/azure-new-service-articles
Draft

Azure Documentation -New Articles#562
paolosalvatori wants to merge 12 commits intomainfrom
docs/azure-new-service-articles

Conversation

@paolosalvatori
Copy link
Copy Markdown
Contributor

@paolosalvatori paolosalvatori commented Apr 15, 2026

docs(azure): Add 25 new service articles with real command output

This PR adds 25 new documentation articles for LocalStack for Azure services. Each article covers a distinct Azure resource type and follows the standard article structure. All az CLI command blocks include a real output block captured from a running LocalStack emulator, with ... used to indicate properties omitted for brevity.

Articles

Service Name Resource Type Description
Action Group Microsoft.Insights/actionGroups Create and manage action groups used as notification targets in Azure Monitor alerts
API Management Microsoft.ApiManagement/service Lifecycle management for API Management service instances (create, show, list, delete)
Application Insights microsoft.insights/components Create and inspect Application Insights components for application telemetry and diagnostics
Autoscale Setting Microsoft.Insights/autoscalesettings Configure autoscale rules for App Service plans and other scalable Azure resources
Bastion Host Microsoft.Network/bastionHosts Provision Azure Bastion hosts for secure browser-based VM access over SSL
Container Registry Microsoft.ContainerRegistry/registries Create registries, push and pull container images using Docker CLI against LocalStack
Cosmos DB Microsoft.DocumentDB/databaseAccounts Create Cosmos DB accounts, SQL databases and containers, and MongoDB databases and collections
Data Collection Rules Microsoft.Insights/dataCollectionRules Create data collection endpoints, rules, and associations for Azure Monitor telemetry pipelines
Diagnostic Setting microsoft.insights/diagnosticSettings Attach diagnostic settings to Azure resources to route logs and metrics to storage or Log Analytics
Function Apps Microsoft.Web/sites Deploy and invoke Azure Functions (Python, .NET, Node.js) backed by a local Docker container
Log Analytics Microsoft.OperationalInsights/workspaces Create Log Analytics workspaces and query activity logs via saved searches
Metric Alert microsoft.insights/metricalerts Create metric-based alert rules targeting Azure resource scopes
Monitor microsoft.insights/diagnosticSettings Overview article covering the Azure Monitor emulation surface: diagnostics, activity logs, and storage export
NAT Gateway Microsoft.Network/natGateways Provision NAT gateways and associate public IP prefixes for outbound-only network flows
Network Interface Microsoft.Network/networkInterfaces Create NICs, attach them to subnets, and manage IP configurations
Private DNS Zone Microsoft.Network/privateDnsZones Create private DNS zones, add DNS records, and link zones to virtual networks
Private Endpoint Microsoft.Network/privateEndpoints Create private endpoints that expose Azure services on a private subnet
Public IP Address Microsoft.Network/publicIPAddresses Allocate and configure static and dynamic public IP addresses
Public IP Prefix Microsoft.Network/publicIPPrefixes Reserve a contiguous block of public IP addresses as a prefix
Role Assignment Microsoft.Authorization/roleAssignments Assign built-in and custom RBAC roles to managed identities at subscription or resource group scope
Role Definition Microsoft.Authorization/roleDefinitions Create and manage custom RBAC role definitions with fine-grained action permissions
Route Table Microsoft.Network/routeTables Create route tables, add custom routes, and associate them with subnets
Scheduled Query Rules microsoft.insights/scheduledqueryrules Create log-based alert rules that run KQL queries against Log Analytics workspaces
Web Test microsoft.insights/webtests Create availability web tests that probe HTTP endpoints on a schedule
Workbook microsoft.insights/workbooks Create Azure Monitor workbooks via REST API for custom dashboards and reports

This pull requests also removes the following articles which services are already covered in other articles or postponed (Azure Kubernetes Service and Azure Container Apps):

Name
app.md
authorization.md
azure-container-registry.md
cdn.md
container-service.md
network.md
operational-insights.md
tables.md
web.md

Article structure

Every article contains the following sections:

  • Introduction — What the service is, what it is used for, and a link to the official Microsoft documentation
  • Getting started — Step-by-step az CLI commands (including azlocal start-interception / azlocal stop-interception preamble) with one real output block per command
  • Features — A bullet list of the operations and capabilities emulated by LocalStack for Azure
  • Limitations — What is not emulated (e.g. network packet routing, live telemetry ingestion, Docker requirement for function execution)
  • Samples — Links to working code samples in the LocalStack samples repository
  • API Coverage — Embedded <AzureFeatureCoverage> component showing the full ARM operation coverage table

Output block conventions

  • Every az command is followed by exactly one ```bash title="Output" block
  • Output was captured live from a running LocalStack for Azure emulator
  • When a response was shortened for readability, ... appears on its own line before the closing } to signal omitted properties

Add documentation for:
- NAT Gateway
- Network Interface
- Public IP Address
- Public IP Prefix
- Bastion Host
- Route Table
- Private Endpoint
- Private DNS Zone

All articles follow the standard template with Introduction, Getting
Started, Features, Limitations (mock), Samples, and API Coverage sections.
Update to include Docker login/push/pull workflow, correct ARM type,
and Docker-backed data plane details.
- API Management: rewrite with az apim create/delete workflow
- Role Definition: new article with az role definition create/list
- Role Assignment: new article with az role assignment create
- Cosmos DB: new article with SQL API and MongoDB API workflows
Monitor (Microsoft.Insights):
- Application Insights
- Action Group
- Metric Alert
- Diagnostic Setting
- Autoscale Setting
- Data Collection Rules
- Scheduled Query Rules
- Web Test
- Workbook

Log Analytics (Microsoft.OperationalInsights):
- Log Analytics Workspace
Add MS Learn overview page links to the Introduction section of all
non-network articles. Each link appears after the Azure service
description and before the LocalStack support statement.
- Expand descriptions in all 24 articles to 3 sentences with For more
  information link on the same line as the last description sentence
- Replace non-canonical LocalStack footer with canonical wording:
  'LocalStack for Azure provides a local environment for building and
  testing applications that make use of <Service Name>.'
- Add stop-interception block after start-interception in all 24
  articles, with explanatory text for both commands
- Add full Launch LocalStack preamble to non-network articles that
  were missing it (16 articles)
- Remove em-dashes from route-table footer (handled by footer replace)
Add ellipsis before closing } in output blocks where Azure API response
was shrunk for brevity. Fixes 65 output blocks across 25 service articles.
Also cleans up structural issues in cosmos-db.mdx and autoscale-setting.mdx
(duplicate sections, malformed fencing).
@paolosalvatori paolosalvatori changed the title Azure Documentation - Introduce Azure Documentation - Introduce new Articles Apr 15, 2026
Every code block in the 25 new service articles now has a prose sentence
immediately before it describing what the command does. Previously, many
blocks were preceded only by a section heading.
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Apr 15, 2026

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 3d544ff
Status: ✅  Deploy successful!
Preview URL: https://55ec0776.localstack-docs.pages.dev
Branch Preview URL: https://docs-azure-new-service-artic.localstack-docs.pages.dev

View logs

Follow-up to the previous commit: adds explanatory sentences before
code blocks that appeared consecutively within a section (e.g. show
followed immediately by list, or delete followed by list to confirm).
All 39 remaining bare code blocks across 19 articles now have prose.
@paolosalvatori paolosalvatori changed the title Azure Documentation - Introduce new Articles Azure Documentation -New Articles Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant