사용자는 다음 절차를 통해, 이미 생성된 DevOps Console 프로젝트에 새로운 빌드 파이프라인을 생성하고 소스를 빌드하여 이미지를 만들고 Kubernetes 클러스터에 워크로드 배포를 진행할 수 있습니다.

워크로드 추가하기를 통해 추가한 워크로드는 Deploy to K8S 스테이지 설정하기에서 사용하게 됩니다.

빌드/배포 추가 시작하기

빌드/배포 추가를 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.

코드 저장소 추가하기 (Option)

코드 저장소를 추가하려면 다음 절차를 따르세요.

1. 코드 저장소 페이지에서 오른쪽 위의 코드 저장소 추가 버튼을 클릭하세요. 코드 저장소 추가 페이지로 이동합니다.
2. 코드 저장소 추가 페이지에서 각 항목을 입력/설정 하세요.
3. Connection Test 버튼을 클릭하세요.
4. 저장 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 등록 툴: 사용자가 사용가능한 SCM Repository 툴의 유형(Github, Gitlab 등)들을 선택하고 사용할 수 있습니다. 미등록 툴: 등록되지 않을 툴의 도메인을 입력하여 사용할 수 있습니다. 미등록 툴 항목은 소스코드가 미포함된(Environment Only) App. 템플릿일때만 나타납니다.
   신규/기존 사용 여부	신규 저장소 생성 또는 기존 저장소 사용 여부를 선택 특정 조건에 따라 활성화 여부가 달라집니다. 자세한 내용은 표. 신규 저장소 생성과 기존 저장소 사용 활성화 조건를 참고하세요.
   저장소 정보	저장소 정보를 입력 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
   인증 정보	인증정보를 입력하세요.
   저장소 정보	저장소 정보를 입력 DevOps Console의 툴로 등록되지 않은 코드 저장소를 사용할 수 있습니다. URL Check 과정을 추가로 거쳐야 합니다.

   표. 코드 저장소 추가 입력 항목

이미지 저장소 추가하기 (Option)

이미지 저장소를 추가하려면 다음 절차를 따르세요.

App. 이미지 저장소 추가

1. 이미지 저장소 페이지에서 오른쪽 위의 App. 이미지 저장소 추가 버튼을 클릭하세요. App. 이미지 저장소 추가 페이지로 이동합니다.
2. App. 이미지 저장소 추가 페이지에서 각 항목을 입력/설정 하세요.
3. Connection Test 버튼을 클릭하세요.
4. 저장 버튼을 클릭하세요.

   항목	설명
   저장소 유형 선택	이미지 저장소 유형을 선택하세요. Devops Console에 등록되지 않은 이미지 저장소를 사용하려면 Image Registry 유형을 선택하세요.
   저장소 생성 여부 선택	새로 저장소를 생성할지, 기존 저장소를 사용할지 선택하세요. 앞에서 Docker hub나 Image Registry 유형을 선택한 경우 기존 저장소 사용만 선택할 수 있습니다.
   등록된 툴	저장소 정보를 입력하세요.
   미 등록 툴	저장소 정보를 입력 DevOps Console의 툴로 등록되지 않은 이미지 저장소를 등록할 수 있습니다. URL Check 버튼을 클릭하여 확인 과정을 진행합니다. 기존 저장소 사용만 선택할 수 있습니다.

   표. App. 이미지 저장소 추가 입력 항목

Pull 전용 이미지 저장소 추가

1. 이미지 저장소 페이지에서 오른쪽 위의 Pull 전용 이미지 저장소 추가 버튼을 클릭하세요. Pull 전용 이미지 저장소 추가 페이지로 이동합니다.
2. Pull 전용 이미지 저장소 추가 페이지에서 각 항목을 입력/설정 하세요.
3. Connection Test 버튼을 클릭하세요.
4. 저장 버튼을 클릭하세요.

워크로드 추가하기

워크로드를 추가하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. Kubernetes 배포 페이지에서 워크로드 추가 메뉴를 클릭하세요. 워크로드 추가 팝업창이 열립니다.
4. 워크로드 추가 팝업창에서 정보를 입력하고 저장 버튼을 클릭하세요.
5. 확인 팝업창에서 확인 버튼을 클릭하여 워크로드 추가를 완료합니다.

   항목	설명
   조회 대상	최초 프로젝트 생성 시 사용한 App.템플릿의 Base 이미지와 동일한 이미지로 배포한 워크로드만 표시됩니다.
   이미 프로젝트에 등록된 워크로드	이미 프로젝트에 등록된 워크로드를 보여줍니다. 이미 프로젝트에 등록된 워크로드는 추가할 수 없습니다.

   표. 워크로드 추가 입력 항목

