빌드 파이프라인

사용자는 연속된 작업들을 하나로 묶어 파이프라인으로 구성할 수 있습니다. 여기서 구성한 파이프라인은 Jenkins의 파이프라인으로 생성됩니다.

빌드 파이프라인 시작하기

빌드 파이프라인 사용을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > 빌드 파이프라인 메뉴를 클릭하세요. 빌드 파이프라인 페이지로 이동합니다.

빌드 파이프라인 추가하기

빌드 파이프라인을 추가하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > 빌드 파이프라인 메뉴를 클릭하세요. 빌드 파이프라인 페이지로 이동합니다.
3. 빌드 파이프라인 페이지에서 오른쪽 위의 파이프라인 추가 버튼을 클릭하세요. 파이프라인 추가 페이지로 이동합니다.
4. 파이프라인 추가 페이지의 각 항목을 입력/설정 하세요.
5. 다음 버튼을 클릭하세요.

   항목	설명
   구분	개발, 운영 구분을 선택 개발, 운영에 따라 역할자별 수행할 수 있는 Action이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)을 참고하세요.
   Jenkins URL	목록에서 빌드 파이프라인을 추가할 Jenkins를 선택하세요.
   빌드 에이전트	빌드 파이프라인이 실행 될 에이전트(빌드 환경)을 선택하세요. 정보 아이콘을 클릭하여 에이전트가 제공하는 툴 목록을 확인할 수 있습니다.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   폴더 유형	폴더 유형을 선택하세요. 기존 폴더: Jenkins에 이미 생성되어 있는 폴더 하위에 파이프라인을 추가합니다. 신규 폴더: Jenkins에 신규 폴더를 생성하고 하위에 파이프라인을 추가합니다.
   폴더	목록에서 폴더를 선택 또는 신규로 생성할 폴더의 이름을 입력하세요.
   파이프라인명	파이프라인 이름을 입력하세요.
   매개변수 설정	파이프라인에서 사용할 매개변수를 설정하세요.
   환경변수 설정	파이프라인에서 사용할 환경변수를 설정하세요.
   스테이지 설정	파이프라인에서 사용할 스테이지를 설정하세요.
   빌드 결과 이메일 수신자 설정	파이프라인이 완료(성공/실패) 된 후 결과 메일을 수신할 수신자를 설정하세요.

   표. 빌드 파이프라인 추가 설정 항목

매개변수 설정하기

파이프라인 실행 시 사용할 매개변수를 설정하려면 다음 절차를 따르세요.

1. 매개변수 카드를 클릭하세요.
2. 추가 버튼을 클릭하여, 매개변수를 추가하세요.
3. 적용 버튼을 클릭하여 매개변수 설정을 완료하세요.

환경변수 설정하기

파이프라인에서 사용할 환경변수를 설정하려면 다음 절차를 따르세요.

1. 환경변수 영역을 클릭하세요. 환경변수 등록 페이지가 오른쪽에 열립니다.
2. 미리 등록된 환경변수 목록이 나타나며 사용할 환경변수 체크박스를 선택하세요.
3. 선택된 환경변수를 확인하고 적용 버튼을 클릭하여 환경변수 설정을 완료하세요.

스테이지 설정하기

파이프라인에서 사용할 스테이지를 설정하려면 다음 절차를 따르세요.

1. 새로운 스테이지 카드를 클릭하세요. 스테이지 영역이 오른쪽에 나타납니다.
2. 스테이지 영역에서 툴과 스테이지 종류를 선택하세요.
3. 스테이지 종류에 따라 필요한 정보를 입력하고 적용 버튼을 클릭하여 스테이지 설정을 완료하세요.

빌드 결과 이메일 수신자 설정하기

빌드 결과를 이메일로 수신 받을 대상자를 설정하려면 다음 절차를 따르세요.

1. 메일 수신자 영역을 클릭하세요. 메일 수신자 추가 페이지가 오른쪽에 열립니다.
2. 검색 영역에서 수신자를 검색하여 추가하세요.
3. 적용 버튼을 클릭하여 메일 수신자 설정을 완료하세요.

최종 파이프라인 스크립트 확인하기

1. 실제 만들어질 빌드 파이프라인 스크립트를 확인합니다. 필요시 직접 스크립트를 수정하세요.
2. 완료 버튼을 클릭하여 파이프라인 추가를 완료하세요.

파이프라인 추가 결과

1. 추가된 결과가 빌드 파이프라인 페이지에 나타납니다.

빌드 파이프라인 관리하기

빌드 파이프라인 목록

빌드 파이프라인 인증정보

빌드 파이프라인 동작(실행, 중지, 수정, 삭제 등)을 수행할 때, 사용자 인증정보가 필요하기 때문에 경우에 따라 사용자에게 요청할 수 있습니다.

IDP 연동 Jenkins의 경우

Jenkins 사용자로 등록되지 않은 경우, 사용자 등록 안내 팝업창이 열리면 Jenkins로 이동하기 링크를 클릭하여 사용자 가입 또는 Jenkins 최초 로그인을 진행하세요.

IDP 미연동 Jenkins의 경우

Jenkins 인증정보가 저장되지 않은 경우, 계정 추가 팝업창이 열리면 계정 유형에 기존 사용자 사용 또는 새로운 사용자 생성을 선택하여 인증정보를 추가하세요.

빌드 파이프라인 실행하기

빌드 파이프라인을 실행하려면 다음 절차를 따르세요.

