[Gitlab][CI/CD] GitLab Runner 설치

 

 

(영문도서) Automating DevOps with GitLab CI/CD Pipelines: Build efficient CI/CD pipelines to verify sec... Paperback

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

 

 

 

 

 

🚀 GitLab Runner 설치

    🔽 개요

        📦 소개

이 전 글을 통해 주니는 내부 서버에 Gitlab(깃랩)을 설치하여 주었어요. 해당 내용은 이 곳에서 확인하실 수 있어요.

[Ubuntu] Docker gitlab 설치

 

깃랩 무료 버전을 이용하더라도 Github(깃헙) 등과 같이 CI/CD를 이용할 수 있답니다.
그래서 이번에는 해당 내용에 대해 설치 및 구성하는 방법에 대해 정리해 볼게요.

 

    🔽 설치하기

        📦 GitLab Runner 설치

최초 설치 전 GitLab Runner Working Directory (작업 디렉터리)와 Data(데이터)를 영속적(Persistent)로 저장하기 위한 Bind mount(바인드 마운트) 디렉터리를 만들어 주어야 해요.

mkdir -p ...../gitlab-runner/config

위와 같이 만들고, 해당 디렉터리 소유권을 $USER로 변경하고, 권한을 변경해 줄게요.

sudo chown -R $USER : $USER {디렉터리 위치}

그런 뒤 docker-compose(도커 컴포즈).yml 파일을 만들어 줄게요.

docker-compose.yml

728x90

주니는 위와 같이 만들어 주었어요.


이제 기동 시켜 볼게요.

docker-compose up -d

 

기동이 잘 된 걸 확인할 수 있어요.

 

 

 

 

 

    🔽 등록하기

        📦 GitLab Runner 등록

깃랩 UI에는 Access(접속)할 사용자에 따라 세 가지 유형의 Runner(러너)가 있어요.

첫째: 공유 러너는 깃랩 인스턴스의 모든 그룹 및 프로젝트에서 사용할 수 있어요. (Admin Area의 CI/CD > Runners)
두번째: 그룹 러너는 그룹의 모든 프로젝트와 하위 그룹에서 사용할 수 있어요. (그룹의 Settings > CI/CD > Runners 섹션)
세번째: 특정 러너는 특정 프로젝트와 연결되요. 일반적으로 특정 러너는 하나의 프로젝트에서만 사용되요. (프로젝트의 Settings > CI/CD > Runners 섹션)

주니는 Shared Runner (공유 러너) 등록 방법을 진행해 볼게요. 참고로 관리자 계정으로 해야 해요.

깃랩 왼쪽을 보면 위와 같이 네비게이션 바가 있는데, Admin Area로 접속해 줄게요.

그런 뒤 CI/CD Tab에 Runner(러너)로 들어가 줄게요.

위와 같이 러너 인스턴스를 만들어 줄거에요.

위와 같이 OS 종류를 선택하고, Run untaged jobs를 체크하여 Tag(태그) 없이 러너를 사용할 수 있도록 해 줄거에요.
이렇게 한 뒤 Create Runner를 클릭하여 러너를 만들어 줍니다.

이렇게 한 뒤 깃랩 러너 컨테이너에 접속 해 줍니다.

docker exec -it {컨테이너 ID} /bin/bash

 

위와 같이 나오면 명령어를 복사해서 깃랩 러너 컨테이너에 입력해 주면 됩니다.

위 명령어 중 url 내용을 깃랩 external_url 내용과 동일하게 맞춰주고, --token 부분에 위와 같이 토큰 값을 입력해 주면 되요.

