什么是 azure-upgrade
在 Azure 上跑着服务的人，应该都经历过这种场景——业务上来了，函数应用的消耗型计划扛不住了，想升级到 Flex Consumption；或者老板一句话，“把咱们的 App Service 迁到容器应用上去”。听起来简单，真动手的时候才发现：配置要改、依赖要查、文档要翻，万一哪个环节漏了，服务直接挂掉。
azure-upgrade 就是专门处理这种事的。它是微软官方 Azure Skills 套件里的一个核心 Skill，帮你评估和自动化升级 Azure 工作负载——从一个服务、托管计划或 SKU 升级到另一个，全部在 Azure 内部完成。
截至 2026 年 7 月，这个 Skill 在 AI SkillHub 上的下载量已经超过 16 万次。它依托微软的 azure-skills 仓库，在 GitHub 上获得了超过 580 颗星。
说白了就是一句话：把 Azure 升级这件事，从“翻文档加提心吊胆”变成“让 AI 帮你评估和自动化执行”。
核心功能
azure-upgrade 的能力覆盖了从评估到执行再到验证的全流程，而且每一步都有明确的规则和确认机制。
升级前评估
这是 azure-upgrade 最与众不同的地方——任何升级操作之前，必须先做评估。工具会生成一份升级就绪报告，收集现有应用的配置、环境变量、依赖关系，告诉你“能不能升、升了会有什么影响”。而不是让你直接上手改，改完发现跑不起来。
计划与层级升级
支持 Azure Functions 从 Consumption 计划升级到 Flex Consumption 计划。这是 Azure Functions 近两年来最重要的计划升级路径，Flex Consumption 提供了更好的弹性伸缩和更灵活的计费方式，但迁移本身涉及不少配置调整。azure-upgrade 会帮你自动处理这些细节。
跨服务迁移
把 App Service 迁移到 Container Apps。从传统的应用服务转向容器化部署，不仅仅是换一个托管环境那么简单——镜像仓库、环境变量、网络配置、健康检查，涉及的东西不少。azure-upgrade 会按顺序执行迁移步骤，而不是让你自己一个一个改。
SKU 变更
升级或变更 Azure 服务的 SKU 层级，比如把 Redis 缓存从 Premium P2 升级到 Managed Redis 的对应 SKU。
Azure SDK for Java 现代化
如果你的 Java 项目还在用旧版的 com.microsoft.azure.* SDK，azure-upgrade 可以帮你迁移到新版的 com.azure.*。这不仅仅是换一个包名——新版 SDK 的 API 设计、认证方式、错误处理都和旧版有很大不同，手工改不仅费时间还容易漏。
幂等且可恢复的自动化脚本
所有升级脚本都是幂等的——也就是说，即使执行到一半中断了，重新跑一遍也不会出问题。不会出现“跑到一半卡住了，重启之后状态乱掉”的情况。
破坏性操作需确认
删除或停止原始应用之前，必须经过用户明确确认。azure-upgrade 不会在你不知情的情况下干掉旧服务——它会先建新的、验证新的跑通了，再问你要不要删旧的。
安装方法
azure-upgrade 的安装依赖 Node.js 环境，以及一个 AI 编程助手（如 Cursor、Claude Code、Windsurf 等）。
环境准备
确保你的机器上有 Node.js 16 或更高版本：
node --version
如果没有，先去 Node.js 官网下载安装。
安装 azure-upgrade Skill
方式一：通过 npx 安装（推荐）
npx skills add https://github.com/microsoft/azure-skills --skill azure-upgrade
或者使用 bzskills 命令：
npx bzskills add microsoft/azure-skills --skill azure-upgrade
方式二：从 GitHub Copilot for Azure 仓库安装
npx skills add https://github.com/microsoft/GitHub-Copilot-for-Azure --skill azure-upgrade
方式三：全局安装（SkillsAuth）
npx skillsauth add microsoft/azure-skills azure-upgrade在 AI 助手中激活
安装过程中，CLI 会提示你选择要安装到的 AI 助手环境——Cursor、Claude Code、Windsurf、Codex、Cline 等。按需选择即可。
安装完成后，在对应 AI 助手的命令面板中输入 /azure-upgrade 就能调用了。
适用场景
Azure Functions 计划升级
这是 azure-upgrade 最典型的使用场景。你的函数应用跑在 Consumption 计划上，随着业务量增长，冷启动越来越频繁、并发限制越来越明显。你想升级到 Flex Consumption 计划——弹性更好、并发更高、计费更灵活。但迁移不是点一下按钮那么简单，涉及配置对比、依赖检查、部署验证。azure-upgrade 会先做评估、生成报告、然后自动化执行迁移步骤。
应用服务容器化
你有一套应用跑在 App Service 上，团队决定全面转向容器化部署，要迁移到 Azure Container Apps。这不仅仅是换一个托管环境——你需要准备容器镜像、调整环境变量、配置 Dapr 或 Service Bus 集成、设置健康检查探针。azure-upgrade 会帮你逐步完成这个迁移。
旧版 Java SDK 现代化
你的 Java 项目还在用 com.microsoft.azure 的旧版 SDK。新版 com.azure SDK 已经发布了很久，性能更好、安全更新更及时、API 设计更现代。但迁移一个大型项目的 SDK 依赖，涉及上百个文件的手工修改。azure-upgrade 可以自动化完成这个迁移。
Redis 缓存迁移
Azure Cache for Redis（ACR）或 Redis Enterprise（ACRE）要迁移到 Azure Managed Redis（AMR）。AMR 是 Azure 推出的新一代托管 Redis 服务，提供了更好的可用性和管理能力。迁移不只是换个连接串那么简单——SKU 映射、数据迁移、高可用配置、IaC 模板更新，都有讲究。azure-upgrade 会帮你处理这些。
使用案例
案例一：从 Consumption 升级到 Flex Consumption
你在 AI 助手中输入：
“升级我的函数应用，从 Consumption 计划到 Flex Consumption 计划。”
评估阶段：检查当前函数应用的配置、依赖、环境变量，生成升级就绪报告
规划阶段：确认目标 Flex Consumption 计划的 SKU 和配置参数
执行阶段：创建新的 Flex Consumption 函数应用，迁移配置和代码
验证阶段：测试新应用是否可访问、功能是否正常
确认阶段：询问你是否要删除旧的 Consumption 计划应用
整个过程不需要你手动翻文档、改配置、担心漏掉什么。
案例二：迁移 App Service 到 Container Apps
“把我的 App Service 迁移到 Container Apps。”
收集 App Service 的运行时配置、环境变量、连接字符串
生成 Container Apps 所需的容器镜像配置
创建新的 Container Apps 环境并部署
验证新服务是否正常运行
确认后再处理旧服务
案例三：现代化旧版 Azure Java SDK
“把我的 Java 项目从 com.microsoft.azure 迁移到 com.azure。”
扫描项目中的所有 Java 文件，定位旧版 SDK 的 import 语句
根据新版 SDK 的 API 映射，生成代码变更方案
自动化替换 import 和 API 调用（涉及 BOM 版本解析）
生成迁移报告，告诉你哪些地方需要人工介入
案例四：迁移 Redis 到 Azure Managed Redis
“把我的 Premium P2 Redis 缓存迁移到 AMR。”
评估当前 Redis 实例的配置和容量
推荐对应的 AMR SKU
更新 IaC 模板（ARM/Bicep/Terraform）中的 Redis 资源定义
执行数据迁移（如果需要）
切换应用连接到新的 AMR 实例
注意事项
评估先行，不要跳过。 azure-upgrade 的规则明确要求——在任何升级操作之前必须先做评估。跳过评估直接执行升级，出了问题工具不负责。
破坏性操作会问你。 删除或停止原始应用之前，azure-upgrade 一定会向你确认。不会出现“一键升级，旧服务被自动删掉”的情况。
确认目标后再动手。 在执行任何变更之前，azure-upgrade 会跟你确认目标计划或 SKU。别急着点“确认”，先看清楚要升到什么规格。
这不是跨云迁移工具。 azure-upgrade 只处理 Azure 内部的升级和迁移。要把工作负载从 AWS 或 GCP 迁到 Azure，用 azure-cloud-migrate。
升级是优化安全的好时机。 官方最佳实践建议，在升级过程中优先使用托管身份（Managed Identity）而不是连接字符串——升级是改进安全配置的绝佳窗口。
保留原应用直到新应用验证通过。 在确认新服务完全正常运行之前，不要动旧服务。azure-upgrade 默认会遵循这个原则。
◯ 评论 0