GitLab CI/CD Pipeline 구축

Sep 01, 2023

Contents

목차 1. CI/CD 파이프라인은 무엇일까?2. Gitlab-Runner 설치 및 등록 3. gitlab-ci.yml 작성 마무리 참고

1. CI/CD 파이프라인은 무엇일까?

CI (Continuous Integration) 지속적 통합 - Application 코드의 변경 사항이 정기적으로 빌드 및 테스트를 거쳐 공유 Repository에 병합되는 과정의 자동화 프로세스

CD (Continuous Delivery, Continuous Deploayment) 지속적 제공/배포 - 개발자의 변경 사항을

Repository에서 Production 환경까지 배포하는 과정의 자동화 프로세스

위의 자동화 프로세스 과정을 “CI/CD 파이프라인”이라고 부른다.

2. Gitlab-Runner 설치 및 등록


# Download
$ curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_amd64.deb"

# Install
$ sudo dpkg -i gitlab-runner_amd64.deb

패키지 Download 및 Install 명령어를 통해 gitlab-runner를 설치한다.

정상적으로 설치되었다면 아래와 같이 확인할 수 있다.


$ gitlab-runner --version

Version:      16.3.0
Git revision: 8ec04662
Git branch:   16-3-stable
GO version:   go1.20.5
Built:        2023-08-20T17:57:26+0000
OS/Arch:      linux/amd64

※ 만약 Git을 설치하지 않았다면 Git부터 설치하자.

gitlab-runner를 설치하였다면, Pipeline을 연결할 GitLab 프로젝트에 gitlab-runner를 등록 시켜주어야 한다.

※ 이 과정은 프로젝트의 Maintainer 또는 Owner 권한이 있는 계정으로 진행 가능하다.

Settings - CI/CD에 Runners 카테고리를 클릭하면 위와 같은 화면이 나온다.

여기서 runner를 등록하기 위해 필요한 ① GitLab URL 과 ② Registration token을 확인하고 gitlab-runner가 설치된 서버에서 등록을 진행하면 된다.


$ sudo gitlab-runner register

Runtime platform  arch=amd64 os=linux pid=9412 revision=8ec04662 version=16.3.0
Running in system-mode.                            
                                                   
Enter the GitLab instance URL (for example, https://gitlab.com/):
{GITLAB_URL}
Enter the registration token:
{REGISTRATION_TOKEN}
Enter a description for the runner:
{DESCRIPTION}
Enter tags for the runner (comma-separated):
{TAG}
Enter optional maintenance note for the runner:
{NOTE}
Enter an executor: custom, shell, instance, virtualbox, docker-autoscaler, docker+machine, kubernetes, docker, docker-windows, parallels, ssh:
{EXECUTOR}

등록이 완료되었으면 Runners 카테고리에 이와같이 Runner가 등록된다.

여기까지가 gitlab-runner 설치 및 등록 과정이다.

3. gitlab-ci.yml 작성

이제 Gitlab CI/CD 파이프라인 에 대한 세부 지침을 구성하는 .gitlab-ci.yml 작성이 남았다.


stages:
  - build
  - deploy

build:
  stage: build
  script:
    - bash mvnw clean install
    - echo "Successfully build"
  tags:
    - spring
  artifacts:
    paths:
      - target/*.jar
    expire_in: 10 min

deploy:
  stage: deploy
  needs:
    - build
  script:
    - at now < start.sh
    - echo "Successfully deploy"
  tags:
    - spring

위와 같이 stages 키워드를 이용하여 파이프라인의 단계, 이름, 순서를 정하고

해당 단계에 맞게 실행할 script를 정의해주면 된다.

여기서 Java Spring, Maven으로 구성된 Web Application을 올리기 위해

build 단계를 통해 jar를 생성하고 deploy 단계에서 생성된 jar를 배포하는 shell script를 이용하였다.

좀 더 다양한 키워드를 확인하고 싶다면 Gitlab_Docs 에서 확인할 수 있다.

여기까지 설정하였다면 개발자가 코드를 수정하고 Push를 할 때마다 아래와 같은 파이프라인이

구성되어 .gitlab-ci.yml 에서 설정한 Job을 수행한다.