∙ Enter the GitLab instance URL: 아무것도 입력하지 않고, Enter를 눌러주면 --url 값이 생성됩니다.
∙Enter the registration token: 아무것도 입력하지 않고, Enter를 눌러주면 --token이 설정됩니다.
∙Enter a description for the runner: 러너에 대한 설명을 입력하고 Enter를 눌러줍니다.
∙Enter tags for the runner: 아무것도 입력하지 않고, Enter를 눌러줍니다.
∙Enter an executor: docker을 입력하고, Enter를 눌러줍니다.
∙Enter the default Docker image: ubuntu:latest를 입력하고, Enter를 눌러줍니다.

 

위와 같이 정상적으로 설정된 걸 볼 수 있어요.

위와 같이 나오면 정상이에요!

이제 Go to runners page 버튼을 눌러줍니다.

CI/CD -> Runners Page

위와 같이 러너 목록이 표시되면 정상적으로 등록된 것이에요.

 

 

 

    🔽 구성하기

        📦 GitLab Runner 구성

깃랩 러너 및 등록된 개별 러너의 동작을 변경하는 부분에 대해 알아볼게요.
깃랩 러너의 구성을 변경하려면 컨테이너 안의 config.toml File(파일)을 수정해주어야 해요.
대부분 옵션 변경 시 깃랩 러너를 다시 시작할 필요가 없어요. 여기에는 listen_address를 제외한 [[runners]] Section(섹션)의 Parameter(파라미터)와 Global 섹션의 대부분의 파라미터가 포함된답니다.

깃랩 러너는 3초마다 구성 수정사항을 확인하고, 필요한 경우 다시 로드하게 되어 있어요.

 

        📦 Job Concurrency (동시성) Configuration(설정)

깃랩 러너가 동시에 여러 Job(작업)을 실행할 수 있도록 적절하게 concurrent를 수정해 줄 수 있어요.
예를 들어 4vCPU/16GiB인 경우 concurrent = 4로 설정해 주면 좋아요.
GitLab.com의 Auto-Scaling(자동 확장) Shared Runner(공유 러너)는 단일 작업이 1 vCPU와 3.75GiB를 사용하여 단일 인스턴스에서 실행되도록 구성됩니다.

 

        📦 Docker Privlieged(특권) Mode(모드) 설정

아래 CI Pipeline(파이프라인 - .gitlab-ci.yml)과 같이 Docker-in-Docker Container(컨테이너)를 사용하여 docker build와 같은 Script를 실행하기 위해서는 특권 모드 설정이 필요해요.

image: docker:git
services:
- docker:dind

build:
  script:
  - docker build -t my-image .
  - docker push my-image

반응형

 

[runners.docker] 섹션에서 privileged = true로 설정해 줍니다.

위에서 이야기 했던 러너 Option(옵션)을 수정하려면 러버 작업 디렉터리 (예: /data/gitlab-runner)에서 아래 명령어를 실행하고, 수정해 줄 수 있어요.

 

/etc/gitlab-runner/config.toml

 

vim config.toml

vim Editor(에디터)를 통해 수정하려고 하는데, 위와 같이 설치가 안되어 있어요.
또한 해당 컨테이너는 데비안 계열의 우분투인 것을 확인할 수 있어요.

apt 명령어를 통해 설치해 줄게요.

apt-get update && apt-get upgrade

먼저 apt 업데이트를 진행해 줄게요.

apt-get install -y vim

위와 같이 설치를 진행해 주었어요.

cat /etc/gitlab-runner/config.toml

위 설정 파일을 변경해 주도록 할게요.

vim /etc/gitlab-runner/config.toml

주니는 위와 같이 concurrent = 3으로 변경해 주었어요.

 

여기까지 되었다면 깃랩의 CI/CD 기능을 이용할 준비가 모두 끝난 것이에요.

추후 깃랩으로 CI/CD 작업을 하게 되면 해당 내용을 또 공유하도록 할게요.

 

 

 

🧐 참고 자료

워크숍 정보 - Setup CI/CD System with GitLab

 

 

 

(영문도서) Automating DevOps with GitLab CI/CD Pipelines: Build efficient CI/CD pipelines to verify sec... Paperback

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."