[Jenkins] AWS 인스턴스를 젠킨스로 배포해보기 - 1편

🌱 들어가기 전

이번 미션에서 젠킨스를 통해 CI / CD를 구축해보고 싶어서 ⭐️베베 선생님⭐️의 힘을 빌려서 한 번 진행해보았다.
나는 t4g.micro를 사용하다 보니 램이 1기가밖에 안 되어서 swap을 해주었어야 했는데,
⭐️ 중요한 건 swap 시 1~1.5기가 정도만 해야 한다는 것이었다.
 
나는 2기가로 해서 지금 Use가 95%로 간당간당하다.
원래 안 돼서 로컬로 실행하고 난리치다가 다시 시도했는데 되기는 했다...

죽어가는 친구

 
1.5기가로 만들고 싶다면 아래와 같이 실행해주면 된다.

# 기존에 존재하는 /swapfile을 비활성화하기
sudo swapoff /swapfile

# 크기가 1.5기가인 /swapfile 생성하기
sudo fallocate -l 1.5G /swapfile

# /swapfile에 대한 파일의 권한 변경하기
sudo chmod 600 /swapfile

# swapfile을 추가하기 위한 swap 공간을 생성한다.
sudo mkswap /swapfile

# swapfile을 swap 메모리에 추가한다.
sudo swapon /swapfile

# /esc/fstab 파일에 파일 시스템 마운트 시 필요한 구성 파일을 수정한다.
sudo vim /etc/fstab

# 파일의 맨 끝에 /swapfile을 스왑 영역으로 마운트하기 위한 옵션을 추가한다.
# 마운트할 파일의 경우 + 파일 시스템 유형 지정 (none) + 마운트할 파일의 유형 지정 (swap) + 마운트 옵션 (sw, 스왑 영역을 의미함)
# 0 (파일 시스템이 백업되어야 하는지 여부, 여기서는 백업 X) + 0 (파일 시스템의 검사 순서 지정) - 검사하지 않음
/swapfile none swap sw 0 0

# 시스템 재부팅
sudo reboot

이후 free를 통해 swap이 잘 되었는지 확인하도록 하자.

---

 

🌱 도커로 젠킨스 실행하기

💡 참고로, 여기 아래에서 나오는 이미지들은 로컬 젠킨스로 시도했을 때 캡쳐했던 것들이어서 맥 환경입니다! (추후 EC2 환경에서 함)
 
먼저, 준비물로 도커가 필요하다.

sudo snap install docker
sudo apt install docker.io

docker.io를 실행할 때 경고 메시지가 떠도 괜찮다. 정상적으로 설치되었음을 의미한다.
 
잘 설치되었는지 체크하기 위해 도커 버전을 확인해주자.

docker --version

 
그리고, 젠킨스를 실행해주기 위한 docker-compose 파일을 작성해주자.

version: "3.9"
services:
  jenkins:
    image: jenkins/jenkins
    restart: always
    ports:
      - "8081:8080"

간단하게 진행하기 위해서 이미지와 포트 옵션 외에 별다른 것은 진행하지 않았다.
 
이때, 포트 옵션을 8081로 두었는데, EC2 인스턴스의 inbound rules에서 허용된 포트 주소여야 한다.

나는 여기서 사용할 수 있는 게 8081밖에 없는 상황이었어서 8081 포트로 진행하였다.
 
이후, docker-compose 파일을 실행하여 도커 컨테이너를 실행하자.

docker-compose up -d

참고로 나는 이미 이미지가 다운받아진 상태여서 이렇게만 뜨지만, 처음이라면 젠킨스 도커 이미지를 다운받느라 조금 걸릴 것이다.
(위에 뜨는 경고 메시지는 현재 실행하지 않는 도커 컨테이너가 있어서 뜬 오류인데, 신경쓰지 않아도 된다!)
 

docker ps -a

이후, 잘 실행되었는지 확인하기 위해 STATUS에 UP xx minutes가 뜨는지 확인하자.
 
💡EC2에서 진행하기 위해서는 매번 sudo를 입력하고 있다면, 번거로우니까 아래와 같이 docker 실행에 대한 권한을 주자.

sudo chmod 666 /var/run/docker.sock

이후 재시작을 하게 되면 sudo 없이 편하게 실행할 수 있을 것이다 😊
 

---

 

🌱 도커로 젠킨스 접속하기

publicIP:8081로 접속했다면 위와 같은 창이 뜰 것이다.
가장 첫 접속이기 때문에 비밀번호를 입력해야 한다.
 

docker logs {container_id}

터미널에 docker logs + 젠킨스가 띄워진 도커 컨테이너의 아이디를 입력해보자. 그럼 아래와 같은 창이 뜰 것이다.

딱 봐도 비밀번호처럼 생긴 친구가 있다.
이 친구를 복사해서 위의 Administrator password에 입력해주자.
 

그럼 여기서 install suggested plugins를 눌러준다.

위와 같이 열심히 실행되고 있을 텐데, 설치에는 5~10분 정도 걸리기 때문에 여유롭게 기다리자!
 

이후, 어드민 계정으로 로그인하기 위한 정보를 입력해준다.
 

원래는 localhost가 아니라 EC2 Public IP:8081 같은 형태여야 한다. (옛날에 캡쳐함...)

 

Jenkins에 접속하기 위한 URL을 입력한다. (기본적으로 입력되어 있는 상태긴 하다 ㅎㅎ)
 

그럼 이렇게 Jenkins 화면이 멋지게 나타난다!
 

---

 

🌱 젠킨스 플러그인 설치하기 - gradle

우리는 gradle로 빌드를 진행할 예정이기 때문에 gradle 관련 플러그인이 필요하다.

Dashboard > Manage Jenkins > Tools 클릭!

Gradle Installations > Version 선택 후 Save 진행하기!
나 같은 경우는 최신이면서 가장 안정화된 gradle 8.1을 설치하였다.

 

---

 

🌱 젠킨스 플러그인 설치하기 - ssh agent

추후 나올 젠킨스 배포 스크립트에서 ssh를 통해 우리의 EC2 인스턴스에 접근을 할 것이다.
이를 위한 ssh agent라는 친구를 설치해보자.

Dashboard > Manage Jenkins > Plugins 클릭!

Available plugins > ssh agent 검색 > 설치 진행!

다시 깃허브 대시보드로 돌아간 다음, 왼쪽의 Manage Jenkins > 아래쪽의 Credentials 클릭!

Stores scoped To Jenkins > Domains > global 클릭!

Add Credentials 클릭!

 
SSH-Username with private key 선택 후, ID는 아무거나, Username은 EC2 호스트 네임을, Private key에는 EC2 인스턴스 접속을 위한 pem 키를 입력한다. (cat xx.pem을 통해 나온 내용을 복사 붙여넣기 해준다.)

추가가 완료되면 이런 식으로 목록에 뜬다.
 

---

생각보다 글이 길어져서 2개로 나누고자 한다.
다음 포스팅으로 깃허브 레파지토리 연동 + 젠킨스 배포 스크립트를 설정해보자!