0Pricing
Terraform Infrastructure as Code · 강의

레지스트리에 모듈 게시하기

재사용 가능한 Terraform 모듈을 Git에서 버전 관리하고 공개 또는 비공개 모듈 레지스트리에 게시해 팀 간에 공유합니다.

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

로컬 모듈을 넘어서

로컬 모듈은 구성 파일 옆의 폴더에 있습니다. 여러 프로젝트와 팀에서 모듈을 공유하려면 모듈 레지스트리에 게시하십시오. 그러면 패키지 관리자처럼 사용자가 이름과 버전으로 모듈을 가져올 수 있습니다.

모듈 소스

source 인수는 Terraform이 모듈을 가져올 위치를 결정합니다. 다음과 같은 선택지가 있습니다.

  • 로컬 경로
  • Git 저장소
  • Terraform 공개 레지스트리
  • Terraform Cloud의 비공개 레지스트리

레지스트리 모듈 사용

레지스트리 모듈은 namespace/name/provider 형식을 사용합니다. 재현 가능한 빌드를 위해 항상 버전을 고정하십시오.

module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "5.1.2"

  name = "my-vpc"
  cidr = "10.0.0.0/16"
}

저장소 이름 지정 규칙

공개 레지스트리에는 특정 저장소 이름이 필요합니다. 바로 terraform-PROVIDER-NAME입니다. 예를 들어 AWS용 네트워크 모듈은 terraform-aws-network라는 이름의 저장소에 있어야 합니다.

표준 모듈 구조

게시 가능한 모듈은 레지스트리가 문서를 자동으로 생성할 수 있도록 예측 가능한 구조를 따릅니다.

terraform-aws-network/
  main.tf
  variables.tf
  outputs.tf
  README.md
  examples/
    basic/main.tf

입력 문서화

각 변수에는 description이 있어야 하며, 가능하면 type도 지정해야 합니다. 레지스트리는 이를 자동으로 문서화된 입력 표로 변환합니다.

variable "cidr" {
  type        = string
  description = "The CIDR block for the VPC"
  default     = "10.0.0.0/16"
}

Git 태그를 사용한 버전 관리

레지스트리는 시맨틱 버전 Git 태그에서 모듈 버전을 가져옵니다. 릴리스를 태그해야 사용자가 새 버전을 사용할 수 있습니다.

git tag v1.0.0
git push origin v1.0.0

Git 소스를 직접 고정하기

레지스트리를 거치지 않고 URL로 Git 저장소를 참조할 수도 있습니다. ref 쿼리 매개변수를 사용해 특정 태그에 고정하면 됩니다.

module "network" {
  source = "git::https://github.com/acme/terraform-aws-network.git?ref=v1.0.0"
  cidr   = "10.0.0.0/16"
}

비공개 레지스트리

Terraform Cloud와 Enterprise는 비공개 레지스트리를 제공합니다. 따라서 내부 모듈을 기밀로 유지하면서도 조직에서 동일한 이름 및 버전 방식으로 검색할 수 있습니다.

시맨틱 버전 제약 조건

안전한 업그레이드를 허용하려면 버전 제약 조건을 사용하십시오. ~> 연산자는 패치 및 마이너 버전의 상승은 허용하지만 호환성을 깨는 메이저 버전 변경은 허용하지 않습니다.

module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.1"
}

모듈 버전 새로 고침

버전 제약 조건을 변경한 후 terraform init -upgrade를 실행하여 허용되는 최신 버전을 가져오고 잠금 파일을 업데이트하십시오.

terraform init -upgrade

빠른 확인

모듈 버전 관리에 대한 이해도를 확인해 보세요.

복습: 모듈 공유

모듈을 게시하고 사용하는 방법을 배웠습니다.

  • terraform-PROVIDER-NAME 저장소 이름 지정 규칙
  • 입력과 출력이 문서화된 표준 구조
  • Git 태그가 결정하는 레지스트리 버전
  • 업그레이드를 안전하게 유지하는 ~>와 같은 버전 제약 조건

이제 재사용 가능한 모듈로 조직의 모든 프로젝트를 운영할 수 있습니다.

자주 묻는 질문

“레지스트리에 모듈 게시하기” 강의는 무료인가요?

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

“레지스트리에 모듈 게시하기”에서 뭘 배우나요?

재사용 가능한 Terraform 모듈을 Git에서 버전 관리하고 공개 또는 비공개 모듈 레지스트리에 게시해 팀 간에 공유합니다. 브라우저에서 직접 실행하는 실습 코드로 Terraform Infrastructure as Code을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Terraform Infrastructure as Code을(를) 시작하는 데 경험이 필요한가요?

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

“레지스트리에 모듈 게시하기” 강의는 얼마나 걸리나요?

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

이 Terraform Infrastructure as Code 강의에서 코드를 작성하고 실행할 수 있나요?

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

이 강의의 모든 강의

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