[DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - 자동화 도구의 사용

 

 

 

이 내용은 인프런 - Jenkins를 이용한 CI/CD Pipeline 구축 강의를 보고 정리한 내용 입니다.


해당 내용의 Code 내용은 이 곳에서 확인하실 수 있습니다.

🗂 목차

● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - 자동화 도구의 사용
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - Jenkins + Infrastructure as Code 와의 연동
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - Jenkins + Ansible + Kubernetes 와의 연동
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - Advenced Jenkins 사용 ① - Pipeline
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - Advenced Jenkins 사용 ② - SonarQube
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - Advenced Jenkins 사용 ③ - Multi Nodes
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - 상용 클라우드 환경에 배포하기
● [DevOps] Jenkins를 이용한 CI/CD Pipeline 구축 - 부록

 

 

🚀 자동화 도구의 사용

    🔽  Jenkins를 이용한 CI / CD 사용

        📦 CI / CD를 위한 Git, Maven 설정

Manage Jenkins -> Jenkins Plugins -> available -> github

최초 github Plugin이 설치 되어 있는지 확인을 해야 해요.
설치가 되어 있지 않다면 설치를 해야 합니다.

주니하랑은 위와 같이 설치가 되어 있어요.



Manage Jenkins -> Global Tool Configuration -> git

Jenkins 관리에서 Global Tool Configuration에 들어가면 아래와 같이 Git에 대한 설정 부분이 있어요.

위에 그림에서 이름은 Git 관련하여 이름을 자유롭게 지정해 주면 되고, Path to Git executable에는 git 관련 명령어를 넣어주면 되요.

이 곳에 git을 넣었다는 것은 git 명령어를 사용할 때, 명령어 접두사가 git으로 시작하기 때문이고, 이를 사용할 수 있는지를 확인하기 위해서에요.

주니하랑은 Synology NAS에 docker를 이용하여 Ubuntu를 설치했고, 그 안에 Jenkins를 설치해 주었어요.
현재 Docker로 기동되고 있는 Container는 위와 같이 3개가 존재하고 있어요.

Jenkins가 구동중인 Container에 접속하기 위해 Container ID 값을 위와 같이 입력하고, bash shell을 이용하겠다고 정의한 명령어를 입력해 주었더니 해당 Container에 접속할 수 있었어요.

Jenkins Container에 git이 설치 되어 있는지 확인하기 위해 위와 같이 확인을 해 주었어요.

주니하랑은 2.34.1 Version에 git이 설치 되어 있어요.



이번에는 maven plugin을 설치해 보도록 할게요.

Manage Jenkins -> Jenkins Plugins -> available(설치 가능) -> maven

 

위와 같이 maven Plugin을 찾아 설치해 주도록 할게요.

Manage Jenkins -> Global Tool Configuration

 

해당 Plugin이 설치가 완료 되었다면 Global Tool Configuration에 Maven 쪽으로 이동을 해 주세요.

728x90

Add Maven을 누르면 위와 같이 Maven을 설치하고, 설정할 수 있는 부분이 나와요.

Install automatically를 누르면 Jenkins Server에 maven을 자동으로 설치해 줄 거에요.

mvn --version

Jenkins Container에서 설치 되어 있는지 확인해 보기 위해 명령어를 입력해 주었더니 역시 설치가 되지 않은 것을 확인할 수 있는 것이에요.

주니하랑은 최신 버전보다 한단계 아래 Version인 3.8.5 Version을 설치해 주도록 할게요.

맨 밑에 Apply를 누르고, save를 누른 뒤 해당 화면을 나와줍니다.






이번에는 Meven Project를 만들어 주도록 해볼게요.

Item name

 

Jenkins Main 화면에서 new Item을 누르면 위와 같은 화면을 만날 수 있어요.

주니하랑은 위와 같이 Item 이름을 정의해 주었어요.

이제 Maven project를 누른 뒤 OK를 눌러주면 됩니다.

General 부분에 간단한 maven 관련 Command를 입력해 주었어요.

Github과 Jenkins 연동을 위해 해당 Project를 위한 Repository를 만들어 주었어요.

이제 위와 같이 준비된 Repository를 연결해 보도록 할거에요.

Jenkins에서는 소스 코드 관리에 위와 같이 Github Repository 주소를 입력해 주었어요.

Credentials는 해당 Git hub Repository가 Private이라면 접속하기 위한 계정값을 넣어야 해요.
하지만, 지금은 Pubilc이기 때문에 넣지 않아도 됩니다.

Pre Steps를 누르게 되면 위와 같은 창을 만날 수 있어요.

해당 Project는 Meven을 이용하기 때문에 Source Code를 Meven Build Tool로 Compile을 하도록 작업할 것이에요.

Meven 설정 관련 내용은 pom.xml에 들어가 있어요.

Root Pom은 이 설정값이 들어간 File인 pom.xml을 바라보게 해주고,

Goals and options에는 Build를 할 때, 어떤 항목들을 가지고 Build할 것인지를 선택해 주어야 하는데, 이 내용을 입력해 주면 되요.

명령어	내   용
clean	기존에 Build한 내용이 있다면 지우기 위해 사용. (target Directory 삭제)
compile	Code를 Compile하여 Build하기 위해 사용.
package	compile된 내용에 따라 pom.xml에 지정된 Option에 따라 Package File 만들기 위해 사용.

기본적으로 Maven과 Gradle을 jar, war 형태에 Package File을 제공하고 있어요.

 

💡 참고 사항

Spring Boot Project는 두가지 형태로 Program을 기동할 수 있어요.

첫번째는 Web Application인 경우 임베디드 톰켓을 내장하고 있는 경우에요. 이 때, jar 형태로 Packaging을 했을 때, 해당 jar를 실행하게 되면 톰켓이 구동되는 방식이에요.

두번째는 내장된 톰켓이 아닌 다른 Web Application Server에 Packaging된 File을 복사하여 해당 Server 안에서 기동될 수 있게 구동되는 방식이고, 이 때는 war 형태로 이용을 해주면 되는 것이에요.

pom.xml

pom.xml을 확인해보면 Packaging을 war로 하겠다고 설정되어 있기 때문에 Build가 성공적으로 끝나면 war File로 Packaging이 될 것이에요.

 

 

이렇게 설정이 완료 되었으면 저장을 해 줍니다.

그런 뒤 지금 빌드(Build now)를 선택해 주도록 할게요.

그럼 위와 같이 Build가 되는 것을 볼 수 있어요.

위의 작업 번호를 누르면 보다 자세한 내용을 확인할 수 있어요.

Console Output을 누르면 작업 내용을 보다 상세히 볼 수 있습니다.

위와 같이 Build 작업이 성공하였어요.

해당 Project에 Workapce를 통해 내용을 확인 해 볼게요.

이 곳에서 target에 들어가 보면 아래와 같이 war File이 만들어진 것을 확인할 수 있어요.

 

참고로 Jenkins Container 내에서 위의 위치에 war File이 저장된 것을 확인할 수 있어요.

 

 

 

 

        📦 CI / CD를 위한 Tomcat Server 연동

이번에는 Jenkins Plugin 중 Deploy to container(Tomcat Plugin)를 설치해 볼게요.

Manage Jenkins -> Jenkins Plugins -> available(설치 가능) -> deploy to container plugin

반응형

위의 Plugin을 설치해 주도록 할게요.

💡 참고 사항

Deploy to container 란?

Jenkins를 통해 Packaging 한 war 혹은 jar File을 Tomcat Web Application이 설치된 Server에 복사하여 구동.

 

설치가 완료 되었다면 두번째 Project를 만들어볼게요.

General에 간단한 설명문을 넣어주었어요.

소스 코드 관리에서 Git을 선택해 주었고, Repository URL에 해당 Git Repository에 주소를 입력해 주었어요.

Public Repository 이기 때문에 Credentials는 none으로 두고, 해당 Respository에서 작업할 Branch를 꼭 맞춰주어야 해요.

주니하랑은 master Branch에 push가 되면 작업할 것이기 때문에 master로 해주었습니다.

Build를 할 때, Maven Build를 할 것이기 때문에 Root POM에 pom.xml을 입력해주어 실행될 수 있게 해주었습니다.

그 다음 빌드 후 조치에 내용을 추가해 볼게요.

빌드 후 조치 추가를 눌어 Deploy war/ear ...를 선택해 줍니다.

 

Build 단계에서 war 혹은 jar File로 Packaging (압축)이 된 것을 어떤 작업을 할 것인가를 정의해 주는 부분이에요.

주니하랑은 해당 Packaging을 Container에 배포를 할 것이기 때문에 위의 내용을 선택한 것이에요.

WAR/EAR files에는 상위 Directory 모두를 포함해서 .war라고 이름지어진 Packaging된 File을 선택하겠다는 것이에요. 

Context path에는 위에서 확인한 war File 위치를 알려주면 되요.

그런 뒤 Tomcat 9 Version을 선택해서 Container에 대한 정보를 입력해 줄게요.


아래 작업을 진행하기 전에 Tomcat Web Application Server를 설치해 주어야 해요.

해당 내용은 이 곳에 정리 해 두었습니다.

최초 Credentials에 Add를 눌러주세요.

tomcat 계정 및 권한 정보

 

주니하랑은 Tomcat을 설치할 때, 위와 같이 계정과 권한 정보를 입력해 주었어요.

위와 같이 kind에 Username with password를 선택해주고, Username과 password에 deployer를 입력해 주세요.

 

Tomcat URL은 Tomcat Server가 설치되어 있고, 해당 Tomcat Port 번호를 입력해 주시면 되요.

주니하랑의 Tomcat Server IP 주소는 위와 같이 되어 있어요.

배포하기 전 Tomcat Server에는 war File이 Tomcat Home에 없는 것을 확인할 수 있어요.

지금 빌드 (Build Now)

 

 

 

지금 빌드를 눌러 빌드를 실행 해 볼게요.

정상적으로 Build / 배포가 성공한 것을 확인할 수 있어요.

Tomcat Server에 war File도 전달된 것을 확인할 수 있어요.

https://{tomcat IP or Domain}:Port 번호/manager/html

 

Tomcat Manager Page에 보면 /hello-wold 라는 경로의 Application이 생성된 것을 확인할 수 있어요.

실행 중에는 true로 되어 있는 것을 보아 정상 구동 중인것을 확인할 수 있어요.

해당 Application URL을 입력해서 들어가니 아주 잘 동작중인 것을 확인할 수 있어요.

        📦 PollSCM 설정을 통한 지속적인 파일 업데이트

이번에는 Update된 내용을 확인을 해서 변경 사항이 있다면 Build를 자동으로 할 수 있는 방법에 대해 공부해 볼게요.
PollSCM은 Polling 작업을 주기적으로 하는 것이에요.

주니하랑은 Build Triggers(빌드 유발)에 Build periodically(Code에 변경 사항이 없어도 일단 Build 수행)에 cron job을 만들어서 특정 시간에 Build가 지정되도록 설정할 것이에요.

여기서는 일정 시간이 되면 자동으로 가져오게 하거나, 변경된 내용이 있으면 가져오는 작업을 할 수 있어요.

만약 Poll SCM 방식을 이용한다면 Code에 변경 사항이 있을 때, Github에서 수정된 내용을 가져오게 되는데, 즉, Commit에 대한 내용이 있을때만 가져오는 방식이에요.


주니하랑은 이번에 Poll SCM 방식을 공부해 볼게요.


위에서 진행한 Project에서 구성 Tab을 클릭하여 줍니다.

이 곳에서 빌드 유발 내용을 수정해 줄 것이에요.

그리고 위와 같이 *을 하나 입력하고, 한 칸 띄고 해서 5개를 입력해 주세요.

위의 내용은 Linux / Unix의 Crontab과 동일한데, 해당 내용을 한번 찾아보시길 권고 드립니다.

위의 내용은 매초마다 변경사항을 확인하겠다는 의미에요.


위에 내용을 수정하고, Apply -> Save를 눌러주세요.


실제 Web을 구동하는 환경에서는 매 초마다 확인하게 설정하진 않을거에요.

src/main/webapp/WEB-INF/view/index.jsp

 

위와 같이 Code를 추가해 주었어요.

그리고 위와 같이 Push를 해주었어요.

이렇게 자동으로 Jenkins에서 Build 작업이 실행되는 것을 확인할 수 있어요.

실제 배포가 제대로 되어서 위와 같이 확인이 되었어요.

    🔽  Docker를 이용한 실습 환경 구성

        📦 SSH + Docker가 설치되어 있는 Container 사용하기

이번에는 외부에 있는 Server에 배포를 하는 방법을 알아보도록 할게요.

먼저 Jenkins에서 publish Over SSH를 설치해 줄게요.

Manage Jenkins -> Jenkins Plugins -> available(설치 가능) -> publish Over ssh

주니하랑은 이제 아래와 같은 작업을 할 거에요.

1. Jenkins에서 war File을 SSH를 이용해서 Server로 복사
2. Server에서 Dockerfile을 만드는데, war File과 Docker Image를 빌드하여 만듦.
3. Docker Image를 Container로 생성.

최초 Jenkins의 Jenkins 관리에서 플러그인 관리로 들어갑니다.

설치 가능에서 publish Over ssh Plugin을 설치해 주세요.

주니하랑은 Test를 위해 test_ubunut 라는 Container를 하나 생성해 주었어요.

sudo docker exec -it {CONTAINER ID} bash

 

위와 같이 Test용 Ubuntu에 접속해 줄게요.

apt-get update && apt-get upgrade -y

먼저 위 명령어를 통해 apt를 update 해 주도록 할게요.

apt-get install openssh-server

위와 같이 ssh를 설치해 주세요.

systemctl 명령어를 통해 ssh 기동 상태를 확인하려 하였으나, 위와 같이 문제가 발생하였어요.

이번에는 systemctl을 설치해 주도록 할게요.

현재 ssh가 죽어있는 것을 확인할 수 있어요.

systemctl로 ssh가 자동 기동되게 하고, 데몬을 시작해 주려 하는데, 위와 같이 문제가 생긴다면 /etc/init.d/를 이용해서 기동할 수 있어요.

위와 같이 정상 기동중인 것을 확인할 수 있어요.

 

이번에는 주니하랑이 리눅스에서 좋아하는 Text Editor인 vim을 설치해 줄게요.

위의 명령어로 몇가지 설정을 바꿔줄게요.

최초 Port 22라고 써진 부분이 주석처리 되어 있을텐데, 주석을 해제하고, 10022로 바꾸어 주었어요.

그런 뒤 PermitRootLogin을 yes로 바꿔 Root 계정으로 ssh 접속을 허용하여 주었어요.
(실제 운영 Server와 같은 곳에서는 ssh로 Root에 바로 접근할 수 있도록 하면 안되요.)

해당 명령어로 ssh를 재 기동하여 주었어요.

 

💡 참고 사항
docker 기동 명령어

#docker run --privileged --name {docker container name} -itd -p 10022:10022 -p 8081:8080 -e container=docker -v /sys/fs/cgroup:/sys/fs/cgroup --cgroups=host {docker Image Name} /usr/sbin/init

privileged : root 권한을 획득하기 위한 Option
-itd -p : Port Fowarding을 위한 Option

현재 ssh가 설치된 Ubuntu ip는 위와 같아요.

한번 ssh로 접속해 볼게요.

그 전에 해당 Container root 계정에 Password를 위와 같이 만들어 주세요.

Password가 등록되지 않으면 ssh로 접근할 수 없어요.

위와 같이 정상적으로 ssh로 접근하는 것을 확인할 수 있어요.

Jenkins 관리에서 시스템 설정에 들어가 줄게요.

밑에 내리다 보면 위와 같이 Publish over SSH가 나올거에요. 여기서 SSH Servers 밑에 추가 버튼을 눌러주세요.

 
먼저 Name에는 해당 Docker Container 이름을 넣어주세요.
Hostname에는 Container의 IP를 넣어주세요.
Username에는 ssh로 접속할 Container 계정 이름을 넣어주시면 되요.

Remote Directory는 현재 위치를 의미하는 . 을 넣어주었어요.

Use password ...를 활성화하면 Password를 입력할 수 있는 곳이 나오는데, root 계정의 비밀번호를 입력해 주면되요.

그런 뒤 Port에는 해당 Server의 ssh Port 번호를 넣어주면 됩니다.

위와 같이 Test Button을 눌렀을 때, Success가 뜬다면 정상 설정한 것이에요.


해당 공부를 위해 주니하랑이 설치했던 SSH Server에 Docker도 설치해 줘야 해요.

이 부분에 대해서는 이 곳에 정리해 두었어요.

        📦 Docker Container에 배포하기 ①

새롭게 Item을 하나 만들어 줄게요.

기존에 만들었던 Item과 크게 차이가 없기 때문에 Copy from을 통해 이 전에 만든 Project를 불러오도록 할게요.

이 전에 Poll SCM을 통해 Project를 진행했었는데, 이번에는 제외하도록 할게요.

그리고, 빌드 후 조치에 Deploy war/ear to a container를 삭제해 줄게요.

그런 뒤 위와 같이 ssh를 통해 배포가 되도록 설정해 줄 것이에요.

Name에는 SSH Server 즉, Docker Container 이름을 적어주면 되요.

Source file에는 war가 담긴 Directory 이름까지 넣어서 입력을 해줄게요.

target이라는 Directory는 ssh Container에서 복사될 필요가 없기 때문에 Remove Prifix에 target을 넣어 war File만 복사되도록 해줄게요.

ssh를 통해 해당 Container에 root로 접속하게 되면 최초 Directory 위치가 /root에요. 
이 곳에 그대로 복사되게 하기 위해 현재 위치를 의미하는 . 을 넣어주었어요.

Exec command에는 해당 Container에 복사가 완료된 뒤 어떤 명령어를 실행할지를 적는 곳인데, 이번에는 복사가 되는 것까지만 확인하기 위해 공란으로 두도록 할게요.

Apply -> save를 눌러 해당 창을 나와 주세요.

현재 ssh Container에 File들은 위와 같이 있어요.

이제 Build를 진행해 볼게요.

Jenkins가 Build / 배포가 완료되었다고 하네요!

ssh Container에서 확인을 해보니 hello-word.war가 생긴걸 확인할 수 있어요.

이번에는 Dockerfile을 하나 만들어줄게요.

From에서는 Container 종류를 적는 곳인데, tomcat 9.0이 설치된 Container를 지정해 주었고,

COPY 부분에 현재 Directory에 있는 hello-world.war File을 해당 Container에 /usr/local/tomcat/webapps 안에 복사하겠다는 의미에요.

참고로 지금 Docker Container 안에 또 다른 Container를 넣고 있다는 것을 잊으면 안되는 것이에요.

다시 Jenkins에 해당 Project에 구성 설정을 들어와서 아까 공백으로 남겨두었던 곳에 위의 명령어를 입력해 주세요.

명령어 내용은 docker를 Build할거고, Container 이름은 docker-server로 할 것이며, Dockerfile을 통해 현재 위치(.)에서 build해라 라는 의미에요.

여기서 -f Options은 Dockerfile을 명시적으로 입력했을 때 사용하는 Option이에요.

다시 Build를 진행해 볼게요.

작업이 정상적으로 완료 되었어요!

ssh Container를 확인해보니 Tomcat Container가 정상적으로 올라간 것을 확인할 수 있어요.

위에 명령어로 Tomcat Container를 기동시켜 볼게요.

참고로 현재 ssh Container에서는 8080 Port를 쓰고 있지 않아요. 그 밖에 Host Server 등에서 8080 Port를 쓰고 있기 때문에 충돌날 일이 없어 위와 같이 Port Forwarding을 해 주었어요.

뭐가 엄청나게 나오는 것을 확인할 수 있어요.

위와 같이 정상적으로 접속되는 것을 확인할 수 있어요.

참고로 Container를 확인할 때는 아래의 명령어를 사용할 수 있어요.

sudo docker ps
sudo docker ps -a

Container를 제거하려면 아래 명령어를 사용할 수 있어요.

sudo docker rm {Container ID 또는 Container 이름}

Docker Image를 확인할 땐 아래 명령어를 사용할 수 있어요.

sudo docker images

Docker Image를 삭제할 때는 아래 명령어를 사용할 수 있어요.

sudo docker remove image {image Id 혹은 이름}
# 또는
sudo docker rmi {image Id 혹은 이름}

🧐 참고 자료

Jenkins를 이용한 CI/CD Pipeline 구축 강의