다음을 통해 공유


Terraform용 Azure 내보내기 개요

Terraform용 Azure Export는 Azure와 Terraform 개념 간의 변환 마찰을 줄이도록 설계된 도구입니다.

이점

Terraform용 Azure Export를 사용하면 다음을 수행할 수 있습니다.

  • Azure에서 Terraform으로의 마이그레이션을 간소화합니다. Terraform용 Azure Export를 사용하면 단일 명령을 사용하여 Azure 리소스를 Terraform으로 마이그레이션할 수 있습니다.
  • 단일 명령을 사용하여 사용자가 지정한 리소스 집합을 Terraform HCL 코드 및 상태로 내보냅니다. Terraform용 Azure Export를 사용하면 내보낼 미리 결정된 범위를 지정할 수 있습니다. 범위는 단일 리소스만큼 세분화될 수 있습니다. 리소스 그룹 및 해당 중첩된 리소스를 내보낼 수도 있습니다. 마지막으로 전체 구독을 내보낼 수 있습니다.
  • 노출된 모든 속성을 사용하여 기존 인프라를 검사합니다. 새로 릴리스된 리소스를 학습하든 프로덕션에서 문제를 조사하든 관계없이 Azure Export for Terraform은 구성 가능한 모든 리소스 속성을 노출하는 옵션을 사용하여 읽기 전용 내보내기를 지원합니다.
  • 계획/적용 워크플로를 따라 Terraform이 아닌 인프라를 Terraform에 통합합니다. HCL 코드를 내보내고, Terraform이 아닌 리소스를 검사하고, 프로덕션 인프라 및 원격 백 엔드에 쉽게 통합합니다.

설치

Terraform GitHub용 Azure 내보내기 페이지에다양한 플랫폼(Windows MSI, Homebrew 및 Linux 설치)에 대한 설치 링크와 소스 코드가 포함된 도구 릴리스가 나열되어 있습니다.

사용

가장 추상적인 Azure Export는 다음과 같이 호출됩니다.

aztfexport [command] [option] <scope>

사용 가능한 옵션 플래그 집합과 마찬가지로 실행 중인 명령에 따라 범위가 변경됩니다. 내보내려는 내용에 따라 사용해야 하는 세 가지 명령이 있습니다.

작업 설명 예시
단일 리소스를 내보냅니다. 단일 리소스를 내보내려면 리소스와 연결된 Azure resourceID를 지정합니다. aztfexport resource [option] <resource id>
리소스 그룹을 내보냅니다. 리소스 그룹(및 해당 중첩된 리소스)을 내보내려면 리소스 그룹 이름을 지정합니다. ID가 아닙니다. aztfexport resource-group [option] <리소스 그룹 이름>
쿼리를 사용하여 내보냅니다. 이 도구는 Azure Resource Graph 쿼리를 사용하여 내보내기를 지원합니다. aztfexport query [option] <ARG where predicate>

공급자

Azure Export는 기본적으로 공급자로 설정 azurerm 되지만 공급자를 내보AzAPI 낼 수도 있습니다.

aztfexport [command] --provider-name=azapi [further options] <scope>

데이터 수집 공개

기본적으로 Terraform용 Azure Export는 원격 분석 데이터를 수집합니다. 그러나 이 프로세스를 쉽게 사용하지 않도록 설정할 수 있습니다.

Microsoft는 수집된 데이터를 집계하여 일반적인 문제를 식별하고 Terraform용 Azure Export 환경을 개선하기 위해 사용 패턴을 식별합니다. 예를 들어 사용 데이터는 성공률이 낮은 명령과 같은 문제를 식별하고 작업의 우선 순위를 지정하는 데 도움이 됩니다. Terraform용 Azure Export는 개인 또는 개인 데이터를 수집하지 않습니다.

데이터 수집을 사용하지 않도록 설정하려면 도구를 설치한 후 다음 명령을 실행합니다.

aztfexport config set telemetry_enabled false

다음 단계

개념:

Terraform용 Azure 내보내기 개념: Terraform용 Azure Export의 워크플로와 모범 사례 및 현재 디자인 제한 사항에 대해 알아봅니다.

빠른 시작 문서:

방법 문서:

방법 문서에서는 설명 및 옵션과 함께 더 복잡한 시나리오를 설명합니다.