GitLab CI/CD는 프로젝트 루트의 .gitlab-ci.yml로 파이프라인을 정의하는 GitLab 내장 CI/CD다. 트리거가 생기면 Stage와 Job으로 이뤄진 Pipeline이 만들어지고, Runner가 Job을 실행한다. 기본 구조부터 변수와 시크릿, Runner, 파이프라인 구성, Job 제어, 외부 연동까지 다룬다.
핵심
- Pipeline은 트리거로 만들어지는 Stage와 Job의 집합이다. Stage는 Job을 묶어 실행 순서를 정하고, Job은 독립 환경에서 도는 실제 작업 단위이며,
script는 Job의 필수 항목이다. CD 시리즈 #1: 기초 - .gitlab-ci.yml의 구조와 Pipeline 이해 - 변수는 Predefined, 파일 정의, Project/Group 변수로 나뉜다. 우선순위는 Trigger > Job > Global > Project > Group > Instance 순이다. Protected 변수는 보호된 브랜치와 태그에서만 읽히고, Masked 변수는 로그에서 가려지며, Job 사이에 값을 넘길 때는 dotenv 아티팩트를 쓴다. CD 시리즈 #2: Variables와 Secrets 관리
- Runner는 Job을 실행하는 에이전트이고, Executor(Shell, Docker, Kubernetes)가 실행 환경을 정한다. 컨테이너 안에서 이미지를 빌드할 때는 TLS를 켠 Docker-in-Docker를 권장하고, 호스트 Docker 소켓 공유는 보안에 주의한다. Job과 Runner는 태그로 맞춘다. CD 시리즈 #3: Runners와 Executors - Docker-in-Docker 심화
- 큰 파이프라인은
include로 설정 파일을 나누고, Parent-Child Pipeline으로 동적 파이프라인을 만들고, Multi-Project Pipeline으로 다른 프로젝트를 트리거한다. CD 시리즈 #4: Pipeline 아키텍처 - Parent-Child와 Multi-Project rules는 조건부 실행,workflow:rules는 파이프라인 생성 여부,needs는 Stage를 건너뛰는 DAG 의존성,dependencies는 아티팩트 다운로드를 제어한다. 재사용은extends로 Job 템플릿을 상속하거나!reference로 필요한 키만 가져온다. CD 시리즈 #5: 고급 Job 제어 - rules, needs, DAG- 외부 시스템과는 Pipeline Trigger, Webhook, GitLab API, ChatOps로 연동하고, 정기 실행은 Scheduled Pipeline(cron)으로 건다. GitOps 도구와 묶을 때는 CI가 아티팩트를 만들고 CD는 GitOps 에이전트가 맡는다. CD 시리즈 #6: 외부 통합 - Triggers, Webhooks, API
시리즈 순서:
- 기초 - .gitlab-ci.yml의 구조와 Pipeline 이해
- Variables와 Secrets 관리
- Runners와 Executors - Docker-in-Docker 심화
- Pipeline 아키텍처 - Parent-Child와 Multi-Project
- 고급 Job 제어 - rules, needs, DAG
- 외부 통합 - Triggers, Webhooks, API