azure-upgrade

개요

azure-upgrade란 무엇인가요?

azure-upgrade는 기존 Azure 워크로드를 위한 가이드형 업그레이드 스킬입니다. 플랜, 티어, SKU 업그레이드처럼 인플레이스 또는 이에 가까운 변경 작업이나, Azure 안에서 서로 밀접하게 연관된 서비스 간 이동에 초점을 맞춥니다.

대표적인 사용 사례는 다음과 같습니다:

• Azure Functions를 Consumption에서 Flex Consumption으로 업그레이드
• Function app을 다른 hosting plan 또는 service tier로 이동
• 기존 Azure 서비스의 SKU 변경
• 백엔드 워크로드를 App Service에서 Azure Container Apps로 마이그레이션

이 스킬은 (Identify → Assess → Pre-migrate → Upgrade → Validate)로 이어지는 구조화된 워크플로에 안전 규칙과 모범 사례 가이드를 결합하여, 운영 중인 애플리케이션을 시행착오 없이 진화시킬 수 있도록 돕습니다.

azure-upgrade는 누가 사용하면 좋은가요?

azure-upgrade는 다음과 같은 사용자를 위해 설계되었습니다:

• Azure 기반 백엔드 서비스를 담당하는 개발자 및 DevOps 엔지니어
• 플랜, 티어, SKU 변경을 관리하는 플랫폼/클라우드 운영 팀
• Flex Consumption 표준화를 추진하거나 App Service에서 Container Apps로 현대화를 진행하는 팀

운영 중인 리소스를 중단시키지 않고 플랜을 조정하거나 최신 Azure 오퍼링으로 옮겨야 한다면, 이 스킬은 반복 가능한 문서화된 경로를 제공합니다.

azure-upgrade는 어떤 문제를 해결하나요?

azure-upgrade는 다음을 도와줍니다:

• 실제 리소스를 건드리기 전에 업그레이드 준비 상태를 평가
• 현재 구성을 기반으로 목표 플랜/티어/SKU를 설계
• 정의된 규칙에 따라 반복적인 업그레이드 단계를 자동화
• 레포지토리의 upgrade-status.md 파일로 진행 상황을 추적
• 엄격한 파괴적 작업 규칙과 사용자 확인을 통해 위험한 작업을 방지

이 스킬은 Azure 내부(in-Azure) 변경에 특화되어 있습니다. 클라우드 간 마이그레이션은 처리하지 않으며, 이 경우에는 azure-cloud-migrate 같은 별도의 마이그레이션 스킬을 사용해야 합니다.

언제 azure-upgrade를 쓰는 것이 좋나요?

다음과 같은 상황에서 azure-upgrade를 사용하세요:

• 실행 중인 Azure Functions 앱을 Flex Consumption으로 업그레이드할 때
• 기존 워크로드의 호스팅 티어나 SKU를 변경해야 할 때
• 앱을 App Service에서 Azure Container Apps로 마이그레이션할 때
• 운영 환경에서의 Azure 업그레이드를 위해 추적 가능하고 단계적인 프로세스가 필요할 때

다음과 같은 경우에는 적합하지 않을 수 있습니다:

• 워크로드를 Azure 밖으로 이동하는 클라우드 간 마이그레이션인 경우
• 기존 리소스가 없는 완전 신규 앱을 구축하는 경우
• CI/CD 파이프라인 자동화만 필요할 때 (azure-deploy 같은 스킬이 더 적합)

업그레이드 시 안전한 롤아웃, 롤백 옵션, 구성 일관성이 가장 중요하다면, azure-upgrade는 그 목적에 맞게 설계된 스킬입니다.

사용 방법

1. 설치 및 설정

microsoft/azure-skills 리포지토리에서 azure-upgrade 스킬을 추가하려면, 에이전트 환경에서 skills CLI를 사용합니다:

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

설치가 완료되면, 스킬 동작 방식을 정의하는 핵심 파일들을 확인하세요:

• SKILL.md – 상위 수준 설명, 트리거, 규칙
• references/global-rules.md – 안전 규칙과 모범 사례
• references/workflow-details.md – 워크플로 단계 세부 내용과 상태 추적 가이드

스킬 규칙에서 참조하는 mcp_azure_mcp_get_bestpractices, mcp_azure_mcp_documentation 같은 Azure MCP 도구에 접근할 수 있도록 에이전트를 구성해야 합니다.

2. 업그레이드 워크플로 이해하기

azure-upgrade는 다음과 같은 정해진 순서를 따릅니다:

1. Identify – 소스 리소스(예: 현재 Functions 플랜)와 목표 플랜/티어/SKU를 명확히 합니다.
2. Assess – 업그레이드 준비 상태와 호환성을 평가합니다.
3. Pre-migrate – 앱 설정, 구성, 종속성, 연결 정보를 수집합니다.
4. Upgrade – 새 플랜/티어/SKU를 적용하거나 새로운 대상 리소스를 생성하는 자동화 단계를 실행합니다.
5. Validate – 업그레이드된 앱이 정상 동작하며 트래픽을 받을 준비가 되었는지 검증합니다.

스킬에 내장된 규칙은 이 단계들을 순서대로 수행하도록 강제합니다. Assess나 Pre-migrate 단계를 건너뛰는 것은 명시적으로 금지되어 있으며, 이를 통해 운영 환경 변경을 보다 안전하고 예측 가능하게 유지합니다.

3. upgrade-status.md로 진행 상황 추적

이 워크플로는 팀 내에서 업그레이드 작업을 감사 가능하고 쉽게 공유할 수 있도록, 레포지토리 로컬의 간단한 추적 파일을 사용합니다.

워크스페이스 루트에 references/workflow-details.md에 문서화된 구조를 참고해 upgrade-status.md를 생성하세요. 최소한 다음 내용을 포함하는 것이 좋습니다:

• 소스 앱 이름과 현재 플랜
• 목표 플랜 또는 서비스
• 리소스 그룹과 지역
• 시작일
• 워크플로 단계 체크리스트(Identify, Assess, Pre-migrate, Upgrade, Validate)
• 이슈, 의사결정, 오류에 대한 메모

에이전트가 각 단계를 진행할 때마다 이 파일을 업데이트하세요. 특정 단계가 실패하면 오류를 기록하고 해결한 뒤 다음 단계로 진행합니다.

4. 글로벌 안전 규칙 준수

references/global-rules.md 파일에는 azure-upgrade를 위한 필수 보호 장치가 정의되어 있습니다. 예를 들면 다음과 같습니다:

• Destructive Action Policy – 에이전트는 ask_user를 통한 명시적 확인 없이 앱, 서비스, 리소스 그룹을 삭제하거나 DNS/커스텀 도메인을 수정해서는 안 됩니다.
• 사용자 확인 절차 – 구독 또는 지역 선택, 새 리소스 생성, 네트워크 제한 변경은 모두 명시적인 사용자 승인을 거쳐야 합니다.
• 모범 사례 – 관리형 ID 사용 권장, 최신 런타임 채택, 업그레이드 대상이 완전히 검증될 때까지 기존 리소스를 유지하는 방식을 우선합니다.

워크플로를 커스터마이즈하거나 확장할 때에도 이러한 규칙을 유지해 운영 환경에서의 자동화를 안전하게 지키세요.

5. 자주 쓰는 업그레이드 시나리오 실행

설치 후에는 SKILL.md에 정의된 트리거에 맞는 자연어 명령을 통해 azure-upgrade와 상호작용할 수 있습니다. 에이전트에게 예를 들어 다음과 같이 요청할 수 있습니다:

• "내 function app이 Consumption에서 Flex Consumption으로 이동할 준비가 되었는지 Assess 해줘."
• "같은 resource group 내에서 내 Functions plan을 Flex Consumption으로 업그레이드하는 작업을 자동화해줘."
• "이 App Service 기반 API를 Azure Container Apps로 마이그레이션하고, cutover 전에 Validate까지 도와줘."
• "이 function app의 hosting plan을 변경하고, 각 단계를 upgrade-status.md에 기록해줘."

그러면 스킬은 다음과 같이 동작합니다:

1. 사용자의 의도를 업그레이드 시나리오로 해석합니다.
2. 관련 시나리오 레퍼런스와 글로벌 규칙을 로드합니다.
3. Azure MCP 도구를 사용해 문서 및 모범 사례를 확인합니다.
4. 영향을 주는 변경 전에는 항상 확인을 요청하면서, 업그레이드 단계를 제안하거나 생성합니다.

6. 관련 스킬로 핸드오프

업그레이드와 검증이 완료되면, azure-upgrade는 다른 Azure 중심 스킬로 자연스럽게 핸드오프할 수 있습니다:

• azure-validate – 업그레이드 이후 더 심층적인 검증과 테스트 수행
• azure-deploy – 업그레이드된 리소스를 대상으로 CI/CD 파이프라인을 구성하거나 개선

이를 통해 azure-upgrade는 변경 관리 워크플로에 집중하면서도, 더 넓은 자동화 생태계 안에서 유기적으로 연동됩니다.

자주 묻는 질문(FAQ)

azure-upgrade는 프로덕션 워크로드에도 적합한가요?

네. azure-upgrade는 프로덕션 환경 사용을 염두에 두고 설계되었습니다. 글로벌 규칙에는 다음이 명시되어 있습니다:

