파이프라인

Table of contents

1. 메뉴이동
2. 파이프라인
   1. 파이프라인 생성
   2. 파이프라인 수정
   3. 파이프라인 실행 미리보기
   4. 파이프라인 실행과 중지
   5. 파이프라인 재시작과 미리보기
   6. 파이프라인 버전별 비교하기

메뉴이동

클러스터/네임스페이스 선택 ➡ 애플리케이션 ➡ 파이프라인

파이프라인

파이프라인은 이미지 빌드 및 배포를 위해 한 개 이상의 태스크를 가지고, 태스크의 연관 관계(디펜던시)를 관리합니다.
파이프라인은 지속적으로 수행이 가능하며 수행에 대한 이력을 관리할 수 있습니다.

파이프라인 목록 중 하나를 선택한 뒤 상단의 파이프라인 탭을 선택하면 파이프라인을 구성하고 있는 태스크 정보를 그래프로 확인할 수 있습니다. 그래프의 노드는 태스크를 의미하며, 노드를 선택하면 해당 태스크에 대한 정보를 조회할 수 있습니다.

상단의 이력 탭에서는 파이프라인을 실행한 빌드 이력을 확인할 수 있습니다. 이때 개별 빌드에 대한 상태 정보가 아이콘으로 표시되는데 각각이 의미하는 바는 다음과 같습니다.

이미지	태스크 상태
	종료(Terminated): 사용자가 빌드를 중지한 상태
	성공(Succeeded) : 태스크가 수행하고 종료코드(exit code)가 0으로 완료된 상태
	실행 중(Running) : 태스크가 수행되고 있는 상태
	실패(Failed) : 태스크가 수행되었지만 종료코드가 0이 아닌 것으로 완료된 상태
	에러(Error) : 태스크가 실행되지 못하거나 비정상 종료된 상태 [발생 예시] - 쿠버네티스 인프라적인 요인으로 태스크가 수행되지 않는 경우 - 수행 중인 태스크가 외부 요인에 의해서 비정상 종료되는 경우
	대기(Pending) : 태스크가 수행 전 대기하는 상태
	경고(Warning): 태스크를 수정 중에 잘못된 데이터를 입력하는 경우 발생

빌드 이력을 선택하면 개별 빌드에 대한 상세 정보를 확인할 수 있습니다.

개별 빌드는 하나 이상의 태스크로 구성되며 태스크를 선택하면 해당 태스크에서 발생한 로그를 확인할 수 있습니다.

• 실패한 태스크의 경우 실패한 원인을 확인할 수 있습니다.

  

• 태스크에는 승인 태스크도 있습니다. 승인 태스크를 선택했을 때 화면 아래에 로그 정보가 아닌 승인 목록이 나타나고, 로그인 한 사용자가 승인자 목록에 포함되어 있을 경우 승인 또는 거절이 가능합니다.

  

  승인의 경우 모든 승인자가 승인해야 다음 태스크로 넘어가며, 한 명의 승인자라도 거절하면 파이프라인은 중지됩니다.

  • 승인 성공
  • 승인 실패

파이프라인 생성

파이프라인 목록의 우측 상단의 + 생성 버튼을 선택하면 나타나는 화면에서 파이프라인 정보를 입력하여 생성할 수 있습니다. 생성 시에는 FORM 또는 YAML로 입력할 수 있습니다.

입력하는 정보는 다음과 같습니다.

파이프라인 생성 시 파이프라인 템플릿에서 태스크에 대한 구성 정보를 불러와 설정할 수 있습니다. 템플릿을 수정해서 사용하고 싶은 경우 파이프라인 생성 후 수정 화면에서 변경 사항을 반영합니다.

• 파이프라인 생성 시 빈 템플릿을 선택하면 태스크가 없는 파이프라인을 생성할 수 있습니다. 이 경우 처음부터 파이프라인을 모두 작성할 수 있습니다.

파이프라인 수정

파이프라인을 생성할 때 태스크에 대한 정보는 파이프라인 템플릿에서 가져와 구성합니다. 파이프라인의 태스크에 대한 정보를 변경해야 하는 경우 변경할 파이프라인을 찾아 파이프라인 탭의 수정 버튼을 선택합니다.

