📌 워크로드 상황 정리

1. 특정 EC2 인스턴스 내 Docker로 Jenkins 컨테이너 운영
2. Jenkins에서 특정 Bitbucket Repository branch 를 Pull 받은 이후 Execute Shell을 활용하여 gradle clean build
3. 아티팩트(Jar)를 SSH를 통해 특정 호스트 내 특정 디렉토리로 전송
4. 쉘 스크립트와 DockerFile을 통해 ECR 이미지를 만들어주고 ECS 클러스터에 배포
5. 해당 브랜치에 반영된 Git Commit Log를 Slack Webhook으로 전송

해당 글에서는 Jenkins Images를 Pull 받고 Docker Container로 동작하는 부분은 제외 하도록 하겠다. Jenkins Home 까지 진입이 된 상태에서 설명된 글이기 때문에 Jenkins를 컨테이너로 동작하는 과정을 알고 싶다면 잘 정리 되어있고 보기 좋은 참조 문서들이 많기 때문에 다른 글을 참고하기 바란다.

1️⃣ Bitbucket App Passwrod 발급

1) Create App Password

2) Permissions 지정

최소한의 권한은 소스코드 관리와 Webhook을 받기 위해 Repository, Webhook 접근권한이 필요하다.
※ 추가로 필요한 부분들은 체크 이후 사용하면 될 것 같다

3) App Password 발급

🚨 고려 사항 : 발급 이후 딱 한 번만 확인이 가능하므로 별도의 저장소나 개인이 관리가 필요함

2️⃣ Jenkins Bitbucket Credentials 생성

1) Jenkins 관리 -> Crdentials

2) Add Credentials

3) Create Credentials

• Username : 형상관리 계정 이름을 나타내는게 대부분이다.
• Password : Bitbucket에서 생성된 App Password
• ID : Jekins 내에서 Credentials를 식별하는 식별자
• Description : 해당 Credentials를 대한 간단한 설명

3️⃣ Publish over SSH Server 설정

1) Publish Over SSH 설치

설치가 안 된 경우 Available pligins 에 들어가서 플러그인을 설치하면 된다.

2) Jenkins 관리 -> System -> SSH 설정

• Name : SSH 서버 별칭
• Hostname : SSH 서버 호스트 주소
• Username : SSH 서버 아이디
• Remote Directory : SSH 서버 Remote 경로 위치
• Passphrase / Password : SSH 서버 비밀번호
  🚨 ※ SSH Password 설정은 sshd_config 파일안에 PasswordAuthenticateion 상태 값을 yes 로 변경

4️⃣ Slack Notification 설정

1) Slack Jenkins CI 플러그인 추가 및 토큰 생성

**🚨 토큰값은 Jekins Slack Credential 설정시 사용하기 때문에 기억해두기!!

2) Slack Notification Plugin 설치

설치가 안 된 경우 Available pligins 에 들어가서 플러그인을 설치하면 된다.

3) Slack Credential 설정

• Secret : 1번에서 만든 Slack Jenkins CI 토큰
• ID : 채널 ID 또는 고유 ID 를 지정
• Description : 해당 Credential 설명

4) Jenkins 관리 -> System -> Slack 설정

• Workspace : Slack 워크스페이스 이름
• Credential : Jenkins가 Slack API를 사용하기 위한 인증 정보 (토큰) / 3번에서 만든 Credential 적용
• Default channel / member id : 기본적으로 메시지가 전송될 Slack 채널 (#채널명) 또는 사용자 (@사용자명)

5️⃣ 쉘 스크립트 및 DockerFile 작성

1) SSH Remote Directory 경로 안에 DockerFile 생성

# Amazon에서 제공하는 Corretto OpenJDK 11 이미지를 기본 이미지로 사용합니다.
FROM amazoncorretto:11

# 빌드시 전달받을 jar 파일의 경로를 정의합니다. 기본값은 현재 디렉토리의 weather-1.0.0-BUILD-SNAPSHOT.jar 파일입니다.
ARG JAR_FILE=./weather-1.0.0-BUILD-SNAPSHOT.jar

# 전달받은 jar 파일을 컨테이너 내부에 app.jar라는 이름으로 복사합니다.
COPY ${JAR_FILE} app.jar

# Spring 프로필을 'dev' 환경으로 활성화합니다.
ENV SPRING_PROFILES_ACTIVE=dev

# 컨테이너 내부의 시간대를 한국 시간으로 설정합니다.
ENV TZ=Asia/Seoul

# 컨테이너가 시작될 때 실행될 명령어입니다.
# 최소 힙 메모리 512MB, 최대 힙 메모리 2048MB로 JVM을 실행하며, app.jar를 실행합니다.
ENTRYPOINT ["java", "-Xms512m", "-Xmx2048m", "-jar", "app.jar"]

• FROM : Docker 이미지를 만들 때 기반 이미지(Base image) 를 지정할 때 사용
• ARG : Docker 이미지 빌드 과정 중에 사용할 수 있는 인자(argument)를 설정
• COPY : 로컬에 있는 파일 또는 디렉터리를 이미지 내부로 복사
• ENV : 컨테이너 내부에서 사용할 환경 변수를 설정
• ENTRYPOINT : Docker 컨테이너가 실행될 때 기본적으로 실행되는 명령어를 지정

