0Pricing
DevOps Bootcamp · 강의

Terraform 모듈 소개

일반적인 인프라 패턴을 캡슐화하고 재사용하여 코드 구성과 유지 관리성을 개선하는 모듈의 장점을 이해해 보세요.

Terraform 모듈 소개은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.

Terraform 모듈이란 무엇입니까?

Terraform 모듈은 Terraform 구성으로 이루어진 독립적인 패키지입니다. 프로그래밍 언어의 함수나 클래스와 비슷하다고 생각할 수 있습니다. 관련 리소스를 하나로 묶어 단일 단위로 관리할 수 있게 해 줍니다.

모듈을 사용하면 인프라 코드를 체계적으로 구성하고 더 쉽게 관리할 수 있으며, 특히 규모가 큰 프로젝트에서 유용합니다.

Terraform 모듈을 사용하는 이유

모듈은 코드로 관리하는 인프라에 다음과 같은 주요 이점을 제공합니다.

  • 재사용성: 인프라의 일부를 한 번 정의한 후 여러 프로젝트나 환경에서 반복하여 사용할 수 있습니다.
  • 구성: 복잡한 구성을 더 작고 관리하기 쉬운 논리적 구성 요소로 나눌 수 있습니다.
  • 일관성: 리소스가 매번 표준화된 방식으로 프로비저닝되도록 보장하여 구성 드리프트와 오류를 줄일 수 있습니다.
  • 협업: 팀이 모듈을 개발하고 공유하여 개발 속도를 높이고 표준을 유지할 수 있습니다.

모듈 구조 설명

Terraform 모듈은 기본적으로 하나 이상의 .tf 파일이 들어 있는 디렉터리입니다. 구조는 유연하지만 일반적으로 다음과 같이 구성합니다.

  • main.tf: 모듈이 생성하는 주요 리소스를 정의합니다.
  • variables.tf: 모듈의 동작을 사용자 지정하는 입력 변수를 선언합니다.
  • outputs.tf: 모듈이 호출한 쪽에 제공하는 출력 값을 정의합니다.
  • versions.tf: 모듈에 사용할 Terraform 및 공급자 버전 제약 조건을 지정합니다.

이처럼 체계적인 구조를 사용하면 코드를 깔끔하고 이해하기 쉽게 유지할 수 있습니다.

첫 번째 모듈 코드

AWS S3 버킷을 생성하는 매우 간단한 모듈을 정의해 보겠습니다. 일반적으로 이 코드는 modules/my_s3_bucket/main.tf와 같은 별도의 디렉터리에 저장합니다.

이 전체 파일을 루트 모듈로 실행하여 작동 방식을 확인할 수도 있지만, 여기서는 모듈의 내부 구조를 보여주는 것이 주된 목적입니다.

provider "aws" {
  region = "us-east-1" # Example region
}

variable "bucket_name" {
  description = "Name for the S3 bucket."
  type        = string
}

variable "acl_setting" {
  description = "ACL for the S3 bucket."
  type        = string
  default     = "private"
}

resource "aws_s3_bucket" "example_bucket" {
  bucket = var.bucket_name
  acl    = var.acl_setting

  tags = {
    Environment = "Dev" # Example tag
  }
}

output "bucket_id" {
  description = "The ID of the S3 bucket."
  value       = aws_s3_bucket.example_bucket.id
}

output "bucket_arn" {
  description = "The ARN of the S3 bucket."
  value       = aws_s3_bucket.example_bucket.arn
}

모듈 입력: 변수

입력 변수를 사용하면 핵심 코드를 변경하지 않고도 모듈의 동작을 사용자 지정할 수 있습니다. 입력 변수는 모듈 디렉터리의 variables.tf 파일에 정의합니다.

모듈을 호출할 때 이러한 변수에 값을 전달하면 다양한 시나리오와 환경에서 모듈을 매우 재사용하기 쉬워집니다. 함수의 인수와 비슷하다고 생각할 수 있습니다.

variable "bucket_name" {
  description = "Name for the S3 bucket."
  type        = string
}

variable "acl_setting" {
  description = "ACL for the S3 bucket."
  type        = string
  default     = "private"
}

모듈 출력: 데이터 노출

출력 값은 모듈을 호출하는 구성에 모듈의 데이터를 노출하는 데 사용합니다. 이를 통해 모듈이 생성한 리소스에 관한 중요한 정보에 액세스할 수 있습니다.

