DevOps Tools

• 1: DevOps Service
• 1.1: Overview
• 1.2: How-to guides
• 1.3: API Reference
• 1.4: CLI Reference
• 1.5: Release Note
• 2: DevOps Console
• 2.1: Overview
• 2.1.1: DevOps Console 소개
• 2.1.2: 역할
• 2.1.3: 화면구성
• 2.2: 시작하기
• 2.2.1: DevOps Console 시작하기
• 2.2.1.1: 가입정보
• 2.2.2: Tutorial (프로젝트생성부터 빌드/배포까지)
• 2.2.2.1: (헬름차트 배포) 빌드/배포 추가하기
• 2.2.2.2: (워크로드 배포) 빌드/배포 추가하기
• 2.2.2.3: (VM 배포) 빌드/배포 추가하기
• 2.2.2.4: (프로젝트 생성 전) 배포 대상 네임스페이스 권한 확인 하기
• 2.3: 프로젝트
• 2.3.1: 프로젝트 개요
• 2.3.2: 프로젝트 생성하기
• 2.3.2.1: (헬름차트 배포) 프로젝트 생성하기
• 2.3.2.2: (워크로드 배포) 프로젝트 생성하기
• 2.3.2.3: (ArgoCD 배포) 프로젝트 생성하기
• 2.3.2.4: (VM 배포) 프로젝트 생성하기
• 2.3.2.5: (빈) 프로젝트 생성하기
• 2.3.3: 프로젝트 시작하기
• 2.3.4: 프로젝트 대시보드
• 2.3.5: 프로젝트 멤버
• 2.4: 빌드/배포
• 2.4.1: 빌드 파이프라인
• 2.4.1.1: 스테이지
• 2.4.1.2: 멀티브랜치 파이프라인
• 2.4.2: Kubernetes 배포
• 2.4.2.1: 헬름릴리스
• 2.4.2.2: 워크로드
• 2.4.2.3: 블루/그린 배포
• 2.4.2.4: 카나리 배포
• 2.4.2.5: Istio
• 2.4.2.6: ArgoCD
• 2.4.3: VM 배포
• 2.4.4: 헬름인스톨
• 2.4.5: Ingress/Service 관리
• 2.4.6: Kubernetes Secret 관리
• 2.4.7: 환경변수 관리
• 2.5: 프로젝트그룹
• 2.5.1: 프로젝트그룹 개요
• 2.5.2: 프로젝트그룹 생성하기
• 2.5.3: 프로젝트그룹 대시보드
• 2.6: 테넌트
• 2.6.1: 테넌트 관리
• 2.6.2: 테넌트 대시보드
• 2.6.3: 테넌트 공지사항
• 2.7: 저장소
• 2.7.1: 코드 저장소
• 2.7.2: 아티팩트 저장소
• 2.7.3: 이미지 저장소
• 2.7.4: 차트 저장소
• 2.7.5: 헬름차트
• 2.7.5.1: Form 입력을 지원하는 헬름차트 작성하기
• 2.8: 품질
• 2.8.1: 코드품질
• 2.9: 툴&템플릿
• 2.9.1: 툴 관리
• 2.9.2: App.템플릿
• 2.9.3: 사용자 설치 Jenkins 툴 등록하기
• 2.10: 배포타겟
• 2.10.1: K8S 클러스터
• 2.10.1.1: 클러스터 Admin Token 확인하기
• 2.10.2: VM서버 그룹
• 2.10.3: 권한 신청
• 2.11: 릴리스관리
• 2.11.1: 릴리스 관리
• 2.11.2: 워크플로 관리
• 2.11.3: 결재 템플릿 설정
• 2.11.4: 태스크
• 2.11.5: JIRA 프로젝트
• 2.12: Release Note

1 - DevOps Service

1.1 - Overview

서비스 개요

DevOps Service는 DevOps Console을 통해 애플리케이션 및 시스템 개발/배포/운영을 위해 표준화된 개발 도구와 코드 프레임워크 기반의 개발 템플릿 및 통합 관리 기능을 제공하는 서비스입니다. 이를 통해 소프트웨어 개발/배포/운영을 빠르고 안정적으로 수행할 수 있으며, DevOps Workflow 내 Samsung Cloud Platform 리소스와 CI/CD Tools에 대한 편리한 통합 관리가 가능합니다.

특장점

• 편리한 코드 관리 및 배포: 소스코드 관리부터 빌드 및 배포까지 사용자는 웹 기반 콘솔을 통해 편리하게 사용이 가능합니다. 또한 소스코드를 분석하여 품질을 향상시킬 수 있도록 다양한 도구 연계를 지원합니다.
• 유연한 배포 방법 제공: 사용자 서비스의 운영 중단 시간을 최소화하며, k8s 클러스터 혹은 Virtual Machine으로의 배포 환경 구성을 제공하여 사용자가 사용자 서비스에 맞는 배포 구성할 수 있도록 유연한 배포 방법을 제공합니다.
• 배포 관리를 위한 저장소 제공: 사용자 서비스의 배포 관리를 위한 소스코드, 라이브러리와 애플리케이션의 아티펙트, 컨테이너 이미지 등을 관리할 수 있는 저장소를 제공합니다.

서비스 구성도

제공 기능

DevOps Service는 표준 개발 도구를 통합 지원하여 개발 환경을 쉽게 구성하고, 빌드/배포의 편의성을 제공하는 서비스로서 다음과 같은 기능을 제공 하고 있습니다.

