Jenkins + GitLab Webhook + Springboot + EC2 자동배포

date

Apr 25, 2023

slug

jenkins-springboot-ec2

author

status

Public

category

📚 Study

tags

CI/CD

summary

Jenkins와 Gitlab Webhook을 통해 Springboot project 빌드하여 EC2로 자동배포 A-Z !!!

type

Post

thumbnail

1. EC2 Docker 설치

1. 커널 버전 확인 : 리눅스 커널이 최소 3.10 버전 이상이어야함

2. apt package index 업데이트하고, HTTPS를 통해 repository를 이용하기 위해 package들을 설치

sudo apt-get update 

sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

3. Official GPG Key 등록(우분투에서 필요한 과정)

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. stable repository 등록

echo \
"deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Doker Engine 설치

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

• 설치가 완료되었다면 docker --version 으로 확인할 수 있습니다.

2. EC2 Jenkins 설치

2-1. EC2 Jenkins container 설치 및 docker 실행

1. Docker 허브로부터 jenkins 이미지 pull

docker pull jenkins/jenkins:lts

2. docker.sock - Permission denied 되면

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post "http://%2Fvar%2Frun%2Fdocker.socreate?fromImage=jenkins%2Fjenkins&tag=lts": dial unix /var/run/docker.sock: connect: permission denied

3. Jenkins container 실행

docker run -d --name jenkins -p 8080:8080 -v /jenkins:/var/jenkins_home -v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -u root jenkins/jenkins:lts

• v /jenkins:/var/jenkins_home젠킨스 컨테이너의 설정을 호스트 서버와 공유함으로써, 컨테이너가 삭제되는 경우에도 설정을 유지할수 있게 해줍니다.

• v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock젠킨스 컨테이너에서도 호스트 서버의 도커를 사용하기 위한 바인딩입니다.이렇게 컨테이너 내부에서 설치없이, 외부의 도커를 사용하는 방식을 DooD(Dock out of Docker) 라고 합니다.[1]

• p 8080:8080젠킨스의 defaul port 인 8080 을 호스트 서버와 매핑해줍니다.

2-2. 브라우저에서 Jenkins 설치

1. 호스트서버 URL:8080 으로 젠킨스 브라우저 접속

2. 설치에 필요한 키값 입력

$ docker logs jenkins

3. suggested plugins 설치, 계정 생성

3. Jenkins 세팅

3-1. GitLab 사용을 위한 세팅

1. Gitlab 플러그인 설치

2. Gitlab Access Token 발급

• Token name : 아무거나 하고 싶은 이름

• Select scopes : read_repository 허용

3. Gitlab credential 생성

• Username : Gitlab 로그인 아이디

• Password : Gitlab 로그인 비밀번호 혹은 위에서 생성한 Gitlab Access Token

3-2. 빌드 후 배포를 위한 세팅

1. 배포를 위한 플러그인 Pulish over SSH 설치

2. SSH Server 생성

• SSH Server
• Name : 확인할 수 있는 이름
• Hostname : 배포할 host server IPv4 (나의 경우, EC2 IP)
• Username : ubuntu

• Key
• .pem 파일 메모장으로 열면 나오는 Key 입력

4. Jenkins Item 생성 및 Gitlab Web hook 연결

4-1. 소스코드 관리

소스코드 관리 - Gitlab 연결

• Repository URL : Gitlab 레포지토리 링크

• Credentials : 4-1. 에서 생성한 credential 연결

• Branches to build : 접근할 브랜치

4-2. 빌드 유발

1. 빌드 유발 - Webhook URL 생성, Secret token 생성

• Build when a change is pushed ~ : webhook URL 기억!

• 고급 > Secret token Generate
• 생성 후 Apply 혹은 저장을 눌러야 활성화됨!

2. Gitlab Webhooks 생성 및 연결

• URL : 위에서 생성한 젠킨스 Webhook URL

• Secret token : 위에서 생성한 젠킨스 Secret token

4-3. 빌드

Execute shell 작성

4-4. 빌드 후 조치

1. SSH를 통해 EC2로 빌드파일 보내기

• SSH Server : 2-2번에서 생성한 SSH server

