azure-upgrade

Tổng quan

azure-upgrade là gì?

azure-upgrade là một kỹ năng nâng cấp có hướng dẫn dành cho các workload Azure hiện có. Kỹ năng tập trung vào các thay đổi in-place hoặc gần in-place, như nâng cấp plan, tier, SKU, hoặc di chuyển giữa các dịch vụ Azure có liên quan chặt chẽ trong khi vẫn ở trong Azure.

Các trường hợp sử dụng điển hình gồm:

• Nâng cấp Azure Functions từ Consumption lên Flex Consumption
• Di chuyển function app sang một hosting plan hoặc service tier khác
• Thay đổi SKU của một dịch vụ Azure hiện có
• Di chuyển backend workload từ App Service sang Azure Container Apps

Kỹ năng này kết hợp một quy trình có cấu trúc (Identify → Assess → Pre-migrate → Upgrade → Validate) với các quy tắc an toàn và hướng dẫn best practice để bạn có thể thay đổi ứng dụng đang chạy mà không phải phán đoán cảm tính.

azure-upgrade dành cho ai?

azure-upgrade được thiết kế cho:

• Developer và DevOps engineer phụ trách các dịch vụ backend chạy trên Azure
• Nhóm vận hành nền tảng và cloud quản lý các thay đổi về plan, tier hoặc SKU
• Các đội nhóm chuẩn hóa trên Flex Consumption hoặc hiện đại hóa từ App Service sang Container Apps

Nếu bạn cần tinh chỉnh plan hoặc chuyển sang các dịch vụ Azure mới hơn mà không làm gián đoạn môi trường production, kỹ năng này mang lại một lộ trình lặp lại được và có tài liệu đầy đủ.

azure-upgrade giải quyết những vấn đề gì?

azure-upgrade giúp bạn:

• Đánh giá mức độ sẵn sàng nâng cấp trước khi động vào bất kỳ resource đang chạy nào
• Lên kế hoạch plan/tier/SKU mục tiêu dựa trên cấu hình hiện tại
• Tự động hóa các bước nâng cấp lặp đi lặp lại theo các quy tắc xác định sẵn
• Theo dõi tiến độ bằng file upgrade-status.md trong repo của bạn
• Tránh thao tác không an toàn thông qua các quy tắc nghiêm ngặt cho hành động phá hủy và yêu cầu người dùng xác nhận

Kỹ năng này tập trung cụ thể vào các thay đổi bên trong Azure. Nó không xử lý việc di chuyển giữa các cloud; với trường hợp đó, bạn nên dùng kỹ năng migration riêng như azure-cloud-migrate.

Khi nào nên dùng azure-upgrade?

Hãy dùng azure-upgrade khi:

• Bạn đang nâng cấp Azure Functions app đang chạy lên Flex Consumption
• Bạn muốn thay đổi hosting tier hoặc SKU cho một workload hiện có
• Bạn đang di chuyển một app từ App Service sang Azure Container Apps
• Bạn cần một quy trình nâng cấp Azure theo giai đoạn, có khả năng truy vết

Có thể không phù hợp khi:

• Bạn đang di chuyển workload ra khỏi Azure (cross-cloud migration)
• Bạn đang thiết lập một ứng dụng hoàn toàn mới không có resource hiện hữu
• Bạn chỉ cần tự động hóa CI/CD pipeline (phù hợp hơn với các kỹ năng như azure-deploy)

Nếu ưu tiên chính của bạn là triển khai an toàn, có phương án rollback và đảm bảo tương đương cấu hình trong quá trình nâng cấp Azure, azure-upgrade được thiết kế đúng cho công việc đó.

Cách sử dụng

1. Cài đặt và thiết lập

Để thêm kỹ năng azure-upgrade từ repository microsoft/azure-skills, hãy dùng skills CLI trong môi trường agent của bạn:

npx skills add https://github.com/microsoft/azure-skills --skill azure-upgrade

Sau khi cài đặt, hãy xem qua các file chính mô tả cách kỹ năng hoạt động:

• SKILL.md – mô tả tổng quan, trigger và các quy tắc
• references/global-rules.md – các quy tắc an toàn và best practice
• references/workflow-details.md – chi tiết các giai đoạn workflow và hướng dẫn theo dõi trạng thái

Đảm bảo agent của bạn được cấu hình với quyền truy cập vào các Azure MCP tool liên quan như mcp_azure_mcp_get_bestpractices và mcp_azure_mcp_documentation, như được tham chiếu trong các quy tắc của skill.

2. Hiểu quy trình nâng cấp