• 지속적 통합 및 배포(CI/CD Continuous Integration/Continuous Deployment): 사용자는 한번의 로그인으로 소스코드 저장소, Artifact 저장소, 코드 분석, 이미지 저장소, 빌드/배포를 담당하는 툴에 접근할 수 있습니다.
• 애플리케이션 템플릿 기반으로 프로젝트 구성: 사용자는 개발 표준이 반영되어 있는 템플릿을 이용하여 Wizard 방식으로 프로젝트를 쉽게 구성할 수 있습니다.
• 주요 개발 언어 및 프레임워크 제공: 사용자는 애플리케이션 개발에 필요한 개발 언어(Java, C#, Python, Ruby 등)와 프레임워크(SpringBoot, Vue.js, .Net 등)을 선택하여 빌드/배포를 위한 프로젝트를 구성할 수 있습니다.
• 빌드/배포 파이프라인 자동 구성: 사용자는 애플리케이션 템플릿에 포함된 빌드/배포 파이프라인 템플릿을 이용하여 파이프라인 스크립트를 자동으로 구성하거나 GUI기반으로 파이프라인의 각 단계를 구성할 수 있습니다.
• 다양한 배포 방식 지원 및 롤백 지원: 사용자는 운영 중인 애플리케이션의 중단시간을 최소화하기 위한 배포 방식(RollingUpdate, Blue-Green)을 이용할 수 있으며, 클릭 한 번으로 원하는 버전으로 롤백할 수 있습니다. 만약 사용자가 배포 환경으로 Virtual Server를 이용하고자 한다면, 패키징된 파일 또는 도커(Docker) 이미지의 형태로 Virtual Server에 배포할 수 있습니다.
• 맞춤형 릴리즈 프로세스 지원: 사용자는 애플리케이션 변경 유형을 고려하여 다양한 릴리즈 프로세스를 정의하고 반복적으로 실행할 수 있습니다.

구성 요소

사용자는 Samsung Cloud Platform DevOps Console을 통해 DevOps Service를 손쉽게 이용할 수 있습니다.

DevOps Console

DevOps Console은 애플리케이션 개발과 빌드/배포에 필요한 도구를 통합적으로 지원하여 프로젝트 구성 및 빌드/배포를 쉽게 관리할 수 있습니다.

• Dev.Starter: 개발 표준이 반영된 샘플 코드뿐만 아니라 빌드/배포에 필요한 템플릿을 통합 제공하는 애플리케이션 템플릿입니다.
• 소스코드 저장소(Source Code Repository): 소스코드 형상관리 도구와의 연계를 지원합니다. Git Repository와 연계할 수 있습니다.
• 아티팩트 저장소(Artifact Repository): 애플리케이션 빌드에 필요한 라이브러리와 애플리케이션 아티팩트를 저장하기 위한 아티팩트 저장소와의 연계를 지원합니다.
• 코드품질(Code Review): 코드 정적 분석을 통해 소스코드의 품질을 측정하고 관리할 수 있는 코드품질 도구와의 연계를 지원합니다.
• 헬름차트 저장소(Helm Chart Repository): Kubernetes에서는 소프트웨어를 쉽게 설치하고 업그레이드하기 위해서 헬름차트를 사용합니다. 사용자가 소프트웨어를 설치하기 위해서는 헬름차트를 직접 작성해야 합니다. 헬름차트를 관리하는 저장소로서 ChartMuseum을 기본으로 제공합니다. 또한 다른 차트 저장소 툴과의 연계도 지원합니다.
• 이미지 저장소(Image Registry): 컨테이너 이미지를 저장하기 위한 이미지 저장소와의 연계를 지원합니다.
• VM 서버 그룹: 애플리케이션의 배포 대상이 되는 Virtual Server 묶음입니다. 사용자는 DevOps Console에서 Virtual Server를 등록하고 배포 대상으로 지정할 수 있습니다.
• Kubernetes Cluster: 애플리케이션의 배포 대상이 되는 클러스터입니다. 사용자는 DevOps Console에서 Kubernetes Cluster을 등록하고 배포 대상으로 지정할 수 있습니다.

리전별 제공 현황

DevOps Service는 아래의 환경에서 제공 가능합니다.

선행 서비스

DevOps Service는 선행 서비스가 없습니다.

1.2 - How-to guides

사용자는 Samsung Cloud Platform Console을 통해 DevOps Service 서비스의 필수 정보를 입력하고, 상세 옵션을 선택하여 해당 서비스를 생성할 수 있습니다. 또한, DevOps Service의 표준화된 개발 도구와 코드, 프레임워크 기반의 개발 템플릿, 통합 관리 기능을 이용하여 효율적으로 개발 프로젝트를 진행할 수 있습니다.

DevOps Service 생성하기

Samsung Cloud Platform Console에서 DevOps Service 서비스를 생성하여 사용할 수 있습니다.

DevOps Service 서비스를 생성하려면 다음 절차를 따르세요.

1. 모든 서비스 > DevOps Tools > DevOps Service 메뉴에서 서비스 생성 버튼을 클릭하세요. DevOps Service의 Service Home 페이지로 이동합니다
2. Service Home페이지에서 DevOps Service 생성 버튼을 클릭하세요. DevOps Service 생성 페이지로 이동합니다.
3. DevOps Service 생성 페이지에서 서비스 생성에 필요한 정보들을 입력하세요.
   • 서비스 정보 입력 영역에서 필요한 정보를 입력하세요.

     구분	필수 여부	상세 설명
     Tenant명	필수	사용자가 생성하는 DevOps Service의 Tenant 이름 DevOps Console 접속 시에 논리적으로 표시되는 이름 영문 소문자로 시작하며 영문 소문자, 숫자와 특수문자(-)를 사용하여 3~30자로 입력
     Tenant 코드	필수	시스템 내부적으로 사용하는 ID 프로젝트 ID와 유사하게 내부적으로 사용되는 ID 값으로 사용자가 입력한 값으로 생성됨 영문 소문자로 시작하며 영문 소문자, 숫자와 특수문자(-)를 사용하여 3~30자로 입력

     표. DevOps Service 필수 정보 입력 항목
   • Tenant 멤버 추가 영역에서 서비스를 사용할 tenant 사용자를 선택하세요.

     구분	필수 여부	상세 설명
     사용자	필수	사용자 목록에서 멤버 선택 서비스 신청자는 Tenant 기본 멤버에 포함됨 1명 이상의 사용자를 선택해야 서비스 생성 가능

     표. DevOps Service Tenant 멤버 추가 항목
   • 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     태그	선택	태그 추가 자원 당 최대 50개까지 추가 가능 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택

     표. DevOps Service 추가 정보 입력 항목
4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요.
   • 생성이 완료되면 자원 목록 페이지에서 생성한 자원을 확인하세요.

DevOps Service 사용하기

DevOps Service 서비스는 DevOps Console 이라는 별도의 Console에서 실질적인 DevOps 환경을 구성할 수 있습니다.

DevOps Service를 사용하려면 다음 절차를 따르세요.

1. 모든 서비스 > DevOps Tools > DevOps Service 메뉴를 클릭하세요. DevOps Service의 Service Honme 페이지로 이동합니다.
2. Service Home 페이지에서 DevOps Service메뉴를 클릭하세요. DevOps Service 목록 페이지로 이동합니다.
3. DevOps Service 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. DevOps Service 상세 페이지로 이동합니다.
4. DevOps Service 상세 페이지에서 DevOps Console 버튼을 클릭하세요. Samsung Cloud Platform DevOps Console 페이지로 이동합니다.

DevOps Service 상세 정보 확인하기

DevOps Service 서비스는 전체 자원 목록과 상세 정보를 확인하고 수정할 수 있습니다. DevOps Service 상세 페이지에서는 상세정보, 태그, 작업 이력 탭으로 구성되어 있습니다.

DevOps Service 상세정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > DevOps Tools > DevOps Service 메뉴를 클릭하세요. DevOps Service의 Service Honme 페이지로 이동합니다.
2. Service Home 페이지에서 DevOps Service메뉴를 클릭하세요. DevOps Service 목록 페이지로 이동합니다.
3. DevOps Service 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. DevOps Service 상세 페이지로 이동합니다.
   • DevOps Service 상세 페이지에는 상태 정보가 표시되며, 상세 정보, 태그, 작업 이력 탭으로 구성됩니다.

     구분	상세 설명
     상태 표시	DevOps Service의 상태를 표시 Active: 사용 가능한 상태 Creating: 생성 중인 상태 Error: 운영 중 에러 발생 상태
     DevOps Console	DevOps Console로 이동하여 서비스를 제어 가능
     서비스 해지	서비스를 해지하는 버튼

     표. DevOps Service 상태 정보 및 부가 기능

상세 정보

DevOps Service 목록 페이지에서 선택한 자원의 상세 정보를 확인할 수 있습니다.

태그

DevOps Service 목록 페이지에서 선택한 자원의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

작업 이력

DevOps Service 목록 페이지에서 선택한 자원의 작업 이력을 확인할 수 있습니다.

DevOps Service 해지하기

DevOps Service를 해지하려면 다음 절차를 따르세요.

1. 모든 서비스 > DevOps Tools > DevOps Service 메뉴를 클릭하세요. DevOps 서비스의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 DevOps Service 메뉴를 클릭하세요. DevOps 목록 페이지로 이동합니다.
3. DevOps Service 목록 페이지에서 해지할 자원을 클릭하세요. DevOps Service 상세 페이지로 이동합니다.
4. DevOps Service 상세 페이지에서 서비스 해지 버튼을 클릭하세요.
5. 해지가 완료되면, DevOps Service 목록 페이지에서 자원이 해지되었는지 확인하세요.

1.3 - API Reference

1.4 - CLI Reference

1.5 - Release Note

2 - DevOps Console

2.1 - Overview

2.1.1 - DevOps Console 소개

서비스 개요

DevOps Console은 표준 개발도구를 통합 지원하여 개발환경을 쉽게 구성하고 빌드/배포의 편의성을 제공하는 서비스로서 다음과 같은 특징이 있습니다.

지속적 통합 및 배포(CI/CD Continuous Integration/Continuous Deployment)를 위한 주요 툴 연동 및 통합 인증

사용자는 한번의 로그인으로 소스코드 저장소, 아티팩트 저장소, 코드분석, 이미지 저장소, 빌드/배포를 담당하는 툴에 접근할 수 있습니다.

애플리케이션 템플릿 기반으로 프로젝트 구성

사용자는 개발표준이 반영되어 있는 템플릿을 이용하여 위저드 방식으로 프로젝트를 쉽게 구성할 수 있습니다.

주요 개발언어 및 프레임워크 제공

사용자는 애플리케이션 개발에 필요한 개발언어(Java, C#, Python, Ruby 등)와 프레임워크(SpringBoot, Vue.js, .Net 등)을 선택하여 빌드/배포를 위한 프로젝트를 구성할 수 있습니다.

빌드/배포 파이프라인 자동 구성

사용자는 애플리케이션 템플릿에 포함된 빌드/배포 파이프라인 템플릿을 이용하여 파이프라인 스크립트를 자동으로 구성하거나 GUI 기반으로 파이프라인의 각 단계를 구성할 수 있습니다.

다양한 배포 방식 지원 및 롤백 지원

사용자는 운영 중인 애플리케이션의 중단시간을 최소화하기 위한 배포방식(RollingUpdate, Blue-Green)을 이용할 수 있으며, 클릭 한 번으로 원하는 버전으로 롤백할 수 있습니다. 만약 사용자가 배포환경으로 VM 서버를 이용하고자 한다면, 패키징된 파일 또는 도커 이미지의 형태로 VM 서버에 배포할 수 있습니다.

맞춤형 릴리스 프로세스 지원

사용자는 애플리케이션 변경 유형을 고려하여 다양한 릴리스 프로세스를 정의하고 반복적으로 실행할 수 있습니다.

구성요소

사용자는 DevOps Console을 통해 DevOps Service를 손쉽게 이용할 수 있습니다.

DevOps Console

애플리케이션 개발과 빌드/배포에 필요한 도구를 통합적으로 지원하여 프로젝트 구성 및 빌드/배포를 쉽게 관리할 수 있습니다.

Dev. Starter

개발표준이 반영된 샘플코드 뿐만 아니라 빌드/배포에 필요한 템플릿을 통합 제공하는 애플리케이션 템플릿입니다.

IDP(ID Provider)

사용자를 통합 관리하고 인증을 담당합니다.

소스코드 저장소

소스코드 형상관리 도구와의 연계를 지원합니다.

아티팩트 저장소

애플리케이션 빌드에 필요한 라이브러리와 애플리케이션 아티팩트를 저장하기 위한 아티팩트 저장소와의 연계를 지원합니다.

코드품질

코드 정적 분석을 통해 소스코드의 품질을 측정하고 관리할 수 있는 코드품질 도구와의 연계를 지원합니다.

헬름차트 저장소

Kubernetes에서는 소프트웨어를 쉽게 설치하고 업그레이드하기 위해서 헬름차트를 사용합니다. 사용자가 소프트웨어를 설치하기 위해서는 헬름차트를 직접 작성해야 합니다. 헬름차트를 관리하는 저장소로서 ChartMuseum을 기본으로 제공합니다. 또한 다른 차트저장소 툴과의 연계도 지원합니다.

이미지 저장소

컨테이너 이미지를 저장하기 위한 이미지 저장소와의 연계를 지원합니다.

VM서버 그룹

애플리케이션의 배포 대상이 되는 VM 서버 묶음입니다. 사용자는 DevOps Console에서 VM을 등록하고 배포 대상으로 지정할 수 있습니다.

Kubernetes Cluster

애플리케이션의 배포 대상이 되는 클러스터입니다. 사용자는 DevOps Console에서 Kubernetes Cluster를 등록하고 배포 대상으로 지정할 수 있습니다.

주요 개념 및 관계

시스템 관리자(System Admin)나 관리자(Admin)는 사용자가 프로젝트를 생성할 때 필요한 툴과 애플리케이션 템플릿을 사전에 정의해야 합니다.

테넌트

프로젝트에서 활용 가능한 툴과 애플리케이션 템플릿을 독립적으로 제공하고 공유하는 논리적 구분 단위입니다. 시스템 관리자는 독립성이 보장되어야 하는 조직(혹은 고객) 단위로 테넌트를 등록하고 테넌트 관리자를 지정합니다. 테넌트 관리자는 해당 테넌트에서 활용할 수 있는 테넌트 툴과 애플리케이션 템플릿, 테넌트 멤버를 등록할 수 있습니다.

프로젝트그룹

개별 프로젝트를 관리하기 위한 단위로서, 특정 테넌트에 속한 멤버가 프로젝트그룹을 생성할 수 있습니다. 따라서 프로젝트그룹은 하나의 테넌트에 속하며, 테넌트에 설정된 툴과 템플릿을 활용할 수 있습니다.

프로젝트

프로젝트는 독립적으로 배포/실행되는 애플리케이션이나 마이크로서비스를 개발하고 관리하는 단위입니다. 따라서 하나의 소스코드 저장소를 기준으로 프로젝트를 구성하는 것이 일반적이지만 애플리케이션이나 개발과 운영조직의 특성에 따라 유연하게 구성할 수 있습니다.

툴

프로젝트에서 활용하는 소스코드 저장소, 이미지 저장소, 빌드/배포 파이프라인, 코드품질 등을 지원하는 개발도구입니다. 각 프로젝트는 소속된 프로젝트그룹이나 테넌트 혹은 애플리케이션의 배포 대상인 Kubernetes Cluster에 지정된 툴을 이용할 수 있습니다. 일반적으로 클러스터 단위로 지정하는 경우는 배포 속도에 영향을 주는 빌드/파이프라인과 이미지 저장소를 지원하는 툴입니다. 툴은 활용 범위에 따라서 크게 세 가지 유형으로 구분합니다.

애플리케이션 템플릿

프로젝트를 쉽게 구성할 수 있게 하는 템플릿입니다. 개발표준을 반영하여 샘플코드까지 지원하는 템플릿을 Dev. Starter라고 하며, 단순히 개발환경 구성을 지원하는 템플릿을 Environment Only라고 합니다. 툴과 마찬가지로 활용 범위에 따라서 크게 세 가지 유형으로 구분합니다.

2.1.2 - 역할

프로젝트 그룹 역할자 및 권한

• 프로젝트 그룹 생성자는 기본으로 Owner 권한입니다.
• Master 는 Owner 의 모든 권한 중 프로젝트그룹 삭제 권한이 없습니다.
• Developer와 Viewer는 조회 권한만 있습니다.

프로젝트 역할자 및 권한

• Owner, Master, Developer, Viewer로 구분됩니다.
• Viewer는 조회 만 가능합니다.
• Developer는 개발 관련 기능의 생성/삭제가 가능합니다.
  • 예시) 빌드 파이프라인, 헬름차트, 배포
• Owner/Master는 프로젝트 내의 모든 기능의 조회/생성/삭제 가능합니다.
• 프로젝트 역할자는 프로젝트그룹의 역할자를 승계합니다.
• 프로젝트의 멤버로 등록되지 않아도 프로젝트그룹의 멤버인 경우 해당 역할을 프로젝트에서 수행 가능합니다.
• 동일한 사용자의 프로젝트와 프로젝트그룹의 역할이 다를 때는 프로젝트 역할이 우선 적용됩니다.
  • 즉, 프로젝트그룹 멤버 중 특정 프로젝트에서 권한을 제한할 수 있습니다.
• 예시) 프로젝트그룹의 Master 역할자를 특정 프로젝트에서 Master 권한을 부여하지 않으려는 경우, 프로젝트 멤버로 등록하고 Developer 혹은 Viewer 권한을 부여하면 됩니다.

• Jenkins 시스템 권한
  • DevOps Console의 프로젝트 권한 체계에 따라 접근 권한이 부여됩니다.
    • 프로젝트 내 각 역할자별 Jenkins 시스템 권한표 참고
  • 프로젝트 역할자에 따라 Jenkins 파이프라인에 권한이 부여됩니다.
  • Jenkins 이외의 다른 툴은 해당 툴 메뉴에서 권한을 설정할 수 있습니다.

시스템 역할자 및 권한

2.1.3 - 화면구성

DevOps Console의 주요 메뉴 페이지에 대해 설명합니다.

처음 접속하면 상단 메뉴와 권한을 가진 모든 프로젝트그룹과 프로젝트가 표시됩니다.

상단 메뉴

상단 메뉴를 통해 메인 화면, 관리 화면 등으로 이동할 수 있으며 사용자 정보를 수정할 수 있습니다. 상단 메뉴는 DevOps Console을 이용하는 동안 항상 표시됩니다.

메인 페이지

사용자가 권한을 가진 모든 프로젝트그룹과 프로젝트의 현황을 표시합니다.

관리 페이지

대시보드, 테넌트, 프로젝트, 툴, 사용자 등 DevOps Console 전반적인 관리 기능을 포함하고 있습니다.

프로젝트그룹 관리 페이지

프로젝트그룹과 릴리스에 대한 관리 페이지입니다.

프로젝트 페이지

프로젝트에 대한 페이지입니다.

2.2 - 시작하기

2.2.1 - DevOps Console 시작하기

DevOps Console에 로그인하고, 표시할 언어와 사용자 정보를 설정하는 방법을 설명합니다.

회원가입하기

DevOps Console을 사용하기 위해서는 Samsung Cloud Platform 과 구분되는 DevOps Console 계정 생성이 필요하고, 회원 가입을 통해 계정을 생성할 수 있습니다.

DevOps Console에 계정을 생성하려면 다음 절차를 따르세요.

1. 로그인 페이지의 회원가입 링크를 클릭하세요. 회원가입 페이지로 이동합니다.
2. 본인 인증을 진행하세요. 본인 인증이 완료되면 다음 버튼을 클릭하세요.

   항목	필수 여부	설명
   자동 입력 방지	필수	이미지에 출력된 문자를 입력창에 입력

   표. 본인 인증 정보
