[Jenkins] 작업 결과물(Springboot jar file, gradle 이용)을 AWS EC2에 반영해보기

목적

작업 결과물(Springboot jar file, gradle 이용)을 AWS EC2에 반영해보기
‣ jenkins 서버에 작업 결과물을 빌드 / 배포하는 셈.
‣ 작업 결과물은 개인 github 에서 가져옴! (github 의 webhook 기능 이용) 

 

작업순서

1️⃣ EC2 생성 및 터미널 접속
‣ EC2 생성방법은 생략함. (t2.micro 이용 (메모리 1GB..jenkins 배포는 되긴함!..), aws linux 이용)
‣ pem key 소중하게 보관하도록하기 (ssh 폴더에 이동시키는 등)

1-1. EC2 보안그룹 설정하기 (인바운드 규칙 설정)

EC2 > 인스턴스 화면

보안그룹 > 인바운드 규칙

인바운드 규칙 설정 (포트허용 설정)

1-2. EC2 인스턴스 서버 접속 시도 (2가지)

- pem key 을 .ssh 폴더로 옮겨주는 작업을 추가함.

$ sudo mv {pem key 위치경로}/jenkins.pem ~/.ssh

⭐️ 참고로 실습의 상황이기에 EC2 서버를 내리고 올리는 경우가 존재한다면
[1. ssh 으로 접속하는 방법] 으로 하는것이 맞을듯. (IPv4가 서버 재시작시 바뀜)

  1-2-1. ssh 으로 접속하는 방법

# ssh -i {pem key 경로} {ec2 인스턴스 계정ID}@{퍼블릭 IPv4 DNS or 퍼블릭 IPv4 IP}
$ ssh -i ~/.ssh/jenkins.pem ec2-user@ec2-2-3-4-5.ap-northeast-2.compute.amazonaws.com

# root 권한이 아닌 경우 
$ sudo ssh -i ~/.ssh/jenkins.pem ec2-user@ec2-2-3-4-5.ap-northeast-2.compute.amazonaws.com

 

  1-2-2. ~/.ssh/config file 에 접속정보 추가 후, Host 명으로 접속하는 방법

$ vi ~/.ssh/config 

# 열어서 아래내용 추가
Host test_jenkins

 User ec2-user
 HostName ec2-2-3-4-5.ap-northeast-2.compute.amazonaws.com
 IdentityFile ~/.ssh/jenkins.pem
 
# 그리고 저장 (:wq!)
 
# 접속시도는 아래와 같이 함. (root 권한 아닌 경우 sudo ssh ~)
$ ssh test_jenkins

 

💥 그런데, Host 명으로 접속 시도중 오류가 발생했다면 ? 

> pem key 권한을 변경해주니 접속이 가능함! (chmod 400 ~ 나에게만 읽기 권한 설정) 

 

2️⃣ EC2 서버 접속 후, 프로그램 설치 및 서버 셋팅

2-1. java 설치
   ‣ 나의 경우, aws linux을 사용했기에 해당문서 ← 를 참고하여 설치함 

2-2. 타임존 변경 (한국 시간)

$ sudo rm /etc/localtime
$ sudo ln -s /usr/share/zoneinfo/Asia/Seoul /etc/localtime

# 날짜 확인
$ date

2-3. 호스트네임 변경

$ sudo hostnamectl set-hostname mungmang-jenkins
$ sudo reboot

# 몇분 후 다시접속

# 확인
$ hostname

2-4. jenkins 설치

# jenkins repository 에 설정파일 생성 
$ sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
$ sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

# jenkins 설치
$ sudo yum install jenkins

# jenkins 실행
$ sudo systemctl start jenkins

# 만약 부팅시 가능하게 설정하려면 다음도 추가
$ sudo systemctl enable jenkins

 

 

2-5. jenkins 접속 및 플러그인 설치

빨간박스 경로의 값을 확인하여 입력해주기

한글로 번역함. 추천 플러그인을 설치하였음. (뭐가 필요한지를 정확하게 모르기 때문!)

.. 플러그인 설치 후,
jenkins 유저 등록 화면에서 로그인할 계정정보 입력 ↓ ↓ ↓ (계정명 및 암호로 jenkins 로그인 가능!)

 

2-6. gradle 설치 https://docs.gradle.org/6.9.1/userguide/installation.html 참고함

$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-6.9.1-bin.zip
$ ls /opt/gradle/gradle-6.9.1

$ export PATH=$PATH:/opt/gradle/gradle-6.9.1/bin
$ gradle -version

 

2-7. git 설치 https://gamoo12.tistory.com/205 참고함

$ sudo yum update -y
$ sudo yum install git -y
$ git version

 

3️⃣ github 설정

3-0. 반영할 프로젝트는 있다고 가정 (작업 결과물)
3-1. EC2에서 ssh key 생성

$ cd ~/.ssh
$ ssh-keygen

# id_rsa key 생성

3-2. github project 내 XXX.pub key 등록 필요
    3-2-1. https://github.com/{git계정}/{git프로젝트}/settings/keys/new 이동 

$ cat ~/.ssh/id_rsa.pub

# ssh-rsa ~ 내용을 복사

github > 프로젝트 > Settings > Deploy keys > Add deploy key

3-3. github 프로젝트 내 webhook 설정필요
    3-2-1.https://github.com/{git계정}/{git프로젝트}/settings/hooks/new 이동 
        • Payload URL : http://{ec2에 jenkins 띄운 주소 (ex. ec2~~:8080}/github-webhook/ 입력
        • Content type :  application/json

jenkins에서 build 버튼 클릭시, github의 webhook 기능 이용하여 작업 결과물 프로젝트를 땡겨가도록 할것임

 

4️⃣ jenkins 설정

1. Credentials 등록 필요 (github 🔛 jenkins 연결유도)

Jenkins 관리 > Manage Credentials > Stores scoped Jenkins 의 Jenkins 클릭 > Global credentials
 
Kind : SSH Username with private key 선택
Private Key: .ssh/id_rsa 을 입력

 

2. 빌드 및 실행 (Dashboard > 대상 프로젝트 > 구성) 

빌드유발
GitHub hook trigger for GITScm polling 선택 

[플러그인 설치 필요] post build task (아래의 내용 기입, 작업 결과물 jar 파일로 만든 것을 실행)
JAR=$(ls -tr /var/lib/jenkins/workspace/{jenkins working directory 명}/build/libs | grep jar | tail -n 1)
echo $JAR
nohup java -jar /var/lib/jenkins/workspace/{jenkins working directory 명}/build/libs/$JAR &

• $(ls -tr /var/lib/jenkins/workspace/{jenkins working directory 명}/build/libs | grep jar | tail -n 1) : jar 파일명 추출 위함.
• nohup java -jar /var/lib/jenkins/workspace/{jenkins working directory 명}/build/libs/$JAR & : jar 실행위함, nohup 을 붙임으로써 백그라운드에서 실행! (터미널 종료 하더라도 작업 결과물은 계속 서버에 실행되어 있도록 하기위함)

 

 

느낀점

‣ 삽질을 줄일 필요성이있겠다.
‣ 파이프라인 작성을 이용한 배포도 한번 해보아야 할것같다. 
‣ docker..kubernetes 등을 이용한 배포방법도 해보아야 할것같다. + 다른 서버에 배포하는 방법 등 

 

---

참고

책: 스프링 부트와 AWS로 혼자 구현하는 웹 서비스

스프링 부트와 AWS로 혼자 구현하는 웹 서비스 - YES24

링크: https://lemontia.tistory.com/656

[Linux] centos7 젠킨스 설치