# Upgrade Azure Workloads and Java SDKs

Azure upgrades can fail when compatibility, identity, deployment, and rollback details are missed. This skill provides phased assessments, migration steps, validation, and recovery guidance.

## Install

```bash
npx skillstore add microsoft/azure-upgrade
```

## Metadata

- Status: approved
- Slug: microsoft-azure-upgrade
- Version: 1.1.4
- Author version: 1.1.4
- Skillstore revision: r2
- Version status: valid
- Tree hash: a221f4331feb70c410eb738fba9a30b4e52047310b78f0b65a23047aa35853e5
- Author: microsoft
- GitHub username: microsoft
- License: MIT
- Repository: https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills/azure-upgrade/
- Ref: ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, env\_access, filesystem, network
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/microsoft-azure-upgrade
- Manifest: https://skillstore.pages.dev/api/skills/microsoft-azure-upgrade/manifest

## Capabilities

- Assess Linux Consumption Function Apps for Flex Consumption compatibility.
- Guide app creation, configuration migration, deployment, validation, cleanup, and rollback.
- Inventory legacy Azure Java SDK dependencies across Maven and Gradle projects.
- Modernize com.microsoft.azure usage to supported com.azure libraries.
- Resolve the latest Azure SDK BOM and apply OpenRewrite migration recipes.
- Route ACR and ACRE migrations to the correct Azure Managed Redis skill.

## Use Cases

- Assess a Functions Upgrade: Check a Linux Consumption app for Flex compatibility before creating resources.
- Modernize Java Dependencies: Replace unsupported Azure Java SDK packages while preserving application behavior and tests.
- Plan a Redis Migration: Identify ACR or ACRE resources and select the correct managed Redis migration path.

## Prompt Templates

### Check Flex Readiness

```
Assess whether my Linux Consumption app <APP_NAME> in <RESOURCE_GROUP> can move to Flex Consumption. Do not create resources.
```

### Create a Functions Plan

```
Plan a Flex Consumption migration for <APP_NAME>. Include compatibility, identity, deployment, validation, rollback, and confirmation gates.
```

### Plan Java Modernization

```
Inventory the Java project at <PROJECT_PATH> for legacy Azure SDKs. Resolve the latest BOM and propose changes before execution.
```

### Execute an Approved Java Plan

```
Execute the approved migration for <PROJECT_PATH>. Confirm wrapper trust, apply required changes, run tests, and summarize remaining risks.
```

## Limitations

- Only documented Functions, Java, and Redis scenarios have detailed workflows.
- The Flex Consumption workflow supports Linux apps and excludes unsupported platform features.
- Java automation requires Python 3.10 and a Maven or Gradle project.
- Azure operations require authenticated tools, adequate permissions, and user approval for resource changes.

## Best Practices

- Complete assessment and rollback planning before changing Azure resources.
- Use managed identity and preserve the original workload until validation succeeds.
- Review wrappers, generated commands, and source changes before execution.

## Anti Patterns

- Do not delete or stop the original workload before explicit confirmation.
- Do not print app settings, connection strings, tokens, or credential files.
- Do not install external migration skills from an unreviewed mutable branch.

## Security Audit

- Audited at: 2026-07-23T19:35:25.639\+00:00
- Summary: Most static matches are documentation syntax, relative links, or scoped Azure checks. Confirmed risks include untrusted wrapper execution, destructive build-file handling, and credential exposure. Hidden persistent directives and unpinned external skill installation add supply-chain and agent-control risk.

## Stats

- Views: 194
- Downloads: 8
- Favorites: 0
- Popularity score: 0