3. 가입 정보 항목의 약관에 동의하세요.

   항목	필수 여부	설명
   서비스 이용약관	필수	서비스 약관 동의 여부 체크
   개인정보 처리방침	필수	개인정보 수집 및 이용 동의 여부 체크
   만 14세 이상입니다.	필수	만 14세 이상 확인 여부 체크

   표. 가입 정보 입력 정보
4. 회원 정보 항목의 필수 항목 정보를 입력하세요.

   항목	필수 여부	설명
   사용자 ID(이메일)	필수	가입자 아이디로 사용할 이메일
   휴대전화 번호	필수	휴대전화 번호 입력 휴대전화 번호를 입력하고 OTP 발송 버튼을 클릭하여, OTP 번호 발급 휴대전화로 발급받은 OTP 번호을 입력하고, 인증 버튼 클릭 OTP 번호가 유효하면 휴대전화 번호 인증 완료
   비밀번호	필수	가입자가 사용할 비밀번호를 8~20자리 이내로 입력 가능 사용자 ID 또는 이름을를 비밀번호로 사용 불가 대문자(영문), 소문자(영문), 숫자, 특수 문자(! @ # $ % ^ & *)를 각 1개 이상 포함 동일한 문자를 3 회 이상 사용 불가 4자리 이상의 연속 문자/숫자는 사용 불가 비밀번호 변경 주기: 90일
   비밀번호 확인	필수	가입자가 사용할 비밀번호 확인
   이름	필수	가입자 이름 문자, 숫자와 공백을 사용하여 100자 이내로 입력 가능
   언어	필수	이메일, SMS 등의 알림 언어 설정
   타임존	필수	사용자의 타임존 정보 설정

   표. 회원 정보 입력 정보
5. 정보를 모두 입력하고, 완료 버튼을 클릭하면 입력한 이메일로 인증 메일이 발송됩니다.
   • 수신한 메일에서 이메일 주소 인증 버튼을 클릭하면 회원가입이 완료됩니다.

로그인하기

DevOps Console에 로그인하려면 로그인 페이지에서 계정 정보를 입력한 후 다음 버튼을 클릭하세요.

OTP 인증 페이지에서 선택한 OTP 유형으로 발급된 OTP 번호를 입력한 후 로그인 버튼을 클릭하세요.

ID나 비밀번호가 기억나지 않을 경우 ID/비밀번호 찾기 링크를 클릭해 먼저 계정 정보를 찾은 후 로그인을 시도하세요.

로그인이 완료되면 DevOps Console 메인 페이지가 열립니다.

사용자 정보 수정하기

사용자 정보를 수정하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 바로가기 아이콘을 클릭하세요.
2. DevOps IDP 링크를 클릭하세요. DevOps IDP 페이지가 새 탭으로 열립니다.
3. 사용자 정보 페이지에서 휴대전화 번호, 비밀번호, 이름, 타임존, 언어 등의 정보를 변경할 수 있습니다.

DevOps Console에서 사용하는 정보를 수정하려면 다음 절차를 따르세요.

1. 메인 페이지의 상단 메뉴에서 사용자 아이콘을 클릭하세요.
2. 계정 정보 메뉴를 클릭하세요. 계정 정보 팝업창이 열립니다.
3. 언어, 시간대 정보를 변경 후 저장 버튼을 클릭하여 계정 정보 수정을 완료하세요.

콘솔 언어 변경하기

DevOps Console에서 표시되는 언어를 변경하려면 로그인 이후 DevOps Console 페이지 아래에 있는 설정 언어를 클릭해 원하는 언어로 변경할 수 있습니다.

인증키 관리하기

메인 페이지의 상단 메뉴에서 사용자 아이콘 클릭 후 인증키 관리 메뉴를 통해 사용자 개별 인증키를 관리할 수 있습니다.

인증키 추가하기

인증키를 추가하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 사용자 아이콘을 클릭하세요.
2. 인증키 관리 메뉴를 클릭하세요. 인증키 관리 팝업창이 열립니다.
3. 인증키 생성 버튼을 클릭하세요. 인증키 생성 팝업창이 열립니다.
4. 만료기한 설정 후 저장 버튼을 클릭하여 인증키 생성을 완료하세요.

보안설정 하기

보안설정을 통해 해당 인증키를 사용할 수 있는 IP를 제한할 수 있습니다.

보안설정을 추가하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 사용자 아이콘을 클릭하세요.
2. 인증키 관리 메뉴를 클릭하세요. 인증키 관리 팝업창이 열립니다.
3. 보안설정 탭을 클릭 후 수정 버튼을 클릭하세요. 보안설정 변경 팝업창이 열립니다.
4. IP 접근제어를 사용 으로 설정하세요.
5. 접근 허용 IP 입력 후 저장 버튼을 클릭하여 보안설정을 완료하세요.

인증키 삭제하기

인증키를 삭제하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 사용자 아이콘을 클릭하세요.
2. 인증키 관리 메뉴를 클릭하세요. 인증키 관리 팝업창이 열립니다.
3. 상태변경 버튼을 클릭하세요.
4. 인증키 상태 변경 팝업이 열리면 미사용 처리 후 저장 버튼을 클릭하세요.
5. 삭제 버튼을 클릭하여 인증키 삭제를 완료하세요.

나의 활동 내역 확인하기

메인 페이지의 상단 메뉴 중 사용자 아이콘 > 나의 활동 내역 메뉴를 클릭하면 사용자는 자신의 DevOps Console 활동 내역을 확인할 수 있습니다.

접근제어 IP 설정하기

접근이 가능한 IP를 등록하여 DevOps Console 접근을 제어할 수 있습니다.

접근제어 IP를 등록하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 바로가기 아이콘을 클릭하세요.
2. DevOps IDP 링크를 클릭하세요. DevOps IDP 페이지가 새 탭으로 열립니다.
3. 왼쪽 메뉴에서 접근제어 메뉴를 클릭하세요.
4. 접근제어 페이지 아래의 수정 버튼을 클릭하세요. 접근제어 수정 페이지로 변경됩니다.
5. 접근제어 IP 설정 을 사용 으로 설정하세요.
6. 접근을 허용 할 IP 추가 후, 저장 버튼을 클릭하여 접근제어 설정을 완료하세요.

회원탈퇴하기

DevOps Console 회원을 탈퇴하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 바로가기 아이콘을 클릭하세요.
2. DevOps IDP 링크를 클릭하세요. DevOps IDP 페이지가 새 탭으로 열립니다.
3. 사용자 정보 페이지 오른쪽 위의 회원탈퇴 버튼을 클릭하세요. 회원탈퇴 팝업창이 열립니다.
4. 현재 비밀번호를 입력창에 입력 후, 회원탈퇴 버튼을 클릭하여 탈퇴를 완료하세요.

2.2.1.1 - 가입정보

사용자는 자신의 기본정보, 인증정보, 가입한 테넌트, 가입한 프로젝트그룹, 가입한 프로젝트를 확인 및 관리할 수 있습니다.

가입정보 시작하기

가입정보 관리를 시작하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 가입 정보 메뉴를 클릭하세요. 가입정보 페이지로 이동합니다.

인증정보 관리하기

인증정보에는 사용자가 툴 등록, 사용 등에 이용한 인증정보가 자동으로 저장됩니다. 필요한 경우, 새로운 인증정보를 추가하거나 기존 인증정보를 수정 또는 삭제할 수 있습니다.

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

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 가입 정보 메뉴를 클릭하세요. 가입정보 페이지로 이동합니다.
3. 가입정보 페이지에서 인증정보 탭을 클릭하세요.

인증정보 추가하기

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

1. 인증정보 탭에서 추가 버튼을 클릭하세요. 인증정보 추가 팝업창이 열립니다.
2. 인증정보 추가 팝업창에서 정보를 입력하세요.
3. 사용자가 접속 가능한 모든 툴과 URL이 표시됩니다.
4. 정보 입력을 완료하고 Connection Test 버튼을 클릭하세요.
5. 저장 버튼을 클릭하세요.

인증정보 수정하기

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

1. 인증정보 탭에서 수정하고자 하는 인증정보를 클릭하세요. 인증정보 수정 팝업창이 열립니다.
2. 인증정보 수정 팝업창에서 정보를 입력한 후 Connection Test 버튼을 클릭하세요.
3. 저장 버튼이 활성화되면 저장 버튼을 클릭하세요.

인증정보 삭제하기

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

1. 인증정보 탭에서 삭제하고자 하는 인증정보의 체크박스를 선택하세요.
2. 인증정보 목록에서 삭제 버튼을 클릭하세요.
3. 확인 팝업창에서 확인 버튼을 클릭하세요.

가입한 테넌트 관리하기

사용자는 자신이 가입한 테넌트의 목록을 조회할 수 있습니다.
또한 새로운 테넌트에 가입 요청할 수 있고, 자신이 가입된 테넌트에서 탈퇴할 수도 있습니다.

가입한 테넌트를 관리하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 가입 정보 메뉴를 클릭하세요. 가입정보 페이지로 이동합니다.
3. 가입정보 페이지에서 가입한 테넌트 탭을 클릭하세요.

테넌트 가입 요청하기

테넌트 가입을 요청하려면 다음 절차를 따르세요.

1. 가입한 테넌트 탭에서 가입 버튼을 클릭하세요. 테넌트 가입 요청 팝업창이 열립니다.
2. 테넌트 가입 요청 팝업창에서 가입할 테넌트 코드를 입력하고 검색 아이콘을 클릭하세요.
3. 요청사유를 입력하고 추가 버튼을 클릭하세요.
4. 추가된 테넌트의 권한을 선택한 후 저장 버튼을 클릭하세요.
5. 확인 팝업창에서 확인 버튼을 클릭하세요.

테넌트 탈퇴하기

테넌트를 탈퇴하려면 다음 절차를 따르세요.

1. 가입한 테넌트 탭에서 탈퇴하고자 하는 테넌트의 체크박스를 선택하세요.
2. 탈퇴 버튼을 클릭하세요.
3. 확인 팝업창에서 확인 버튼을 클릭하세요.

가입한 프로젝트그룹 관리하기

사용자는 자신이 가입한 프로젝트그룹 목록을 조회할 수 있습니다.

가입한 프로젝트그룹을 관리하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 가입 정보 메뉴를 클릭하세요. 가입정보 페이지로 이동합니다.
3. 가입정보 페이지에서 가입한 프로젝트그룹 탭을 클릭하세요.

프로젝트그룹 목록에서 프로젝트그룹을 클릭하면, 프로젝트그룹 관리 페이지로 이동합니다.

프로젝트그룹 관리에 대한 자세한 내용은 프로젝트그룹 개요를 참고하세요.

가입한 프로젝트 관리하기

사용자는 자신이 가입한 프로젝트 목록을 조회할 수 있습니다.

가입한 프로젝트를 관리하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 가입 정보 메뉴를 클릭하세요. 가입정보 페이지로 이동합니다.
3. 가입정보 페이지에서 가입한 프로젝트 탭을 클릭하세요.

프로젝트 목록에서 프로젝트를 클릭하면, 프로젝트 관리 페이지로 이동합니다.

프로젝트에 대한 자세한 내용은 프로젝트를 참고하세요.

2.2.2 - Tutorial (프로젝트생성부터 빌드/배포까지)

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

프로젝트그룹 생성하기

사용자는 프로젝트그룹을 생성할 수 있습니다. 사용자는 프로젝트그룹을 생성할 테넌트에 가입되어 있어야 합니다.

프로젝트그룹 생성하기

프로젝트그룹을 생성하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트그룹 생성하며 시작하기 버튼 또는 프로젝트그룹 생성 버튼을 클릭하세요. 프로젝트그룹 생성 팝업창이 열립니다.
2. 항목을 입력 후 저장 버튼을 클릭하여 프로젝트그룹 생성을 완료하세요.

테넌트 가입하기

테넌트에 가입하려면 다음 절차를 따르세요.

1. 프로젝트그룹 생성 팝업창에서 테넌트 가입 바로가기 링크를 클릭하세요. 테넌트 가입 요청 팝업창이 열립니다.
2. 테넌트 검색 항목에 가입할 테넌트 코드를 정확하게 입력하고 검색 아이콘을 클릭하세요. 테넌트 정보가 조회됩니다.
3. 검색된 테넌트가 맞는지 확인하고 요청사유를 입력 후 추가 버튼을 클릭하세요. 하단 목록에 추가됩니다.
4. 하단 목록에 추가한 테넌트에 대한 권한을 선택한 후 저장 버튼을 클릭하세요.

(헬름차트 배포)프로젝트 생성하기

사용자는 App.템플릿, 헬름차트, 툴 관리을 이용하여, 특정 Kubernetes 클러스터에 애플리케이션을 배포하는 프로젝트를 만들 수 있습니다.

프로젝트 생성 시작하기

프로젝트 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지가 열립니다.

기본 정보 입력하기

프로젝트의 기본 정보를 입력합니다. 프로젝트명, 프로젝트 ID는 중복될 수 없고 유일해야 합니다.

기본정보를 입력하려면 다음 절차를 따르세요.

1. 프로젝트 생성 페이지에서 프로젝트 구성 방법 항목의 App. 템플릿 활용을 선택하세요.
2. 배포 타겟 항목은 Kubernetes를 선택하세요.
3. 추가 내용 입력 후 시작 버튼을 클릭하세요.

   항목	설명
   프로젝트명	프로젝트명을 입력하세요.
   프로젝트 ID	프로젝트 ID를 입력하세요.
   프로젝트 구성 방법	프로젝트 구성 방법을 선택 App. 템플릿 활용: 미리 제공되는 App. 템플릿을 선택합니다. 직접 구성: App. 템플릿 없이 직접 구성합니다.
   배포 타겟	배포 타겟을 선택 Kubernetes: 애플리케이션을 Kubernetes 클러스터에 배포합니다. Kubernetes(ArgoCD): ArgoCD를 사용하여 애플리케이션을 Kubernetes 클러스터에 배포합니다. VM(Artifact): 애플리케이션을 VM서버에 배포합니다. VM(Docker): 애플리케이션을 Docker 이미지로 만들어 VM서버에 배포합니다. N/A: 빌드 결과를 배포하지 않는 경우 선택합니다.
   K8S 클러스터	배포할 대상 클러스터를 선택 DevOps Console K8S 클러스터의 클러스터 중 사용자가 접근권한을 가진 클러스터만 선택할 수 있습니다.
   네임스페이스	배포할 대상 네임스페이스를 선택 K8S 클러스터에서 조회된 클러스터 중 사용자가 접근 권한을 가진 네임스페이스만 선택할 수 있습니다.

   표. 프로젝트 생성 기본 정보 입력 항목

애플리케이션 템플릿 선택하기

사용자는 프로젝트를 구성할 애플리케이션 템플릿을 선택할 수 있습니다.

샘플 소스코드가 포함된 애플리케이션 템플릿을 기반으로 프로젝트를 생성하면, 배포될 애플리케이션을 확인할 수 있습니다.

반면 Environment Only로 표기된 템플릿을 이용하면 샘플 소스코드 없이 빌드/배포 환경만 구성합니다.

이미 구성된 소스코드 저장소를 사용하여 프로젝트를 구성할 경우 Environment Only로 표시된 템플릿을 선택하세요.

애플리케이션 템플릿 선택하기를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   필터	미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
   검색	검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.

   표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

사용자는 코드저장소 설정 단계를 통해 소스코드를 관리할 저장소를 설정할 수 있습니다.

신규 저장소 생성과 기존 저장소 사용 활성화 조건은 애플리케이션 템플릿과 툴에 따라서 다르게 나타납니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 코드 저장소 항목에서 코드 저장소 유형을 선택하세요.
2. 신규 저장소 생성 또는 기존 저장소 사용을 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

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

   표. 프로젝트 생성 코드 저장소 설정 항목

코드 품질 설정하기

사용자는 품질 관리를 위한 저장소를 구성할 수 있습니다.

코드 품질을 설정하려면 다음 절차를 따르세요.

1. 코드 품질 항목에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 사용자가 사용 가능한 Code Quality 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 신규 저장소 생성을 선택할 경우, 품질 프로젝트명/품질 프로젝트 Key를 입력해야 합니다. 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL	SonarQube URL을 선택하세요.
   품질 프로젝트명	SonarQube의 프로젝트의 이름을 입력하세요.
   품질 프로젝트 Key	SonarQube의 프로젝트의 Key를 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.

   표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

사용자는 이미지 저장소 설정단계를 통해 빌드된 컨테이너 이미지를 저장할 저장소를 설정할 수 있습니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 이미지 저장소 항목에서 저장소 유형을 선택하세요.
2. 신규 저장소 생성/기존 저장소 사용 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소 유형을 선택 사용자가 사용가능한 Image Registry 툴의 유형들이 나타납니다.
   저장소 정보	저장소 생성 방식을 선택하세요. 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
   인증 정보	인증정보를 입력하세요.

   표. 프로젝트 생성 이미지 저장소 설정 항목

배포대상 환경 설정하기

사용자는 헬름차트를 통해 직접 구성을 통해 배포를 할 수 있습니다.

헬름릴리스명과 헬름차트 선택 시 헬름차트 설치 항목과 차트에 포함된 기본 Values.yaml 항목이 나타납니다.

사용가능한 헬름차트는 App. 템플릿과 연계되어 있습니다. 지원 헬름차트 관리하기를 통해 수정/삭제 할 수 있습니다.

배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 항목에서 헬름차트를 통해 직접 구성을 선택하세요.
2. 헬름릴리스명을 입력하세요.
3. 검색 버튼을 클릭하여 사용할 헬름차트 를 선택하세요.
4. Values.yaml을 수정 후 Validation Check 버튼을 클릭하세요.
5. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   배포 대상	배포 대상을 선택하세요.
   헬름릴리스명	생성할 헬름릴리스의 이름을 입력하세요. 해당 이름은 배포될 클러스터의 네임스페이스 내에서 유일해야 합니다.
   헬름차트	헬름차트를 선택하세요. 헬름차트 선택 시 하위에 선택한 차트에 대한 세부 내용이 표시
   K8S 정보	Value.yaml 구성에 필요한 Kubernetes 클러스터의 정보를 보여줍니다.
   Values. yaml	Values.yaml 내용을 수정하세요. 헬름차트 설치 시 사용할 values.yaml 파일 입니다.

   표. 프로젝트 생성 배포 대상 환경 설정 항목

빌드 파이프라인 설정하기

사용자는 애플리케이션을 빌드하고 배포하는 파이프라인을 구성할 수 있습니다.

구성할 파이프라인의 각 단계를 확인할 수 있으며 빌드 Job 이름을 변경할 수 있습니다.

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

1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
   • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
   • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   빌드/배포 파이프라인	빌드/배포 파이프라인 정보를 보여줍니다. 빌드/배포 파이프라인은 App. 템플릿의 파이프라인 템플릿 관리하기에 등록된 정보를 바탕으로 표시
   구분	개발/운영 구분을 선택하세요. 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)를 참고하세요.
   URL	파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요. 사용자가 사용가능한 Jenkins 가 나타납니다.
   빌드 에이전트	파이프라인 빌드에 사용될 에이전트를 선택하세요. 에이전트에 대한 정보는 에이전트(kubernetes) 관리하기, 에이전트(VM) 관리하기를 참고하세요.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   사용자 정보	IDP 연동 Jenkins 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요. Jenkins 사용자로 등록되지 않은 경우, 사용자 등록 안내 팝업창이 열리면 Jenkins로 이동하기 링크를 클릭하여 사용자 가입 또는 Jenkins 최초 로그인을 진행하세요. IDP 미연동 Jenkins 인증정보를 입력하고 Connection Test 버튼을 클릭하세요.
   환경 변수 설정	Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
   Image Tag Pattern	컨테이너 이미지의 tag 부여방식을 선택하세요.
   Deploy Strategy	컨테이너 이미지의 배포방식을 선택하세요.
   배포 결과 수신자	빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.

   표. 프로젝트 생성 빌드 파이프라인 설정 항목

