CI/CD 설정 가이드

SDD 프로젝트에 CI/CD를 통합하는 방법입니다.

빠른 시작

# GitHub Actions 설정
sdd cicd setup github

# 생성되는 파일:
# .github/workflows/sdd-validate.yml
# .github/workflows/sdd-labeler.yml

---

GitHub Actions

자동 설정

sdd cicd setup github

생성되는 워크플로우

1. sdd-validate.yml

PR 및 푸시 시 스펙을 자동 검증합니다.

트리거:

• .sdd/ 디렉토리 변경 시
• main, master, develop 브랜치

실행 내용:

• 스펙 검증 (sdd validate)
• Constitution 검증
• 영향도 리포트 생성

2. sdd-labeler.yml

PR에 자동으로 라벨을 추가합니다.

라벨 종류:

• spec:도메인명 - 변경된 도메인
• constitution - Constitution 변경 시
• spec:new - 새 스펙 추가
• spec:update - 스펙 수정
• spec:remove - 스펙 삭제

수동 설정

워크플로우를 직접 생성하려면:

# .github/workflows/sdd-validate.yml
name: SDD Validate

on:
  pull_request:
    paths:
      - '.sdd/**'

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install SDD
        run: npm install -g sdd-tool

      - name: Validate Specs
        run: sdd validate --ci

커스터마이징

엄격 모드

sdd cicd setup github --strict

경고도 에러로 처리합니다.

알림 추가

# 실패 시 Slack 알림
- name: Notify Slack on Failure
  if: failure()
  uses: slackapi/slack-github-action@v1
  with:
    payload: |
      {"text": "SDD 검증 실패: ${{ github.event.pull_request.html_url }}"}
  env:
    SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }}

---

GitLab CI

자동 설정

sdd cicd setup gitlab

생성 파일

.gitlab-ci-sdd.yml 파일이 생성됩니다.

기존 .gitlab-ci.yml에 include하세요:

# .gitlab-ci.yml
include:
  - local: '.gitlab-ci-sdd.yml'

---

상태 체크 설정

GitHub Branch Protection에 연동

1. Settings → Branches → main 규칙 편집
2. "Require status checks to pass" 활성화
3. 검색창에 Validate Specs 입력
4. 체크 추가

이제 스펙 검증을 통과해야만 PR 병합이 가능합니다.

필수 체크 목록

체크 이름	설명	권장
Validate Specs	스펙 검증	필수
Add Labels	라벨 추가	선택

---

Git Hooks 연동

로컬에서도 검증을 실행하려면:

# Git hooks 설치
sdd git hooks install

훅 종류

훅	시점	검증 내용
pre-commit	커밋 전	변경된 스펙만 검증
commit-msg	커밋 메시지 작성 후	메시지 형식 검증
pre-push	푸시 전	전체 스펙 검증

---

CI 환경 확인

CI 환경인지 확인:

# CI 환경에서 실행 (출력 간소화)
sdd validate --ci

# CI 체크
sdd cicd check
sdd cicd check --strict

---

문제 해결

"Status check not found"

상태 체크가 보이지 않으면:

1. 워크플로우가 최소 1번 실행되어야 함
2. .sdd/ 경로 변경이 포함된 PR 생성
3. 워크플로우 파일 이름 확인

검증 실패

# 로컬에서 먼저 검증
sdd validate

# 상세 출력
sdd validate --verbose

권한 오류

GitHub Actions에서 라벨 추가 실패 시:

1. Settings → Actions → General
2. "Workflow permissions" 섹션
3. "Read and write permissions" 선택

---

관련 문서

• 커밋 컨벤션
• 브랜치 전략
• Git Hooks 설정