Skip to content

fix: Point to database reference files - #1550

Merged
Tom Meschter (tmeschter) merged 7 commits into
microsoft:mainfrom
tmeschter:20260327-Issue-1536
Apr 2, 2026
Merged

fix: Point to database reference files#1550
Tom Meschter (tmeschter) merged 7 commits into
microsoft:mainfrom
tmeschter:20260327-Issue-1536

Conversation

@tmeschter

@tmeschter Tom Meschter (tmeschter) commented Mar 27, 2026

Copy link
Copy Markdown
Member

Fixes #1536.
Fixes #1541.

In issue #1536 an integration test run has failed due to a timeout. Among other things, the agent needed eight tries to come up with a sufficiently complex password for the Azure SQL admin account... but it shouldn't have been specifying a password to begin with. Instead it should be using Entra-based authentication. The SQL database reference docs explain this, but the test never pulled them in. Here we add further links to these docs in a few key locations to help pull them in.

Similarly in #1541 some but not all of the files were read by the agent.

Fixes microsoft#1536.

In issue microsoft#1536 an integration test run has failed due to a timeout. Among other things, the agent needed eight tries to come up with a sufficiently complex password for the Azure SQL admin account... but it shouldn't have been specifying a password to begin with. Instead it should be using Entra-based authentication. The SQL database reference docs explain this, but the test never pulled them in. Here we add further links to these docs in a few key locations to help pull them in.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates azure-prepare reference documentation to more reliably pull in Azure SQL Database guidance (notably Entra-only auth) during App Service–based app planning, addressing the integration-test timeout root cause in #1536.

Changes:

  • Add cross-links from App Service guidance to common database backend reference docs (SQL Database, Cosmos DB).
  • Add an explicit “App Service + API + SQL Database” research pattern that points to the SQL Database reference set.
  • Add reference links in the architecture service-mapping table and bump azure-prepare skill version.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
plugin/skills/azure-prepare/references/services/app-service/README.md Adds a “Common Data Backends” section linking to SQL Database and Cosmos DB references.
plugin/skills/azure-prepare/references/research.md Adds a concrete research-loading sequence for App Service + API + SQL Database to encourage loading SQL auth docs.
plugin/skills/azure-prepare/references/architecture.md Adds “Reference” links for key data services to make deeper guidance discoverable during architecture planning.
plugin/skills/azure-prepare/SKILL.md Bumps skill version to reflect reference updates.

Comment thread plugin/skills/azure-prepare/references/research.md Outdated
kvenkatrajan
kvenkatrajan previously approved these changes Mar 30, 2026
Remove references to the azure-security and azure-security-hardening skills as they do not exist.
Copilot AI review requested due to automatic review settings March 30, 2026 16:38

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (2)

plugin/skills/azure-prepare/references/research.md:26

  • azure-networking is listed as a related skill for AKS, but there is no azure-networking skill in plugin/skills/. This should be updated to an existing AKS/networking skill (e.g., azure-kubernetes) so the guidance is actionable.
| AKS | [AKS](services/aks/README.md) | `azure-networking` |

plugin/skills/azure-prepare/references/research.md:43

  • The Key Vault row points to a non-existent azure-keyvault-expiration-audit skill (no such directory under plugin/skills/). If the intent is Key Vault expiration auditing, consider pointing to the existing azure-compliance skill (which includes Key Vault expiration checks) or remove the skill reference.
| Key Vault | [Key Vault](services/key-vault/README.md) | `azure-keyvault-expiration-audit` |

Comment thread plugin/skills/entra-app-registration/SKILL.md
Comment thread plugin/skills/azure-prepare/references/research.md
kvenkatrajan
kvenkatrajan previously approved these changes Mar 30, 2026
@tmeschter Tom Meschter (tmeschter) changed the title Point to database reference files fix: Point to database reference files Mar 31, 2026
kvenkatrajan
kvenkatrajan previously approved these changes Mar 31, 2026

@wbreza Wallace Breza (wbreza) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good — all 9 database/service reference links verified, non-existent skill references correctly removed, version bumps and snapshots properly updated. Token-efficient at ~1,136 tokens added.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

plugin/skills/azure-prepare/references/research.md:44

  • azure-keyvault-expiration-audit is listed as a related skill for Key Vault, but there is no skill by that name in plugin/skills/. If the intent is to route to the Key Vault expiration audit, point to the azure-compliance skill (it contains the Key Vault expiration assessment) or rename this entry to match an actual invokable skill.
| **Security & Identity** | | |
| Key Vault | [Key Vault](services/key-vault/README.md) | `azure-keyvault-expiration-audit` |
| Managed Identity | — | `entra-app-registration` |

Comment thread plugin/skills/azure-prepare/references/research.md
@tmeschter
Tom Meschter (tmeschter) merged commit 45a27e2 into microsoft:main Apr 2, 2026
16 checks passed
Tom Meschter (tmeschter) added a commit to tmeschter/GitHub-Copilot-for-Azure that referenced this pull request Apr 2, 2026
* Point to database reference files

Fixes microsoft#1536.
Fixes microsoft#1541.

In issue microsoft#1536 an integration test run has failed due to a timeout. Among other things, the agent needed eight tries to come up with a sufficiently complex password for the Azure SQL admin account... but it shouldn't have been specifying a password to begin with. Instead it should be using Entra-based authentication. The SQL database reference docs explain this, but the test never pulled them in. Here we add further links to these docs in a few key locations to help pull them in.

* Remove references to non-existent skills

Remove references to the azure-security and azure-security-hardening skills as they do not exist.

* Bump versions

* Update snapshots
Barbara 4bes (Ba4bes) pushed a commit to Ba4bes/GitHub-Copilot-for-Azure that referenced this pull request Apr 24, 2026
* Point to database reference files

Fixes microsoft#1536.
Fixes microsoft#1541.

In issue microsoft#1536 an integration test run has failed due to a timeout. Among other things, the agent needed eight tries to come up with a sufficiently complex password for the Azure SQL admin account... but it shouldn't have been specifying a password to begin with. Instead it should be using Entra-based authentication. The SQL database reference docs explain this, but the test never pulled them in. Here we add further links to these docs in a few key locations to help pull them in.

* Remove references to non-existent skills

Remove references to the azure-security and azure-security-hardening skills as they do not exist.

* Bump versions

* Update snapshots
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

4 participants