기존 리소스 가져오기

때로는 수동으로 만들었거나 다른 도구로 생성한 클라우드 리소스가 있을 수 있습니다. Terraform 가져오기를 사용하면 이러한 기존 리소스를 Terraform의 관리 대상에 포함할 수 있습니다.

이제 Terraform이 해당 리소스의 상태를 추적하고, 향후 변경 사항을 구성 파일을 통해 적용할 수 있다는 뜻입니다. 이는 "브라운필드" 환경에서 코드형 인프라(IaC)를 도입하기 위한 핵심 단계입니다.

가져오기는 다음과 같은 상황에서 유용합니다.

• 기존 인프라 마이그레이션: Terraform 외부에서 생성한 리소스를 IaC 작업 흐름에 포함합니다.
• Terraform의 점진적 도입: 모든 것을 다시 만들지 않고 기존 리소스부터 시작합니다.
• 상태 손실 복구: 상태 파일을 잃어버린 경우 Terraform과 리소스의 연결을 다시 설정합니다(원격 상태를 사용하면 이런 일은 드뭅니다).

terraform import 명령어의 기본 구조는 간단합니다. 이 명령어는 클라우드 제공업체에서 기존 리소스를 찾아 상태 파일에 추가하고, 구성의 리소스 블록과 연결하도록 Terraform에 지시합니다.

여기에는 두 가지 주요 정보가 필요합니다. 리소스의 Terraform 주소와 해당 리소스에 대한 클라우드 제공업체의 ID입니다.

리소스 주소는 Terraform이 구성 내 특정 리소스를 식별하는 방식입니다. 다음 패턴을 따릅니다: resource_type.resource_name.

• resource_type: 리소스 유형입니다(예: aws_s3_bucket, azurerm_resource_group).
• resource_name: Terraform 구성에서 리소스에 지정하는 로컬 이름입니다(예: my_bucket, web_app).

이 주소는 .tf 파일에 이미 존재해야 합니다.

클라우드 제공업체(AWS, Azure, GCP 등)의 모든 리소스에는 흔히 ID라고 부르는 고유 식별자가 있습니다. Terraform에 가져올 기존 리소스가 정확히 무엇인지 알려면 이 ID가 필요합니다.

이 ID는 클라우드 제공업체의 콘솔이나 CLI, API를 통해 찾을 수 있습니다. 예를 들어 AWS S3 버킷의 ID는 버킷 이름이고, EC2 인스턴스에는 i-0abcdef1234567890과 같은 인스턴스 ID가 있습니다.

중요한 단계: terraform import를 실행하기 전에 Terraform 구성 파일(.tf 파일)에 이에 대응하는 리소스 블록을 정의해야 합니다.

이 블록은 Terraform에 예상되는 리소스 유형과 리소스가 가져야 할 ATTRIBUTE를 알려 줍니다. Terraform은 가져오기 중 이 정의를 사용하여 리소스의 스키마를 파악합니다.

이름이 my-existing-coddykit-bucket-123인 기존 AWS S3 버킷이 있다고 가정해 보겠습니다. 먼저 main.tf에 해당 리소스 블록을 정의하세요.

이제 HCL 정의가 있으므로 terraform import 명령어를 실행할 수 있습니다. my-existing-coddykit-bucket-123을 기존 버킷의 실제 이름/ID로 바꾸세요.

디렉터리에서 이미 terraform init을 실행했는지 확인하세요!

가져오기가 성공하면 Terraform이 해당 리소스를 상태 파일에 추가합니다. terraform state show를 사용하면 이를 확인할 수 있으며, 이 명령어는 Terraform이 인식하는 가져온 리소스의 ATTRIBUTE를 표시합니다.

그런 다음 반드시 terraform plan을 실행하여 HCL과 가져온 리소스의 실제 상태 사이에 예상하지 못한 차이가 없는지 확인하세요.

기존 AWS EC2 인스턴스를 Terraform으로 가져오려고 합니다. terraform import 명령어를 실행하기 전에 다음 중 어떤 단계를 반드시 완료해야 하나요?

terraform import를 사용하여 기존 클라우드 리소스를 Terraform의 관리 대상에 포함하는 방법을 배웠습니다.

• 먼저 HCL에 리소스 블록을 정의합니다.
• 그다음 클라우드 제공업체의 리소스 ID를 확인합니다.
• 마지막으로 terraform import ADDRESS ID를 실행합니다.
• 항상 terraform plan을 실행하여 차이를 조정하세요.

이 강력한 명령어는 수동으로 관리하는 인프라와 완전히 IaC를 기반으로 하는 환경 사이의 간극을 메워 줍니다.