GitLab Runner 시작하기
GitLab Runner 관리는 CI/CD 작업 실행 인프라 관리의 전체 수명 주기를 포함합니다: 러너 관리 프로세스는 더 큰 워크플로우의 일부입니다: 범위와 태그를 통해 러너 액세스를 관리하고, 성능을 모니터링하고, 러너 플리트를 유지 관리합니다.
GitLab Runner 관리는 CI/CD 작업 실행 인프라 관리의 전체 수명 주기를 포함합니다:
- 러너 배포 및 등록
- 특정 워크로드에 대한 실행자 구성
- 조직 성장에 맞춰 용량 확장
러너 관리 프로세스는 더 큰 워크플로우의 일부입니다:
범위와 태그를 통해 러너 액세스를 관리하고, 성능을 모니터링하고, 러너 플리트를 유지 관리합니다.
1단계: 러너 설치#
GitLab Runner를 설치하여 CI/CD 작업을 실행하는 애플리케이션을 만듭니다.
설치는 대상 인프라에서 GitLab Runner를 다운로드하고 설정하는 작업을 포함합니다. 설치 프로세스는 대상 운영 체제에 따라 다릅니다. GitLab은 Linux, Windows, macOS 및 z/OS에 대한 바이너리와 설치 지침을 제공합니다. 플랫폼과 요구 사항에 따라 설치 방법을 선택합니다.
자세한 내용은 GitLab Runner 설치를 참조하세요.
2단계: 러너 등록#
러너를 등록하여 GitLab 인스턴스와 GitLab Runner가 설치된 머신 간의 인증된 통신을 설정합니다. 등록은 인증 토큰을 사용하여 개별 러너를 GitLab 인스턴스에 연결합니다. 등록 중에 러너의 범위, 실행자 유형 및 러너 작동 방식을 결정하는 기타 구성 매개변수를 지정합니다.
러너를 등록하기 전에 특정 GitLab 그룹이나 프로젝트로 제한할지 여부를 결정해야 합니다. 등록 중에 서로 다른 액세스 범위로 셀프 관리 러너를 구성하여 사용할 수 있는 프로젝트를 결정할 수 있습니다:
- 인스턴스 러너: GitLab 인스턴스의 모든 프로젝트에서 사용 가능
- 그룹 러너: 특정 그룹 및 하위 그룹의 모든 프로젝트에서 사용 가능
- 프로젝트 러너: 특정 프로젝트에서만 사용 가능
러너를 등록할 때 태그를 추가하여 적절한 러너로 작업을 라우팅합니다. 의미 있는 태그를 할당하고 .gitlab-ci.yml 파일에서 이를 참조하여 필요한 기능이 있는 러너에서 작업이 실행되도록 합니다.
CI/CD 작업이 실행될 때 할당된 태그를 보고 사용할 러너를 알 수 있습니다. 태그는 작업에 사용 가능한 러너 목록을 필터링하는 유일한 방법입니다.
자세한 내용은 다음을 참조하세요:
3단계: 실행자 선택#
GitLab Runner 실행자는 GitLab Runner가 CI/CD 작업을 실행하는 데 사용할 수 있는 다양한 환경과 방법입니다. 실행자는 파이프라인 작업이 실제로 실행되는 방식과 위치를 결정합니다. 적절한 구성은 올바른 보안 경계를 갖춘 적절한 환경에서 작업이 실행되도록 합니다.
러너를 등록할 때 실행자를 선택해야 합니다. GitLab Runner는 실행자 시스템을 사용하여 작업이 실행되는 위치와 방법을 결정합니다. 실행자는 각 작업이 실행되는 환경을 결정합니다. 인프라와 작업 요구 사항에 맞는 실행자를 선택합니다.
예를 들어:
- CI/CD 작업에서 PowerShell 명령을 실행하려면 Windows 서버에 GitLab Runner를 설치한 다음 셸 실행자를 사용하는 러너를 등록할 수 있습니다.
- CI/CD 작업에서 사용자 정의 Docker 컨테이너에서 명령을 실행하려면 Linux 서버에 GitLab Runner를 설치하고 Docker 실행자를 사용하는 러너를 등록할 수 있습니다.
이러한 예시는 가능한 구성 중 일부일 뿐입니다. 가상 머신에 GitLab Runner를 설치하고 다른 가상 머신을 실행자로 사용할 수 있습니다.
자세한 내용은 실행자를 참조하세요.
4단계: 러너 구성 및 작업 실행 시작#
러너를 설치하고 등록할 때 자동으로 생성되는 config.toml 파일을 편집하여 GitLab Runner를 구성할 수 있습니다.
이 파일에서 특정 러너 또는 모든 러너에 대한 설정을 편집할 수 있습니다.
동시성 제한, 로깅 수준, 캐시 설정, CPU 제한 및 실행자별 매개변수를 설정하도록 구성합니다.
러너 플리트 전체에서 일관된 구성을 사용합니다.
러너가 구성되어 프로젝트에서 사용 가능한 상태가 되면 CI/CD 작업에서 러너를 사용할 수 있습니다.
러너는 일반적으로 GitLab Runner를 설치한 동일한 머신에서 작업을 처리합니다. 그러나 컨테이너, Kubernetes 클러스터 또는 클라우드의 자동 확장 인스턴스에서 작업을 처리하는 러너를 사용할 수도 있습니다.
자세한 내용은 다음을 참조하세요:
5단계: 러너 구성, 확장 및 최적화 계속#
고급 러너 기능은 작업 실행 효율성을 향상시키고 복잡한 CI/CD 워크플로우를 위한 특수 기능을 제공합니다. 이러한 최적화는 자동 확장, 성능 모니터링, 플리트 관리 및 특수 구성을 통해 작업 실행 시간을 줄이고 개발자 경험을 향상합니다.
자동 확장은 작업 수요에 따라 러너 용량을 자동으로 조정하고, 성능 최적화는 효율적인 리소스 활용을 보장합니다. 이러한 기능은 인프라 비용을 제어하면서 변동하는 워크로드를 처리하는 데 도움이 됩니다.
플리트 관리는 여러 러너에 대한 중앙 집중식 제어 및 모니터링을 제공하여 엔터프라이즈 규모의 러너 배포를 가능하게 합니다. 플리트 확장은 여러 러너에 걸쳐 용량을 조정하고 운영 모범 사례를 구현하는 작업을 포함합니다.
내장된 Prometheus 메트릭을 사용하여 러너 상태와 성능을 모니터링하는 데 도움을 받습니다. 활성 작업 수, CPU 활용률, 메모리 사용량, 작업 성공률 및 대기열 길이와 같은 주요 메트릭을 추적하여 러너가 효율적으로 작동하도록 합니다.
자세한 내용은 다음을 참조하세요: