Jenkins를 macOS 개발 환경에서 실행하는 방법

로컬 머신에 Jenkins를 설정하고 GitLab 인스턴스에서 연결하는 단계별 가이드입니다. GitLab은 Jenkins에서 웹훅을 트리거하고, Jenkins는 GitLab과 API를 통해 연결됩니다. 두 애플리케이션을 같은 머신에서 실행하여 서로 접근할 수 있도록 할 수 있습니다.

기존 Jenkins 통합을 구성하는 경우 Jenkins CI 서비스를 참조하세요.

Jenkins 설치

Homebrew를 사용하여 Jenkins를 설치하고 서비스를 시작합니다. 

brew install jenkins
brew services start jenkins

GitLab 구성

GitLab은 기본적으로 로컬호스트나 로컬 네트워크로의 요청을 허용하지 않습니다. 로컬 머신에서 Jenkins를 실행할 때 로컬 액세스를 활성화해야 합니다.

  1. 관리자로 GitLab 인스턴스에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래 관리 영역을 선택합니다.
  3. 설정 > 네트워크를 선택합니다.
  4. 아웃바운드 요청을 확장하고, 다음 확인란을 선택합니다:
    • 웹훅 및 통합에 대한 로컬 네트워크 요청 허용
    • 시스템 후크에서의 로컬 네트워크 요청 허용

GitLab 웹훅에 대한 자세한 내용은 웹훅 및 보안 위험한 내부 웹 서비스를 참조하세요.

Jenkins는 GitLab API를 사용하며 액세스 토큰이 필요합니다.

  1. GitLab 인스턴스에 로그인합니다.
  2. 프로필 사진을 선택한 후 설정을 선택합니다.
  3. 액세스 토큰을 선택합니다.
  4. API 범위가 활성화된 새 액세스 토큰을 생성합니다. 토큰 값을 메모하세요.

Jenkins 구성

Jenkins에서 GitLab API 연결을 구성하려면 Jenkins 서버 구성을 참조하세요.

Jenkins 프로젝트 구성

빌드를 실행할 Jenkins 프로젝트를 구성하는 방법은 Jenkins 프로젝트 구성을 참조하세요.

GitLab 프로젝트 구성

Jenkins와 GitLab 간의 통합을 구성할 수 있습니다:

설정 확인

리포지터리에서 변경을 만들고 MR을 엽니다. Jenkins 프로젝트에서 새로운 빌드를 트리거한 상태여야 하며, MR에서는 Pipeline #NUMBER passed라는 위젯이 표시되어야 합니다. 또한 Jenkins 빌드로 연결되는 링크도 포함되어 있어야 합니다.