Chapter2 - CPU Bound 애플리케이션(Jenkins 배포)

• 안녕하세요~ 이전에 운영하던 블로그 및 GitHub, 공부 내용을 정리하는 Study-GitHub 가 있습니다!

• 네이버 블로그

• GitHub

• Study-GitHub

• 🐔

---

✔ CLASS101 백엔드 시스템 실무 - Chapter2 CPU Bound 애플리케이션

안녕하세요, 클래스101 백엔드 시스템 실무 강의를 듣고, 복습 차원으로 정리하여 남기려고 합니다! 혹시 문제가 된다면 글을 삭제하겠습니다 !!

 

class101.net/products/5fc4a3b4fc231b000d85661b

현직 대기업 개발자 푸와 함께하는 진짜 백엔드 시스템 실무!

---

 

 

✔ Jenkins를 이용해서 배포하기

• Build & Deploy

• Batch

• GCP 인스턴스는 Jenkins용 인스턴스 한 개와 애플리케이션 실행용 인스턴스 한 개, 총 두 개의 인스턴스로 구성

 

 

 

 

 

🎗 GCP 인스턴스 생성

Jenkins용 GCP 인스턴스를 생성합니다.

    • 이름 & 리전(서울) & 머신 유형(e2-micro) & 부팅 디스크(CentOS 7) & 방화벽 허용 을 설정하고 생성합니다.

 

application용 GCP 인스턴스를 생성합니다.

    • 이름 & 리전(서울) & 머신 유형(e2-micro) & 부팅 디스크(CentOS 7) & 방화벽 허용 을 설정하고 생성합니다.

 

 

 

 

🎗 GCP 인스턴스에 Jenkins 설치하기

• wget 설치

    • sudo yum install wget

 

• Maven 설치

    • sudo yum install maven

 

• git 설치

    • sudo yum install git

 

• docker 설치

    • sudo yum install docker

 

• Jenkins 설치 & 데몬 실행

    • 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 

    • sudo yum install jenkins 

    • sudo systemctl start jenkins   (jenkins 데몬 실행)

    • sudo systemctl status jenkins (jenkins 실행 상태 여부 확인)

 

 

 

 

🎗 GCP 방화벽 8080 포트 열기

Jenkins는 8080포트로 떠있기 때문에, 8080 포트를 열어줍니다.

GCP 인스턴스에서 방화벽 규칙 설정 클릭

 

 

 

방화벽 규칙 만들기 클릭

 

 

 

위와 같이 이름, 대상, 소스 IP 범위, 프토토콜 및 포트 를 수정하고 만들기를 누릅니다.

0.0.0.0/0 ==> 모든 IP 대상

 

 

 

 

🎗 Jenkins 접속 & 설정

인스턴스의 외부IP:8080 으로 접속하면, 위와 같은 화면이 나옵니다.

위 화면에서 관리자 패스워드를 입력하는 부분이 있는데, 아래 명령어를 통해 비밀번호를 확인하고 입력합니다.

 

 

$ sudo cat /var/lib/jenkins/secrets/initialAdminPassword

 

 

 

 

비밀번호를 입력하고 다음으로 넘어오면, 위 화면이 나오는데요

좌측은 추천 플러그인을 설치하는 것이고, 우측은 선택된 플러그인만 설치하는 버튼입니다.

여기서는 좌측 Install suggested plugins 를 클릭합니다.

 

 

 

 

플러그인을 모두 설치한 뒤 계정을 생성합니다.

 

 

 

 

Jenkins URL에는 현재 접속한 URL을 그대로 사용합니다.

 

 

 

 

위 화면에서 Start using Jenkins를 클릭하면 Jenkins 설정은 모두 끝나게됩니다.

 

 

 

 

위와 같은 초기 화면이 나오면 정상적으로 Jenkins를 사용할 수 있는 상태입니다.

 

 

 

 

 

 

좌측 Jenkins 관리 > 플러그인 관리 > 설치 가능 > SSH 입력 > Publish Over SSH 클릭 > 재시작 없이 설치하기

 

 

 

 

 

Publish Over SSH 정상적으로 설치된 화면 -> 메인 페이지로 돌아갑니다.

 

 

 

• 대칭키, 비대칭키

• 대칭키

    • 암호화에 사용하는 키와 복호화에 사용하는 키가 동일한 것

 

• 비대칭키

    • 암호화에 사용하는 키와 복호화에 사용하는 키가 다른 것

비대칭키의 암호화, 복호화에 사용되는 키는 분명 '다른 값' 이지만 연관되어 있는 값입니다.

 

대칭키, 비대칭키 참고

 

🎗 Jenkins 공개키 설정

$ ssh-keygen -t rsa -f ~/.ssh/id_rsa

위 명령어를 통해 공개키를 생성합니다.

(중간에 엔터 키를 한번 누릅니다.)

 

 

해당 파일은 /home/zzang9haha/.ssh 파일에 저장이 생성 되었습니다.

    • id_rsa => 개인키

    • id_rsa.pub => 공개키

 

 

 

 

$ vi id_rsa.pub

application용 GCP 인스턴스에 등록하기 위해 위 명령어를 통해 공개키를 확인하고 복사 합니다.

그 후 application GCP 인스턴스 SSH로 접속합니다.

 

 

다음 명령어를 통해 설정 파일로 들어갑니다.

$ vi -/.ssh/authorized_keys

 

 

 

 

위에서 복사한 id_rsa.pub 파일의 내용을 붙여넣기 합니다.

(간혹 엔터키도 같이 복사가 되는 경우가 있어서, 위와 같이 붙여넣기가 잘 되었는지 확인합니다.)

(esc => :(콜론) => wq 입력 후 엔터 치면 저장되고 vi 에디터모드를 나가는 명령어입니다.)

 

 

 

※ GCP에서 따로 Jenkins의 공개키를 등록하는 방법은 다음과 같습니다.

GCP 인스턴스 > 메타데이터 > SSH키 > 수정

위로 들어가서 공개키를 붙여넣기 해주시면 됩니다.

 

 

 

 

위 명령어를 통해 디렉토리와 파일의 권한을 수정합니다.

 

 

 

 

Jenkins 사이트에서 Jenkins 관리 > 시스템 설정에서 SSH key를 설정합니다.

(jenkins GCP 인스턴스에서 id_rsa 파일의 내용을 복사하시면 됩니다.)

 

 

 

 

 

바로 아래 부분에 SSH Servers를 추가합니다.

    • Name: GCP 인스턴스의 이름

    • Hostname: GCP 인스턴스의 내부 IP

    • Username: GCP 인스턴스에서 SSH에 접속했을 때 나오는 계정

    • Remote Directory: GCP에서 hoem 디렉토리의 경로(cd ~)

 

 

 

 

위 Test Configuration 을 눌러 Success 라는 메시지가 뜨면 저장을 눌러줍니다.

 

 

 

 

 

 

🎗 Jenkins에 배포 스크립트 작성

Jenkins에서 배포 스크립트는 Item이라는 단어로 관리가 되는데, 새로운 Item을 클릭합니다.

 

 

 

 

item name을 설정하고, Freestyle project 클릭 후 OK 버튼을 누릅니다.

 

 

 

 

다음 화면에서 다른 부분은 손대지말고, 빌드 후 조치에서 Send build artifacts over SSH 를 클릭합니다.

 

고급 클릭 > Verbose output in console 체크(로그를 자세히 출력) 합니다.

그 후 Exec command 에서 docker run 명령어를 입력하고 저장합니다.

 

 

 

 

저장이 끝난 후 좌측에 Build Now를 클릭하면 아래 #1 이라고 생성된걸 볼 수 있습니다.

 

 

 

#1 을 클릭하고, Console Output을 클릭하면 콘솔 로그가 나오는데, 정상적으로 실행이 되지 않았습니다.

 

sudo: docker: command not found

sudo 명령어를 찾을 수 없다는 에러입니다.

 

 

 

프로젝트 돌아가기 > 구성 클릭 후 Exec command 부분을 수정합니다.

sudo 를 제거하고, 좌측 포트(외부)를 8080으로 수정합니다.

 

 

 

그 후 다시 Build Now를 클릭하면, #2가 생성되는데 로그를 확인해봅니다.

 

 

 

 

docker를 찾을 수 없다는 오류입니다.

Jenkins GCP에는 docker을 설치했으나, application GCP에는 docker을 설치하지 않아서 발생하는 오류입니다.

application GCP에도 docker을 설치한 후 데몬을 실행합니다.

$ sudo yum install docker

$ sudo systemctl start docker

위 과정이 끝나면 Jenkins에서 다시 Build Now를 누르고, 로그를 확인해봅니다.

 

 

 

 

 

이번에도 빌드가 실패했습니다. 권한 관련 오류입니다.

해당 파일의 권한을 수정합니다.

$ sudo chmod 666 /var/run/docker.sock

 

 

 

 

다시 Build Now를 클릭하고 로그를 확인합니다.

위와 같이 모래시계가 나오면서, 실행이 되지 않는데요,,

이는 로그가 출력되면서 배포가 끝난 상태가 아니라고 Jenkins가 판단하기 때문입니다.

 

 

먼저 위 작업은 종료를 한 뒤(X 버튼) 구성으로 돌아갑니다.

 

 

 

 

위와 같이 Exec command 부분을 수정합니다.

    • nohup: 명령을 백그라운드로 실행

    • > dev/null ~ : 표준 에러를 표준 출력으로 Redirection

 

 

 

이번엔 노란색 불이 아닌 파란색 불로 들어왔는데, 로그를 확인해봅니다.

 

정상적으로 실행이 된 걸 볼 수 있습니다.

 

 

 

 

 

 

🎗 애플리케이션 실행 테스트

마지막으로 애플리케이션이 정상적으로 실행 되었는지 테스트를 진행합니다.

아래 URL로 접속을 합니다.

    • URL: 외부 IP:8080/hash/123

 

드디어, 정상적으로 애플리케이션이 실행된 걸 볼 수 있습니다 !! 😍