• 태스크가 없는 파이프라인의 경우에는 수정하여, 빈 태스크의 + 버튼을 선택하면 태스크 구성을 할 수 있습니다.

태스크에 대한 스펙을 작성할때에는 태스크 이름과 태스크 연관관계를 설정하고 상세정보는 태스크 템플릿을 기반으로 작성합니다.

태스크의 이름은 쿠버네티스 이름 정책에 맞춰 작성하고 태스크의 연관관계는 해당 태스크을 수행하는 조건에 대한 정보를 입력합니다. 이는 이름.상태 의 형식으로 입력할 수 있습니다. 상태에 입력할 수 있는 값은 다음과 같습니다.

연관관계 작성 방법은 다음과 같습니다.

• 태스크 연결
  • 태스크 연관관계의 입력창을 선택한 후 태스크 설정
    
• 태스크 상태, 조건 추가
  • 순차적으로 태스크의 상태와 조건을 선택
    
• 태스크 삭제, 수정
  • 수정이 필요한 태스크, 상태를 클릭하여 내용 변경
    

[연관관계 작성 예시]

• 조건
  • parent 태스크 후 child 와 child2 태스크를 수행한다.
  • child 태스크와 child2 태스크가 둘 다 성공하면 child3 태스크를 수행한다.
• 설정
  
• 주의 : 파이프라인의 작업 공간에 대한 프로비저닝 설정 구성 시, 접근 모드를 ReadWriteOnce로 구성할 경우, 위 예시처럼 child 와 child2 태스크가 같이 동시에 시작하는 파이프라인을 구성하면 쓰기가 실패할 수 있기 때문에 ReadWriteMany로 생성해야 합니다.

태스크 템플릿

태스크를 작성하기 위해서는 태스크 템플릿에서 필요한 태스크를 불러와 파라미터를 설정하는 과정을 거칩니다.

태스크 템플릿의 종류는 다음과 같습니다.

파라미터까지 설정이 완료되면 저장 버튼을 선택해 작성을 완료합니다.

• 파이프라인 수정 시 쿠버네티스 리소스를 참조하는 방법은 다음과 같습니다.
  • 현재 사용자 권한에 따른 쿠버네티스 리소스 목록을 선택
  • 환경변수를 입력
    
  • 파이프라인 수정 시 쿠버네티스 리소스를 생성할 수 있는 경우는 Secret, ConfigMap, PersistentVolumeClaim 3가지 경우가 있습니다. 생성 화면은 각 메뉴별 생성 화면과 동일합니다.

파이프라인 실행 미리보기

이력 탭에서 실행하기 버튼을 클릭하면 파이프라인 미리보기 페이지로 이동할 수 있습니다.

성공한 가장 최신의 빌드를 현재 버전 으로서 비교 기준이 되며, 빌드를 통해 반영될 파이프라인 변경 사항을 미리보기 버전 으로서 비교가 가능합니다.
우측 하단의 실행하기 버튼으로 파이프라인을 실행시킬 수 있습니다.

파이프라인 실행과 중지

이력 탭에서 실행하기 버튼을 선택하면 파이프라인의 빌드가 실행되는 모습을 확인할 수 있습니다.

상단의 중지 버튼 또는 우측의 멈춤 아이콘 버튼을 선택하면 진행 중인 파이프라인의 빌드를 중지시킬 수 있습니다.

파이프라인 재시작과 미리보기

빌드 내역 중 특정 빌드로 다시 배포하고 싶은 경우 해당 빌드 내역의 우측 버튼을 이용해 다시 배포도 가능합니다. 이 경우 다시 실행하려는 빌드가 성공으로 완료되었을 때만 가능합니다.
재시작 버튼을 눌러서 재시작에 대한 파이프라인 미리보기 페이지로 이동할 수 있습니다.

성공한 가장 최신의 빌드를 현재 버전 으로서 비교 기준이 되며, 재시작을 통해 반영될 파이프라인 변경 사항을 재시작 버전 으로서 비교가 가능합니다. 우측 하단의 재시작 버튼으로 파이프라인을 재시작 시킵니다.

파이프라인 버전별 비교하기

성공한 특정 빌드 버전들에 한하여 서로 변경 사항을 비교 가능합니다.

리스트에서 선택한 특정 버전을 기준으로 다른 성공한 버전들과 비교할 수 있습니다.