출력은 모듈 디렉터리의 outputs.tf 파일에 정의하며, Terraform 구성의 다른 부분이나 다른 모듈에서도 참조할 수 있습니다.

output "bucket_id" {
  description = "The ID of the S3 bucket."
  value       = aws_s3_bucket.example_bucket.id
}

output "bucket_arn" {
  description = "The ARN of the S3 bucket."
  value       = aws_s3_bucket.example_bucket.arn
}

사용자 지정 모듈 호출하기

이제 my_s3_bucket 모듈을 정의했으므로 루트 구성에서 호출해 보겠습니다. source 속성은 Terraform이 모듈을 찾을 위치를 지정합니다.

로컬 모듈의 경우 모듈 디렉터리로 가는 상대 경로를 지정합니다. 모듈의 입력 변수에 값을 전달하고 모듈이 노출한 출력에 액세스할 수 있습니다.

provider "aws" {
  region = "us-east-1"
}

module "my_website_bucket" {
  source      = "./modules/my_s3_bucket" # Path to your local module
  bucket_name = "my-unique-website-bucket-12345"
  acl_setting = "public-read"
}

output "website_bucket_arn" {
  description = "ARN of the website S3 bucket."
  value       = module.my_website_bucket.bucket_arn
}

output "website_bucket_id" {
  description = "ID of the website S3 bucket."
  value       = module.my_website_bucket.bucket_id
}

다양한 모듈 소스

모듈은 로컬에만 있는 것이 아닙니다! Terraform은 다양한 소스에서 모듈을 가져올 수 있으므로 유연하게 사용할 수 있습니다.

  • 로컬 경로: ./modules/my_module (예제에서 사용한 방식)
  • Terraform 레지스트리: hashicorp/vpc/aws (공개적으로 제공되는 모듈)
  • Git 저장소: git::https://example.com/repo.git
  • S3 버킷: s3::https://s3-us-west-2.amazonaws.com/example-bucket/module.zip

Terraform 레지스트리는 일반적인 인프라 패턴에 사용할 수 있도록 미리 구축되고 커뮤니티의 검증을 거친 모듈을 찾기에 좋은 곳입니다.

모듈이 가져오는 실질적인 효과

여러 환경(개발, 스테이징, 운영)에 걸쳐 수백 개의 리소스를 관리한다고 생각해 보세요. 모듈이 없다면 구성 파일이 방대하고 반복적으로 작성되어야 합니다.

모듈을 사용하면 "웹 서버"나 "데이터베이스" 패턴을 한 번 정의할 수 있습니다. 그런 다음 환경별 설정에 따라 서로 다른 변수를 전달하면서 각 인스턴스에 해당 모듈을 호출하기만 하면 됩니다. 이렇게 하면 오류가 크게 줄고 업데이트가 간소화되며 인프라의 확장성이 향상됩니다.

빠른 확인

Terraform 모듈의 구조와 이점을 학습하셨습니다. 이제 핵심적인 장점을 알고 있는지 확인해 보겠습니다.

복습 및 다음 단계

이 레슨에서는 인프라 코드를 구성하고 재사용하는 강력한 도구로 Terraform 모듈을 소개했습니다. 다음 내용을 학습하셨습니다.

  • 모듈은 리소스를 재사용 가능한 단위로 캡슐화합니다.
  • 코드 구성, 일관성, 재사용성을 향상합니다.
  • 모듈은 입력에 variables.tf를, 노출할 데이터에 outputs.tf를 사용합니다.
  • 로컬 경로, 레지스트리 또는 Git 저장소에서 모듈을 호출할 수 있습니다.

다음으로 직접 재사용 가능한 모듈을 만들고, 더 고급 패턴과 모범 사례를 살펴보겠습니다.

자주 묻는 질문

“Terraform 모듈 소개” 강의는 무료인가요?

네 — “Terraform 모듈 소개” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.

“Terraform 모듈 소개”에서 뭘 배우나요?

일반적인 인프라 패턴을 캡슐화하고 재사용하여 코드 구성과 유지 관리성을 개선하는 모듈의 장점을 이해해 보세요. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“Terraform 모듈 소개” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Terraform 모듈 소개
  2. 재사용 가능한 모듈 만들기
  3. 환경에 작업 공간 사용
  4. 레지스트리에 모듈 게시하기
← DevOps Bootcamp(으)로 돌아가기