moved 블록 참조

moved 블록 참조 (moved block reference)

이 주제는 moved 블록에 대한 참조 정보를 제공해요. 이 블록을 사용해 리소스의 주소를 프로그래밍 방식으로 변경하세요. Terraform 구성에서 moved 블록을 사용하는 방법에 대한 자세한 내용은 리팩터링 (Refactoring)을 참고하세요.

출처: 문서

본문

구성 모델 (Configuration model)

moved 블록은 다음 인자를 지원해요:

완전한 구성 (Complete configuration)

다음 moved 블록은 설정할 수 있는 모든 지원 내장 인자를 정의해요:

moved {
    from = <old address for the resource>
    to = <new address for the resource>
}

명세 (Specification)

이 섹션은 moved 블록에서 구성할 수 있는 필드에 대한 자세한 내용을 제공해요.

moved

moved 블록은 리소스의 이전 주소와 새 주소를 지정해요. 다음 표는 moved 블록에서 설정할 수 있는 인자를 설명해요.

인자 설명 타입 필수
from 리소스의 이전 주소를 지정해요. 문법은 Terraform이 모듈, 리소스 및 하위 모듈 내부의 리소스를 선택할 수 있게 해요. 문자열 필수
to 리소스를 재배치할 새 주소를 지정해요. 문법은 Terraform이 모듈, 리소스 및 하위 모듈 내부의 리소스를 선택할 수 있게 해요. 문자열 필수

to 필드에 지정된 리소스에 대한 새 plan을 만들기 전에 Terraform은 from 필드에 지정된 주소의 기존 객체를 state에서 확인해요. Terraform은 기존 객체를 to 필드에 지정된 문자열로 이름을 바꾼 다음 plan을 만들어요. 계획은 Terraform이 from 필드에 지정된 리소스를 to 필드에 지정된 리소스로 프로비저닝하도록 지시해요. 결과적으로 Terraform은 Terraform 실행 중에 리소스를 파괴하지 않아요.

예제 (Example)

다음 예제는 AWS 인스턴스를 주소 aws_instance.a에서 aws_instance.b로 이동해요:

moved {
  from = aws_instance.a
  to   = aws_instance.b
}

더 알아보기 (Learn more)