사용자 정의 설정하기

사용자는 빌드에 사용될 Dockerfile 파일의 경로를 지정하고 수정할 수 있습니다.

또한 빌드 파이프라인 설정하기에서 설정한 정보를 바탕으로 생성된 최종 스크립트를 확인할 수 있고 수정도 할 수 있습니다.

Dockerfile, 파이프라인 스크립트를 설정하려면 다음 절차를 따르세요.

1. 사용자 정의 설정 페이지에서 정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.

   항목	설명
   Dockerfile 설정	신규 Dockerfile 생성 또는 기존 Dockerfile 사용 여부를 선택하세요. 기존 Dockerfile 사용은 Environment Only App. 템플릿을 선택 후 코드 저장소 설정하기에서 기존 저장소 사용으로 선택한 경우만 선택할 수 있습니다.
   Dockerfile 경로	소스코드 상의 Dockerfile 파일 경로를 지정하세요.
   Branch 명	Branch 명은 코드 저장소 설정하기에서 설정 시 등록한 Branch 명이 자동으로 등록됩니다.
   Dockerfile	Dockerfile의 파일 내용을 확인 및 수정하세요.
   파이프라인 스크립트	파이프라인 스크립트를 확인 및 수정하세요.

   표. 프로젝트 생성 사용자 정의 설정 항목

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

빌드 파이프라인 실행 확인하기

프로젝트 페이지에서 파이프라인 실행 상태를 확인할 수 있으며 최초 프로젝트 생성이 완료되면 빌드 파이프라인이 자동으로 실행됩니다.

빌드 파이프라인이 실패한 경우, 왼쪽 빌드 파이프라인 메뉴를 통해 파이프라인 수정 및 재실행을 진행하세요.

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

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

배포 결과 확인하기

파이프라인 실행 완료 후 헬름차트 배포 결과를 확인할 수 있습니다.

헬름차트 배포 결과에 대한 자세한 내용은 헬름릴리스를 참고 하세요.

배포 결과를 확인하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 빌드/배포 > Kubernetes 배포 메뉴를 클릭하세요. Kubernetes 배포 페이지로 이동합니다.
3. 헬름릴리스 목록을 클릭하여 상세 배포 결과를 확인하세요.

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

사용자는 다음 절차를 통해, 이미 생성된 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. 완료 버튼을 클릭하여 파이프라인 추가를 완료하세요.

파이프라인 추가 결과

2.2.2.2 - (워크로드 배포) 빌드/배포 추가하기

사용자는 다음 절차를 통해, 이미 생성된 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. 완료 버튼을 클릭하여 파이프라인 추가를 완료하세요.

파이프라인 추가 결과

2.2.2.3 - (VM 배포) 빌드/배포 추가하기

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

VM서버그룹/VM서버 추가하기 (Option)를 통해 추가한 VM 서버그룹/VM 서버는 Deploy to VM 스테이지 설정하기에서 사용하게 됩니다.

빌드/배포 추가 시작하기

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

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. 저장 버튼을 클릭하세요.

아티팩트 저장소 추가하기 (Option)

아티팩트 저장소를 추가하려면 다음 절차를 따르세요.

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

   항목	설명
   저장소 생성 여부 선택	새로 저장소를 생성할지, 기존 저장소를 사용할지 선택합니다.
   기본정보 입력	Base URL, 저장소 타입 선택 및 저장소/인증정보 입력합니다.

   표. 아티팩트 저장소 추가하기 입력 항목

VM서버그룹/VM서버 추가하기 (Option)

VM서버 그룹을 추가하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 배포 타겟 > VM서버 그룹 메뉴를 클릭하세요. VM서버 그룹 페이지로 이동합니다.
3. VM서버 그룹 페이지에서 추가 버튼을 클릭하세요. VM서버 그룹 추가 페이지로 이동합니다.
4. 기본 정보 입력 후 저장 버튼을 클릭하여 VM서버 그룹 설정을 완료하세요.

   항목	설명
   서버그룹명	VM서버 그룹 이름을 입력하세요.
   설명	설명을 입력하세요.
   타입	VM서버그룹의 타입을 선택 SSH: VM 배포시 SSH 명령어를 통하여 배포를 수행합니다. 에이전트: VM 배포시 에이전트를 이용하여 배포를 수행합니다. (에이전트 연동하기)
   VM서버	추가: VM서버 그룹에 포함되는 VM서버를 추가 하세요. 삭제: VM서버 그룹에서 삭제하려는 VM서버의 체크박스를 체크하고 삭제를 클릭하여 삭제 하세요.

   표. VM서버 그룹 추가 입력 항목

VM서버 추가하기

VM서버를 추가하기 위해서는 해당 VM서버 그룹의 Manager 권한이 필요합니다.

