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

macOS 로컬 환경에서 Jenkins를 설치하고 GitLab 인스턴스와 연동하여 CI/CD 파이프라인을 구성하는 방법을 설명합니다.

이 문서는 로컬 머신에 Jenkins 를 설치하고 GitLab 인스턴스에서 연결하는 방법을 단계별로 안내합니다. GitLab은 Jenkins에 웹훅을 트리거하고, Jenkins는 API를 사용하여 GitLab에 연결합니다. 두 애플리케이션을 동일한 머신에서 실행하면 서로 접근할 수 있는지 확인할 수 있습니다. 기존 Jenkins 통합 구성에 대한 자세한 내용은 Jenkins CI 서비스 를 참고하세요. Jenkins 설치 # Homebrew를 사용하여 Jenkins를 설치하고 서비스를 시작합니다. brew install jenkins brew services start jenkins GitLab 구성 # GitLab은 기본적으로 localhost 또는 로컬 네트워크에 대한 요청을 허용하지 않습니다. 로컬 머신에서 Jenkins를 실행할 때는 로컬 접근을 활성화해야 합니다. 관리자로 GitLab 인스턴스에 로그인합니다. 오른쪽 상단 모서리에서 Admin 을 선택합니다. 왼쪽 사이드바에서 Settings > Network 를 선택합니다. Outbound requests 를 펼치고 다음 체크박스를 선택합니다: Allow requests to the local network from webhooks and integrations Allow requests to the local network from system hooks GitLab 웹훅에 대한 자세한 내용은 웹훅 및 보안되지 않은 내부 웹 서비스 를 참고하세요. Jenkins는 GitLab API를 사용하며 액세스 토큰이 필요합니다. GitLab 인스턴스에 로그인합니다. 오른쪽 상단 모서리에서 아바타를 선택합니다. Edit profile 을 선택합니다. 왼쪽 사이드바에서 Access > Personal access tokens 를 선택합니다. API 범위가 활성화된 새 액세스 토큰을 생성합니다. 토큰 값을 기록해 둡니다. Jenkins 구성 # Jenkins에서 GitLab API 연결을 구성하는 방법은 Jenkins 서버 구성 을 참고하세요. Jenkins 프로젝트 구성 # 빌드를 실행할 Jenkins 프로젝트를 설정하는 방법은 Jenkins 프로젝트 구성 을 참고하세요. GitLab 프로젝트 구성 # Jenkins와 GitLab 간의 통합을 구성할 수 있습니다: Jenkins 통합 권장 방식 을 사용합니다. 웹훅 사용 . 설정 테스트 # 리포지터리에서 변경 내용을 적용하고 머지 리퀘스트를 엽니다. Jenkins 프로젝트에서 새 빌드가 트리거되었는지 확인하고, 머지 리퀘스트에 Pipeline #NUMBER passed 라는 위젯이 표시되어야 합니다. 또한 Jenkins 빌드 링크도 포함되어야 합니다.