Keem 개발 블로그

이전 글에 이어지는 내용입니다.

들어가며

내가 설계한 기본적인 프로세스는 다음과 같다

메인 브랜치로 머지 → Webhook 전달 → Docker 이미지 빌드 → Docker Hub에 푸시 → 결과 알림

본 글에서 Discord 알림을 제외한 모든 프로세스를 다룰 것이다.

1. Jenkins 접속

브라우저에서 ec2 public ip에 8080 포트로 jenkins 서버에 접속한다.

예시) http://0.0.0.0:8080

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

명령어를 통해 출력된 admin 비밀번호로 로그인이 가능하다.

Install suggeseted plugins 설치
로그인 계정을 생성하고 젠킨스 접근 URL을 입력한다

2. Credentials 생성

GitHub Credentails

GitHub Access Token 발급

Settings > Developer Settings > Personal access tokens (classic) > Generate new token (classic)

repo 관련 권한과 hook 권한을 체크해준다.

GitHub Credentails 등록

jenkins 관리 > Credentials > System > Glabal credentials > Add Credentials

Kind: Username with password
Scope: Global
Username: GitHub username
Password: GitHub access token
ID: Identifier used in pipeline code (e.g., github-credentials)

Docker Credentails

Kind: Username with password
Scope: Global
Username: Docker Email
Password: Docker Password
ID: Identifier used in pipeline code (e.g., github-credentials)

3. plugins 다운로드

GitHub API Plugin
Generic Integration
Generic Webhook Trigger
SSH Agent Plugin
Docker
Docker Pipeline

4. GitHub Webhook 설정

Settings > Webhooks > Add webhook

Payload URL 예시 - http://0.0.0.0:8080/github-webhook/ (jenkins 주소)

5. Pipeline 구축

new items > pipeline

사진과 같이 선택하고 GitHub 레포지토리 URL을 넣으면 된다.

pipeline {
    agent any
 
    environment {
        JAVA_HOME = "/usr/lib/jvm/java-17-amazon-corretto"
        GRADLE_HOME = "/opt/gradle/gradle-8.12"
        PATH = "${JAVA_HOME}/bin:${GRADLE_HOME}/bin:${env.PATH}"
        IMAGE_NAME = "도커 닉네임/생성할 이미지 이름"
    }
 
    triggers {
        githubPush()
    }
 
    stages {

6. 결과 확인

main 브랜치에 머지되면 이미지 빌드를 수행하고 Docker Hub에 업로드 되는 것을 볼 수 있다.