Gitlab에 러너를 등록하기

목차

• 소개
• 러너 등록하기
• 러너 구성하기
• 러너 테스트하기
• 문제 해결

소개

이 글은 Gitlab에 러너를 등록하고 설정하는 방법에 대해 안내합니다. Gitlab의 CI/CD를 활용하기 위해서는 러너를 등록해야 하며, 이를 통해 자동화된 빌드, 테스트, 배포 등의 작업을 실행할 수 있습니다.

러너 등록하기

1. Gitlab 러너 설치 문서를 참고하여 해당 환경에 맞게 러너를 설치합니다.
2. Gitlab 레포지토리로 이동하여 “Settings” 메뉴에서 “CI/CD” 탭으로 이동합니다.
3. “Runner” 항목에서 등록할 레포지토리 URL 및 등록 토큰을 확인합니다.
4. 터미널에서 gitlab-runner register 명령을 실행합니다.
5. URL과 토큰을 입력하고, executor는 원하는 설정으로 선택합니다. Docker를 사용하는 것을 추천합니다.
6. 기본 이미지로 ubuntu:latest를 설정합니다.
7. gitlab-runner verify 명령을 실행하여 러너가 정상적으로 등록되었는지 확인합니다.
8. gitlab-runner start 명령을 실행하여 러너 서비스를 시작합니다.
9. 다시 Gitlab 레포지토리의 “Settings” 메뉴에서 “CI/CD” 탭으로 이동합니다.
10. 초록색 불이 나타나는지 확인합니다. 성공적으로 등록된 경우 아래 이미지와 같은 화면이 표시됩니다.
    
11. “Edit” 버튼을 클릭하여 러너를 편집합니다.
12. “Run untagged jobs” 옵션을 선택합니다. 이 옵션은 태그가 없는 작업도 실행할 수 있도록 해줍니다.

러너 구성하기

1. 레포지토리의 루트 디렉토리에서 .gitlab-ci.yml 파일을 생성합니다.
2. 다음 코드를 입력하여 테스트 작업을 실행해보세요.

stages:
  - deploy

deploy:
  stage: deploy
  script:
    - echo 'hello runner'
  only:
    - main

3. 위 코드는 간단한 테스트용 작업을 실행하는 것입니다. 다음과 같은 결과가 나타나면 성공입니다.
   

문제 해결

만약 러너가 정상적으로 작동하지 않는다면, 다음 단계를 다시 확인해보세요:

• Gitlab 러너 설치 문서를 참고하여 올바르게 설치되었는지 확인합니다.
• 등록할 레포지토리 URL 및 토큰을 정확하게 입력했는지 확인합니다.
• 편집한 러너 구성이 올바른지 다시 확인합니다.

이 글을 통해 Gitlab에 러너를 등록하고 설정하는 방법에 대해 알아보았습니다. Gitlab의 CI/CD를 효율적으로 활용하여 개발 작업을 자동화할 수 있습니다.