terraform destroy
작업 활성화- 작업에서 사용자 정의
terraform
명령 실행 - 작업에 사용자 정의 디버그 도구 추가
- 커스텀 컨테이너 이미지 추가
- 기본 브랜치에서 자동으로 배포
- 여러 환경에 Terraform 배포
Terraform 템플릿 레시피
경고: Terraform CI/CD 템플릿은 폐지되어 GitLab 18.0에서 제거될 예정입니다. 자세한 내용은 폐지 안내를 참조하십시오.
이 페이지에 나열된 레시피를 파이프라인에 추가하여 Terraform 통합을 사용자 정의할 수 있습니다.
자신의 Terraform 구성을 공유하려면 해당 페이지에 레시피를 기여해보세요.
terraform destroy
작업 활성화
다음 스니펫을 .gitlab-ci.yml
에 추가하세요.
include:
- template: Terraform.latest.gitlab-ci.yml
destroy:
extends: .terraform:destroy
destroy
작업은 cleanup
단계의 일부입니다. deploy
작업과 마찬가지로 destroy
작업은 항상 manual
이며 기본 브랜치에 연결되어 있지 않습니다.
destroy
작업을 GitLab 환경에 연결하려면:
include:
- template: Terraform.latest.gitlab-ci.yml
deploy:
environment:
name: $TF_STATE_NAME
action: start
on_stop: destroy
destroy:
extends: .terraform:destroy
environment:
name: $TF_STATE_NAME
action: stop
이 설정에서 destroy
작업은 항상 생성됩니다. 그러나 특정 조건을 만족하는 경우에만 destroy
작업을 만들고 싶을 수 있습니다.
다음 구성은 TF_DESTROY
가 true일 때만 destroy
작업을 생성하고, destroy 계획을 실행하며 deploy
작업을 생략합니다:
include:
- template: Terraform.latest.gitlab-ci.yml
build:
rules:
- if: $TF_DESTROY == "true"
variables:
TF_CLI_ARGS_plan: "-destroy"
- when: on_success
deploy:
environment:
name: $TF_STATE_NAME
action: start
on_stop: destroy
rules:
- if: $TF_DESTROY == "true"
when: never
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $TF_AUTO_DEPLOY == "true"
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
when: manual
destroy:
extends: .terraform:destroy
dependencies:
- build
variables:
TF_CLI_ARGS_destroy: "${TF_PLAN_CACHE}"
environment:
name: $TF_STATE_NAME
action: stop
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH && $TF_DESTROY == "true"
when: manual
이 구성에는 알려진 문제점이 있습니다. destroy
작업이 deploy
작업과 같은 파이프라인에 없을 때 on_stop
환경 액션이 작동하지 않습니다.
작업에서 사용자 정의 terraform
명령 실행
사용자 정의 terraform
명령을 실행하는 작업을 정의하려면 gitlab-terraform
래퍼를 사용할 수 있습니다:
include:
- template: Terraform.latest.gitlab-ci.yml
state-list:
stage: validate # 원하는 스테이지를 사용할 수 있지만, 정의해야 합니다
script: gitlab-terraform state list
gitlab-terraform
명령은 terraform
명령을 설정하고 주어진 인수로 실행합니다.
이 작업을 Terraform 상태별 리소스 그룹에서 실행하려면 작업에 resource_group
을 할당하세요:
include:
- template: Terraform.latest.gitlab-ci.yml
state-list:
stage: validate # 원하는 스테이지를 사용할 수 있지만, 정의해야 합니다
resource_group: ${TF_STATE_NAME}
script: gitlab-terraform state list
작업에 사용자 정의 디버그 도구 추가
Terraform 템플릿 작업에서 사용하는 기본 이미지에는 최소한의 도구만 포함되어 있습니다. 그러나 디버깅을 위해 추가 도구를 추가하고 싶을 수 있습니다.
추가 도구를 추가하려면:
- 작업 또는 파이프라인의
before_script
에 도구를 설치합니다. -
script
또는after_script
블록에서 도구를 사용합니다.-
script
블록을 사용하는 경우에는 템플릿 작업 명령을 다시 추가해야 합니다.
-
예를 들어, 다음 스니펫은 모든 작업에 대해 bash
와 jq
를 before_script
에 설치합니다:
include:
- template: Terraform.latest.gitlab-ci.yml
default:
before_script: apk add --update bash jq
build
및 deploy
작업에만 추가하려면 해당 작업에 직접 추가하세요:
include:
- template: Terraform.latest.gitlab-ci.yml
build:
before_script: apk add --update bash jq
deploy:
before_script: apk add --update bash jq
커스텀 컨테이너 이미지 추가
디버그 도구 및 간단한 설치를 위해
작업에 커스텀 디버그 도구를 추가
해야합니다. 도구가 복잡하거나 캐싱이 이점이 있는 경우
gitlab-terraform
이미지를 기반으로 사용자 정의 컨테이너 이미지를 만들 수 있습니다.
나중에 이 커스텀 이미지를 Terraform 작업에서 사용할 수 있습니다.
사용자 정의 컨테이너 이미지를 정의하려면:
-
사용자 정의 도구가 포함된 새
Dockerfile
을 정의하세요. 예를 들어,.gitlab/ci/Dockerfile
에bash
와jq
를 설치하세요.FROM registry.gitlab.com/gitlab-org/terraform-images/stable:latest RUN apk add --update bash jq
- 새 작업에서
Dockerfile
이 변경될 때마다 이미지를 빌드하는준비
단계를 정의하세요.- 빌드된 이미지는 GitLab 컨테이너 레지스트리에 푸시됩니다. 이미지가 병합 요청에서 생성되었는지 또는 기본 브랜치에서 생성되었는지 여부를 나타내는 태그가 적용됩니다.
- Terraform 작업에서 이미지를 사용하세요.
build
및deploy
와 같은 특수한before_script
구성과 결합하여 Terraform의 입력을 생성하는 등의 설정 명령을 수행할 수 있습니다.
예를 들어, 완전히 작동하는 파이프라인 구성은 다음과 같습니다:
include:
- template: Terraform.latest.gitlab-ci.yml
variables:
IMAGE_TAG: latest
workflow:
rules:
- if: $CI_MERGE_REQUEST_IID
changes:
- .gitlab/ci/Dockerfile
variables:
IMAGE_TAG: ${CI_COMMIT_REF_SLUG}
- when: always
stages:
- prepare
- validate
- test
- build
- deploy
- cleanup
prepare:image:
needs: []
stage: prepare
image:
name: gcr.io/kaniko-project/executor:v1.9.0-debug
entrypoint: [""]
rules:
# MR에 있을 경우 커밋 SHA로 태그 지정
- if: $CI_MERGE_REQUEST_IID
changes:
- .gitlab/ci/Dockerfile
variables:
DOCKER_TAG: $CI_COMMIT_REF_SLUG
# 기본 브랜치에서 "latest"로 태그 지정
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
changes:
- .gitlab/ci/Dockerfile
variables:
DOCKER_TAG: latest
before_script:
# Docker 레지스트리 및 종속성 프록시에 인증
- echo "{\"auths\":{\"$CI_REGISTRY\":{\"auth\":\"$(printf "%s:%s" "${CI_REGISTRY_USER}" "${CI_REGISTRY_PASSWORD}" | base64 | tr -d '\n')\"}}}" > /kaniko/.docker/config.json
script:
- /kaniko/executor
--context "${CI_PROJECT_DIR}/.gitlab/ci"
--cache=true
--dockerfile "${CI_PROJECT_DIR}/.gitlab/ci/Dockerfile"
--destination "${CI_REGISTRY_IMAGE}:${DOCKER_TAG}"
build:
image: ${CI_REGISTRY_IMAGE}:${IMAGE_TAG}
deploy:
image: ${CI_REGISTRY_IMAGE}:${IMAGE_TAG}
예제 저장소는 GitLab Terraform 템플릿 사용 프로젝트를 참조하십시오.
기본 브랜치에서 자동으로 배포
TF_AUTO_DEPLOY
변수를 "true"
로 설정하여 기본 브랜치에서 자동으로 배포할 수 있습니다. 다른 모든 값은 "false"
로 해석됩니다.
variables:
TF_AUTO_DEPLOY: "true"
include:
- template: Terraform.latest.gitlab-ci.yml
여러 환경에 Terraform 배포
고유한 Terraform 상태를 갖는 여러 환경에서 파이프라인을 실행할 수 있습니다.
stages:
- validate
- test
- build
- deploy
include:
- template: Terraform/Base.latest.gitlab-ci.yml
- template: Jobs/SAST-IaC.latest.gitlab-ci.yml
variables:
# x로 설정하여 환경 작업에서 TF_STATE_NAME이 비어 있지 않도록 합니다.
# https://gitlab.com/groups/gitlab-org/-/epics/7437를 기다립니다(변수 기본값 사용)
TF_STATE_NAME: x${CI_ENVIRONMENT_NAME}
TF_CLI_ARGS_plan: "-var-file=vars/${CI_ENVIRONMENT_NAME}.tfvars"
fmt:
extends: .terraform:fmt
validate:
extends: .terraform:validate
plan dev:
extends: .terraform:build
environment:
name: dev
plan prod:
extends: .terraform:build
environment:
name: prod
apply dev:
extends: .terraform:deploy
environment:
name: dev
apply prod:
extends: .terraform:deploy
environment:
name: prod
이 구성은 기본 GitLab 템플릿에서 수정되었습니다.