(헬름차트 배포) 빌드/배포 추가하기

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

헬름인스톨 하기 통해 배포한 헬름릴리스는 Deploy to K8S 스테이지 설정하기에서 사용하게 됩니다.

빌드/배포 추가 시작하기

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

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

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

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

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 저장소 > 코드 저장소를 클릭하세요.
3. 오른쪽 위의 코드 저장소 추가 버튼을 클릭하세요. 코드 저장소 추가 페이지가 열립니다.
4. 각 항목을 입력/설정 하고 Connection Test 버튼을 클릭하세요.
5. 저장 버튼을 클릭하여 코드 저장소 추가를 완료하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 등록 툴: 사용자가 사용가능한 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. 왼쪽 메뉴에서 빌드/배포 > 헬름인스톨 메뉴를 클릭하세요.
3. K8S 클러스터 항목에서 설치하려는 K8S 클러스터를 선택하세요.
4. 헬름인스톨을 원하는 헬름차트를 클릭해서 헬름차트 상세 화면으로 이동합니다.
5. 헬름인스톨 버튼을 클릭 합니다. 헬름차트 설치 화면으로 이동합니다.
6. 각 항목을 입력하고 다음 버튼을 클릭합니다.

   항목	설명
   릴리스명	헬름차트 릴리스에서 사용할 이름을 입력합니다. 네임스페이스 내에서 중복될 수 없고 유일해야 합니다.
   구분	개발, 운영
   버전	헬름인스톨 하려는 차트의 버전을 선택하세요.
   K8S 클러스터	헬름인스톨이 되는 대상 K8S 클러스터를 표시합니다. 변경은 불가능하며, 변경을 원하는 경우 헬름인스톨 시작하기에서 K8S 클러스터를 선택하세요.
   네임스페이스	헬름인스톨이 되는 대상 네임스페이스를 목록에서 선택하세요.
   참고정보	선택한 K8S 클러스터에서 제공하는 참고정보 입니다. 각 탭을 클릭하여 상세정보를 확인할 수 있습니다.
   차트에 포함된 기본 Values.yaml	values.yaml 파일을 수정해서 원하는 값으로 헬름인스톨을 실행할 수 있습니다. 필요시 참고정보를 확인해서 해당 값으로 values.yaml 파일을 수정하세요.
   작성 유형	Form 입력이 지원되는 헬름차트에서만 작성 유형 항목이 표시 Form: 화면에 표시된 항목을 입력하세요. Form 입력을 지원하는 헬름차트 작성은 Form 입력을 지원하는 헬름차트 작성하기를 참고하세요. values.yaml: 일반적인 헬름차트와 동일한 yaml 편집기 화면에서 값을 수정하세요. Form / values.yaml 입력은 서로 전환이 가능하나 전환 시 기존에 입력된 내용은 초기화 됩니다.
   Form 입력	작성 유형에서 Form을 선택했을 경우에 보여지는 화면으로, 각 항목을 확인하고 값을 입력하세요. 입력을 완료한 후 Validation Check 버튼을 클릭해서 입력값을 검증하세요.

   표. 헬름인스톨 설정 항목
7. 헬름차트 설치 팝업창이 열립니다. 실행 버튼을 클릭해서 헬름인스톨을 완료합니다.
8. 설치가 완료되면 Kubernetes 배포 페이지가 열립니다.

빌드 파이프라인 추가하기

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

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. 완료 버튼을 클릭하여 파이프라인 추가를 완료하세요.

파이프라인 추가 결과