VM서버를 추가하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 배포 타겟 > VM서버 그룹 메뉴를 클릭하세요. VM서버 그룹 페이지로 이동합니다.
3. VM서버 그룹 페이지의 VM서버 그룹 목록에서 VM서버를 추가할 VM서버 그룹을 클릭하세요. VM서버 그룹 상세 페이지로 이동합니다.
4. VM서버 그룹 상세 페이지에서 추가 버튼을 클릭하세요. VM서버 추가 페이지로 이동합니다.
5. VM서버 추가 페이지에서 기본 정보 입력 후 추가 버튼을 클릭하여 VM서버 설정을 완료하세요.

   항목	설명
   서버명	VM서버 이름을 입력하세요.
   설명	설명을 입력하세요.
   IP	IP를 입력하세요.
   SSH Port	SSH 연결시 사용할 VM서버의 port를 입력하세요.
   OS	OS를 입력하세요.
   위치	위치를 선택하세요.
   인증정보	SSH 연결시 사용할 VM서버의 인증정보를 입력하세요.
   Secret Key	에이전트가 설치된 VM서버를 인증하기 위한 비밀키입니다.

   표. VM서버 추가 입력 항목

빌드 파이프라인 추가하기

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

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 VM 스테이지 설정하기

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

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

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

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

파이프라인 추가 결과

2.2.2.4 - (프로젝트 생성 전) 배포 대상 네임스페이스 권한 확인 하기

사용자는 다음 절차를 통해 DevOps Console 프로젝트를 생성하고, 소스를 빌드/배포를 수행하기 전 배포대상이 되는 클러스터 / 네임스페이스의 사용 권한이 있는지 살펴보고, 필요시 담당자에게 클러스터 / 네임스페이스에 권한 추가를 요청하세요.

DevOps Console K8S 클러스터의 네임스페이스 권한 확인하기

DevOps Console에서 사용 중인 K8S 클러스터의 네임스페이스에 대하여 권한 여부를 확인하려면 다음 절차를 따르세요.

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 배포 타겟 > K8S 클러스터 메뉴를 클릭하세요. K8S 클러스터 목록 페이지로 이동합니다.
3. K8S 클러스터를 클릭하세요. 선택한 K8S 클러스터의 상세정보 페이지로 이동합니다.
4. 네임스페이스 탭을 클릭하세요. 네임스페이스 목록 화면이 나타납니다.
5. 네임스페이스를 클릭하면 네임스페이스 상세 페이지로 이동합니다.

2.3 - 프로젝트

2.3.1 - 프로젝트 개요

사용자는 해당 프로젝트의 상세정보 뿐만 아니라 관련된 헬름릴리스 정보, 사용하고 있는 툴 정보 등을 확인할 수 있습니다.

프로젝트의 권한이 Master 이상인 사용자는 이 메뉴를 통해 프로젝트 이름을 수정 할 수 있고 Owner 는 프로젝트를 삭제할 수 있습니다.

프로젝트 개요 시작하기

프로젝트 개요 사용을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 프로젝트 개요 메뉴를 클릭하세요. 프로젝트 개요 화면이 나타납니다.

프로젝트명 수정하기

프로젝트명을 수정하려면 다음 절차를 따르세요.

1. 프로젝트 개요 화면에서 오른쪽 위의 프로젝트명 수정 버튼을 클릭하세요. 프로젝트명 수정 팝업창이 열립니다.
2. 프로젝트명 수정 팝업창에서 프로젝트명을 수정하고 저장 버튼을 클릭하여 프로젝트명 수정을 완료하세요.

프로젝트 삭제하기

프로젝트를 삭제하려면 다음 절차를 따르세요.

1. 프로젝트 개요 화면에서 오른쪽 위의 프로젝트 삭제 버튼을 클릭하세요. 프로젝트 삭제 팝업창이 열립니다.
2. 프로젝트 삭제 팝업창에서, 확인 버튼을 클릭하세요. 프로젝트 삭제 페이지로 이동합니다.
3. 프로젝트 삭제 페이지에서 필요한 내용을 입력, 선택하고 삭제 버튼을 클릭하세요. 프로젝트 삭제 팝업창이 열립니다.
4. 프로젝트 삭제 팝업창에서 프로젝트명을 입력하세요.
5. 확인 버튼을 클릭하여 프로젝트 삭제를 완료하세요.

   항목	설명
   프로젝트명 확인	삭제하려는 현재 프로젝트명을 입력하세요.
   헬름릴리스 삭제 빌드 파이프라인 삭제 코드저장소 삭제	프로젝트와 동시에 삭제하려는 경우 선택 선택: 프로젝트 삭제 시 실제 물리적 삭제 명령어를 실행합니다. 미선택: DevOps Console에서만 논리적으로 삭제되며, 실제 각 툴에는 남아 있습니다.

   표. 프로젝트 삭제 입력 항목

모든 프로젝트 관리하기

1. 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 테넌트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 테넌트 > 프로젝트 메뉴를 클릭하세요. 프로젝트 페이지로 이동합니다.

2.3.2 - 프로젝트 생성하기

2.3.2.1 - (헬름차트 배포) 프로젝트 생성하기

사용자는 App.템플릿, 헬름차트, 툴 관리를 이용하여, 특정 Kubernetes 클러스터에 애플리케이션을 배포하는 프로젝트를 만들 수 있습니다.

프로젝트 생성 시작하기

프로젝트 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지로 이동합니다.

기본 정보 입력하기

프로젝트의 기본 정보를 입력합니다. 프로젝트명, 프로젝트 ID는 중복될 수 없고 유일해야 합니다.

기본정보를 입력하려면 다음 절차를 따르세요.

1. 프로젝트 생성 페이지에서 프로젝트 구성 방법 항목의 App. 템플릿 활용을 선택하세요.
2. 배포 타겟 항목은 Kubernetes를 선택하세요.
3. 추가 내용 입력 후 시작 버튼을 클릭하세요.

   항목	설명
   프로젝트명	프로젝트명을 입력하세요.
   프로젝트 ID	프로젝트 ID를 입력하세요.
   프로젝트 구성 방법	프로젝트 구성 방법을 선택 App. 템플릿 활용: 미리 제공되는 App. 템플릿을 선택합니다. 직접 구성: App. 템플릿 없이 직접 구성합니다.
   배포 타겟	배포 타겟을 선택 Kubernetes: 애플리케이션을 Kubernetes 클러스터에 배포합니다. Kubernetes(ArgoCD): ArgoCD를 사용하여 애플리케이션을 Kubernetes 클러스터에 배포합니다. VM(Artifact): 애플리케이션을 VM서버에 배포합니다. VM(Docker): 애플리케이션을 Docker 이미지로 만들어 VM서버에 배포합니다. N/A: 빌드 결과를 배포하지 않는 경우 선택합니다.
   K8S 클러스터	배포할 대상 클러스터를 선택 DevOps Console K8S 클러스터의 클러스터 중 사용자가 접근권한을 가진 클러스터만 선택할 수 있습니다.
   네임스페이스	배포할 대상 네임스페이스를 선택 K8S 클러스터에서 조회된 클러스터 중 사용자가 접근 권한을 가진 네임스페이스만 선택할 수 있습니다.

   표. 프로젝트 생성 기본 정보 입력 항목

App. 템플릿 선택하기

사용자는 프로젝트를 구성할 애플리케이션 템플릿을 선택할 수 있습니다.

샘플 소스코드가 포함된 애플리케이션 템플릿을 기반으로 프로젝트를 생성하면, 배포될 애플리케이션을 확인할 수 있습니다.

반면 Environment Only로 표기된 템플릿을 이용하면 샘플 소스코드 없이 빌드/배포 환경만 구성합니다.

이미 구성된 소스코드 저장소를 사용하여 프로젝트를 구성할 경우 Environment Only로 표시된 템플릿을 선택하세요.

애플리케이션 템플릿 선택하기를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   필터	미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
   검색	검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.

   표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

사용자는 코드저장소 설정 단계를 통해 소스코드를 관리할 저장소를 설정할 수 있습니다.

신규 저장소 생성과 기존 저장소 사용 활성화 조건은 애플리케이션 템플릿과 툴에 따라서 다르게 나타납니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 코드 저장소 항목에서 코드 저장소 유형을 선택하세요.
2. 신규 저장소 생성 또는 기존 저장소 사용을 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

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

   표. 프로젝트 생성 코드 저장소 설정 항목

코드 품질 설정하기

사용자는 품질 관리를 위한 저장소를 구성할 수 있습니다.

코드 품질을 설정하려면 다음 절차를 따르세요.

1. 코드 품질 항목에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 사용자가 사용 가능한 Code Quality 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 신규 저장소 생성을 선택할 경우, 품질 프로젝트명/품질 프로젝트 Key를 입력해야 합니다. 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL	SonarQube URL을 선택하세요.
   품질 프로젝트명	SonarQube의 프로젝트의 이름을 입력하세요.
   품질 프로젝트 Key	SonarQube의 프로젝트의 Key를 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.

   표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

사용자는 이미지 저장소 설정단계를 통해 빌드된 컨테이너 이미지를 저장할 저장소를 설정할 수 있습니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 이미지 저장소 항목에서 저장소 유형을 선택하세요.
2. 신규 저장소 생성/기존 저장소 사용 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소 유형을 선택 사용자가 사용가능한 Image Registry 툴의 유형들이 나타납니다.
   저장소 정보	저장소 생성 방식을 선택하세요. 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
   인증 정보	인증정보를 입력하세요.

   표. 프로젝트 생성 이미지 저장소 설정 항목

배포대상 환경 설정하기

사용자는 헬름차트를 통해 직접 구성을 통해 배포를 할 수 있습니다.

헬름릴리스명과 헬름차트 선택 시 헬름차트 설치 항목과 차트에 포함된 기본 Values.yaml 항목이 나타납니다.

사용가능한 헬름차트는 App. 템플릿과 연계되어 있습니다. 지원 헬름차트 관리하기를 통해 수정/삭제 할 수 있습니다.

배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 항목에서 헬름차트를 통해 직접 구성을 선택하세요.
2. 헬름릴리스명을 입력하세요.
3. 검색 버튼을 클릭하여 사용할 헬름차트 를 선택하세요.
4. Values.yaml을 수정 후 Validation Check 버튼을 클릭하세요.
5. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   배포 대상	배포 대상을 선택하세요.
   헬름릴리스명	생성할 헬름릴리스의 이름을 입력하세요. 해당 이름은 배포될 클러스터의 네임스페이스 내에서 유일해야 합니다.
   헬름차트	헬름차트를 선택하세요. 헬름차트 선택 시 하위에 선택한 차트에 대한 세부 내용이 표시
   K8S 정보	Value.yaml 구성에 필요한 Kubernetes 클러스터의 정보를 보여줍니다.
   Values. yaml	Values.yaml 내용을 수정하세요. 헬름차트 설치 시 사용할 values.yaml 파일 입니다.

   표. 프로젝트 생성 배포 대상 환경 설정 항목

빌드 파이프라인 설정하기

사용자는 애플리케이션을 빌드하고 배포하는 파이프라인을 구성할 수 있습니다.

구성할 파이프라인의 각 단계를 확인할 수 있으며 빌드 Job 이름을 변경할 수 있습니다.

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

1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
   • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
   • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   빌드/배포 파이프라인	빌드/배포 파이프라인 정보를 보여줍니다. 빌드/배포 파이프라인은 App. 템플릿의 파이프라인 템플릿 관리하기에 등록된 정보를 바탕으로 표시
   구분	개발/운영 구분을 선택하세요. 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)를 참고하세요.
   URL	파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요. 사용자가 사용가능한 Jenkins 가 나타납니다.
   빌드 에이전트	파이프라인 빌드에 사용될 에이전트를 선택하세요. 에이전트에 대한 정보는 에이전트(kubernetes) 관리하기, 에이전트(VM) 관리하기를 참고하세요.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   사용자 정보	IDP 연동 Jenkins 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요. Jenkins 사용자로 등록되지 않은 경우, 사용자 등록 안내 팝업창이 열리면 Jenkins로 이동하기 링크를 클릭하여 사용자 가입 또는 Jenkins 최초 로그인을 진행하세요. IDP 미연동 Jenkins 인증정보를 입력하고 Connection Test 버튼을 클릭하세요.
   환경 변수 설정	Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
   Image Tag Pattern	컨테이너 이미지의 tag 부여방식을 선택하세요.
   Deploy Strategy	컨테이너 이미지의 배포방식을 선택하세요.
   배포 결과 수신자	빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.

   표. 프로젝트 생성 빌드 파이프라인 설정 항목

사용자 정의 설정하기

사용자는 빌드에 사용될 Dockerfile 파일의 경로를 지정하고 수정할 수 있습니다.

또한 빌드 파이프라인 설정하기에서 설정한 정보를 바탕으로 생성된 최종 스크립트를 확인할 수 있고 수정도 할 수 있습니다.

Dockerfile, 파이프라인 스크립트를 설정하려면 다음 절차를 따르세요.