---

2) SSH Remote Directory 경로 안에 쉘 스크립트 생성 ( ※ VI 편집기 )

🚩 1단계: AWS ECR 로그인 (인증)

🚩 2단계: Docker 이미지 빌드하기

🚩 3단계: Docker 이미지에 ECR 레지스트리 태그 붙이기

🚩 4단계: ECR로 Docker 이미지 푸시하기 (업로드)

🚩 5단계: 로컬 이미지 삭제하기 (정리)

🚩 6단계: AWS ECS 서비스 재배포 (이미지 업데이트 적용)

#!/bin/bash

# AWS ECR 로그인 (도커 클라이언트 인증)
aws ecr get-login-password --region ap-northeast-2 | docker login --username AWS --password-stdin 998251115309.dkr.ecr.ap-northeast-2.amazonaws.com

# Docker 이미지 빌드 (로컬 Dockerfile 사용)
docker build -t dev-weather /home/admin/weather-dev

# Docker 이미지 태그 지정 (ECR 레포지토리에 맞게 변경)
docker tag dev-weather:latest 998251115309.dkr.ecr.ap-northeast-2.amazonaws.com/dev-weather:latest

# AWS ECR로 Docker 이미지 업로드
docker push 998251115309.dkr.ecr.ap-northeast-2.amazonaws.com/dev-weather:latest

# 로컬 Docker 이미지 삭제 (디스크 공간 확보)
docker rmi 998251115309.dkr.ecr.ap-northeast-2.amazonaws.com/dev-weather:latest
docker rmi dev-weather:latest

# AWS ECS 서비스 강제 재배포 (새로운 이미지 적용)
aws ecs update-service --cluster dev-weather-cluster --service dev-weather-service --force-new-deployment

6️⃣ Jenkins FreeStyle Project 구성

1) FreeStyle Project 생성

2) FreeStyle Project 구성

1. Git 소스코드 관리

• Repository URL : Git Repository URL
• Credentials : Jenkins에서 등록한 Bitbucket Credentials 설정
• Branch Specifier : 브랜치명

Git Trigger를 제외한 이유 ❓

• 불필요한 빌드 방지

• 의도적인 수동 제어

🚨 꺼진불도 다시보자!!!!!

---

2. Build Steps

1. chmod +x ./gradlew

1) 이 명령어는 현재 디렉토리에 있는 gradlew 파일을 실행 가능(executable)하게 만드는 명령입니다.
2) chmod 명령어는 파일의 접근 권한(permission)을 변경하는 명령어입니다.
3) +x 옵션은 파일을 실행할 수 있는 권한을 부여하는 의미이며, 주로 스크립트나 실행파일을 실행하기 위해 설정합니다.
4) ./gradlew는 Gradle Wrapper로, 프로젝트에서 정의한 Gradle 버전을 자동으로 다운로드하고 빌드합니다.

🚨 즉, 이 명령어가 없으면 ./gradlew 실행 시 Permission denied 에러가 발생할 수 있습니다.

2. ./gradlew clean build

1) 이 명령어는 Gradle 프로젝트를 빌드하는 과정입니다.
2) clean은 이전 빌드에서 생성된 모든 빌드 결과물을 삭제하는 작업입니다.
3) 주로 이전 빌드로 인해 발생할 수 있는 충돌이나 문제를 방지하기 위해 사용합니다.
4) build는 프로젝트의 소스를 컴파일하고, 테스트를 수행한 후 빌드 결과물(JAR/WAR 등)을 생성합니다.

---

3. 빌드 후 조치

• Name : Jenkins System에서 설정한 SSH
• Source files : 빌드된 결과물(artifact)에 대한 경로 위치
• Remove prefix : 접두사로 지정된 경로를 제거한 후 나머지 경로만 사용
• Remote directory : 전송된 아티팩트를 대상 서버 원하는 경로
• Exec command : 아티팩트를 원격 서버에 전송한 후 실행할 명령어

쉘 스크립트에 배포에 대한 명령어를 정의해놨으니 쉘 스크립트를 실행!!!!!

---

4. Slack Webhook

• Notification message includes : Jenkins가 Slack으로 보낼 알림 메시지에 포함할 항목들을 선택할 수 있도록 해주는 설정입니다.
• Credential : Jenkins System에서 설정한 Slack Credentials

🔹 결론

Jenkins에서 Pipeline(Job as Code) 방식이 더 많이 사용되고 권장되고 있지만 Pipeline 대비 Freestyle 장점을 적어보겠다.

⭐ 별도의 스크립트 작성 없이 플러그인을 쉽고 간편하게 추가 및 사용 가능
⭐ 코드 없이 직관적인 GUI 기반의 관리
⭐ 빠르고 쉬운 설정이 가능하다. 즉, 구성 속도가 빠르다.
⭐ 러닝커브가 낮기 때문에 신규 사용자도 진입 장벽이 매우 낮은 장점이 있다.