사내 Jenkins를 도입하며 제가 기여했던 부분을 글로 정리합니다.

0. 서론

저번 글에서는 Jenkins를 설치하고 초기 설정까지 완료하여 홈 화면에 접속하였습니다.
이번에는 Github 연동하고 새로운 Freestyle Project를 만들어보는 것을 진행해보고자 합니다.
사내에서는 GitLab을 사용하였으나 좀 더 많은 분들에게 도움이 되었으면 하는 바람으로 Github 연동에 대해 소개하겠습니다.

1. Github 토큰 발급하기

토근 발급은 간단하게 이미지로 발급 순서를 설명하도록 하겠습니다!

토큰은 외부에 노출되지 않도록 주의해주세요.

2. Jenkins에 토큰 등록하기

Jenkins 홈화면에서 좌측의 Jenkins 관리 메뉴로 진입하여 Credentials 메뉴로 선택합니다.

이후 (global)를 눌러 나타난 페이지의 우상단의 파란색의 Add Credentials 버튼을 눌러 Credentials 등록화면으로 진입합니다.

이후 새 토큰을 아래처럼 생성해줍니다.

• Kind: Username with password
• Scope: Global (기본값)
• Username: Gihtub 아이디
• Password: Github 토큰
• ID: 식별자 (원하는 값 입력)
• Description: 설명 (원하는 값 입력)

3. Freestyle Project 만들기

Jenkins의 Freestyle Project는 간단한 CI/CD 작업일 때 유용합니다.
Pipeline은 Groovy 언어를 이용하여 코드로 CI/CD 작업을 정의할 수 있어 IaC(Infrastructure as Code)로 관리할 수 있습니다.

이번에는 간단하게 빌드 및 배포만 진행할 예정이므로 Freestyle Project를 생성해봅시다!

프로젝트를 생성하면 바로 프로젝트 구성 화면이 나타납니다.

소스 코드 관리

소스 코드 관리 항목에서 Git을 선택하고 이미지처럼 입력해주세요.

• Repository URL: 빌드할 프로젝트의 Repoistory
• Credentials: 2번 단계에서 등록한 토큰 선택
  • Private Repository일 때만 선택
• Branch Specifier: 빌드하고 싶은 브랜치 선택

저는 Spring Boot 프로젝트를 빌드해보겠습니다.

Build Steps

이후 Build Steps에서 Invoke Gradle Script를 선택해줍니다.

그 후 Use Gradle Wrapper를 선택한 후 아래와 같이 입력해줍니다.

기본적으로, Gradle plugin은 build script 경로의 gradlew을 파일을 사용합니다. 만약 없다면 작업공간 내의 파일을 사용합니다.

우리는 현재 제 프로젝트에는 gradlew가 포함되어 repository에 올라가 있으므로 ${workspace}를 입력해줍니
다.

빌드하기

설정이 완료되었으니 저장 후, 메인 화면 좌측에 있는 지금 빌드 버튼을 눌러 빌드를 시도해봅시다.

빌드가 성공적으로 완료되었네요!

작업 공간의 빌드 경로에도 정상적으로 jar 파일이 생성되어 있는 것을 확인할 수 있습니다.

결론

이제 Github 프로젝트를 clone해 Spring Boot 프로젝트를 빌드하는 것까지 성공하였습니다.

다음 시간에는 빌드한 프로젝트를 외부 기기에 배포하는 작업에 대해 포스팅하겠습니다!