PowerShell을 사용하여 청사진 정의 가져오기 및 내보내기

아티클
02/23/2024

Important

2026년 7월 11일에 청사진(미리 보기)이 사용 중단됩니다. 기존 청사진 정의와 할당을 템플릿 사양과 배포 스택으로 마이그레이션하세요. 청사진 아티팩트는 배포 스택을 정의하는 데 사용되는 ARM JSON 템플릿 또는 Bicep 파일로 변환됩니다. 아티팩트를 ARM 리소스로 작성하는 방법을 알아보려면 다음을 참조하세요.

Azure Blueprints는 Azure Portal을 통해 완벽하게 관리할 수 있습니다. 조직에서 Azure Blueprints를 사용할 때 청사진 정의를 관리 코드로 간주해야 합니다. 이 개념을 종종 IaC(코드 제공 인프라)라고 합니다. 청사진 정의를 코드로 처리 하면 Azure Portal이 제공하는 이점 이상의 추가 이점을 제공합니다. 따라서 다음과 같은 이점이 있습니다.

청사진 정의 공유
청사진 정의 백업
다른 테넌트 또는 구독에서 청사진 정의 재사용
소스 제어에 청사진 정의 배치
- 테스트 환경에서 청사진 정의의 자동화된 테스트
- CI/CD(연속 통합 및 지속적인 배포) 파이프라인 지원

청사진 정의를 코드로 관리하는 것은 어떤 이유로든 도움이 됩니다. 이 문서에서는 Az.Blueprint 모듈에서 Import-AzBlueprintWithArtifact 및 Export-AzBlueprintWithArtifact 명령을 사용하는 방법을 보여줍니다.

필수 조건

이 문서에서는 Azure Blueprints에 대한 일반적인 실무 지식이 있다고 가정합니다. 아직 수행하지 않은 경우 다음 문서를 살펴보세요.

포털에서 청사진 만들기
배포 단계 및 청사진 수명 주기에 대해 읽어보기
PowerShell을 사용하여 청사진 정의 및 할당 만들기 및 관리

아직 설치되지 않은 경우 Az.Blueprint 모듈 추가를 수행하여 PowerShell 갤러리에서 Az.Blueprint 모듈을 설치하고 유효성을 검사합니다.

청사진 정의의 폴더 구조

청사진을 내보내고 가져오는 방법을 살펴보기 전에 청사진 정의를 구성하는 파일이 어떻게 구조화되었는지 살펴보겠습니다. 청사진 정의는 자체 폴더에 저장해야 합니다.

Important

Import-AzBlueprintWithArtifact cmdlet의 Name 매개 변수에 값이 전달되지 않으면 청사진 정의가 저장된 폴더의 이름이 사용됩니다.

이름이 blueprint.json이어야 하는 청사진 정의와 함께 청사진 정의가 구성되는 아티팩트입니다. 각 아티팩트는 이름이 artifacts인 하위 폴더에 있어야 합니다. 즉, 폴더에서 JSON 파일로 구성되는 청사진 정의의 구조는 다음과 같이 표시됩니다.

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

청사진 정의 내보내기

청사진 정의를 내보내는 단계는 간단합니다. 청사진 정의를 내보내는 것은 공유, 백업 또는 소스 제어에 배치하는 데 유용할 수 있습니다.

Blueprint [필수]
- 청사진 정의를 지정합니다.
- 참조 개체를 가져오는 데 Get-AzBlueprint를 사용합니다.
OutputPath [필수]
- 청사진 정의 JSON 파일을 저장할 경로를 지정합니다.
- 출력 파일은 청사진 정의의 이름을 가진 하위 폴더에 있습니다.
Version (선택 사항)
- 청사진 참조 개체에 두 개 이상의 버전에 대한 참조가 포함된 경우 출력할 버전을 지정합니다.

{subId}로 표시된 구독에서 내보낼 청사진 정의에 대한 참조를 가져옵니다.

# Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'

Export-AzBlueprintWithArtifact cmdlet을 사용하여 지정된 청사진 정의를 내보냅니다.
```
Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'
```

청사진 정의 가져오기

내보낸 청사진 정의가 있거나 필요한 폴더 구조에 수동으로 만든 청사진 정의가 있으면 해당 청사진 정의를 다른 관리 그룹 또는 구독으로 가져올 수 있습니다.

기본 제공 청사진 정의의 예제는 Azure Blueprint GitHub 리포지토리를 참조하세요.

Name [필수]
- 새 청사진 정의의 이름을 지정합니다.
InputPath [필수]
- 청사진 정의를 만들 경로를 지정 합니다.
- 필요한 폴더 구조와 일치해야 합니다.
ManagementGroupId (선택 사항)
- 현재 컨텍스트 기본값이 아닌 경우 청사진 정의를 저장할 관리 그룹 ID입니다.
- ManagementGroupId 또는 SubscriptionId를 지정해야 합니다.
SubscriptionId (선택 사항)
- 현재 컨텍스트 기본값이 아닌 경우 청사진 정의를 저장할 구독 ID입니다.
- ManagementGroupId 또는 SubscriptionId를 지정해야 합니다.

Import-AzBlueprintWithArtifact cmdlet을 사용하여 지정된 청사진 정의를 가져옵니다.

# Login first with Connect-AzAccount if not using Cloud Shell

Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'

청사진 정의를 가져온 후에는 PowerShell을 사용하여 할당합니다.

고급 청사진 정의를 만드는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

정적 및 동적 매개 변수를 사용합니다.
청사진 시퀀싱 순서를 사용자 지정합니다.
청사진 리소스 잠금으로 배포를 보호합니다.
청사진을 코드로 관리합니다.

다음 단계

청사진 수명 주기에 대해 알아봅니다.
정적 및 동적 매개 변수 사용 방법 이해
청사진 시퀀싱 순서를 사용자 지정하는 방법 알아보기
청사진 리소스 잠금을 활용하는 방법 알아보기
일반 문제 해결 방법을 통해 청사진 할당 중에 발생하는 문제 해결

다음을 통해 공유