Terraform과 GitLab을 사용한 인프라스트럭처 자동화

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitLab으로 인프라스트럭처를 관리하기 위해, Terraform과의 통합을 사용하여 버전을 지정하고, 재사용하고, 공유할 수 있는 리소스를 정의할 수 있습니다.

  • 컴퓨팅, 저장 및 네트워킹 리소스와 같은 저수준 컴포넌트를 관리합니다.
  • DNS 항목 및 SaaS 기능과 같은 고수준 컴포넌트를 관리합니다.
  • GitOps 배포 및 IaC(Infrastructure-as-Code) 워크플로를 통합합니다.
  • GitLab을 Terraform 상태 저장 공간으로 사용합니다.
  • 공통 및 복잡한 인프라스트럭처 패턴을 단순화하기 위해 Terraform 모듈을 저장하고 사용합니다.

기능에 대한 GitLab 통합 개요 영상을 시청하세요.

Terraform 및 OpenTofu 지원

GitLab은 Terraform 및 OpenTofu와 모두 통합됩니다. 대부분의 기능이 완전히 호환되며 다음을 포함합니다.

단순함을 위해 GitLab 문서는 주로 Terraform을 참조합니다. 그러나 Terraform 및 OpenTofu 통합 사이의 차이점은 문서화되어 있습니다.

프로젝트를 Terraform과 통합

  • IaC 스캐닝은 GitLab 14.6에서 소개되었습니다.
caution
Terraform CI/CD 템플릿은 폐기되며 GitLab 18.0에서 제거될 예정입니다. 자세한 내용은 폐기 알림을 참조하세요.

GitLab 및 Terraform과의 통합은 GitLab CI/CD를 통해 이루어집니다. 프로젝트에 Terraform 템플릿을 추가하고 해당 내용을 사용자 정의합니다.

시작하려면, 당신의 요구를 가장 잘 충족하는 템플릿을 선택하세요.

모든 템플릿:

  • GitLab에서 관리되는 Terraform 상태를 Terraform 상태 저장 백엔드로 사용합니다.
  • test, validate, build, deploy 네 가지 파이프라인 단계를 실행합니다.
  • test, validate, plan 및 plan-json Terraform 명령을 실행합니다. 또한 apply는 기본 브랜치에서만 실행됩니다.
  • IaC 스캐닝을 사용하여 보안 문제를 확인합니다.

최신 Terraform 템플릿 (폐기됨)

최신 템플릿은 가장 최근의 GitLab 버전과 호환됩니다. 최신 GitLab 기능을 제공하지만 잠재적으로 호환성이 없을 수 있습니다.

최신 Terraform 템플릿은 안전하게 사용할 수 있습니다:

  • GitLab.com을 사용하는 경우.
  • 모든 새로운 GitLab 릴리스와 함께 Self-managed되는 인스턴스를 사용하는 경우.

안정적이고 고급 Terraform 템플릿 (폐기됨)

이전 버전의 GitLab을 사용하는 경우, GitLab 버전과 템플릿 버전 간의 호환성 오류가 발생할 수 있습니다. 이 경우 다음 템플릿 중 하나를 사용할 수 있습니다:

note
각 GitLab 주요 릴리스(예: 15.0)마다 최신 템플릿이 이전 템플릿을 대체합니다. 이 과정은 호환성이 없을 수 있습니다. 필요한 경우 템플릿의 이전 버전을 사용할 수 있습니다.

Terraform 템플릿 사용 (폐기됨)

Terraform 템플릿을 사용하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 Terraform과 통합하려는 프로젝트를 찾습니다.
  2. 코드 > 리포지터리를 선택합니다.

  3. .gitlab-ci.yml 파일을 편집하고 include 속성을 사용하여 Terraform 템플릿을 가져옵니다: 

    include:
 # 최신 템플릿을 가져오려면 다음을 사용하세요:
  - template: Terraform.latest.gitlab-ci.yml
 # 고급 최신 템플릿을 가져오려면 다음을 사용하세요:
  - template: Terraform/Base.latest.gitlab-ci.yml
 # 안정적인 템플릿을 가져오려면 다음을 사용하세요:
  - template: Terraform.gitlab-ci.yml
 # 고급 안정적인 템플릿을 가져오려면 다음을 사용하세요:
  - template: Terraform/Base.gitlab-ci.yml

  4. 다음과 같이 변수를 추가합니다: 

    variables:
  TF_STATE_NAME: default
  # 만약 terraform 파일이 하위 디렉터리에 있다면, TF_ROOT를 그에 맞게 설정하세요. 예를 들어:
  # TF_ROOT: terraform/production
  5. 선택 사항. 가져온 템플릿에서 사용자 정의할 수 있는 내용을 자신의 .gitlab-ci.yml 파일에서 재정의합니다.

자체 Terraform CI/CD 템플릿 빌드 및 호스팅

GitLab은 더 이상 Terraform CI/CD 템플릿 및 terraform-images (기본 작업 이미지, terraform를 포함)을 배포하지 않지만, 여전히 GitLab 파이프라인에서 Terraform을 사용할 수 있습니다.

자체 템플릿 및 이미지를 빌드 및 호스팅하는 방법을 알아보려면 Terraform Images 프로젝트를 참조하세요.

Terraform 템플릿 레시피

GitLab이 제공하는 템플릿 레시피는 Terraform 템플릿 레시피를 참조하세요.

프로젝트를 OpenTofu와 통합

OpenTofu는 GitLab OpenTofu CI/CD 컴포넌트를 사용하여 Terraform 특정 GitLab 기능과 모두 통합될 수 있습니다.

컴포넌트를 포함하여 파이프라인에 validate, plan, apply 워크플로를 추가할 수 있습니다. 

include:
  - component: gitlab.com/components/opentofu/validate-plan-apply@<VERSION>
    inputs:
      version: <VERSION>
      opentofu_version: <OPENTOFU_VERSION>
      root_dir: terraform/
      state_name: production

stages: [validate, build, deploy]

자세한 정보와 사용 가능한 템플릿 및 입력에 대한 자세한 내용은 OpenTofu CI/CD 컴포넌트 README를 참조하세요.

관련 주제