1. 사용자 정의 설정 페이지에서 정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.

   항목	설명
   Dockerfile 설정	신규 Dockerfile 생성 또는 기존 Dockerfile 사용 여부를 선택하세요. 기존 Dockerfile 사용은 Environment Only App. 템플릿을 선택 후 코드 저장소 설정하기에서 기존 저장소 사용으로 선택한 경우만 선택할 수 있습니다.
   Dockerfile 경로	소스코드 상의 Dockerfile 파일 경로를 지정하세요.
   Branch 명	Branch 명은 코드 저장소 설정하기에서 설정 시 등록한 Branch 명이 자동으로 등록됩니다.
   Dockerfile	Dockerfile의 파일 내용을 확인 및 수정하세요.
   파이프라인 스크립트	파이프라인 스크립트를 확인 및 수정하세요.

   표. 프로젝트 생성 사용자 정의 설정 항목

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

2.3.2.2 - (워크로드 배포) 프로젝트 생성하기

사용자는 App.템플릿, 툴 관리 와 워크로드를 이용하여, 특정 Kubernetes 클러스터에 배포하는 프로젝트를 만들 수 있습니다.

프로젝트 생성 시작하기

프로젝트를 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지로 이동합니다.

기본 정보 입력하기

프로젝트의 기본 정보를 입력합니다. 프로젝트명, 프로젝트 ID는 중복될 수 없고 유일해야 합니다.

기본정보를 입력하려면 다음 절차를 따르세요.

1. 프로젝트 생성 페이지에서 프로젝트 구성 방법 항목의 App. 템플릿 활용을 선택하세요.
2. 배포 타겟 항목은 Kubernetes를 선택하세요.
3. 추가 내용 입력 후 시작 버튼을 클릭하세요.

   항목	설명
   프로젝트명	프로젝트명을 입력하세요.
   프로젝트 ID	프로젝트 ID를 입력하세요.
   프로젝트 구성 방법	프로젝트 구성 방법을 선택 App. 템플릿 활용: 미리 제공되는 App. 템플릿을 선택합니다. 직접 구성: App. 템플릿 없이 직접 구성합니다.
   배포 타겟	배포 타겟을 선택 Kubernetes: 애플리케이션을 Kubernetes 클러스터에 배포합니다. Kubernetes(ArgoCD): ArgoCD를 사용하여 애플리케이션을 Kubernetes 클러스터에 배포합니다. VM(Artifact): 애플리케이션을 VM서버에 배포합니다. VM(Docker): 애플리케이션을 Docker 이미지로 만들어 VM서버에 배포합니다. N/A: 빌드 결과를 배포하지 않는 경우 선택합니다.
   K8S 클러스터	배포할 대상 클러스터를 선택 DevOps Console K8S 클러스터의 클러스터 중 사용자가 접근권한을 가진 클러스터만 선택할 수 있습니다.
   네임스페이스	배포할 대상 네임스페이스를 선택 K8S 클러스터에서 조회된 클러스터 중 사용자가 접근 권한을 가진 네임스페이스만 선택할 수 있습니다.

   표. 프로젝트 생성 기본 정보 입력 항목

애플리케이션 템플릿 선택하기

사용자는 프로젝트를 구성할 애플리케이션 템플릿을 선택할 수 있습니다.

샘플 소스코드가 포함된 애플리케이션 템플릿을 기반으로 프로젝트를 생성하면, 배포될 애플리케이션을 확인할 수 있습니다.

반면 Environment Only로 표기된 템플릿을 이용하면 샘플 소스코드 없이 빌드/배포 환경만 구성합니다.

이미 구성된 소스코드 저장소를 사용하여 프로젝트를 구성할 경우 Environment Only로 표시된 템플릿을 선택하세요.

애플리케이션 템플릿 선택하기를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   필터	미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
   검색	검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.

   표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

사용자는 코드저장소 설정 단계를 통해 소스코드를 관리할 저장소를 설정할 수 있습니다.

신규 저장소 생성과 기존 저장소 사용 활성화 조건은 애플리케이션 템플릿과 툴에 따라서 다르게 나타납니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 코드 저장소 항목에서 코드 저장소 유형을 선택하세요.
2. 신규 저장소 생성 또는 기존 저장소 사용을 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

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

   표. 프로젝트 생성 코드 저장소 설정 항목

코드 품질 설정하기

사용자는 품질 관리를 위한 저장소를 구성할 수 있습니다.

코드 품질을 설정하려면 다음 절차를 따르세요.

1. 코드 품질 항목에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 사용자가 사용 가능한 Code Quality 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 신규 저장소 생성을 선택할 경우, 품질 프로젝트명/품질 프로젝트 Key를 입력해야 합니다. 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL	SonarQube URL을 선택하세요.
   품질 프로젝트명	SonarQube의 프로젝트의 이름을 입력하세요.
   품질 프로젝트 Key	SonarQube의 프로젝트의 Key를 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.

   표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

사용자는 이미지 저장소 설정단계를 통해 빌드된 컨테이너 이미지를 저장할 저장소를 설정할 수 있습니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 이미지 저장소 항목에서 저장소 유형을 선택하세요.
2. 신규 저장소 생성/기존 저장소 사용 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소 유형을 선택 사용자가 사용가능한 Image Registry 툴의 유형들이 나타납니다.
   저장소 정보	저장소 생성 방식을 선택하세요. 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
   인증 정보	인증정보를 입력하세요.

   표. 프로젝트 생성 이미지 저장소 설정 항목

배포대상 환경 설정하기

사용자는 배포대상 워크로드 선택을 통해 배포를 할 수 있습니다.

배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 항목에서 배포대상 워크로드 선택을 선택하세요. 배포대상 워크로드 영역이 나타납니다.
2. 배포대상 워크로드 영역에서 배포할 대상 워크로드와 대상 컨테이너를 선택하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   배포 대상	배포 대상을 선택 헬름차트를 통해 직접 구성 배포 대상 워크로드 선택
   조회 대상	조회 대상을 선택하세요.
   워크로드	워크로드를 선택 프로젝트 생성 시작 시 선택한 Kubernetes 클러스터에 존재하는 워크로드를 표시합니다.
   대상 컨테이너	선택된 워크로드에서 사용할 대상 컨테이너를 선택하세요.

   표. 배포 대상 환경 설정 항목

빌드 파이프라인 설정하기

사용자는 애플리케이션을 빌드하고 배포하는 파이프라인을 구성할 수 있습니다.

구성할 파이프라인의 각 단계를 확인할 수 있으며 빌드 Job 이름을 변경할 수 있습니다.

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

1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
   • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
   • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   빌드/배포 파이프라인	빌드/배포 파이프라인 정보를 보여줍니다. 빌드/배포 파이프라인은 App. 템플릿의 파이프라인 템플릿 관리하기에 등록된 정보를 바탕으로 표시
   구분	개발/운영 구분을 선택하세요. 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)를 참고하세요.
   URL	파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요. 사용자가 사용가능한 Jenkins 가 나타납니다.
   빌드 에이전트	파이프라인 빌드에 사용될 에이전트를 선택하세요. 에이전트에 대한 정보는 에이전트(kubernetes) 관리하기, 에이전트(VM) 관리하기를 참고하세요.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   사용자 정보	IDP 연동 Jenkins 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요. Jenkins 사용자로 등록되지 않은 경우, 사용자 등록 안내 팝업창이 열리면 Jenkins로 이동하기 링크를 클릭하여 사용자 가입 또는 Jenkins 최초 로그인을 진행하세요. IDP 미연동 Jenkins 인증정보를 입력하고 Connection Test 버튼을 클릭하세요.
   환경 변수 설정	Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
   Image Tag Pattern	컨테이너 이미지의 tag 부여방식을 선택하세요.
   Deploy Strategy	컨테이너 이미지의 배포방식을 선택하세요.
   배포 결과 수신자	빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.

   표. 프로젝트 생성 빌드 파이프라인 설정 항목

사용자 정의 설정하기

사용자는 빌드에 사용될 Dockerfile 파일의 경로를 지정하고 수정할 수 있습니다.

또한 빌드 파이프라인 설정하기에서 설정한 정보를 바탕으로 생성된 최종 스크립트를 확인할 수 있고 수정도 할 수 있습니다.

Dockerfile, 파이프라인 스크립트를 설정하려면 다음 절차를 따르세요.

1. 사용자 정의 설정 페이지에서 정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.

   항목	설명
   Dockerfile 설정	신규 Dockerfile 생성 또는 기존 Dockerfile 사용 여부를 선택하세요. 기존 Dockerfile 사용은 Environment Only App. 템플릿을 선택 후 코드 저장소 설정하기에서 기존 저장소 사용으로 선택한 경우만 선택할 수 있습니다.
   Dockerfile 경로	소스코드 상의 Dockerfile 파일 경로를 지정하세요.
   Branch 명	Branch 명은 코드 저장소 설정하기에서 설정 시 등록한 Branch 명이 자동으로 등록됩니다.
   Dockerfile	Dockerfile의 파일 내용을 확인 및 수정하세요.
   파이프라인 스크립트	파이프라인 스크립트를 확인 및 수정하세요.

   표. 프로젝트 생성 사용자 정의 설정 항목

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

2.3.2.3 - (ArgoCD 배포) 프로젝트 생성하기

사용자는 App.템플릿, 툴 관리, ArgoCD 를 이용하여 배포하는 프로젝트를 만들 수 있습니다.

프로젝트 생성 시작하기

프로젝트를 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지로 이동합니다.

기본 정보 입력하기

프로젝트의 기본 정보를 입력합니다. 프로젝트명, 프로젝트 ID는 중복될 수 없고 유일해야 합니다.

기본정보를 입력하려면 다음 절차를 따르세요.

1. 프로젝트명 및 프로젝트 ID를 입력하세요.
2. 프로젝트 구성 방법 항목은 App. 템플릿 활용을 선택하세요.
3. 배포 타겟은 Kubernetes(ArgoCD)를 선택하세요.
4. ArgoCD App 생성 방식을 선택하세요.
   • 신규 App 생성: 프로젝트를 생성하면서 ArgoCD에 신규 ArgoCD 애플리케이션을 생성합니다.
   • 기존 App 사용: 기존 ArgoCD 애플리케이션을 이용해서 프로젝트를 생성합니다.
5. 각 입력 완료 후, 시작 버튼을 클릭하세요.

App. 템플릿 선택하기

사용자는 프로젝트를 구성할 애플리케이션 템플릿을 선택할 수 있습니다.

샘플 소스코드가 포함된 애플리케이션 템플릿을 기반으로 프로젝트를 생성하면, 배포될 애플리케이션을 확인할 수 있습니다.

반면 Environment Only로 표기된 템플릿을 이용하면 샘플 소스코드 없이 빌드/배포 환경만 구성합니다.

이미 구성된 소스코드 저장소를 사용하여 프로젝트를 구성할 경우 Environment Only로 표시된 템플릿을 선택하세요.

애플리케이션 템플릿 선택하기를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   필터	미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
   검색	검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.

   표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

사용자는 코드저장소 설정 단계를 통해 소스코드를 관리할 저장소를 설정할 수 있습니다.

신규 저장소 생성과 기존 저장소 사용 활성화 조건은 애플리케이션 템플릿과 툴에 따라서 다르게 나타납니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 코드 저장소 항목에서 코드 저장소 유형을 선택하세요.
2. 신규 저장소 생성 또는 기존 저장소 사용을 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

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

   표. 프로젝트 생성 코드 저장소 설정 항목

코드 품질 설정하기

사용자는 품질 관리를 위한 저장소를 구성할 수 있습니다.

코드 품질을 설정하려면 다음 절차를 따르세요.

1. 코드 품질 항목에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 사용자가 사용 가능한 Code Quality 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 신규 저장소 생성을 선택할 경우, 품질 프로젝트명/품질 프로젝트 Key를 입력해야 합니다. 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL	SonarQube URL을 선택하세요.
   품질 프로젝트명	SonarQube의 프로젝트의 이름을 입력하세요.
   품질 프로젝트 Key	SonarQube의 프로젝트의 Key를 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.

   표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

사용자는 이미지 저장소 설정단계를 통해 빌드된 컨테이너 이미지를 저장할 저장소를 설정할 수 있습니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 이미지 저장소 항목에서 저장소 유형을 선택하세요.
2. 신규 저장소 생성/기존 저장소 사용 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소 유형을 선택 사용자가 사용가능한 Image Registry 툴의 유형들이 나타납니다.
   저장소 정보	저장소 생성 방식을 선택하세요. 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
   인증 정보	인증정보를 입력하세요.

   표. 프로젝트 생성 이미지 저장소 설정 항목

배포대상 환경 설정하기

신규 App 생성

