Publish azure.yaml schema on schemastore.org#7330
Merged
rajeshkamal5050 merged 2 commits intomainfrom Mar 26, 2026
Merged
Conversation
Agent-Logs-Url: https://github.com/Azure/azure-dev/sessions/8e8040c8-ba59-4946-a485-9118f588c536 Co-authored-by: spboyer <7681382+spboyer@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Publish azure.yaml schema on schemastore.org
Publish azure.yaml schema on schemastore.org
Mar 25, 2026
spboyer
requested review from
rajeshkamal5050,
tg-msft,
vhvb1989 and
wbreza
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
Publishes metadata needed for SchemaStore-based tooling to automatically associate the azure.yaml/azure.yml JSON schema with Azure Developer CLI project configuration files.
Changes:
- Added top-level
titleanddescriptionfields to thev1.0andalphaazure.yamlJSON schemas. - Added a new
schemas/schemastore-catalog-entry.jsonfile containing a ready-to-submit SchemaStore catalog entry (withfileMatchand versioned URLs).
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| schemas/v1.0/azure.yaml.json | Adds SchemaStore-friendly top-level schema metadata (title/description). |
| schemas/alpha/azure.yaml.json | Adds SchemaStore-friendly top-level schema metadata (title/description). |
| schemas/schemastore-catalog-entry.json | Provides the SchemaStore catalog.json entry to enable auto-detection for azure.yaml/azure.yml. |
rajeshkamal5050
approved these changes
Mar 26, 2026
Contributor
|
/check-enforcer override |
github-actions bot
added a commit
to weikanglim/azure-dev
that referenced
this pull request
Mar 26, 2026
Add release history entries for versions 1.23.11, 1.23.12, and 1.23.13 that were merged in the last 24 hours to the Azure/azure-dev upstream. Key v1.23.13 features documented: - remoteBuild suggestion when Docker is missing (Azure#7247) - azd auth status --output json agent-friendly mode (Azure#7236) - Preflight warning abort fix (Azure#7329) - Extension IPv4/IPv6 fix + timeout increase (Azure#7346) - Container Apps and ARM error suggestions (Azure#7250) - azure.yaml SchemaStore catalog entry (Azure#7330) Also add an 'Agent Auth Validation' section to external-authentication.md documenting the new azd auth status --output json behavior for AI agents. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Tools that use the SchemaStore catalog (JetBrains IDEs, Neovim via SchemaStore.nvim, etc.) don't auto-associate schemas with
azure.yaml/azure.ymlfiles. Publishing to schemastore.org provides this file-matching for free across the ecosystem.Changes
schemas/v1.0/azure.yaml.json&schemas/alpha/azure.yaml.json— Added top-leveltitleanddescriptionfields required by SchemaStore conventionsschemas/schemastore-catalog-entry.json(new) — Ready-to-submit catalog entry for the SchemaStore/schemastore repository; includesfileMatchforazure.yaml/azure.ymland bothv1.0andalphaversion URLsNext step
Submit a PR to
SchemaStore/schemastoreadding the contents ofschemas/schemastore-catalog-entry.jsonintosrc/api/json/catalog.json(alphabetically). The catalog entry looks like:{ "name": "azure.yaml", "description": "Azure Developer CLI (azd) configuration file", "fileMatch": ["azure.yaml", "azure.yml"], "url": "https://raw.githubusercontent.com/Azure/azure-dev/main/schemas/v1.0/azure.yaml.json", "versions": { "1.0": "https://raw.githubusercontent.com/Azure/azure-dev/main/schemas/v1.0/azure.yaml.json", "alpha": "https://raw.githubusercontent.com/Azure/azure-dev/main/schemas/alpha/azure.yaml.json" } }⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.