시작하기

• 1: DevOps Console 시작하기
• 1.1: 가입정보
• 2: Tutorial (프로젝트생성부터 빌드/배포까지)
• 2.1: (헬름차트 배포) 빌드/배포 추가하기
• 2.2: (워크로드 배포) 빌드/배포 추가하기
• 2.3: (VM 배포) 빌드/배포 추가하기
• 2.4: (프로젝트 생성 전) 배포 대상 네임스페이스 권한 확인 하기

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. 현재 비밀번호를 입력창에 입력 후, 회원탈퇴 버튼을 클릭하여 탈퇴를 완료하세요.

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 - 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.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 - (워크로드 배포) 빌드/배포 추가하기

사용자는 다음 절차를 통해, 이미 생성된 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.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.4 - (프로젝트 생성 전) 배포 대상 네임스페이스 권한 확인 하기

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

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

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

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