CI/CD가 뭔가요? 실전편

3기_샐리
우아한테크코스 3기 샐리(조연우)입니다 :)
More posts by 3기_샐리.

3기_샐리

10 Oct 2021• 3 min read

지난번 CI/CD가 뭔가요? - 이론편에서 CI/CD에 대해서 알아보았다.

이번 글에서는 jenkins를 이용해 하나의 CI/CD 환경을 구축하는 방법에 대해 알아보는 시간을 갖도록 하겠다.

개선 근로에서 구현한 리뷰 매칭 프로그램 을 젠킨스를 통해 master branch에 merge되면 새롭게 배포하는 환경을 구축하도록 하자.

Jenkins 환경 구축하기

우선 jenkins를 위한 서버가 필요하다.

해당 서버에 자신의 운영체제에 맞는 jenkins를 설치하도록 하자.

이 글에서는 어느 운영체제에서도 설치할 수 있도록 docker image로 jenkins를 설치하고 관리하도록 하겠다.

docker image 받기

docker pull jenkins/jenkins:lts jenkins 프로세스를 위한 컨테이너를 만들기 위해 image 정보를 받아온다.

docker images 로 설치받은 이미지들을 확인하자.
docker container 실행

docker run -d -p 8080:8080 --name jenkins jenkins/jenkins docker를 이용해 8080포트에 jenkins라는 이름의 jenkins 프로세스를 실행한다.

docker ps 로 동작 중인 컨테이너들을 확인하자.

이제 해당 서버의 8080 포트로 접근을 하면 아래와 같이 jenkins에 로그인하라는 문구를 확인할 수 있을 것이다.

docker exec -it jenkins /bin/bash로 우리가 생성한 컨테이너에 접근하도록 하자.

컨테이너에 접속한 뒤 cat /var/jenkins_home/secrets/initialAdminPassword를 입력한 뒤에 사진의 폴더 속 내용을 조회하면 jenkins에 접근할 수 있는 비밀번호를 확인할 수 있을 것이다.

로그인하고 나면, Customize Jenkins 페이지가 보이는데, 플러그인 설치에 관한 내용이 보이는데 Install Suggested Plugins를 선택하도록 하자.

이후 설치가 끝나면 계정 생성 페이지가 나오는데, 계정을 생성하고 나면 아래와 같은 화면을 마주할 수 있다.

이러면 설치는 모두 끝났다. 이제 jenkins에 프로젝트를 연결해보도록 하자!

Jenkins를 이용한 CI/CD 환경 구축하기

플러그인 확인

Jenkins에서 shell script를 통한 작업 생성 시에는 Post build task Plugin, gradle 빌드 시 Gradle Plugin, maven 빌드 시 Maven Plugin과 같은 플러그인이 필요하다.

Jenkins 관리 -> Plugin 관리 -> 설치된 플러그인 목록에 해당되는 플러그인이 존재하지 않는 경우, 설치 가능 탭에서 설치해주도록 하자.
작업 생성

새로운 item 탭에 들어가면 다음과 같은 화면을 조회할 수 있을 것이다.

build를 하면서 보다 복잡한 shell script 실행이 필요한 경우 pipeline을 통한 구축을 하는 것이 좋다.

지금은 간단한 환경 구축이니 freestyle로 작업을 만들어보도록 하자.

Github Project 등록

위와 같이 General -> Github project에 체크하고 저장소 url을 입력한다.

소스 코드 관리 -> Git 체크하고 Repository URL을 다시 한번 입력해준다.

저장소를 사용하려면 자격 증명이 필요하다. 토큰을 등록해주기 위해 Github 페이지에서 settings -> Developer Settings -> Personal access tokens -> Generate Access token으로 접근할 범위를 아래와 같이 선택하고 토큰을 생성하자.

만들어진 access token을 잘 갖고 있다가 Credentials에 Add를 클릭해 자격 증명을 해주자.

Kind는 Username with password를 선택하고 Username에는 자신의 github 아이디, password에는 발급받은 토큰을 입력해주도록 한다.

Credential 추가 후에는 소스코드관리 Credentials 탭에서 생성한 Credential을 입력하도록 한다.
Build trigger 추가

Branches to build에는 빌드 할 브랜치명을 선택해주고, 빌드 유발에는 Github hook trigger for GITScm polling을 선택해준다. 이것은 Github의 webhook으로부터 빌드를 유발받겠다는 의미이다.
Build 추가

Build -> invoke Gradle script를 선택하고 Tasks에 수행할 빌드를 적어준다.

이때, gradle wrapper를 사용하는 경우 아래와 같이 작성한다.
Build 후 조치

Log text에는 로깅 내용이 일치하는지 확인을 위한 용도로 사용한다.

Script에는 빌드 성공 후 배포할 스크립트를 적는다.
저장

Apply 와 저장을 클릭해준다.