azure-upgrade tuân theo một chuỗi bước được xác định sẵn:

1. Identify – Xác định rõ resource nguồn (ví dụ: Functions plan hiện tại) và plan, tier hoặc SKU mục tiêu.
2. Assess – Tạo bản đánh giá mức độ sẵn sàng và tương thích của việc nâng cấp.
3. Pre-migrate – Thu thập app settings, cấu hình, dependency và thông tin kết nối.
4. Upgrade – Thực thi các bước tự động để áp dụng plan/tier/SKU mới hoặc tạo resource mục tiêu mới.
5. Validate – Xác minh ứng dụng sau nâng cấp hoạt động bình thường và sẵn sàng nhận traffic.

Các quy tắc enforced bởi skill yêu cầu phải tuân thủ đúng thứ tự giai đoạn. Việc bỏ qua bước đánh giá hoặc pre-migration bị khuyến cáo là không nên, giúp giữ cho thay đổi trong môi trường production an toàn và dễ dự đoán.

3. Theo dõi tiến độ với upgrade-status.md

Workflow sử dụng một file theo dõi đơn giản, nằm trong repo, để giúp quá trình nâng cấp có thể audit và chia sẻ trong cả đội.

Tạo upgrade-status.md ở thư mục gốc workspace của bạn theo cấu trúc được mô tả trong references/workflow-details.md. Tối thiểu, file nên ghi lại:

• Tên app nguồn và plan hiện tại
• Plan hoặc dịch vụ mục tiêu
• Resource group và region
• Ngày bắt đầu
• Checklist các giai đoạn workflow (Identify, Assess, Pre-migrate, Upgrade, Validate)
• Ghi chú về vấn đề, quyết định và lỗi phát sinh

Cập nhật file này khi agent hoàn thành từng giai đoạn. Nếu một giai đoạn thất bại, ghi lại lỗi và xử lý xong trước khi tiếp tục.

4. Tuân thủ các quy tắc an toàn toàn cục

File references/global-rules.md định nghĩa các guardrail bắt buộc cho azure-upgrade, bao gồm:

• Destructive Action Policy – Agent không được xóa app, service, resource group, hoặc chỉnh sửa DNS/custom domain nếu không có xác nhận rõ ràng qua ask_user.
• User confirmation checks – Việc chọn subscription hoặc region, tạo resource mới, thay đổi giới hạn mạng đều phải được người dùng phê duyệt rõ ràng.
• Best practice – Skill ưu tiên managed identity, runtime hiện đại, và giữ resource gốc chạy cho đến khi resource nâng cấp được xác thực đầy đủ.

Khi tùy biến hoặc mở rộng workflow, hãy giữ nguyên các quy tắc này để tự động hóa của bạn vẫn an toàn trong môi trường production.

5. Chạy các kịch bản nâng cấp phổ biến

Sau khi cài đặt, bạn tương tác với azure-upgrade bằng các intent ngôn ngữ tự nhiên khớp với trigger trong SKILL.md. Ví dụ một số prompt bạn có thể gửi cho agent:

• "Assess if my function app is ready to move from Consumption to Flex Consumption."
• "Automate the upgrade of my Functions plan to Flex Consumption in the same resource group."
• "Help me migrate this App Service API to Azure Container Apps and validate it before cutover."
• "Change the hosting plan for this function app and document each step in upgrade-status.md."

Sau đó skill sẽ:

1. Diễn giải intent của bạn thành một kịch bản nâng cấp cụ thể.
2. Tải các tài liệu tham chiếu kịch bản liên quan và global rule.
3. Sử dụng Azure MCP tool để tra cứu tài liệu và kiểm tra best practice.
4. Đề xuất hoặc tạo các bước nâng cấp, và xin xác nhận trước khi thực hiện bất kỳ thay đổi ảnh hưởng lớn nào.

6. Bàn giao cho các kỹ năng liên quan

Sau khi nâng cấp và validate thành công, azure-upgrade hỗ trợ bàn giao gọn gàng sang các kỹ năng Azure khác:

• azure-validate – để validate và test sâu hơn sau khi nâng cấp.
• azure-deploy – để thiết lập hoặc tối ưu CI/CD pipeline cho các resource vừa nâng cấp.

Cách này giúp azure-upgrade tập trung vào workflow quản lý thay đổi, đồng thời vẫn nằm trong một hệ sinh thái tự động hóa rộng hơn.

Câu hỏi thường gặp (FAQ)

azure-upgrade có phù hợp cho workload production không?

Có, azure-upgrade được thiết kế cho môi trường production. Các global rule yêu cầu rõ ràng:

• Thực thi theo giai đoạn (không bỏ qua bước đánh giá)
• Xác nhận cho mọi hành động phá hủy hoặc không thể đảo ngược
• Giữ app/service gốc chạy cho đến khi phiên bản nâng cấp được xác thực đầy đủ

Khi dùng đúng cách và kết hợp với quy trình quản lý thay đổi nội bộ của bạn, kỹ năng này hỗ trợ nâng cấp an toàn trong môi trường production.

azure-upgrade có xử lý việc di chuyển giữa các cloud không?

Không. azure-upgrade tập trung vào các nâng cấp bên trong Azure, như thay đổi plan, tier, SKU, hoặc di chuyển giữa các dịch vụ Azure như App Service và Container Apps. Để di chuyển workload giữa các cloud, bạn nên dùng kỹ năng migration chuyên biệt như azure-cloud-migrate.

Tôi có thể nâng cấp những dịch vụ Azure nào với azure-upgrade?

Kỹ năng này hướng tới các workload hiện hữu như:

• Azure Functions app (ví dụ: Consumption → Flex Consumption)
• Ứng dụng chạy trên Azure App Service
• Workload bạn muốn chuyển sang Azure Container Apps

Vì các quy tắc nền tảng tập trung vào plan, tier và SKU, kỹ năng đặc biệt hữu ích khi bạn cần hiện đại hóa hosting hoặc điều chỉnh năng lực cho các dịch vụ backend.

azure-upgrade theo dõi những gì đã thực hiện bằng cách nào?

Kỹ năng sử dụng file upgrade-status.md trong repository của bạn, như mô tả trong references/workflow-details.md. File này ghi lại:

• Thông tin resource chính
• Trạng thái hoàn thành từng giai đoạn
• Lỗi và ghi chú khắc phục

Cơ chế đơn giản này giúp quá trình nâng cấp có thể audit và dễ xem lại, ngay cả khi có nhiều thành viên hoặc agent cùng tham gia.

azure-upgrade có xóa resource gốc của tôi không?

Không, nếu không có chấp thuận rõ ràng. references/global-rules.md định nghĩa Destructive Action Policy nghiêm ngặt cho:

• Xóa app, service, hoặc resource group
• Dừng hoặc vô hiệu hóa service ban đầu
• Thay đổi DNS hoặc custom domain binding

Tất cả các thao tác này đều yêu cầu xác nhận qua ask_user. Bạn luôn là người quyết định khi nào (hoặc có) decommission resource gốc sau khi nâng cấp thành công.

Tôi có thể tùy biến workflow của azure-upgrade không?

Bạn có thể điều chỉnh cách sử dụng workflow (ví dụ: tích hợp file trạng thái với quy trình nội bộ hoặc kết hợp với công cụ riêng của bạn), nhưng các giai đoạn và quy tắc an toàn được đặt ra để giữ cho việc nâng cấp có thể dự đoán và an toàn. Nếu bạn mở rộng hoặc bọc quanh azure-upgrade, hãy giữ lại:

• Chuỗi Identify → Assess → Pre-migrate → Upgrade → Validate
• Các global rule cho hành động phá hủy và xác nhận

Điều này đảm bảo mọi tự động hóa tùy biến vẫn được hưởng lợi từ các guardrail sẵn có.

azure-upgrade phù hợp thế nào với CI/CD pipeline?

azure-upgrade tập trung vào các thay đổi vận hành một lần hoặc định kỳ đối với resource hiện có. Sau khi hoàn tất nâng cấp và validate, kỹ năng có thể bàn giao cho azure-deploy để:

• Cấu hình hoặc cập nhật CI/CD pipeline
• Căn chỉnh workflow triển khai với plan, tier hoặc dịch vụ mới

Hãy dùng azure-upgrade để thay đổi an toàn đặc tính hạ tầng, rồi dựa vào các kỹ năng tập trung vào pipeline cho việc triển khai liên tục.

Tôi cần chuẩn bị gì trước khi dùng azure-upgrade?

Trước khi chạy azure-upgrade, hãy đảm bảo bạn có:

• Quyền truy cập vào Azure subscription và resource group mục tiêu
• Nhận thức rõ về plan/tier/SKU hoặc dịch vụ mục tiêu (ví dụ: Container Apps)
• Môi trường agent đã cấu hình với skill azure-upgrade và các Azure MCP tool

Chuẩn bị sẵn thông tin này sẽ giúp agent nhanh chóng hoàn thành các giai đoạn Identify và Assess, giảm bớt việc phải xác nhận qua lại.