신규 ArgoCD 애플리케이션을 생성하여 배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 환경 화면에서 ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
2. 인증정보의 입력 화면이 나타납니다.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 신규로 생성할 ArgoCD 애플리케이션의 입력 화면이 나타납니다.
5. ArgoCD 애플리케이션 이름과 ArgoCD 프로젝트 이름을 입력하세요.
6. 저장소 타입을 선택하세요.
7. 헬름차트를 선택하세요.
8. 헬름차트와 헬름차트 Git 저장소의 정보가 표시됩니다.
9. Values.yaml을 수정 후 Validation Check 버튼을 클릭하세요.
10. Git 저장소 정보와 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
11. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

    항목	설명
    URL 입력 방식	URL 입력 방식을 선택하세요. 목록에서 선택: 툴로 등록된 ArgoCD 툴이 나타납니다. 직접 입력
    ArgoCD URL	ArgoCD URL 입력 후 확인 버튼을 클릭하세요. 인증정보 영역이 나타납니다.
    인증정보	인증정보를 입력 후 Connection Test 버튼을 클릭하세요. 애플리케이션 기본정보 영역이 열립니다.
    애플리케이션 이름	ArgoCD 에 생성할 ArgoCD 애플리케이션 이름을 입력하세요.
    프로젝트 이름	ArgoCD 애플리케이션의 프로젝트 이름을 입력하세요.
    저장소 타입	저장소 타입을 선택하세요. 헬름차트로 신규 저장소 생성: 헬름차트를 사용하여 GitOps에 사용될 Git 저장소를 생성합니다. 헬름차트 정보 영역이 열립니다. 기존 Git 저장소 사용
    헬름차트	헬름차트를 선택하세요.
    헬름차트 Git 저장소	GitOps에 사용될 Git 저장소의 정보를 입력하세요.

    표. 신규 App 생성 설정 항목

기존 App 사용

기존 ArgoCD 애플리케이션을 사용하여 배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 환경 화면에서 ArgoCD URL 입력 후 확인 버튼을 클릭하세요.
2. 기존 ArgoCD 애플리케이션 이름과 인증정보 입력 화면이 나타납니다.
3. 기존 애플리케이션 이름과 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. ArgoCD 애플리케이션에 연동된 Git 저장소를 구분하기위한 URL Check 팝업창이 열립니다..
5. URL Check 팝업창에서 Base URL 수정 후 확인 버튼을 클릭하세요.
6. ArgoCD 애플리케이션에 연동된 Git 저장소 정보가 표시됩니다.
7. Git 저장소의 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
8. Manifest Root 경로 영역에서 변경할 yaml 파일명과 키 값을 입력하세요.
9. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   URL 입력 방식	URL 입력 방식을 선택 목록에서 선택: 툴로 등록된 ArgoCD 툴이 나타납니다. 직접 입력
   ArgoCD URL	ArgoCD URL 입력 후 확인 버튼을 클릭하세요. 기존 애플리케이션 이름과 인증정보 영역이 나타납니다.
   애플리케이션 이름 / 인증정보	기존 애플리케이션 이름과 인증정보를 입력 후 Connection Test 버튼을 클릭하세요. Git 저장소와 ArgoCD 정보 영역이 나타납니다.
   URL Check	전체 URL에서 Base URL과 Path를 구분합니다.
   Git 저장소 인증정보	선택한 기존 애플리케이션이 사용중인 Git 저장소의 인증정보를 입력하세요.
   Image Repo Key	이미지 저장소 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요. 만약 repository와 tag의 키값이 같다면 같은 값을 입력하세요.
   Image Tag Key	이미지 태그 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요. 만약 repository와 tag의 키값이 같다면 같은 값을 입력하세요.
   Image Secret Key	이미지 시크릿 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요.
   Deploy Strategy Key	배포 전략 정보가 기록된 Yaml 파일 경로와 Key 값을 입력하세요 (필수값이 아닙니다).

   표. 기존 App 사용 설정 항목

빌드 파이프라인 설정하기

사용자는 애플리케이션을 빌드하고 배포하는 파이프라인을 구성할 수 있습니다.

구성할 파이프라인의 각 단계를 확인할 수 있으며 빌드 Job 이름을 변경할 수 있습니다.

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

1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
   • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
   • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   빌드/배포 파이프라인	빌드/배포 파이프라인 정보를 보여줍니다. 빌드/배포 파이프라인은 App. 템플릿의 파이프라인 템플릿 관리하기에 등록된 정보를 바탕으로 표시
   구분	개발/운영 구분을 선택하세요. 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)를 참고하세요.
   URL	파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요. 사용자가 사용가능한 Jenkins 가 나타납니다.
   빌드 에이전트	파이프라인 빌드에 사용될 에이전트를 선택하세요. 에이전트에 대한 정보는 에이전트(kubernetes) 관리하기, 에이전트(VM) 관리하기를 참고하세요.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   사용자 정보	IDP 연동 Jenkins 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요. Jenkins 사용자로 등록되지 않은 경우, 사용자 등록 안내 팝업창이 열리면 Jenkins로 이동하기 링크를 클릭하여 사용자 가입 또는 Jenkins 최초 로그인을 진행하세요. IDP 미연동 Jenkins 인증정보를 입력하고 Connection Test 버튼을 클릭하세요.
   환경 변수 설정	Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
   Image Tag Pattern	컨테이너 이미지의 tag 부여방식을 선택하세요.
   Deploy Strategy	컨테이너 이미지의 배포방식을 선택하세요.
   배포 결과 수신자	빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.

   표. 프로젝트 생성 빌드 파이프라인 설정 항목

사용자 정의 설정하기

사용자는 빌드에 사용될 Dockerfile 파일의 경로를 지정하고 수정할 수 있습니다.

또한 빌드 파이프라인 설정하기에서 설정한 정보를 바탕으로 생성된 최종 스크립트를 확인할 수 있고 수정도 할 수 있습니다.

Dockerfile, 파이프라인 스크립트를 설정하려면 다음 절차를 따르세요.

1. 사용자 정의 설정 페이지에서 정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.

   항목	설명
   Dockerfile 설정	신규 Dockerfile 생성 또는 기존 Dockerfile 사용 여부를 선택하세요. 기존 Dockerfile 사용은 Environment Only App. 템플릿을 선택 후 코드 저장소 설정하기에서 기존 저장소 사용으로 선택한 경우만 선택할 수 있습니다.
   Dockerfile 경로	소스코드 상의 Dockerfile 파일 경로를 지정하세요.
   Branch 명	Branch 명은 코드 저장소 설정하기에서 설정 시 등록한 Branch 명이 자동으로 등록됩니다.
   Dockerfile	Dockerfile의 파일 내용을 확인 및 수정하세요.
   파이프라인 스크립트	파이프라인 스크립트를 확인 및 수정하세요.

   표. 프로젝트 생성 사용자 정의 설정 항목

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

2.3.2.4 - (VM 배포) 프로젝트 생성하기

사용자는 App.템플릿, 툴 관리를 이용하여, 특정 VM 서버에 배포하는 프로젝트를 만들 수 있습니다.

VM 배포 목적의 프로젝트를 생성하기 전 배포대상 VM 서버에 대한 정보를 등록하세요. VM 서버 등록에 대한 자세한 사항은 VM서버 그룹 시작하기를 참고하세요.

프로젝트 생성 시작하기

프로젝트 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지로 이동합니다.

기본 정보 입력하기

1. 프로젝트 생성 페이지에서 프로젝트명 및 프로젝트 ID를 입력하세요.
2. 프로젝트 구성 방법 항목은 App. 템플릿 활용을 선택하세요.
3. 배포 타겟 항목은 VM(Artifact) 혹은 VM(Docker) 를 선택하세요.
   • VM(Artifact) 는 war/jar 파일을 생성 후 배포대상 서버로 전송합니다.
   • VM(Docker) 는 빌드 및 이미지 빌드 후 docker 명령어를 실행합니다.
4. 배포 방식 을 선택하세요.
   • 배포 방식에 따른 차이: 표. SSH 방식 vs 에이전트 방식
5. 각 입력 완료 후 시작 버튼을 클릭하세요.

App. 템플릿 선택하기

사용자는 프로젝트를 구성할 애플리케이션 템플릿을 선택할 수 있습니다.

샘플 소스코드가 포함된 애플리케이션 템플릿을 기반으로 프로젝트를 생성하면, 배포될 애플리케이션을 확인할 수 있습니다.

반면 Environment Only로 표기된 템플릿을 이용하면 샘플 소스코드 없이 빌드/배포 환경만 구성합니다.

이미 구성된 소스코드 저장소를 사용하여 프로젝트를 구성할 경우 Environment Only로 표시된 템플릿을 선택하세요.

애플리케이션 템플릿 선택하기를 시작하려면 다음 절차를 따르세요.

1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   필터	미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
   검색	검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.

   표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

사용자는 코드저장소 설정 단계를 통해 소스코드를 관리할 저장소를 설정할 수 있습니다.

신규 저장소 생성과 기존 저장소 사용 활성화 조건은 애플리케이션 템플릿과 툴에 따라서 다르게 나타납니다.

저장된 인증정보를 수정/삭제하려면 인증정보 관리하기를 참고하세요.

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

1. 코드 저장소 항목에서 코드 저장소 유형을 선택하세요.
2. 신규 저장소 생성 또는 기존 저장소 사용을 선택 후 정보를 입력하세요.
3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

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

   표. 프로젝트 생성 코드 저장소 설정 항목

코드 품질 설정하기

사용자는 품질 관리를 위한 저장소를 구성할 수 있습니다.

코드 품질을 설정하려면 다음 절차를 따르세요.

1. 코드 품질 항목에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소를 선택 사용자가 사용 가능한 Code Quality 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 신규 저장소 생성을 선택할 경우, 품질 프로젝트명/품질 프로젝트 Key를 입력해야 합니다. 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL	SonarQube URL을 선택하세요.
   품질 프로젝트명	SonarQube의 프로젝트의 이름을 입력하세요.
   품질 프로젝트 Key	SonarQube의 프로젝트의 Key를 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.

   표. 프로젝트 생성 코드 품질 설정 항목

아티팩트 저장소 설정하기

사용자는 아티팩트를 위한 저장소를 구성할 수 있습니다.

미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.

아티팩트 저장소를 설정하려면 다음 절차를 따르세요.

1. 아티팩트 저장소 화면에서 저장소 유형을 선택하세요.
2. 기본정보와 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
3. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.

   항목	설명
   저장소 유형	사용할 저장소 유형을 선택 사용자가 사용가능한 Artifact Repository 툴의 유형들이 나타납니다.
   신규/기존/미사용 여부	저장소 생성 방식을 선택 미생성을 선택할 경우 바로 다음 단계로 진행할 수 있습니다.
   Base URL / Endpoint URL	Nexus URL 또는 Object Storage URL 을 선택하세요.
   저장소 타입 / 버킷명	Nexus인 경우, raw(hosted) 로 자동 등록됩니다. Object Storage인 경우, 툴 등록 시 입력한 버킷명이 자동 등록됩니다.
   저장소명 / 폴더명	Nexus에서 사용할 저장소명을 입력하세요. Object Storage에서 사용할 폴더명을 입력하세요.
   인증정보	인증정보를 입력 새로운 사용자 생성하거나 기존 인증정보를 사용할수도 있습니다.

   표. 아티팩트 저장소 설정 입력 항목

배포대상 환경 설정하기

배포대상 환경을 설정하려면 다음 절차를 따르세요.

1. 배포 대상 환경 화면에서 필수정보 입력 후 다음 버튼을 클릭하세요.

   항목	설명
   배포 구성	직접 배포스크립트를 작성할지 선택 직접 배포 스크립트 작성 선택 시 사용자 정의 단계에서 내용을 작성합니다.
   배포 방식	선택한 배포 방식이 나타납니다. 표. SSH 방식 vs 에이전트 방식
   아티팩트 저장소	에이전트 방식일때 사용할 저장소의 주소가 나타납니다. 배포 방식이 Agent인 경우 활성화 됩니다.
   수동 배포	수동 배포 기본값을 선택 파이프라인 실행 시 수동 배포 관련 매개변수의 기본 설정값을 선택하세요.
   배포 순서	배포대상 서버가 복수개인 경우 병렬로 배포할지 순차적으로 배포할지 선택하세요.
   배포대상 설정	배포대상 서버를 설정하세요. 설정 클릭 시 배포 대상 VM설정 팝업창이 열립니다.
   자동복원 설정	자동복원 설정 여부를 선택 배포가 실패하면 직전 성공한 배포로 복원됩니다. 배포 방식이 Agent인 경우 활성화 됩니다.
   파일 배포 전 명령어	파일 배포 전에 수행해야 하는 명령어를 작성합니다.
   전송할 파일	Source: 빌드 파이프라인이 실행되는 경로(Jenkins workspace) 이후의 파일 경로를 입력하세요. Target: VM서버에서 파일이 배포될 경로를 입력하세요. 추가 버튼을 이용하여 파일을 추가할 수 있습니다.
   파일 배포 후 명령어	파일 배포 후에 수행해야 하는 명령어를 작성합니다.

   표. 배포대상 환경 설정 항목

