Jenkins 원격 서버 배포(Publish Over SSH) (1)

1. Architecture

설명

1 GitHub에 코드 변경 사항 발생

2 GitHub에 코드 변경 사항이 감지되면, 설정된 GitHub Webhook이 Jenkins에게 HTTP POST 요청

3 Jenkins에서 변경사항 감지하고 CI / CD 파이프라인 실행

4  빌드 & 배포

5 소프트웨어를 빌드하고 테스트한 후, Docker 이미지로 패키징하고 EC2 인스턴스에 배포한다.

 

먼저 기존에 가지고 있던 프로젝트 파일이 빌드가 잘되는지 로컬에서 확인한다.

 

2. EC2 세팅

EC2에서 인스턴스를 만들어준다. 이해의 편의성과 사용 후 ec2를 내릴거기에 ip를 가리지 않고 설명하겠다.

본인은 Ubuntu 프리티어로 만들었다. 탄력적 IP로 접속을 위한 IP를 생성한다.

만든 ec2와 연결해준다.

ec2생성시 사용한 .pem키를 이용해서 원격에 연결해준다.

ssh -i opensource.pem ubuntu@3.35.152.81

 

3. docker 설치

SWAP MEMORY

$ sudo fallocate -l 2G /swapfile
$ sudo chmod 600 /swapfile
$ sudo mkswap /swapfile
$ sudo swapon /swapfile

 

아래와 같은 화면이 뜨면 성공이다.

 

repository setup

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

docker GPG 추가

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

repository setup

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

docker install

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

docker install check

$ sudo docker run hello-world

도커가 성공적으로 설치되었다.

 

4. 젠킨스 설치

 

젠킨스 이미지 다운로드

$ docker pull jenkins/jenkins:lts

젠킨스 컨테이너

$ sudo docker run -d -p 8080:8080 -v /jenkins:/var/jenkins_home --name jenkins -u root jenkins/jenkins:lts

 

docker-compose 사용하기

docker-compose는 컨테이너들의 실행을 관리하는 도커의 기능으로, 하나의 컨테이너만 사용 할 때도 유용하다.

$ sudo apt install docker-compose

 

Docker Compose 업그레이드

$ sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

 

도커 실행 경로에서 

$ sudo vim docker-compose.yml

아래 내용 작성

version: "3"
services:
  jenkins:
    image: jenkins/jenkins:lts
    user: root
    volumes:
      - ./jenkins:/var/jenkins_home
    ports:
      - 8081:8080

 

생성한 docker-compose.yml 이 존재하는 경로에서 아래의 명령을 실행하면 복잡한 명령 없이도 도커 컨테이너를 실행할 수 있다.

• version: Docker Compose 파일의 버전
• services: Docker Compose가 관리할 서비스를 정의
  • jenkins: 관리할 서비스 이름
    • image: 사용할 이미지  지정
    • user: 컨테이너 내부에서 사용할 사용자를 지정
    • volumes: 호스트와 컨테이너 간 디렉토리를 연결하여 데이터를 유지하며, 호스트의 ./jenkins 디렉토리를 컨테이너의 /var/jenkins_home 디렉토리에 연결
    • ports: 호스트와 컨테이너 간의 포트 매핑, 호스트의 8081 포트를 컨테이너의 8080 포트로 매핑

이렇게 설정된 Docker Compose 파일을 사용하면 로컬 머신에서 Jenkins를 실행하고, 데이터를 보존하고, 8081 포트를 통해 접근할 수 있다.

 

$ sudo docker-compose up -d

-d 옵션은 컨테이너가 데몬으로 실행됨을 의미

데몬이란?

백그라운드에서 실행되는 프로세스.

프로세스들은 주로 시스템 서비스나 작업을 수행하며, 사용자의 입력을 기다리지 않고 실행

"-d" 옵션을 사용하면 프로그램이 백그라운드에서 실행되며, 보통 시스템 부팅 시 자동으로 시작되고, 사용자와의 상호 작용 없이 작업을 수행

8080포트와 http를 열어줘야한다.

http를 열어주지 않으면 webhooks가 연결이 되지않아 깃허브에 Push해도 자동으로 배포가 되지않는다.