Index of every page on this site: llms.txt
All skills
microsoft avatar

/azure-upgrade

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
Run it yourself

Assess and upgrade Azure workloads between plans, tiers, or SKUs, or modernize Azure SDK dependencies in source code. WHEN: upgrade Consumption to Flex Consumption, upgrade Azure Functions plan, change hosting plan, function app SKU, migrate App Service to Container Apps, modernize legacy Azure Java SDKs (com.microsoft.azure to com.azure), migrate Azure Cache for Redis (ACR/ACRE) to Azure Managed Redis (AMR).

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-upgrade

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesservicesfunctionsconsumption-to-flexwindowsprogress-tracking.md

≈1.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Migration Progress

Maintain <UPGRADE_DIR>/upgrade-status.md and show the current status in chat at every transition. The workflow documents are the source of truth; do not maintain a second hard-coded step inventory here.

Build the Checklist

  1. Read the ordered ### Phase headings in workflow.md to determine the phase names and total.
  2. Read the ordered workflow-unit table in automation.md. For each phase, load the linked automation files that own its work and add their executable headings in document order. Include conditional and optional headings; mark them skipped only after evaluating their conditions.
  3. Use a numbered step label such as 4g as its stable ID. For unnumbered work, use the exact heading text.
  4. On resume, rebuild the workflow snapshot from the current headings and reconcile it with saved state:
    • preserve matching completed, skipped, deferred, blocked, and pending entries;
    • add new headings as pending in document order;
    • record renamed or removed saved entries under Notes instead of silently discarding them.

Resume After External Provisioning

When Step 4b is blocked on keyless provisioning and the user returns with a target resource ID, load Adopt a User-Provisioned Target before any target writes. Keep the block until read-only verification and user approval succeed. Do not reapply target-name defaults or rerun creation/conversion commands.

Record the adopted target resource ID in Current Status and its verified storage, identity, and monitoring resource IDs in Notes. Mark Step 4b complete only as externally provisioned and verified; reconcile applicable skipped steps as directed by the adoption procedure. Set Next action to the first unfinished step at or after 4c, not app creation. Preserve all outstanding approval gates.

Reporting Rules

  1. Before each action, update Current Status and display: Phase <current> of <total> · <step> · <description> · <state>.
  2. After success, mark the item complete and immediately display the next item.
  3. At an approval gate, use state awaiting approval and invoke ask_user in the same turn.
  4. Mark work skipped — <reason> when it is not applicable or the user intentionally omits it and no later action is expected in this migration.
  5. Mark work deferred — <reason> when it remains outstanding but the user chooses to continue, such as access-restricted HTTP validation or production trigger cutover. Preserve it in the workflow snapshot and summarize it in Next action or Notes; never represent it as complete.
  6. Mark work blocked when an intended action cannot proceed because of an error or unresolved dependency. Record the error without secrets and do not advance unless the user explicitly chooses to defer or skip the work.
  7. The workflow may advance past skipped or deferred items. A phase may close with those states, but its summary must identify deferred work.
  8. Do not report a percentage; validation and cutover duration varies by function count.

Migration Outcomes

Track an outcome separately from the current step state:

Outcome Meaning
in progress The workflow is still executing or awaiting decisions
validation-only success The target was created, configured, deployed, and verified at the agreed scope, but applicable production traffic or trigger cutover remains skipped or deferred
production cutover complete All applicable production traffic and triggers use the target, target processing is validated, no production-readiness work remains deferred, and the source no longer processes production workloads
rolled back The target migration was abandoned or reversed and the source remains the production app

Never infer production cutover complete from successful resource creation, deployment, ARM health, or partial validation alone. A user may explicitly conclude a test migration as validation-only success.

State meanings:

State Meaning
pending Not started
in progress Currently executing
awaiting approval Waiting at an explicit user decision gate
blocked Intended work cannot proceed
skipped Not applicable or intentionally omitted; no later action expected
deferred Postponed and still outstanding
complete Finished and verified

Status Template

# Windows Consumption to Flex Migration Status

## Current Status

| Property | Value |
|----------|-------|
| Source app | <SOURCE_APP_NAME> |
| Target app | <NEW_APP_NAME or pending> |
| Target resource ID | <verified target resource ID or pending> |
| Outcome | in progress / validation-only success / production cutover complete / rolled back |
| Current phase | <current> of <total derived from scenario headings> |
| Current step | <step> |
| State | pending / in progress / awaiting approval / blocked / skipped / deferred / complete |
| Next action | <description> |
| Last updated | <UTC timestamp> |

## Workflow Snapshot

<Populate from the current scenario and automation headings. Nest each phase's executable steps beneath it.>

## Notes

<Decisions, skipped steps, failures, workflow reconciliation, and resumability details. Never record secrets.>

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts25d3 checks · Risk SAFE
  • Gen Agent Trust Hub25d

    This skill facilitates the assessment and automated upgrade of Azure workloads and Java SDK dependencies. It includes security considerations such as command execution and external resource retrieval, which are used appropriately within its intended functionality as a migration tool.

  • Socket25d

    No alerts

  • Snyk25d

    Risk: LOW · No issues

Signed by skilld at 0d60658. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
compatibility
python3.10+
metadata
{
  "author": "Microsoft",
  "version": "1.2.3"
}

README badge

README badge for microsoft/skills/azure-upgrade