젠킨스 작업의 이해

서론

   젠킨스는 CI/CD 파이프라인에서 핵심적인 역할을 수행하는 도구로, 다양한 작업을 통해 소프트웨어 개발 프로세스를 자동화할 수 있습니다. 이번 글에서는 젠킨스 작업의 개념, 생성, 구성, 실행 방법, 그리고 유용한 팁까지 자세히 알아보자.

---

젠킨스의 작업

   작업(Job)은 젠킨스에서 특정 작업 단위를 정의한 것이다. 빌드, 테스트, 배포 같은 프로세스를 자동화할 때 사용되며, 작업 단위는 유연하게 구성할 수 있다. 기본 작업 외에도 플러그인을 통해 추가 작업 유형을 사용할 수 있다.

젠킨스의 빌드

   작업이 실행되면 빌드(Build)가 생성된다. 빌드는 작업의 실행 단위로, 소스 코드와 설정 정보를 기반으로 수행된다. 빌드 결과는 다음과 같은 상태로 표시된다.

• 성공(Success): 작업이 정상적으로 완료됨
• 실패(Failure): 작업 중 오류 발생
• 중단(Aborted): 작업이 수동으로 취소됨
• 불안정(Unstable): 작업은 완료되었으나 일부 경고나 테스트 실패가 발생함

   빌드 기록은 젠킨스에서 추적 가능하며, 이력을 통해 문제를 분석하고 수정할 수 있다.

프리스타일 작업

    프리스타일 작업(Freestyle Project)은 젠킨스에서 가장 기본적인 작업 유형으로, 초기 설정이 간단하고 다양한 플러그인을 조합하여 사용할 수 있다. 주요 특징은 다음과 같다.

• 빌드 환경과 소스 코드 관리 통합
• 간단한 후속 작업 정의 가능
• 자동화 요구 사항이 낮은 프로젝트에 적합

   프리스타일 작업은 CI/CD를 처음 접하거나 간단한 빌드를 실행할 때 유용하다.

---

젠킨스의 작업 생성

   작업을 생성하려면 다음과 같은 과정을 거친다.

1. 젠킨스 대시보드에서 새 작업(New Item) 클릭
2. 작업 이름 입력 (예: My First Job)
3. 작업 유형 선택 (예: Freestyle Project, Pipeline 등)
4. OK 버튼 클릭
5. 구성 화면에서 작업 설정 후 저장(Save) 클릭

젠킨스의 작업 구성

    작업을 생성한 후, 빌드 요구 사항에 따라 작업을 구성해야 한다. 아래는 자주 사용하는 주요 옵션이다.

매개변수형 프로젝트

• 매개변수: 작업 실행 시 사용자 입력값을 받을 수 있도록 설정한다. 예: 빌드 번호, 환경 변수 등.
• 매개변수를 통해 유연한 빌드가 가능하다.

프로젝트 비활성화

• 작업을 일시적으로 중단하려면 이 프로젝트를 비활성화 옵션을 선택한다. 비활성화된 작업은 실행되지 않는다.

동시 빌드 실행

• 여러 빌드를 동시에 실행하려면 이 작업을 병렬로 실행 허용 옵션을 활성화한다.
• 높은 빌드 트래픽이 예상되는 프로젝트에서 유용하다.

대기 시간

• 빌드 실행 전 대기 시간을 설정하여 특정 시점 이후에 빌드를 시작할 수 있다. 이를 통해 스케줄 조정이 가능한다.

재시도 회수

• 빌드 실패 시 자동으로 재시도할 횟수를 설정한다. 안정성이 중요한 프로젝트에서 유용하다.

업스트림 프로젝트가 빌드 중일 때 빌드 차단

• 의존 관계가 있는 업스트림 프로젝트가 빌드 중일 경우, 현재 작업 실행을 차단하여 리소스 충돌을 방지한다.

다운스트림 프로젝트가 빌드 중일 때 빌드 차단

• 다운스트림 프로젝트의 빌드 완료 여부를 확인한 후 작업을 실행하도록 설정한다.

커스텀 워크스페이스 사용

• 기본 워크스페이스 대신 특정 디렉터리를 지정하여 빌드 데이터를 저장한다. 고정된 경로가 필요한 경우에 적합한다.

표시 이름 지정

• 작업의 기본 이름 대신 별칭을 설정하여 관리하기 쉽게 만든다. 예: My Critical Job.

의존성 빌드 로그 유지

• 의존 관계가 있는 작업의 빌드 로그를 함께 보관하여 문제 발생 시 참고할 수 있다.

소스 코드 관리

• Git 또는 SVN 등과 통합하여 소스 코드를 자동으로 가져온다.
• 브랜치 지정, 체크아웃 정책 등을 설정할 수 있다.

빌드 브랜치

• 특정 브랜치에서만 빌드를 실행하도록 설정한다. 예: main 브랜치에서만 작업 실행.

빌드 트리거

• SCM 폴링, 타임 스케줄러, 또는 Webhook을 통해 작업 실행 조건을 정의한다.

포스트-빌드 액션

• 빌드 완료 후 실행할 작업을 설정한다. 예: 이메일 알림, 테스트 결과 보고, 파일 배포 등.

---

작업 실행 및 결과 확인

   작업을 실행하려면 대시보드에서 작업 이름 클릭 후 Build Now 버튼 클릭하게 된다. 작업 실행 후 결과는 Build History 섹션에서 확인할 수 있다. 각 빌드 번호를 클릭하면 상세 로그와 결과를 분석할 수 있다. 빌드 로그를 활용하여 오류를 추적하고 문제를 해결할 수 있다.

작업 수정

   기존 작업을 수정하려면 다음과 같이 진행된다.

1. 작업 페이지에서 Configure 클릭
2. 필요한 설정 변경
3. Save 클릭하여 수정 내용을 저장

   수정된 작업은 이후 빌드부터 적용된다.

워크스페이스 보기 및 관리

   워크스페이스는 작업 실행 중 생성된 파일과 데이터를 저장하는 공간이다. 이를 통해 빌드 아티팩트, 로그, 임시 파일을 확인할 수 있다.

• 워크스페이스 확인: 작업 페이지에서 Workspace 링크 클릭
• 워크스페이스 비우기: Wipe Out Current Workspace 옵션 사용

작업 삭제

   더 이상 필요하지 않은 작업은 삭제할 수 있다.

1. 작업 페이지에서 Delete Project 클릭
2. 삭제 확인 창에서 Yes 선택

   주의: 삭제된 작업은 복구할 수 없으므로 중요한 작업은 백업 후 삭제하라.