• Source files : 전송될 파일의 경로(있는 곳)

• Remove prefix : 전송할 파일 경로(어디까지 보낼지, 상위폴더까지 보낼 것인지 혹은 해당 파일만 보낼 것인지 등)

• Remote directory : 전송할 위치(EC2의 S08~/back 하위에 파일을 저장하겠다는 뜻)

• Exec commend : 그 후 실행할 commend

2. Dockerfile 사용하여 container 실행

• Dockerfile도 EC2로 전송

• 기존 컨테이너 중지 및 삭제 후 컨테이너 이미지 재빌드

• 도커 컨테이너 실행

참고링크

젠킨스 SSH Server 연결하고 빌드 후 조치 알아보기

1. 젠킨스 관리에 플러그인 관리로 들어갑니다. 2. Publish Over SSH를 검색하고 플러그인을 설치합니다. 3. 다시 젠킨스 관리로 들어와서 시스템 설정으로 들어갑니다. 4. 밑으로 쭉 내리면 Publish over SSH 가 있습니다. SSH Servers 부분에서 추가를 눌러줍니다. 5. Name을 입력하고 Hostname을 입력합니다. AWS EC2일 경우 IPv4 DNS 등 입력하면 됩니다. 여기서 Username은 ec2에 유저이름을 입력해야합니다. EC2 Ubuntu의 경우 ubuntu가 유저이름입니다. 6. 이제 위에서 Publish over SSH 에서 유저 비밀번호나 key를 입력해야 합니다. 저는 비밀번호로 로그인 하기 때문에 Passphrase에 Change Password..

https://cokes.tistory.com/120

[Jenkins] Jenkins를 이용한 배포 자동화(3) - Publish Over SSH 를 이용한 원격 서버 배포

Publish over SSH 플러그인이 2022년 1월 12일 부로 젠킨스 보안 정책으로 인해 배포가 중단되었습니다. https://www.jenkins.io/security/advisory/2022-01-12/ Publish Over SSH plugin 을 사용하면 원격 서버에 SSH를 통한 배포를 할 수 있습니다. SSH란? SSH란 Secure Shell Protocol 의 약자로 네트워크 상의 다른 컴퓨터에 로그인 하거나 원격 시스템에서 명령을 실행하고 다른 시스템으로 파일을 복사할 수 있도록 해주는 응용 프로그램 또는 그 프로토콜은 가리킵니다. 1. Publish Over SSH 설치 2022년 2월 현재 젠킨스 플러그인 관리를 통한 설치가 불가능 하기 때문에 직접 .hpi 확장자를 다운로드 ..

https://minsoolog.tistory.com/45

[CI/CD] Gitlab과 Jenkins로 CI/CD 구축하기

Gitlab과 Jenkins로 CI/CD 구축하기

https://velog.io/@hanif/Gitlab과-Jenkins로-CICD-구축하기

깃랩과 젠킨스 연동

Settings>Access Tokens 에 들어가서 Project Access Tokens를 생성한다. 이름을 입력하고 'api', 'read api', 'read_repository'를 선택하고 생성한다. 그럼 아래 사진같이 access token이 나오는데 이를

https://velog.io/@psystar99/깃랩과-젠킨스-연동

Jenkins 을 활용하여 Spring boot 를 자동배포 하기(1)

# 구성도 # 사전 준비사항 본인것이거나, 권한을 가지고 있는 GitHub repository에 올라간 Spring Boot 프로젝트 2021.11.21 - [JAVA/Spring] - IntelliJ와 GitHub 연동하기 IntelliJ와 GitHub 연동하기 - 일단 스프링 부트 프로젝트를 생성하기 위해 스프링 이니셜라이저 사이트로 이동한다. https://start.spring.io/ 아래와같이 서정하고 제너레이터를 클릭하여 파일을 다운받는다. - 인텔리J를 실행시 may9noy.tistory.com 1. 도커와 Jenkins을 설치하기 2021.11.17 - [CI | CD/Jenkins] - Jenkins 설치 Jenkins 설치 # Jenkins을 설치하는 과정에 대해서 알아보자. Jenki..

https://may9noy.tistory.com/365