1. 빌드 파이프라인 페이지에서 실행할 빌드 파이프라인의 실행 버튼을 클릭하세요.
2. 매개변수(파라미터)가 있는 경우 파이프라인 실행 매개변수 입력 팝업창이 열립니다.
3. 필요한 항목을 입력 후 확인 버튼을 클릭하세요.

빌드 파이프라인 실행 로그보기

빌드 파이프라인 실행 로그를 보려면 다음 절차를 따르세요.

1. 빌드 파이프라인 페이지에서 실행할 빌드 파이프라인의 로그 버튼을 클릭하세요.
2. 파이프라인 로그 팝업창이 열리며 실행 로그를 확인할 수 있습니다.

빌드 파이프라인 빌드 이력보기

빌드 파이프라인의 전체 빌드 이력을 보려면 다음 절차를 따르세요.

1. 빌드 파이프라인 페이지에서 확인하려는 빌드 파이프라인의 더보기 아이콘을 클릭하세요.
2. 빌드 이력 메뉴를 클릭하세요. 빌드 이력 페이지가 열립니다.

   항목	설명
   Config Diff	Config Diff 팝업창이 열립니다.
   로그	파이프라인 로그 팝업창이 열립니다.
   추가 메뉴	빌드 상세 페이지로 이동합니다.
   파이프라인 스테이지 보기	펼치기 아이콘을 클릭하여 스테이지 보기를 펼칩니다.

   표. 빌드 파이프라인 목록 보기 기능

설정정보 비교하기

Config Diff 버튼을 통해 이전 빌드 이력과의 설정정보를 비교할 수 있습니다.

로그보기

로그 버튼을 통해 빌드 이력의 로그를 확인할 수 있습니다.

빌드 상세보기

더보기 아이콘를 통해 빌드 상세 정보를 확인할 수 있습니다.

빌드 파이프라인 수정하기

빌드 파이프라인을 수정하려면 다음 절차를 따르세요.

1. 빌드 파이프라인 페이지에서 수정하려는 빌드 파이프라인의 더보기 아이콘을 클릭하세요.
2. 파이프라인 수정 버튼을 클릭하세요. 파이프라인 수정 페이지로 이동합니다.

스크립트 직접 수정하기

파이프라인 스크립트를 직접 수정하려면 다음 절차를 따르세요.

1. 파이프라인 수정 페이지의 스크립트 에디터 창에서 Jenkins에서 지원하는 문법에 맞는 스크립트를 직접 입력하세요.
2. 입력 완료 후 저장 버튼을 클릭하여 파이프라인 수정을 완료하세요.

Script Generator 기능을 사용해서 수정하기

Script Generator 기능을 사용해서 파이프라인 스크립트를 수정하려면 다음 절차를 따르세요.

1. 파이프라인 수정 페이지에서 Script Generator를 ON으로 변경하세요.
2. 빌드 에이전트와 스크립트 유형을 선택하세요.
3. 스테이지 설정을 진행 후 스크립트 생성 버튼을 클릭하여 스크립트를 생성하세요.
4. 생성된 스크립트를 참고하여 파이프라인을 수정하고 저장 버튼을 클릭하여 파이프라인 수정을 완료하세요.

   항목	설명
   Script Generator	Script Generator 기능을 ON/OFF 하세요.
   스크립트 기본정보	스크립트 생성을 위한 기초 정보를 선택하세요.
   기존 스크립트	기존에 존재하는 스크립트 입니다.
   신규 스크립트	Script Generator를 통해 생성되는 새로운 스크립트입니다.
   스크립트 수정	새로 생성된 스크립트를 참고하여 왼쪽의 기존 스크립트를 직접 수정하세요.
   Jenkins Credential 업데이트	새로 생성된 스크립트에 새로운 인증정보가 있는 경우 Jenkins Credential 업데이트 버튼 클릭하세요. 해당 인증정보를 Jenkins에 업데이트(저장) 합니다.
   K8S Secret 업데이트	Deploy to K8S 스테이지의 경우 K8S Secret을 변경하는 경우 K8S Secret 업데이트 버튼을 클릭하세요. 해당 Secret 생성 및 배포 시 이용하도록 업데이트(저장) 합니다.

   표. Script Generator 기능

빌드 파이프라인 복제하기

빌드 파이프라인을 복제하려면 다음 절차를 따르세요.

1. 복제하려는 빌드 파이프라인의 더보기 아이콘을 클릭하세요.
2. 파이프라인 복제 메뉴를 클릭하세요. 파이프라인 복제 팝업창이 열립니다.
3. 정보 입력 완료 후 저장 버튼을 클릭하여 파이프라인 복제를 완료하세요.

   항목	설명
   파이프라인 복제 정보	복제할 파이프라인의 정보를 입력하세요.
   파이프라인 수정	복제할 파이프라인을 수정하세요. 참고: 빌드 파이프라인 수정하기

   표. 빌드 파이프라인 복제하기 기능

빌드 파이프라인 삭제하기

빌드 파이프라인을 삭제하려면 다음 절차를 따르세요.

1. 빌드 파이프라인 페이지에서 삭제하려는 빌드 파이프라인의 더보기 아이콘을 클릭하세요.
2. 파이프라인 삭제 메뉴를 클릭하세요. 파이프라인 삭제 팝업창이 열립니다.
3. 파이프라인 삭제 팝업창에서 확인 버튼을 클릭하여 파이프라인 삭제를 완료하세요.