빌드 파이프라인 설정하기

사용자는 애플리케이션을 빌드하고 배포하는 파이프라인을 구성할 수 있습니다.

구성할 파이프라인의 각 단계를 확인할 수 있으며 빌드 Job 이름을 변경할 수 있습니다.

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

1. 빌드 파이프라인 설정 단계에서 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.

   항목	설명
   빌드/배포 파이프라인	빌드/배포 파이프라인 정보를 보여줍니다. 빌드/배포 파이프라인은 App. 템플릿의 파이프라인 템플릿 관리하기에 등록된 정보를 바탕으로 표시
   구분	개발/운영 구분을 선택 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다. 역할자별 권한은 표. 프로젝트 내 각 역할자별 권한(1)를 참고하세요.
   URL	파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력 사용자가 사용 가능한 Jenkins 가 나타납니다.
   빌드 에이전트	파이프라인 빌드에 사용될 에이전트를 선택 에이전트에 대한 정보는 에이전트(kubernetes) 관리하기, 에이전트(VM) 관리하기를 참고하세요.
   빌드 환경 OS	빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
   인증 정보	Jenkins의 인증정보를 입력하세요.
   환경 변수 설정	Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
   배포 결과 수신자	빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.

   표. 빌드 파이프라인 설정 입력 항목

사용자 정의 설정하기

배포대상 서버 및 배포 설정 단계에서 배포 구성 항목을 직접 배포 스크립트 작성을 선택한 경우 이 단계에서 파이프라인 내용을 수정하여 배포설정을 완료하세요.

사용자 정의 설정을 하려면 다음 절차를 따르세요.

1. 사용자 정의 단계에서 내용 확인 및 수정 후 다음 버튼을 클릭하세요.

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

2.3.2.5 - (빈) 프로젝트 생성하기

사용자는 아무 설정도 하지 않은 상태의 빈(Empty) 프로젝트를 만들 수 있습니다.

빈 프로젝트를 생성 후 빌드/배포를 구성하기 위해서 사용자는 직접 코드 저장소 추가하기, 이미지 저장소 추가하기, 헬름인스톨 하기, 빌드 파이프라인 추가하기 등의 작업을 진행해야 합니다.

프로젝트 생성 시작하기

빈 프로젝트 생성을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 생성 버튼을 클릭하세요. 프로젝트 생성 페이지로 이동합니다.

기본 정보 입력하기

프로젝트의 기본 정보를 입력합니다. 프로젝트명, 프로젝트 ID는 중복될 수 없고 유일해야 합니다.

기본정보를 입력하려면 다음 절차를 따르세요.

1. 프로젝트 생성 페이지에서 프로젝트 구성 방법 항목 중 직접 구성을 선택하세요.
2. 프로젝트명, 프로젝트 ID 입력 후 시작 버튼을 클릭하세요. 요약정보 화면이 나타납니다.

프로젝트 생성 완료하기

사용자는 최종적으로 생성할 프로젝트 및 툴 정보를 확인하고 프로젝트 생성을 시작할 수 있습니다.

프로젝트 생성을 완료하려면 다음 절차를 따르세요.

1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.

2.3.3 - 프로젝트 시작하기

사용자는 프로젝트 생성하기를 통해 프로젝트를 생성할 수 있습니다.

프로젝트 페이지에서 사용자는 프로젝트 관리를 위한 다양한 메뉴를 활용할 수 있습니다.

프로젝트 시작하기

프로젝트를 시작하려면 다음 절차를 따르세요.

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

프로젝트 메뉴

대시보드

대시보드 (프로젝트 대시보드)

프로젝트를 구성하는 개별적인 항목들의 정보를 한눈에 파악할 수 있는 대시보드 메뉴입니다.

빌드/배포

빌드 파이프라인(빌드/배포 - 빌드 파이프라인)

Jenkins 파이프라인을 확인하고 빌드/배포 작업을 수행 및 수정할 수 있는 메뉴입니다.

Kubernetes 배포 (빌드/배포 - Kubernetes 배포)

배포된 헬름릴리스 리스트와 배포 상태를 확인할 수 있는 메뉴입니다.

VM 배포 (빌드/배포 - VM 배포)

배포된 VM 리스트와 배포 상태를 확인할 수 있는 메뉴입니다.

헬름인스톨 (헬름인스톨)

헬름차트를 조회 수행할 수 있는 메뉴입니다.

Ingress/Service 관리 (Ingress/Service 관리)

Ingress/Service를 조회 및 추가할 수 있는 메뉴입니다.

Kubernetes Secret 관리 (Kubernetes Secret 관리)

Kubernetes Secret을 조회 및 추가할 수 있는 메뉴입니다.

환경변수 관리 (환경변수 관리)

환경변수를 조회 및 추가할 수 있는 메뉴입니다.

저장소

코드 저장소 (저장소)

프로젝트의 코드 저장소를 조회 및 추가할 수 있는 메뉴입니다.

아티팩트 저장소 (아티팩트 저장소)

프로젝트의 이미지 저장소를 조회 및 추가할 수 있는 메뉴입니다.

이미지 저장소 (이미지 저장소)

프로젝트의 이미지 저장소를 조회 및 추가할 수 있는 메뉴입니다.

차트 저장소 (차트 저장소)

프로젝트의 차트 저장소를 조회 및 추가할 수 있는 메뉴입니다.

헬름차트 (헬름차트)

프로젝트 헬름차트를 조회 및 추가할 수 있는 메뉴입니다.

품질

코드 품질 (코드품질)

프로젝트의 코드 품질 프로젝트를 조회 및 추가할 수 있는 메뉴입니다.

프로젝트 개요

프로젝트 개요 (프로젝트 개요)

프로젝트의 상세정보뿐만 아니라 관련된 헬름릴리스 정보, 사용하고 있는 툴들의 정보 등을 확인할 수 있는 메뉴입니다.

멤버

멤버 (프로젝트 멤버)

프로젝트 사용자를 관리할 수 있는 메뉴입니다.

2.3.4 - 프로젝트 대시보드

프로젝트를 구성하는 개별적인 항목들의 정보를 대시보드에서 한눈에 파악할 수 있습니다.

프로젝트 대시보드 시작하기

대시보드 사용을 시작하려면 다음 절차를 따르세요.

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

   항목	설명
   프로젝트 정보	프로젝트 기본 정보를 표시합니다.
   파이프라인	빌드 파이프라인에 추가된 파이프라인의 상태를 표시합니다. 숫자 링크를 클릭하여 다른 파이프라인의 상태를 확인 할 수 있습니다.
   헬름릴리스 상태	Kubernetes 배포에 추가된 헬름릴리스의 상태를 확인 할 수 있습니다.
   블루/그린 배포 상태	블루/그린 배포 상태를 확인 할 수 있습니다.
   카나리 상태	카나리 상태를 확인 할 수 있습니다.
   ArgoCD 애플리케이션 상태	Kubernetes 배포에 추가된 ArgoCD 애플리케이션의 상태를 확인 할 수 있습니다.
   Kubernetes 배포 이력	Kubernetes 배포 이력을 최신순으로 표시합니다.
   VM 배포 이력	VM 배포 이력을 최신순으로 표시합니다.
   코드 품질	코드품질 툴과 연계하여 코드품질 툴 분석정보를 표시합니다.
   코드 이력	코드 저장소에 추가된 코드 저장소의 이력을 표시합니다. 다음 항목에 대해 목록에서 선택, 코드 이력에 표시 할 수 있습니다. Git 형상 Git Branch
   규모 및 사용현황	해당 프로젝트의 사용자와 툴, 빌드/배포 현황을 표시합니다.
   월별 파이프라인 실행 추이	해당 프로젝트 내의 월별 파이프라인 실행 횟수, 평균 실행주기 및 실행 시간을 표시합니다.
   비활성 파이프라인	기준일에 따라 미실행 및 성공 이력이 없는 파이프라인 목록을 표시합니다.
   필수 스테이지	코드저장소 기준으로 파이프라인에서 어떤 스테이지 작업이 수행 되었는지를 표시합니다.
   최근 이벤트 내역	프로젝트에서 발생한 최근 이벤트 내역을 확인 할 수 있습니다.

   표. 프로젝트 대시보드 표시 항목

2.3.5 - 프로젝트 멤버

다른 사용자들에게 해당 프로젝트에 접근할 수 있는 권한을 주거나, 프로젝트에 접근 권한이 있는 사용자들의 권한을 변경하거나, 더 이상 프로젝트에 접근할 수 없도록 권한을 삭제하는 기능을 포함합니다.

프로젝트 멤버 시작하기

프로젝트 멤버 사용을 시작하려면 다음 절차를 따르세요.

1. 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
2. 왼쪽 메뉴에서 멤버 메뉴를 클릭하세요. 멤버 화면이 나타납니다.

프로젝트 멤버 추가하기

프로젝트에 멤버를 추가하려면 다음 절차를 따르세요.

1. 멤버 목록에서 추가 버튼을 클릭하세요. 멤버 추가 팝업창이 열립니다.
2. 멤버 추가 팝업창에서 설정 완료 후 확인 버튼을 클릭하여 프로젝트 멤버 추가를 완료하세요.

   항목	설명
   사용자 탭	이메일 검색 후 멤버로 추가 버튼을 클릭하여 추가하세요.
   프로젝트 탭	타 프로젝트의 멤버 전체를 현재 프로젝트의 멤버로 추가하려면 선택하세요.
   멤버 추가	프로젝트 멤버로 추가하려는 사용자를 클릭하여 추가하세요.
   권한 설정	멤버에게 부여 할 역할을 설정하세요. Owner Master Developer Viewer
   멤버 삭제	X 아이콘을 클릭하여 프로젝트 멤버에서 삭제하세요.

   표. 프로젝트 멤버 추가 화면 항목

프로젝트 멤버의 역할 변경하기

프로젝트 멤버의 역할을 변경하려면 다음 절차를 따르세요.

1. 멤버 목록에서 역할을 변경하려는 사용자를 확인하세요.
2. 사용자의 프로젝트 역할을 목록에서 선택하세요. 선택과 동시에 저장되며, 해당 사용자의 프로젝트 역할이 변경됩니다.

프로젝트 멤버 삭제하기

프로젝트에서 멤버를 삭제하려면 다음 절차를 따르세요.

1. 멤버 목록에서 삭제하려는 사용자의 체크박스를 선택하세요.
2. 멤버 목록 위의 삭제 버튼을 클릭하여 선택된 사용자를 프로젝트 멤버에서 삭제하세요.

2.4 - 빌드/배포

2.4.1 - 빌드 파이프라인

사용자는 연속된 작업들을 하나로 묶어 파이프라인으로 구성할 수 있습니다. 여기서 구성한 파이프라인은 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. 파이프라인 삭제 팝업창에서 확인 버튼을 클릭하여 파이프라인 삭제를 완료하세요.

2.4.1.1 - 스테이지

사용자는 스테이지 종류와 각 스테이지별 항목에 대한 설명을 확인할 수 있습니다.

빌드 파이프라인 추가하기 또는 빌드 파이프라인 수정하기에서 스테이지 설정을 할 수 있습니다.

공통 항목

스테이지 설정 페이지는 다음과 같이 구성되어 있습니다.

Checkout

코드 저장소에 등록된 Git 저장소에서 checkout 명령어를 수행하는 스테이지 입니다.

스테이지 종류로 Checkout을 선택합니다.

Build

애플리케이션을 빌드하는 명령어를 수행하는 스테이지 입니다.

스테이지 종류로 Build를 선택합니다.

Docker Build

Docker 이미지 빌드를 수행하는 스테이지 입니다.

스테이지 종류로 Docker Build를 선택합니다.

예시 스크립트

예시의 결과로 만들어진 빌드 파이프라인 스크립트는 다음과 같습니다.

Deploy to K8S

Kubernetes 배포를 수행하는 스테이지 입니다.

스테이지 종류로 Deploy to K8S를 선택합니다.

Deploy to VM

VM 배포를 수행하는 스테이지 입니다.

스테이지 종류로 Deploy to VM을 선택합니다.

Trigger Build

원격으로 파이프라인을 실행하는 스테이지 입니다.

스테이지 종류로 Trigger Build를 선택합니다.

원격 실행 정보 확인

Trigger Build 스테이지를 통한 원격 실행 정보(상위/하위 파이프라인)는 빌드 상세보기 화면에서 확인 가능합니다.

기타 스테이지