K8S 인증정보 수정하기

K8S 인증정보란 빌드 파이프라인에서 배포를 수행할 때 K8S 클러스터/네임스페이스를 사용할 권한을 확인할 때 사용하는 인증정보입니다.

K8S 인증정보를 수정하려면 다음 절차를 따르세요.

1. 배포 상세 페이지에서 K8S 클러스터/네임스페이스 오른쪽의 인증정보 수정 아이콘을 클릭하세요. 인증정보 수정 팝업창이 열립니다.
2. 인증정보는 로그인 한 사용자의 계정으로 고정됩니다. 수정을 위해 저장 버튼을 클릭하세요.
3. 확인 팝업창에서 확인 버튼을 클릭하세요.
4. K8S 인증정보가 로그인한 사용자로 변경됩니다.

빌드 파이프라인 추가하기

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

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

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

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

매개변수 설정하기

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

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

환경변수 설정하기

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

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

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

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

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

추가 스테이지 설정하기

Checkout 스테이지 설정하기

Checkout 스테이지를 추가하려면 다음 절차를 따르세요.

1. 새로운 스테이지 영역을 클릭하세요. 스테이지 설정 페이지가 오른쪽에 열립니다.
2. 스테이지 설정 페이지에서 스테이지 종류로 Checkout을 선택하세요.
3. 정보 입력 후 적용 버튼을 클릭하세요. (URL에서 코드 저장소 추가하기 (Option)에서 추가한 코드 저장소를 선택할 수 있습니다.)

   항목	설명
   URL	checkout을 수행 할 코드 저장소를 선택합니다.
   Branch 명	checkout 할 branch 명을 입력합니다.

   표. Checkout 스테이지 입력 항목

Build 스테이지 설정하기

Build 스테이지를 추가하려면 다음 절차를 따르세요.

1. 더하기 아이콘을 클릭하여 새로운 스테이지를 추가하세요.
2. 새로운 스테이지 영역을 클릭하세요. 스테이지 설정 페이지가 오른쪽에 열립니다.
3. 스테이지 설정 페이지에서 스테이지 종류로 Build를 선택하세요.
4. 스테이지 설정 페이지에서 정보 입력 후 적용 버튼을 클릭하세요.

   항목	설명
   언어	애플리케이션이 사용하는 프로그래밍 언어를 선택합니다.
   Build 도구	애플리케이션 빌드에 사용하는 Build 도구를 선택합니다. 선택한 Build 도구에 따라 기본 Shell 명령어를 제공합니다.
   Shell 명령어	애플리케이션 빌드에 사용할 명령어를 입력합니다. Shell에서 사용가능한 모든 명령어 사용이 가능합니다.

   표. Build 스테이지 입력 항목

Docker Build 스테이지 설정하기

Docker Build 스테이지를 추가하려면 다음 절차를 따르세요.

1. 더하기 아이콘을 클릭하여 새로운 스테이지를 추가하세요.
2. 새로운 스테이지 영역을 클릭하세요. 스테이지 설정 페이지가 오른쪽에 열립니다.
3. 스테이지 종류로 Docker Build를 선택하세요.
4. 정보 입력 후 적용 버튼을 클릭하세요. (Registry URL에서 이미지 저장소 추가하기 (Option)에서 추가한 이미지 저장소를 선택할 수 있습니다.)

Deploy to K8S 스테이지 설정하기

Deploy to K8S 스테이지를 추가하려면 다음 절차를 따르세요.

1. + 아이콘을 클릭하여 새로운 스테이지를 추가하세요.
2. 새로운 스테이지 영역을 클릭하세요. 스테이지 설정 페이지가 오른쪽에 열립니다.
3. 스테이지 설정 페이지에서 스테이지 종류로 Deploy to K8S를 선택하세요.
4. 스테이지 설정 페이지에서 정보 입력 후 적용 버튼을 클릭하세요. (유형에서 워크로드를 선택하면 워크로드 추가하기에서 추가한 워크로드를 선택할 수 있습니다.)

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

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

파이프라인 추가 결과