pulumi-arm-to-pulumi

소개 pulumi-arm-to-pulumi

Azure ARM(Azure Resource Manager) 템플릿, Bicep 또는 Azure 코드를 Pulumi로 변환하거나 마이그레이션하기 위한 체계적인 워크플로우로, 기존 Azure 리소스를 Pulumi 관리 환경으로 가져오는 과정도 포함됩니다. 이 스킬은 이러한 마이그레이션, 변환 또는 가져오기가 요청될 때마다 로드되도록 설계되었으며, 스킬이 로드되기 전에 이미 작성된 마이그레이션 계획을 이 스킬의 요구 사항에 맞춰 수정합니다.

성공 기준은 엄격합니다. 모든 ARM 리소스는 Pulumi 프로그램에 포함되거나 보고서에서 명시적으로 그 사유가 설명되어야 합니다. 출력 결과는 구조적으로 유효해야 하며 Pulumi 미리보기가 성공적으로 수행되어야 합니다. 또한 기존 리소스를 가져올 때 미리보기에서 차이점(생성, 업데이트, 교체 또는 삭제)이 전혀 없어야 하며, 발생하는 모든 차이점은 ‘미리보기 해결 워크플로’를 통해 해결되어야 합니다. 풀 리퀘스트에 적합한 공식 마이그레이션 보고서가 항상 생성되며, 여기에는 ARM-Pulumi 리소스 매핑, 제공자 결정, 동작 차이 및 수동 단계가 포함됩니다.

워크플로는 순서대로 진행됩니다. 정보 수집 단계에서는 Azure 자격 증명을 확인하고(ESC 환경 및 az login 사용), jq를 사용하여 ARM 템플릿을 분석하여 리소스 유형, 매개변수, 변수, dependsOn 배열, 복사 루프 및 조건문을 추출하며, 선택적으로 az resource list 및 show 명령을 사용하여 리소스 인벤토리를 구축합니다. 자동화된 ARM 변환기가 없으므로 코드 변환은 수동으로 이루어지며, 기본적으로 azure-native 제공자를 사용하고 클래식 Azure 제공자를 대체 옵션으로 지정하여, 사용자가 선택한 언어에서 모든 조건문, 루프 및 종속성을 보존합니다. 선택적 리소스 가져오기는 예측 가능한 구독, 리소스 그룹 및 제공자 경로를 따르는 Azure 리소스 ID와 함께 인라인 리소스 가져오기 옵션을 사용하며, 이후 차이가 없는지 유효성 검사를 수행합니다. 마지막으로, 스택 구성이 ARM 매개변수와 일치하도록 설정됩니다. 관련 문서인 arm-conversion-patterns.md 및 arm-import.md에는 상세한 매핑 패턴과 가져오기 및 '차이 없음(zero-diff)' 디버깅 절차가 설명되어 있습니다.

자주 묻는 질문

ARM 템플릿을 변환하는 자동화 도구가 있나요?

아니요. 이 스킬은 ARM-to-Pulumi 변환에 수동 변환이 필요하며, 참조 패턴이 매핑을 안내해 주지만 전체 변환 과정은 사용자가 직접 담당해야 합니다.

어떤 Pulumi 제공자를 사용해야 하나요?

Azure Resource Manager API를 완전히 지원하려면 기본적으로 @pulumi/azure-native를 사용하고, azure-native에 기능이 없거나 더 간단한 추상화가 필요한 경우에는 기존 @pulumi/azure 프로바이더로 대체하십시오.

'차이 없음(zero-diff)' 가져오기 유효성 검사는 무엇을 의미하나요?

기존 리소스를 가져온 후, Pulumi 미리 보기에는 생성(create), 업데이트(update), 교체(replace) 또는 삭제(delete) 항목이 표시되어서는 안 됩니다. 모든 차이점은 arm-import.md에 설명된 미리 보기 해결 워크플로를 통해 해결됩니다.

Azure 자격 증명은 어떻게 설정하나요?

자격 증명을 제공하는 ESC 환경을 통해, `pulumi env run` 명령어에 `az login`(서비스 주체 및 페더레이션 토큰)을 사용하여 자격 증명을 설정하고, `az account show` 명령어로 확인합니다. 지정된 환경이 없는 경우, 이 스킬은 사용할 ESC 환경을 묻습니다.

마이그레이션이 완료되면 어떤 결과가 제공되나요?

ARM-Pulumi 리소스 매핑, 제공자 결정 사항, 동작 차이점, 누락되거나 수동으로 수행해야 하는 단계, 검증 지침 등이 포함된, 풀 리퀘스트(pull request)에 적합한 공식 마이그레이션 보고서입니다.

모든 파일