배포 가이드 (EC2 + start.sh + Jenkins)

slack-notifier 를 EC2(리눅스) 에 단일 정적 바이너리로 올리고, start.sh(백그라운드, sudo/systemd 불필요) 로 운영하며, Jenkins 로 빌드·배포를 자동화한다. 도커 레지스트리 불필요(바이너리 직접 배포).

[git push] → Jenkins (네이티브 Go) → go vet/test/build → sshpass scp(바이너리+start.sh) → EC2
                                                                   → start.sh restart
[Gitea/Notion] ──webhook(HTTPS)──→ Caddy(:443) ──→ slack-notifier(:8000) ──→ Slack

기본 경로: APP_DIR=/data/app/notifier, 유저 ec2-user, 아키텍처 amd64 (Jenkins 파라미터로 조정).

1. EC2 최초 1회 셋업

1-1. 설치 경로 / 환경파일

# 배포 계정(ec2-user)이 소유 → sudo 없이 배포/기동 가능
sudo mkdir -p /data/app/notifier
sudo chown -R ec2-user:ec2-user /data/app/notifier

# 비밀값/설정 — 서버에만 두고 절대 커밋하지 않음
vi /data/app/notifier/.env.prod
#   SLACK_BOT_TOKEN=xoxb-...
#   DEFAULT_SLACK_CHANNEL=C...        (브로드캐스트 채널, GITEA_BROADCAST=on 일 때)
#   GITEA_BROADCAST=off
#   MONITOR_SLACK_CHANNEL=C...        (에러 알림)
#   GITEA_WEBHOOK_SECRET=...
#   NOTION_VERIFICATION_TOKEN=...
#   NOTION_API_TOKEN=...
#   LOG_RETENTION_DAYS=7

앱은 -env prod 로 실행되어 .env.prod 를 읽고, 로그는 /data/app/notifier/logs/app-YYYY-MM-DD.log 로 날짜별 회전된다(7일 보존). stdout/패닉은 logs/console.log 에 남는다.

1-2. 실행 스크립트(start.sh)

start.sh 는 Jenkins 배포 시 바이너리와 함께 자동 전송되므로 수동 복사는 보통 불필요하다. 최초 수동 기동이 필요하면:

# 바이너리·start.sh·.env.prod 를 /data/app/notifier 에 둔 뒤
cd /data/app/notifier
./start.sh start prod      # 시작 (start|stop|restart|status)
./start.sh status

1-3. HTTPS 리버스 프록시(Caddy)

웹훅은 공개 HTTPS 가 필수. Caddy 가 Let's Encrypt 인증서를 자동 발급한다.

sudo cp deploy/Caddyfile /etc/caddy/Caddyfile
sudo vi /etc/caddy/Caddyfile        # your-domain.com 을 실제 도메인으로 교체 (reverse_proxy localhost:8000)
sudo systemctl restart caddy

도메인 A 레코드 → EC2 퍼블릭 IP
보안그룹 인바운드 80, 443(ACME + 웹훅 수신), 그리고 Jenkins → EC2 22(SSH) 허용
웹훅 등록 주소: https://your-domain.com/webhooks/{gitea,notion}

2. Jenkins 셋업

2-1. 플러그인 / Go 도구 / sshpass

플러그인: Go Plugin, Credentials Binding
Manage Jenkins → Tools → Go installations 에 Go 추가:
- Name: go-1.26.4 (Jenkinsfile 의 tools { go '...' } 와 일치)
- "Install automatically" 로 1.26.x (또는 에이전트의 Go 경로)
빌드 에이전트에 sshpass 설치 (아이디/비번 SSH): sudo yum install -y sshpass / apt install -y sshpass

2-2. 자격증명(아이디/비번)

Jenkins → Credentials → Username with password 추가
- ID: palnet-dev-ops (Jenkinsfile 의 DEPLOY_CRED_ID 와 일치)
- Username = EC2 SSH 유저(ec2-user), Password = 접속 비밀번호 — 둘 다 파이프라인이 자격증명에서 가져옴
- (호스트 IP 는 자격증명에 없으므로 DEPLOY_HOST 파라미터로 받음)
대상 EC2 는 비밀번호 SSH 허용(/etc/ssh/sshd_config 의 PasswordAuthentication yes) 필요
배포 계정이 APP_DIR 소유 → sudo 불필요

2-3. 파이프라인 잡

Pipeline script from SCM → 이 저장소 → Jenkinsfile
파라미터(첫 실행 시 생성됨):
- DEPLOY_HOST = EC2 DNS/IP (비우면 빌드·테스트만, 배포 스킵)
- APP_DIR = /data/app/notifier
- ARCH = amd64(x86) 또는 arm64(Graviton/t4g) ← 인스턴스 아키텍처와 반드시 일치
- (SSH 유저는 palnet-dev-ops 자격증명의 username 사용 → 별도 파라미터 없음)

배포는 main 브랜치 + DEPLOY_HOST 지정 시에만 수행된다. (일반 Pipeline 잡은 BRANCH_NAME 이 비어 branch 'main' 매칭이 안 되므로, Multibranch Pipeline 권장 — 단일 잡으로 쓸 거면 Jenkinsfile 의 when 에서 branch 'main' 을 제거할 것.)

2-4. 파라미터 변경 시 (stale 가드)

Jenkins 의 parameters 는 변경해도 1빌드 늦게 등록된다(step/environment 는 즉시 반영). 그 사이 옛 파라미터로 빌드·배포되는 사고를 막기 위해 Guard: params sync 스테이지가 있다.

parameters {} 를 바꿀 때 규칙:

파라미터를 수정하고
parameters 의 PARAMS_VERSION 기본값과 environment.PARAMS_VERSION 을 둘 다 +1
커밋/푸시 → 첫 빌드는 Guard 에서 의도적으로 실패(파라미터 재등록만 됨) → 한 번 더 빌드하면 정상 진행

3. 배포 동작 / 롤백

교체 순서: 바이너리(임시명)·start.sh 전송 → start.sh stop → mv 로 교체(정지 상태라 ETXTBSY 없음) → start.sh start prod → status.
로그 확인: tail -f /data/app/notifier/logs/app-$(date +%F).log (구조적 로그) / logs/console.log (stdout·패닉)
롤백: 이전 커밋으로 다시 빌드/배포. 필요하면 배포 전 cp slack-notifier slack-notifier.bak 단계를 추가해도 됨.

4. 수동 배포(참고, Jenkins 없이)

make build-linux ARCH=amd64                                   # 정적 바이너리 생성
sshpass -e scp -P 22 slack-notifier deploy/start.sh ec2-user@EC2:/data/app/notifier/   # SSHPASS 환경변수 사용
ssh ec2-user@EC2 'cd /data/app/notifier && chmod +x start.sh && ./start.sh restart prod && ./start.sh status'

5.7 KiB Raw Permalink Blame History