[GitLab CI/CD] install & register group runner

GitLab SaaS + AWS EC2 인스턴스를 Group Runner로 등록하는 방법 소개

 

 

 

1. Instance Runner 사용해제 및 Group Runner 등록

루트 그룹 Settings - CI/CD - Runners - Enable instance runners for this group 체크 해제 (shared runner 미사용)

루트 그룹 Build - Runners - New Group Runner 버튼 클릭

태그 입력 및 Run untagged jobs 체크

(체크 안하면 태그 지정이 안되어있는 경우 파이프라인이 구동되지 않을 수 있음)

Create runner 버튼 클릭

기본 설정 그대로 두고

gitlab-runner register 명령 부분 복사

View runners 버튼 클릭

생성 확인

 

 

 

2. EC2 인스턴스 프로비저닝

우분투 24.04 + 프리티어 지원 가능한 t2.micro 클래스 선택

EC2 Instance Connect 통해서 접근할거기때문에 SSH 키 페어는 생성하지 않고

보안그룹은 Instance Connect 접두사 찾아서 인바운드 트래픽 허용하도록 지정

 

 

 

3. GitLab Runner 설치 (latest 버전)

아래 명령어 순서대로 실행

curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash

sudo apt install gitlab-runner -y

# Runner 등록 시 Step 1 섹션에서 나왔던 명령어 붙여넣기
sudo gitlab-runner register\
  --url https://gitlab.com\
  --token ${token}

URL 지정하는 부분은 SaaS 기준 그대로 엔터

러너 이름 입력

executor 유형 입력 (위 예시는 shell executor)

위 정보 뜨고

깃랩 그룹러너 화면에서 위와 같이 온라인 상태 되면 성공
이후 하위그룹 내 파이프라인에서 등록한 러너로 job 실행되는지 확인