• 단계 기반 실행(Assess 단계 생략 금지)
• 파괴적이거나 되돌릴 수 없는 작업에 대한 사전 확인
• 업그레이드된 버전이 완전히 검증될 때까지 기존 앱/서비스 유지

의도된 방식으로 사용하고 기존 변경 관리 프로세스와 함께 운영한다면, 프로덕션 환경에서도 안전한 업그레이드를 지원합니다.

azure-upgrade로 클라우드 간 마이그레이션도 할 수 있나요?

아니요. azure-upgrade는 플랜, 티어, SKU 변경이나 App Service에서 Container Apps로의 이동처럼 Azure 내부(in-Azure) 업그레이드에 초점을 맞추고 있습니다. 워크로드를 다른 클라우드로 옮겨야 한다면, azure-cloud-migrate 같은 전용 마이그레이션 스킬을 사용하는 것이 좋습니다.

azure-upgrade로 어떤 Azure 서비스를 업그레이드할 수 있나요?

이 스킬은 다음과 같은 기존 워크로드를 주 대상으로 합니다:

• Azure Functions 앱(예: Consumption → Flex Consumption)
• Azure App Service에서 실행 중인 앱
• Azure Container Apps로 이전하려는 워크로드

기본 규칙이 플랜, 티어, SKU에 집중되어 있기 때문에, 백엔드 서비스의 호스팅을 현대화하거나 용량을 조정해야 할 때 특히 유용합니다.

azure-upgrade는 어떤 방식으로 작업 내역을 추적하나요?

이 스킬은 references/workflow-details.md에 설명된 대로, 레포지토리 내 upgrade-status.md 파일을 활용합니다. 이 파일에는 다음 내용이 기록됩니다:

• 주요 리소스 정보
• 각 단계 완료 상태
• 오류와 해결 방법 메모

이처럼 단순한 메커니즘을 통해, 여러 팀원이나 에이전트가 관여하더라도 업그레이드 작업을 감사 가능하고 리뷰하기 쉽게 유지할 수 있습니다.

azure-upgrade가 기존 리소스를 삭제해 버리지는 않나요?

명시적인 승인 없이는 삭제하지 않습니다. references/global-rules.md에는 엄격한 Destructive Action Policy가 정의되어 있으며, 다음 작업은 모두 해당됩니다:

• 앱, 서비스, 리소스 그룹 삭제
• 기존 서비스를 중지하거나 비활성화하는 작업
• DNS 또는 커스텀 도메인 바인딩 수정

이러한 작업은 모두 ask_user를 통한 명시적 확인이 필요합니다. 업그레이드 후 원본 리소스를 언제(또는 실제로) 폐기할지는 사용자가 직접 결정할 수 있습니다.

azure-upgrade 워크플로를 커스터마이즈할 수 있나요?

업그레이드 워크플로를 활용하는 방식은 얼마든지 조정할 수 있습니다. 예를 들어 status 파일을 내부 프로세스와 연계하거나 다른 내부 도구와 결합해 사용할 수 있습니다. 다만, 정의된 단계와 안전 규칙은 업그레이드를 예측 가능하고 안전하게 유지하기 위해 존재합니다. azure-upgrade를 확장하거나 래핑하더라도 다음을 유지하는 것이 좋습니다:

• Identify → Assess → Pre-migrate → Upgrade → Validate 순서
• 파괴적 작업 및 확인에 대한 글로벌 규칙

이렇게 하면 커스텀 자동화도 내장된 보호 장치의 이점을 계속 누릴 수 있습니다.

azure-upgrade는 CI/CD 파이프라인과 어떻게 연계되나요?

azure-upgrade는 기존 리소스에 대한 일회성 또는 주기적인 운영 변경에 초점을 맞춥니다. 업그레이드와 검증을 마친 뒤에는 azure-deploy로 핸드오프하여 다음과 같은 작업을 수행할 수 있습니다:

• CI/CD 파이프라인 구성 또는 업데이트
• 새 플랜, 티어, 서비스에 맞춘 배포 워크플로 정렬

즉, azure-upgrade로 인프라 특성을 안전하게 변경한 다음, 지속적인 배포는 파이프라인 중심 스킬에 맡기는 구성이 이상적입니다.

azure-upgrade를 사용하기 전에 무엇을 준비해야 하나요?

azure-upgrade를 실행하기 전에 다음을 준비하세요:

• 대상 Azure subscription 및 resource group에 대한 접근 권한
• 목표 플랜/티어/SKU 또는 대상 서비스(예: Container Apps)에 대한 명확한 정의
• azure-upgrade 스킬과 Azure MCP 도구가 설정된 에이전트 환경

이 정보를 미리 준비해 두면 에이전트가 Identify와 Assess 단계를 더 빠르게 진행할 수 있으며, 불필요한 확인 요청을 줄일 수 있습니다.