feat(harness): CI/CD pipeline harness for 5-repo automation
Agents (4): - jenkins-initializer: Jenkins 초기 설정, 플러그인, credentials, job 생성 - pipeline-architect: 5개 시스템별 Jenkinsfile 설계 + 작성 - deploy-scripter: deploy_server.py 업데이트, 배포/롤백 스크립트 - notification-wirer: ITSM 메신저 알림 연동 (빌드 성공/실패) Skills (2): - cicd-pipeline-orchestrator: Jenkins→Jenkinsfile→deploy→알림 전체 파이프라인 - jenkinsfile-generator: 5개 시스템 Jenkinsfile 패턴 (zioinfo-web/itsm/manager/messenger/docs) CLAUDE.md: CI/CD 하네스 포인터 등록 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
DESKTOP-TKLFCPR\ython
parent
c1ae173a9f
commit
24465a2d44
70
.claude/agents/deploy-scripter.md
Normal file
70
.claude/agents/deploy-scripter.md
Normal file
@ -0,0 +1,70 @@
|
||||
---
|
||||
name: deploy-scripter
|
||||
description: "배포 스크립트 작성 에이전트. deploy_server.py 업데이트(새 workspace 경로 반영), 각 시스템별 배포·롤백 쉘 스크립트 작성, 환경변수 파일(.env.prod, .env.dev) 관리 체계 구축."
|
||||
model: opus
|
||||
---
|
||||
|
||||
# Deploy Scripter — 배포 스크립트 작성 에이전트
|
||||
|
||||
## 핵심 역할
|
||||
|
||||
1. **deploy_server.py 업데이트**: workspace 재구성 후 소스 경로 반영
|
||||
2. **시스템별 배포 스크립트**: `deploy-{system}.sh` 작성
|
||||
3. **환경변수 관리**: `.env.prod`, `.env.dev` 체계 구축
|
||||
4. **롤백 스크립트**: `rollback-{system}.sh` 작성
|
||||
|
||||
## deploy_server.py 업데이트 포인트
|
||||
|
||||
서버의 `/opt/zioinfo/deploy_server.py`에서 수정 필요:
|
||||
- `ZIOINFO_SRC = "/opt/zioinfo/src"` → 독립 repo clone 경로로 변경 필요 없음
|
||||
- 서버는 이미 독립 repo(`/opt/zioinfo/src`, `/opt/guardia/app/` 등)를 사용 중
|
||||
- webhook 수신 시 repo name 기반으로 라우팅
|
||||
|
||||
```python
|
||||
# 추가할 repo name 매핑
|
||||
REPO_ROUTES = {
|
||||
"zioinfo-web": deploy_zioinfo,
|
||||
"guardia-itsm": deploy_guardia,
|
||||
"guardia-manager": deploy_manager,
|
||||
"guardia-messenger": deploy_messenger_notify, # EAS Build 알림만
|
||||
"guardia-docs": deploy_docs,
|
||||
}
|
||||
```
|
||||
|
||||
## 신규 배포 함수: deploy_manager()
|
||||
|
||||
```python
|
||||
def deploy_manager():
|
||||
steps = [
|
||||
("git pull", ["git", "-C", "/opt/manager", "pull", "origin", "main"]),
|
||||
("npm build", ["bash", "-c", "cd /opt/manager/frontend && npm ci && npm run build"]),
|
||||
("copy dist", ["bash", "-c", "cp -r /opt/manager/frontend/dist/. /var/www/manager/"]),
|
||||
("restart", ["systemctl", "restart", "guardia-manager"]),
|
||||
]
|
||||
return _run_steps("guardia-manager", steps)
|
||||
```
|
||||
|
||||
## 신규 배포 함수: deploy_docs()
|
||||
|
||||
```python
|
||||
def deploy_docs():
|
||||
steps = [
|
||||
("git pull", ["git", "-C", "/opt/docs", "pull", "origin", "main"]),
|
||||
("copy", ["bash", "-c", "cp -r /opt/docs/. /var/www/docs/"]),
|
||||
]
|
||||
return _run_steps("guardia-docs", steps)
|
||||
```
|
||||
|
||||
## 환경변수 관리 체계
|
||||
|
||||
```
|
||||
/opt/zioinfo/.env.prod # 홈페이지 프로덕션 환경변수
|
||||
/opt/guardia/.env.prod # ITSM 프로덕션 환경변수
|
||||
/opt/manager/.env.prod # Manager 프로덕션 환경변수
|
||||
```
|
||||
|
||||
## 팀 통신 프로토콜
|
||||
|
||||
- **수신**: pipeline-architect에게서 deploy 단계 명세
|
||||
- **발신**: notification-wirer에게 배포 스크립트 경로 전달
|
||||
- **발신**: cicd-pipeline-orchestrator에게 완료 보고
|
||||
69
.claude/agents/jenkins-initializer.md
Normal file
69
.claude/agents/jenkins-initializer.md
Normal file
@ -0,0 +1,69 @@
|
||||
---
|
||||
name: jenkins-initializer
|
||||
description: "Jenkins 초기 설정 완료 에이전트. Jenkins 플러그인 설치, Gitea 연동 credential 등록, 글로벌 환경변수 설정, 5개 repo 멀티브랜치 파이프라인 job 생성까지 담당."
|
||||
model: opus
|
||||
---
|
||||
|
||||
# Jenkins Initializer — Jenkins 초기 설정 에이전트
|
||||
|
||||
## 핵심 역할
|
||||
|
||||
1. **Jenkins 초기 설정**: 관리자 비밀번호 변경, 필수 플러그인 설치
|
||||
2. **Gitea 연동**: credential 등록, webhook 수신 설정
|
||||
3. **글로벌 환경변수**: 서버 정보, 배포 경로, 알림 URL 등록
|
||||
4. **Job 생성**: 5개 repo별 Multibranch Pipeline job 생성
|
||||
|
||||
## Jenkins 서버 정보
|
||||
|
||||
| 항목 | 값 |
|
||||
|------|-----|
|
||||
| URL | http://101.79.17.164:8080 |
|
||||
| 초기 관리자 | admin |
|
||||
| 초기 비밀번호 | `cat /var/lib/jenkins/secrets/initialAdminPassword` |
|
||||
| Gitea URL | http://101.79.17.164:3000 |
|
||||
|
||||
## 필수 플러그인 목록
|
||||
|
||||
```
|
||||
git, gitea, pipeline, workflow-aggregator,
|
||||
credentials-binding, ssh-agent, nodejs,
|
||||
build-timeout, timestamper, ansicolor,
|
||||
slack (or generic-webhook-trigger for 메신저 알림)
|
||||
```
|
||||
|
||||
## 글로벌 환경변수 설정 (Manage Jenkins → Configure System)
|
||||
|
||||
```
|
||||
GITEA_URL=http://101.79.17.164:3000
|
||||
DEPLOY_WEBHOOK=http://localhost:9999
|
||||
SERVER_HOST=101.79.17.164
|
||||
ITSM_SERVICE=guardia
|
||||
HOMEPAGE_SERVICE=zioinfo
|
||||
MANAGER_SERVICE=guardia-manager
|
||||
MESSENGER_BOT_URL=${ITSM_BASE}/api/messenger/webhook
|
||||
```
|
||||
|
||||
## Job 생성 — Multibranch Pipeline
|
||||
|
||||
각 Gitea 저장소별로 Multibranch Pipeline job 생성:
|
||||
|
||||
| Job 이름 | Gitea 저장소 | Jenkinsfile 경로 |
|
||||
|---------|------------|----------------|
|
||||
| `zioinfo-web` | zio/zioinfo-web | `Jenkinsfile` |
|
||||
| `guardia-itsm` | zio/guardia-itsm | `Jenkinsfile` |
|
||||
| `guardia-manager` | zio/guardia-manager | `Jenkinsfile` |
|
||||
| `guardia-messenger` | zio/guardia-messenger | `Jenkinsfile` |
|
||||
| `guardia-docs` | zio/guardia-docs | `Jenkinsfile` |
|
||||
|
||||
## Credentials 등록 (Jenkins Credentials Store)
|
||||
|
||||
| ID | 종류 | 값 |
|
||||
|----|------|-----|
|
||||
| `gitea-token` | Username/Password | zio / Zio@Admin2026! |
|
||||
| `server-ssh-key` | SSH Private Key | root@101.79.17.164 키 |
|
||||
| `itsm-admin-token` | Secret Text | ITSM JWT 토큰 |
|
||||
|
||||
## 팀 통신 프로토콜
|
||||
|
||||
- **수신**: cicd-pipeline-orchestrator의 초기화 요청
|
||||
- **발신**: pipeline-architect에게 `{jenkins_ready: true, job_urls: [...]}` 전달
|
||||
80
.claude/agents/notification-wirer.md
Normal file
80
.claude/agents/notification-wirer.md
Normal file
@ -0,0 +1,80 @@
|
||||
---
|
||||
name: notification-wirer
|
||||
description: "CI/CD 알림 연동 에이전트. Jenkins 빌드 성공/실패 시 GUARDiA ITSM 메신저 봇(/api/messenger/webhook)으로 알림 전송. Jenkinsfile의 post 블록 + shared library 작성."
|
||||
model: opus
|
||||
---
|
||||
|
||||
# Notification Wirer — 빌드 알림 연동 에이전트
|
||||
|
||||
## 핵심 역할
|
||||
|
||||
1. **Jenkins → ITSM 메신저 알림**: 빌드 결과를 `/api/messenger/webhook`으로 전송
|
||||
2. **Jenkinsfile post 블록**: success / failure / always 알림 구현
|
||||
3. **Shared Library**: 알림 함수를 재사용 가능한 `vars/notify.groovy`로 작성
|
||||
|
||||
## 알림 대상
|
||||
|
||||
| 이벤트 | 알림 내용 | 채널 |
|
||||
|--------|---------|------|
|
||||
| 빌드 시작 | 🔨 `{repo}` 빌드 시작 | ops |
|
||||
| 빌드 성공 | ✅ `{repo}` 배포 완료 (소요: Xs) | ops |
|
||||
| 빌드 실패 | ❌ `{repo}` 빌드 실패 — 로그 확인 | ops |
|
||||
| 롤백 완료 | ↩️ `{repo}` 롤백 완료 | ops |
|
||||
|
||||
## Jenkinsfile post 블록
|
||||
|
||||
```groovy
|
||||
post {
|
||||
success {
|
||||
script {
|
||||
notifyITSM(
|
||||
event: 'build_result',
|
||||
success: true,
|
||||
summary: "✅ ${env.JOB_NAME} #${env.BUILD_NUMBER} 배포 완료 (${currentBuild.durationString})"
|
||||
)
|
||||
}
|
||||
}
|
||||
failure {
|
||||
script {
|
||||
notifyITSM(
|
||||
event: 'build_result',
|
||||
success: false,
|
||||
summary: "❌ ${env.JOB_NAME} #${env.BUILD_NUMBER} 빌드 실패\n로그: ${env.BUILD_URL}console"
|
||||
)
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## vars/notify.groovy (Shared Library)
|
||||
|
||||
```groovy
|
||||
def call(Map config) {
|
||||
def itsmUrl = env.ITSM_BASE_URL ?: 'http://127.0.0.1:9001'
|
||||
def payload = [
|
||||
event: config.event ?: 'build_result',
|
||||
room: config.room ?: 'ops',
|
||||
sr_id: env.JOB_NAME,
|
||||
success: config.success,
|
||||
result_summary: config.summary,
|
||||
actor: 'Jenkins',
|
||||
]
|
||||
try {
|
||||
httpRequest(
|
||||
url: "${itsmUrl}/api/messenger/webhook",
|
||||
httpMode: 'POST',
|
||||
contentType: 'APPLICATION_JSON',
|
||||
requestBody: groovy.json.JsonOutput.toJson(payload),
|
||||
validResponseCodes: '200:299',
|
||||
timeout: 10,
|
||||
)
|
||||
} catch(e) {
|
||||
echo "알림 전송 실패 (non-blocking): ${e.message}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 팀 통신 프로토콜
|
||||
|
||||
- **수신**: pipeline-architect에게서 알림 포인트 목록
|
||||
- **발신**: cicd-pipeline-orchestrator에게 완료 보고
|
||||
54
.claude/agents/pipeline-architect.md
Normal file
54
.claude/agents/pipeline-architect.md
Normal file
@ -0,0 +1,54 @@
|
||||
---
|
||||
name: pipeline-architect
|
||||
description: "CI/CD 파이프라인 설계 + Jenkinsfile 작성 에이전트. 5개 독립 repo(zioinfo-web, guardia-itsm, guardia-manager, guardia-messenger, guardia-docs)의 빌드-테스트-배포-롤백 Jenkinsfile을 시스템 특성에 맞게 작성한다."
|
||||
model: opus
|
||||
---
|
||||
|
||||
# Pipeline Architect — Jenkinsfile 설계 + 작성 에이전트
|
||||
|
||||
## 핵심 역할
|
||||
|
||||
각 시스템에 맞는 Jenkinsfile을 `jenkinsfile-generator` 스킬을 참조하여 작성한다.
|
||||
|
||||
## 시스템별 파이프라인 특성
|
||||
|
||||
| 시스템 | 빌드 | 테스트 | 배포 | 롤백 |
|
||||
|--------|------|--------|------|------|
|
||||
| **zioinfo-web** | npm build + mvn package | - | jar 배포 → restart zioinfo | 이전 jar 복원 |
|
||||
| **guardia-itsm** | pip install | pytest (있으면) | rsync → restart guardia | git revert |
|
||||
| **guardia-manager** | npm build | - | /var/www/manager/ 복사 | 이전 빌드 복원 |
|
||||
| **guardia-messenger** | EAS Build | - | 스토어 제출 (수동) | N/A |
|
||||
| **guardia-docs** | - | - | /var/www/docs/ 복사 | git checkout |
|
||||
|
||||
## 파이프라인 공통 단계
|
||||
|
||||
```groovy
|
||||
stages {
|
||||
stage('Checkout') { ... }
|
||||
stage('Build') { ... }
|
||||
stage('Test') { when { expression { testExists() } } ... }
|
||||
stage('Deploy') { when { branch 'main' } ... }
|
||||
stage('Notify') { post { always { ... } } }
|
||||
}
|
||||
```
|
||||
|
||||
## 분기 전략
|
||||
|
||||
| 브랜치 | 동작 |
|
||||
|--------|------|
|
||||
| `main` | Build → Test → Deploy (프로덕션) |
|
||||
| `develop` | Build → Test (배포 없음) |
|
||||
| `feature/*` | Build only |
|
||||
|
||||
## 작업 원칙
|
||||
|
||||
1. **Sparse Checkout**: `manual/`, `docs/` 등 불필요한 폴더 제외
|
||||
2. **타임아웃**: 각 stage에 timeout 설정 (build: 10분, deploy: 5분)
|
||||
3. **아티팩트**: 빌드 결과물 Jenkins artifact로 보관 (최근 5개)
|
||||
4. **환경변수**: `credentials()` 사용, 하드코딩 금지
|
||||
|
||||
## 팀 통신 프로토콜
|
||||
|
||||
- **수신**: jenkins-initializer에게서 `jenkins_ready` 신호
|
||||
- **발신**: deploy-scripter에게 `{jenkinsfile_paths, deploy_stages}` 전달
|
||||
- **발신**: notification-wirer에게 알림 포인트 목록 전달
|
||||
160
.claude/skills/cicd-pipeline-orchestrator/SKILL.md
Normal file
160
.claude/skills/cicd-pipeline-orchestrator/SKILL.md
Normal file
@ -0,0 +1,160 @@
|
||||
---
|
||||
name: cicd-pipeline-orchestrator
|
||||
description: "GUARDiA CI/CD 파이프라인 전체 구축 오케스트레이터. Jenkins 초기 설정 → 5개 repo Jenkinsfile 작성 → deploy_server.py 업데이트 → 메신저 알림 연동까지 완전한 CI/CD 파이프라인을 구축한다. 다음 상황에서 반드시 사용: (1) 'CI/CD 파이프라인 구축', 'Jenkins 설정', 'Jenkinsfile 만들어줘'; (2) '빌드 자동화', '배포 자동화', '파이프라인 완성'; (3) 빌드 실패 알림, 롤백 설정; (4) 다시 실행, 업데이트, 수정, 보완."
|
||||
---
|
||||
|
||||
# GUARDiA CI/CD 파이프라인 오케스트레이터
|
||||
|
||||
**실행 모드:** 하이브리드
|
||||
- Phase 1(Jenkins 초기화): 서브 에이전트
|
||||
- Phase 2(Jenkinsfile 작성 × 5): 병렬 서브 에이전트
|
||||
- Phase 3(deploy_server + 알림): 에이전트 팀
|
||||
|
||||
---
|
||||
|
||||
## 현재 인프라 현황
|
||||
|
||||
```
|
||||
Gitea (port 3000, SSL) → 5개 독립 repo 존재
|
||||
Webhook(port 9999) → deploy_server.py 실행 중
|
||||
Jenkins(port 8080) → 설치됨, 초기 설정 미완
|
||||
서버 (101.79.17.164) → Ubuntu 24.04
|
||||
```
|
||||
|
||||
## 파이프라인 전체 흐름
|
||||
|
||||
```
|
||||
git push (개발자)
|
||||
↓
|
||||
Gitea webhook → port 9999 (deploy_server.py)
|
||||
↓ ↓
|
||||
즉시 배포 Jenkins Job 트리거
|
||||
(간단한 경우) (복잡한 빌드)
|
||||
↓ ↓
|
||||
restart Build → Test → Deploy → Notify
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 0: 사전 확인
|
||||
|
||||
```bash
|
||||
# Jenkins 접근 확인
|
||||
curl -sf http://localhost:8080/api/json 2>/dev/null && echo "OK" || echo "Jenkins 설정 필요"
|
||||
|
||||
# 초기 비밀번호 확인 (미설정 시)
|
||||
sudo cat /var/lib/jenkins/secrets/initialAdminPassword 2>/dev/null
|
||||
|
||||
# 서비스 상태
|
||||
systemctl is-active jenkins
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 1: Jenkins 초기 설정 (jenkins-initializer)
|
||||
|
||||
**실행 모드: 서브 에이전트**
|
||||
|
||||
```
|
||||
1. Jenkins 초기 비밀번호 확인 → admin 패스워드 변경
|
||||
2. 필수 플러그인 설치: git, pipeline, gitea, credentials-binding, nodejs, http_request
|
||||
3. Gitea credential 등록 (gitea-token)
|
||||
4. 글로벌 환경변수 설정 (ITSM_BASE_URL, SERVER_HOST 등)
|
||||
5. Gitea webhook → Jenkins trigger 설정
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 2: Jenkinsfile 작성 (pipeline-architect × 5, 병렬)
|
||||
|
||||
**실행 모드: 병렬 서브 에이전트**
|
||||
|
||||
`jenkinsfile-generator` 스킬 참조하여 5개 시스템 동시 작성:
|
||||
|
||||
| 시스템 | 저장 경로 | 스테이지 |
|
||||
|--------|----------|---------|
|
||||
| zioinfo-web | `workspace/zioinfo-web/Jenkinsfile` | checkout→npm→mvn→deploy |
|
||||
| guardia-itsm | `workspace/guardia-itsm/Jenkinsfile` | checkout→pip→pytest→rsync |
|
||||
| guardia-manager | `workspace/guardia-manager/Jenkinsfile` | checkout→npm→copy |
|
||||
| guardia-messenger | `workspace/guardia-messenger/Jenkinsfile` | checkout→validate→eas |
|
||||
| guardia-docs | `workspace/guardia-docs/Jenkinsfile` | checkout→copy |
|
||||
|
||||
---
|
||||
|
||||
## Phase 3: 배포 + 알림 (에이전트 팀)
|
||||
|
||||
**실행 모드: deploy-scripter + notification-wirer 협업**
|
||||
|
||||
### deploy-scripter 담당
|
||||
```python
|
||||
# deploy_server.py 업데이트
|
||||
# guardia-manager, guardia-docs 배포 함수 추가
|
||||
# REPO_ROUTES 딕셔너리에 새 repo 매핑
|
||||
```
|
||||
|
||||
### notification-wirer 담당
|
||||
```groovy
|
||||
// vars/notify.groovy (Jenkins Shared Library)
|
||||
// ITSM webhook으로 빌드 결과 전송
|
||||
// 각 Jenkinsfile의 post 블록에 notifyITSM() 호출 추가
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 4: 각 Repo에 Jenkinsfile 커밋 + push
|
||||
|
||||
```bash
|
||||
for repo in zioinfo-web guardia-itsm guardia-manager guardia-messenger guardia-docs; do
|
||||
cd C:\GUARDiA\repos\$repo
|
||||
git add Jenkinsfile
|
||||
git commit -m "ci: add Jenkins pipeline"
|
||||
git push origin main
|
||||
done
|
||||
```
|
||||
|
||||
→ Gitea webhook → Jenkins job 자동 실행 검증
|
||||
|
||||
---
|
||||
|
||||
## Phase 5: 전체 파이프라인 검증
|
||||
|
||||
```bash
|
||||
# Jenkins job 상태 확인 (Jenkins API)
|
||||
curl -sf http://localhost:8080/job/zioinfo-web/lastBuild/api/json | python3 -m json.tool
|
||||
|
||||
# 최근 배포 로그 확인
|
||||
tail -20 /var/log/zioinfo/deploy.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 에러 핸들링
|
||||
|
||||
| 오류 | 원인 | 해결 |
|
||||
|------|------|------|
|
||||
| Jenkins 포트 접근 불가 | 방화벽 또는 서비스 중단 | `systemctl restart jenkins` |
|
||||
| 플러그인 설치 실패 | 네트워크 또는 버전 | Jenkins Update Center 확인 |
|
||||
| Gitea webhook 미트리거 | secret 불일치 | deploy_server.py SECRET 확인 |
|
||||
| EAS 빌드 실패 | EXPO_TOKEN 만료 | expo.dev에서 토큰 갱신 |
|
||||
|
||||
---
|
||||
|
||||
## 테스트 시나리오
|
||||
|
||||
**정상 흐름:**
|
||||
1. `workspace/guardia-itsm/`에서 코드 수정 → `repos/guardia-itsm/`에 push
|
||||
2. Gitea webhook → Jenkins `guardia-itsm` job 트리거
|
||||
3. Build → Test → Deploy → ITSM 메신저 알림 수신 확인
|
||||
|
||||
**에러 흐름:**
|
||||
- mvn build 실패 → Jenkins 빌드 실패 표시 → ITSM 메신저 "❌ 빌드 실패" 알림
|
||||
|
||||
---
|
||||
|
||||
## should-trigger
|
||||
|
||||
- "CI/CD 파이프라인 구축해줘"
|
||||
- "Jenkins job 만들어줘"
|
||||
- "Jenkinsfile 작성해줘"
|
||||
- "빌드 실패 알림 연동"
|
||||
- "guardia-itsm 파이프라인 완성"
|
||||
228
.claude/skills/jenkinsfile-generator/SKILL.md
Normal file
228
.claude/skills/jenkinsfile-generator/SKILL.md
Normal file
@ -0,0 +1,228 @@
|
||||
---
|
||||
name: jenkinsfile-generator
|
||||
description: "GUARDiA 5개 시스템(zioinfo-web, guardia-itsm, guardia-manager, guardia-messenger, guardia-docs)의 Jenkinsfile을 작성하는 스킬. 각 시스템의 빌드/테스트/배포/롤백 단계를 Groovy Pipeline DSL로 구현. 다음 상황에서 반드시 사용: (1) 'Jenkinsfile 작성', '파이프라인 작성'; (2) 특정 시스템 CI/CD 파이프라인 설계; (3) 빌드/배포 단계 추가·수정; (4) 다시 실행, 업데이트, 보완."
|
||||
---
|
||||
|
||||
# GUARDiA Jenkinsfile 작성 스킬
|
||||
|
||||
## 공통 파이프라인 구조
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
options {
|
||||
buildDiscarder(logRotator(numToKeepStr: '5'))
|
||||
timeout(time: 20, unit: 'MINUTES')
|
||||
timestamps()
|
||||
}
|
||||
environment {
|
||||
ITSM_BASE_URL = 'http://127.0.0.1:9001'
|
||||
DEPLOY_LOG = '/var/log/zioinfo/deploy.log'
|
||||
}
|
||||
stages { ... }
|
||||
post {
|
||||
success { script { notifyITSM(success: true) } }
|
||||
failure { script { notifyITSM(success: false) } }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## zioinfo-web Jenkinsfile
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
environment {
|
||||
SRC_DIR = '/opt/zioinfo/src'
|
||||
JAR_DIR = '/opt/zioinfo/app'
|
||||
STATIC_DIR = '/var/www/zioinfo'
|
||||
MVN = '/usr/bin/mvn'
|
||||
}
|
||||
options {
|
||||
buildDiscarder(logRotator(numToKeepStr: '5'))
|
||||
timeout(time: 20, unit: 'MINUTES')
|
||||
}
|
||||
stages {
|
||||
stage('Checkout') {
|
||||
steps {
|
||||
checkout([
|
||||
$class: 'GitSCM', branches: scm.branches,
|
||||
userRemoteConfigs: scm.userRemoteConfigs,
|
||||
extensions: [[$class: 'SparseCheckoutPaths',
|
||||
sparseCheckoutPaths: [[path: 'frontend'], [path: 'backend']]
|
||||
]]
|
||||
])
|
||||
}
|
||||
}
|
||||
stage('Frontend Build') {
|
||||
steps {
|
||||
dir('frontend') {
|
||||
sh 'npm ci --legacy-peer-deps --prefer-offline 2>/dev/null || npm install --legacy-peer-deps'
|
||||
sh 'npm run build'
|
||||
}
|
||||
}
|
||||
}
|
||||
stage('Backend Build') {
|
||||
steps {
|
||||
dir('backend') {
|
||||
sh "${MVN} clean package -DskipTests -q"
|
||||
}
|
||||
}
|
||||
}
|
||||
stage('Deploy') {
|
||||
when { branch 'main' }
|
||||
steps {
|
||||
sh '''
|
||||
cp backend/target/*.jar ${JAR_DIR}/app.jar
|
||||
cp -r backend/src/main/resources/static/. ${STATIC_DIR}/
|
||||
systemctl restart zioinfo
|
||||
sleep 4
|
||||
systemctl is-active zioinfo || exit 1
|
||||
'''
|
||||
}
|
||||
}
|
||||
}
|
||||
post {
|
||||
success { echo "✅ zioinfo-web 배포 완료" }
|
||||
failure { echo "❌ zioinfo-web 빌드 실패" }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## guardia-itsm Jenkinsfile
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
environment {
|
||||
APP_DIR = '/opt/guardia/app'
|
||||
VENV = '/opt/guardia/venv'
|
||||
SERVICE = 'guardia'
|
||||
}
|
||||
options { buildDiscarder(logRotator(numToKeepStr: '5')); timeout(time: 15, unit: 'MINUTES') }
|
||||
stages {
|
||||
stage('Checkout') { steps { checkout scm } }
|
||||
stage('Install') {
|
||||
steps {
|
||||
sh "${VENV}/bin/pip install -r requirements.txt -q"
|
||||
}
|
||||
}
|
||||
stage('Test') {
|
||||
when { expression { fileExists('tests/') } }
|
||||
steps {
|
||||
sh "${VENV}/bin/pytest tests/ -q --tb=short || true"
|
||||
}
|
||||
}
|
||||
stage('Deploy') {
|
||||
when { branch 'main' }
|
||||
steps {
|
||||
sh '''
|
||||
rsync -a --exclude=__pycache__ --exclude=.git \
|
||||
--exclude=rpa_rules.json \
|
||||
. ${APP_DIR}/
|
||||
systemctl restart ${SERVICE}
|
||||
sleep 4
|
||||
systemctl is-active ${SERVICE} || exit 1
|
||||
'''
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## guardia-manager Jenkinsfile
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
environment {
|
||||
SRC_DIR = '/opt/manager'
|
||||
STATIC_DIR = '/var/www/manager'
|
||||
SERVICE = 'guardia-manager'
|
||||
}
|
||||
options { buildDiscarder(logRotator(numToKeepStr: '5')); timeout(time: 15, unit: 'MINUTES') }
|
||||
stages {
|
||||
stage('Checkout') { steps { checkout scm } }
|
||||
stage('Frontend Build') {
|
||||
steps {
|
||||
dir('frontend') {
|
||||
sh 'npm ci 2>/dev/null || npm install'
|
||||
sh 'npm run build'
|
||||
}
|
||||
}
|
||||
}
|
||||
stage('Deploy') {
|
||||
when { branch 'main' }
|
||||
steps {
|
||||
sh '''
|
||||
cp -r frontend/dist/. ${STATIC_DIR}/
|
||||
systemctl restart ${SERVICE} 2>/dev/null || true
|
||||
echo "Manager 배포 완료"
|
||||
'''
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## guardia-messenger Jenkinsfile
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
options { buildDiscarder(logRotator(numToKeepStr: '3')); timeout(time: 30, unit: 'MINUTES') }
|
||||
stages {
|
||||
stage('Checkout') { steps { checkout scm } }
|
||||
stage('Validate') {
|
||||
steps {
|
||||
sh 'node --version && npm --version'
|
||||
sh 'npx eas --version 2>/dev/null || npm install -g eas-cli -q'
|
||||
}
|
||||
}
|
||||
stage('EAS Build') {
|
||||
when { branch 'main' }
|
||||
steps {
|
||||
withCredentials([string(credentialsId: 'expo-token', variable: 'EXPO_TOKEN')]) {
|
||||
sh 'eas build --platform android --profile preview --non-interactive 2>&1 | tail -5'
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
post {
|
||||
success { echo "📱 Messenger 빌드 완료 — expo.dev에서 확인하세요" }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## guardia-docs Jenkinsfile
|
||||
|
||||
```groovy
|
||||
pipeline {
|
||||
agent any
|
||||
environment { DOCS_DIR = '/var/www/docs' }
|
||||
options { buildDiscarder(logRotator(numToKeepStr: '3')) }
|
||||
stages {
|
||||
stage('Checkout') { steps { checkout scm } }
|
||||
stage('Deploy') {
|
||||
when { branch 'main' }
|
||||
steps {
|
||||
sh '''
|
||||
mkdir -p ${DOCS_DIR}
|
||||
cp -r . ${DOCS_DIR}/
|
||||
echo "문서 배포 완료"
|
||||
'''
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
18
CLAUDE.md
18
CLAUDE.md
@ -159,6 +159,24 @@ workspace/guardia-itsm/
|
||||
|
||||
---
|
||||
|
||||
## 하네스: CI/CD 파이프라인
|
||||
|
||||
**목표:** Jenkins + Gitea webhook + deploy_server.py 기반 5개 repo 완전 자동화 파이프라인. 빌드-테스트-배포-롤백-알림 전 단계 구축.
|
||||
|
||||
**트리거:** CI/CD 파이프라인, Jenkins 설정, Jenkinsfile 작성, 빌드 자동화, 배포 자동화 요청 시 `cicd-pipeline-orchestrator` 스킬을 사용하라.
|
||||
|
||||
**현재 인프라:**
|
||||
- Gitea webhook → port 9999 (deploy_server.py) ✅
|
||||
- Jenkins port 8080 설치됨, 초기 설정 미완 ⚠️
|
||||
- 5개 독립 repo (workspace/) ✅
|
||||
|
||||
**변경 이력:**
|
||||
| 날짜 | 변경 내용 | 대상 | 사유 |
|
||||
|------|----------|------|------|
|
||||
| 2026-06-01 | 초기 하네스 구성 | 전체 | CI/CD 파이프라인 구축 |
|
||||
|
||||
---
|
||||
|
||||
## 하네스: GUARDiA Manager
|
||||
|
||||
**목표:** GUARDiA ITSM·홈페이지·서버 인프라·CI/CD 통합 관제 관리자 포털 구축
|
||||
|
||||
Loading…
Reference in New Issue
Block a user