툴 관리

툴이란 DevOps Console 에서 CI/CD 기능을 지원하기 위해 DevOps Console과 상호작용하는 애플리케이션들을 의미합니다.

현재 DevOps Console 에서 지원하는 툴 목록은 툴 분류를 참고 하세요.

툴 관리 시작하기

툴 관리를 시작하려면 다음 절차를 따르세요.

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

툴 유형

각각의 툴은 툴 유형에 따라 사용하게 되는 영역이 달라집니다.

툴 유형	설명
System Tool	DevOps Console 전역에 걸쳐 사용 가능합니다. 시스템 관리자만 관리할 수 있습니다. 테넌트 관리자는 자신의 테넌트에서 사용가능하게 되어있을 때 해제만 가능합니다.
Tenant Tool	특정 테넌트에서 사용 가능합니다. 여러 개의 테넌트와 클러스터를 맵핑하여 사용할 수 있습니다. 툴 등록시 최초 등록한 테넌트의 테넌트 관리자만 관리할 수 있습니다. 추가로 등록한 테넌트는 사용만 할 수 있습니다.
ProjectGroup Tool	특정 프로젝트 그룹에서 사용 가능합니다. 여러 개의 프로젝트 그룹을 맵핑하여 사용합니다. 해당 프로젝트 그룹의 오너가 관리할 수 있습니다.

표. 툴 유형

툴 분류

현재 DevOps Console 에서 지원하는 툴 목록은 다음과 같습니다.

툴 분류	툴
CICD Pipeline	`Jenkins`
SCM Repository	`GitLab`, `GitHub`, Git-based SCM
Image Registry	`Harbor`, `Docker Hub`, `SCP Container Registry`, Docker Image Registry
Code Quality	`SonarQube`
Artifact Repository	`Nexus`, Object Storage (S3 compatible)
Helm Chart Repository	`Harbor`
Project Management Software	`JIRA`

표. 툴 분류

참고

릴리스 일정에 따라 지원 가능한 툴이 변경(추가/삭제)될 수 있습니다.
Samsung Cloud Platform의 Marketplace 서비스를 통해 CI/CD 툴 설치에 대한 기술 지원을 받을 수 있습니다. (에스코어에서 제공하며 지원 가능한 툴은 Marketplace 서비스에서 확인)

관리소속

테넌트/프로젝트그룹 유형으로 툴 추가시 선택한 테넌트 또는 프로젝트그룹을 나타냅니다.
다음 아이콘으로 관리 소속의 유형을 구분합니다.

관리 소속이 테넌트입니다.
관리 소속이 프로젝트그룹입니다.

툴 추가하기

툴을 추가하려면 다음 절차를 따르세요.

툴 페이지에서 추가 버튼을 클릭하세요. 툴 추가 팝업창이 열립니다.

툴 지원 타입 선택

툴 추가 팝업창에서 툴의 지원 타입을 선택하세요.
선택을 완료하고 다음 버튼을 클릭하세요. 기본정보 입력 화면이 나타납니다.
항목 설명
유형 툴의 지원타입을 선택
유형별 설명은 툴 유형을 참고하세요.
테넌트/프로젝트그룹 어떤 테넌트/프로젝트그룹에 맵핑할지 선택하세요.
표. 툴 추가 시 지원 타입 선택 항목

항목	설명
유형	툴의 지원타입을 선택 유형별 설명은 툴 유형을 참고하세요.
테넌트/프로젝트그룹	어떤 테넌트/프로젝트그룹에 맵핑할지 선택하세요.

기본 정보 입력

툴 추가 팝업창의 기본정보 입력 화면에서 툴 분류, 툴을 선택하세요. 선택한 툴에 따라 입력 화면이 달라집니다.
- 툴 분류별 설명은 툴 분류를 참고하세요.
필요한 정보를 입력 한 후 Connection Test 버튼을 클릭하세요.
다음 버튼을 클릭하세요.

SCM Repository

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
URL for API	`Github.com` API 경로를 입력하세요.
Org 생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 Github Organization 생성을 가능하게 할지 여부를 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택하세요.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. SCM Repository 입력 항목

CICD Pipeline

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
메일 서비스	이메일 발송 기능을 사용할지 여부를 선택하세요.
구분	해당 툴을 개발/운영 용도로 사용할지 선택하세요.
IP	IP 목록을 입력 입력한 IP 정보는 해당 툴 사용자를 위한 VM서버 방화벽 해제하기에서 사용됩니다.
IP 대역	IP 대역을 입력 입력한 IP 대역 정보는 해당 툴 사용자를 위한 VM서버 방화벽 해제하기에서 사용됩니다.
IDP 사용여부	IDP 사용여부를 선택하세요.
IDP 유형	IDP 사용 시, IDP 유형(CMP IDP, 그 외 IDP)을 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. CICD Pipeline 입력 항목

주의

Jenkins의 시스템 설정 중 Built-In Node의 Number of executors 항목이 1 이상으로 설정되어 있는 경우, 보안상 문제가 발생할 수 있으므로 툴 추가 되지 않습니다.

Jenkins 관리 메뉴에서 Built-In Node의 Number of executors 항목이 0으로 설정 되어 있어야 합니다.
참고 Jenkins 공식적으로 Controller Node에서 빌드실행을 지양하도록 가이드하고 있습니다.
- https://www.jenkins.io/doc/book/security/controller-isolation/

Image Registry

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
URL for API	`Docker Hub` API 경로를 입력하세요.
이미지 저장소 URL	Docker Registry 사용을 위한 URL을 입력하세요.
사설 SSL 인증서 사용	사설 SSL의 사용/미사용 여부를 선택하세요.
시스템 공통 이미지 포함	시스템 공통 이미지 포함 여부를 선택하세요.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증 타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. Image Registry 입력 항목

Code Quality

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 `SonarQube` 프로젝트 생성을 가능하게 할지 여부를 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
툴 버전	`SonarQube`의 버전을 입력하세요.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증 타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. Code Quality 입력 항목

Artifact Repository

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 `Nexus` 리파지토리 생성을 가능하게 할지 여부를 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증 타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. Artifact Repository 입력 항목

Helm Chart Repository

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
사설 SSL 인증서 사용	사설 SSL의 사용/미사용 여부를 선택하세요.
헬름차트 저장소 URL	해당 툴의 저장소 URL을 입력 중복된 URL은 등록할 수 없습니다.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증 타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. Helm Chart Repository 입력 항목

Project Management Software

항목	설명
툴명	사용자가 구분하기 위한 툴 이름을 입력하세요.
툴 분류	툴 분류를 선택하세요.
툴	툴을 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 `JIRA` 프로젝트 생성을 가능하게 할지 여부를 선택하세요.
URL	툴에 접근하기위한 URL 주소를 입력 중복된 URL은 등록할 수 없습니다.
IDP 사용여부	IDP 사용여부를 선택하세요.
사용자 계정 인증 타입	툴 사용자의 인증 타입을 선택하세요.
관리자 계정 인증 타입	툴 관리자의 인증 타입을 선택하세요.
관리자 아이디	툴 관리자의 아이디를 입력하세요.
관리자 비밀번호 / 토큰	툴 관리자의 비밀번호 또는 토큰을 입력하세요.

표. Project Management Software 입력 항목

부가 정보 입력

툴 추가 팝업창의 기본정보 입력 화면에서 다음 버튼을 클릭하면 부가정보 입력 화면이 나타납니다.
각 항목을 선택하고 완료 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 툴 추가를 완료하세요.

항목	설명
사용여부	해당 테넌트/프로젝트그룹에서 툴을 사용할지 여부를 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택 툴 분류가 SCM Repository인 경우에만 노출됩니다.

표. 부가 정보 입력 항목

툴 상세

툴의 상세정보 관리를 시작하려면 다음 절차를 따르세요.

툴 페이지에서 상세정보 관리를 원하는 툴을 클릭하세요. 툴 상세 페이지로 이동합니다.

툴 기본정보 관리하기

툴의 기본정보를 확인하려면 다음 절차를 따르세요.

툴 상세 페이지에서 기본정보 탭을 클릭하세요.

툴의 기본정보를 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 기본정보 탭을 클릭하세요.
수정 버튼을 클릭하세요.
필요한 정보를 수정한 후 저장 버튼을 클릭하세요.

글로벌 툴 관리하기

참고

툴이 Jenkins인 경우만, 글로벌 툴 탭이 노출됩니다.

Jenkins 웹 화면의 Jenkins 관리 > Global Tool Configuration 메뉴를 DevOps Console에서 조작할 수 있는 기능입니다.
DevOps Console에서 Jenkins로 단방향 등록만 지원합니다. (즉, 사용자가 DevOps Console에서 수정한 사항이 Jenkins의 정보를 덮어 쓰게 됩니다.)
사용자는 Jenkins에서 사용할 수 있는 툴 목록을 관리할 수 있으며, 글로벌 툴에 등록된 툴은 스테이지 구성 시 Tools에서 사용됩니다.

클로벌 툴을 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 클로벌 툴 탭을 클릭하세요.

글로벌 툴 추가하기

클로벌 툴을 추가하려면 다음 절차를 따르세요.

클로벌 툴 탭에서 추가하려는 항목의 편집 아이콘을 클릭하세요. 글로벌 툴 관리 팝업창이 열립니다.
- 필수 툴은 DevOps Console에서 자동으로 설정하게 됩니다.
- 필수 툴은 삭제할 수 없으며 홈 경로만 수정할 수 있습니다.
추가 버튼을 클릭하세요. 목록의 아래쪽에 신규 행이 추가됩니다.
추가된 신규 행에 정보를 입력하고 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.
항목 설명
툴 종류 툴 종류는 자동으로 설정됩니다.
이름 툴 이름을 입력하세요.
홈 경로 툴이 설치된 경로를 입력하세요.
표. 글로벌 툴 추가 입력 항목

항목	설명
툴 종류	툴 종류는 자동으로 설정됩니다.
이름	툴 이름을 입력하세요.
홈 경로	툴이 설치된 경로를 입력하세요.

글로벌 툴 수정하기

클로벌 툴을 수정하려면 다음 절차를 따르세요.

클로벌 툴 탭에서 추가하려는 항목의 편집 아이콘을 클릭하세요. 글로벌 툴 관리 팝업창이 열립니다.
내용 수정 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

글로벌 툴 삭제하기

글로벌 툴을 삭제하려면 다음 절차를 따르세요.

클로벌 툴 탭에서 추가하려는 항목의 편집 아이콘을 클릭하세요. 글로벌 툴 관리 팝업창이 열립니다.
목록 삭제 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

에이전트(kubernetes) 관리하기

참고

툴이 Jenkins인 경우만, 에이전트(kubernetes) 탭이 노출됩니다.

사용자는 Jenkins에서 빌드 시에 사용되는 에이전트(슬레이브)를 관리할 수 있습니다.

Jenkins 웹 화면의 1) Jenkins 관리 > 시스템 설정 > Cloud > Pod Templates 또는 2) Jenkins 관리 > 노드 관리 > Configure Clouds > Pod Templates 메뉴를 DevOps Console에서 조작할 수 있는 기능입니다.

DevOps Console에서 Jenkins로 단방향 등록만 지원합니다. (즉, 사용자가 DevOps Console에서 수정한 사항이 Jenkins의 정보를 덮어 쓰게 됩니다.)

에이전트(Kubernetes)를 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
Pod Template 관리 목록의 정보 아이콘을 클릭하세요. Pod Template 사용 안내 팝업창이 열립니다.

컨테이너 리소스 타입 추가하기

안내

사용자가 컨테이너 리소스 타입을 수정하면 Pod Template 에 영향을 줍니다.

컨테이너 리소스 타입을 미사용 → 사용 으로 변경하면, Pod Template 숫자는 (컨테이너 리소스 타입 숫자 X Pod Template 숫자) 만큼 늘어나게 됩니다.
컨테이너 리소스 타입을 사용 → 미사용 으로 변경하면, 늘어났던 Pod Template은 다시 원래의 숫자로 줄어들게 됩니다.
늘어나는 Pod Template 의 에이전트명, Label 등은 중복을 피하기 위해 사용자가 컨테이너 리소스 타입 등록 시 입력한 Resource Type 항목을 조합하여 자동 생성됩니다.

컨테이너 리소스 타입을 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
컨테이너 리소스 타입 관리의 편집 아이콘을 클릭하세요. 컨테이너 리소스 타입 관리 팝업창이 열립니다.
추가 버튼을 클릭해서 내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

항목	설명
사용 여부	사용여부를 설정하세요. 사용 여부를 변경하려면, 해당 `Jenkins`툴을 사용하여 구성한 빌드 파이프라인이 존재하지 않아야 합니다.
Resource Type	리소스 명을 입력하세요.
CPU/Memory (Request)	Kubernetes Pod Agent가 구성될 때, 사용될 리소스의 요청 값을 입력하세요.
CPU/Memory (Limit)	Kubernetes Pod Agent가 구성될 때, 사용될 리소스의 제한 값을 입력하세요.

표. 컨테이너 리소스 타입 추가 입력 항목

컨테이너 리소스 타입 수정하기

컨테이너 리소스 타입을 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
컨테이너 리소스 타입 관리의 편집 아이콘을 클릭하세요. 컨테이너 리소스 타입 관리 팝업창이 열립니다.
내용 수정 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

컨테이너 리소스 타입 삭제하기

컨테이너 리소스 타입을 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
컨테이너 리소스 타입 관리의 편집 아이콘을 클릭하세요. 컨테이너 리소스 타입 관리 팝업창이 열립니다.
내용 삭제 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

Pod Template 추가하기

Pod Template을 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
Pod Template 관리 목록의 추가 버튼을 클릭하세요. 에이전트(Kubernetes) 추가 화면이 나타납니다.
내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

항목	설명
타겟 Kubernetes	Pod Template을 추가할 타겟 Kubernetes를 선택 실제 Jenkins에 등록된 Kubernetes 목록을 보여줍니다.
에이전트명	Pod Template의 이름을 입력하세요.
Label	Jenkins Pipeline Script에서 해당 에이전트를 호출하기 위한 Label 값을 입력하세요.
상속 Pod Template	설정 값(환경 변수, Volume…)을 상속받을 Pod Template을 선택 실제 Jenkins에 등록된 Pod Template 목록을 보여줍니다.
컨테이너	Jenkins의 Container Template 항목에 매핑되는 정보로, 이름/도커 이미지/작업 경로/명령어/인자 값을 입력 필수 컨테이너 정보는 삭제할 수 없으며, 이름을 변경할 수 없습니다.
툴 경로	Jenkins의 Tool Locations 항목에 매핑되는 정보로, 이름/홈 경로를 입력 글로벌 툴 목록에 추가된 툴만 선택할 수 있습니다.
지원 스테이지	지원 스테이지 구성을 선택 DevOps Console의 빌드 파이프라인 템플릿 구성에 활용되는 정보입니다. 필수 스테이지 정보는 선택 해제할 수 없습니다.

표. Pod Template 추가하기 입력 항목

참고

만약 사용자가 지원 스테이지 항목에서 Docker Build 를 체크하지 않은 경우,

Docker Build가 반드시 필요한 Kubernetes, VM(Docker) 유형의 App.템플릿을 통해 프로젝트로 구성할 때 해당 Jenkins를 사용할 수 없습니다.
빌드 파이프라인 추가하기 를 통해 빌드 파이프라인을 구성할 때, Docker Build 스테이지를 추가할 수 없습니다.

Pod Template 상세보기

Pod Template의 상세정보를 조회하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
Pod Template 관리 목록에서 조회할 에이전트의 상세보기 버튼을 클릭하세요. 에이전트(Kubernetes) 상세 화면이 나타납니다.

Pod Template 수정하기

Pod Template을 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
Pod Template 관리 목록에서 조회할 에이전트의 상세보기 버튼을 클릭하세요. 에이전트(Kubernetes) 상세 화면이 나타납니다.
수정 버튼을 클릭하세요.
내용 수정 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 수정을 완료하세요.

Pod Template 삭제하기

Pod Template을 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(Kubernetes) 탭을 클릭하세요.
Pod Template 관리 목록에서 조회할 에이전트의 상세보기 버튼을 클릭하세요. 에이전트(Kubernetes) 상세 화면이 나타납니다.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 삭제를 완료하세요.

에이전트(VM) 관리하기

참고

툴이 Jenkins인 경우만, 에이전트(VM) 탭이 노출됩니다.

Jenkins에서 사용할 수 있는 Node 목록을 관리할 수 있습니다.
Jenkins의 Jenkins 관리 > 노드 관리 메뉴를 DevOps Console에서 조작할 수 있는 기능입니다.
DevOps Console에서 Jenkins로 단방향 등록만 지원합니다. (즉, 사용자가 DevOps Console에서 수정한 사항이 Jenkins의 정보를 덮어 쓰게 됩니다.)

에이전트(VM)을 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
노드 관리 목록의 정보 아이콘을 클릭하세요. Node 사용 안내 팝업창이 열립니다.

에이전트 연결 관리하기

실제 Jenkins와 에이전트(VM)을 연결할 터널링 포트를 등록합니다. 터널링 port는 Jenkins마다 다를 수 있습니다.

에이전트 연결을 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
에이전트 연결 관리의 편집 아이콘을 클릭하세요. 에이전트 연결 관리 팝업창이 열립니다.
내용 입력 후 저장 버튼을 클릭하세요.

에이전트(VM) 추가하기

에이전트(VM)을 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
에이전트 연결 관리의 추가 버튼을 클릭하세요. 에이전트(VM) 추가 화면이 나타납니다.
내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 삭제를 완료하세요.

항목	설명
타겟 OS	VM의 OS 정보를 입력하세요.
에이전트명	VM의 이름을 입력하세요.
원격 루트 디렉토리	디렉토리 경로를 입력하세요.
Label	Jenkins Pipeline Script에서 해당 에이전트를 호출하기 위한 Label 값을 입력하세요.
툴 경로	Jenkins의 Tool Locations 항목에 매핑되는 정보로, 이름/홈 경로를 입력 글로벌 툴 목록에 추가된 툴만 선택할 수 있습니다.
지원 스테이지	지원 스테이지 구성을 선택 DevOps Console의 빌드 파이프라인 템플릿 구성에 활용되는 정보입니다. 필수 스테이지 정보는 선택 해제할 수 없습니다.

표. 에이전트(VM) 추가하기 입력 항목

참고

만약 사용자가 지원 스테이지 항목에서 Docker Build 를 체크하지 않은 경우,

Docker Build가 반드시 필요한 Kubernetes, VM(Docker) 유형의 App.템플릿을 통해 프로젝트로 구성할때 해당 Jenkins를 사용할 수 없습니다.
빌드 파이프라인 추가하기 를 통해, 빌드 파이프라인을 구성할 때, Docker Build 스테이지를 추가할 수 없습니다.

에이전트(VM) 상세보기

에이전트(VM)의 상세정보를 조회하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
노드 관리 목록에서 에이전트를 클릭하세요. 에이전트(VM) 상세 화면이 나타납니다.
Jenkins - 에이전트 연결 정보의 정보 아이콘을 클릭하세요.
에이전트 연결 안내 팝업창이 열립니다.

에이전트(VM) 연동하기

참고

에이전트 연동을 위해서는 VM 서버에 Java가 설치되어 있어야 합니다.

에이전트(VM)을 등록 후 사용하기 위해서는 실제 VM 서버와 연결을 진행해야 합니다.

에이전트(VM)을 연동하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
노드 관리 목록에서 연동하려는 에이전트를 클릭하세요. 에이전트(VM) 상세 화면이 나타납니다.
jnlpUrl과 secret을 참고하세요.
Jenkins - 에이전트 연결 정보의 정보 아이콘을 클릭하세요. 에이전트 연결 안내 팝업창이 열립니다.
에이전트 파일 다운로드 버튼을 클릭하여 agent.jar 파일을 다운로드 받으세요.
- agent.jar 버전에 따라 실행에 문제가 있을 수도 있습니다.
- 자신의 Jenkins에서도 직접 다운로드 받을 수 있습니다. ({JENKINS_URL}/jnlpJars/agent.jar)
배포할 VM 서버에 접속하여 디렉토리를 생성하세요.
생성된 디렉토리에 다운로드 받은 agent.jar 파일을 복사하세요.
생성된 디렉토리 경로에서 아래 명령어를 실행하세요.

배경색 변경

java -jar agent.jar -jnlpUrl {jnlpUrl} -secret {secret}

java -jar agent.jar -jnlpUrl {jnlpUrl} -secret {secret}

에이전트(VM) 실행 명령어

에이전트(VM) 수정하기

에이전트(VM)을 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
노드 관리 목록에서 수정하려는 에이전트를 클릭하세요. 에이전트(VM) 상세 화면이 나타납니다.
수정 버튼을 클릭하세요.
내용 수정 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

에이전트(VM) 삭제하기

에이전트(VM)을 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 에이전트(VM) 탭을 클릭하세요.
노드 관리 목록에서 삭제하려는 에이전트를 클릭하세요. 에이전트(VM) 상세 화면이 나타납니다.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

글로벌 라이브러리 관리하기

빌드 파이프라인에서 사용 가능한 library 목록을 관리할 수 있습니다. Jenkins의 Jenkins 관리 → 시스템 설정 → Global Pipeline Libraries 메뉴를 DevOps Console에서 조작할 수 있는 기능입니다.
라이브러리와 연결된 Credential 정보는 Jenkins 관리 > Manage Credentials 메뉴에서 확인 가능합니다.
DevOps Console에서 Jenkins로 단방향 등록만 지원합니다. (즉, 사용자가 DevOps Console에서 수정한 사항이 Jenkins의 정보를 덮어 쓰게 됩니다.)

에이전트(VM)을 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 글로벌 라이브러리 탭을 클릭하세요.

글로벌 라이브러리 추가하기

주의

필수 라이브러리 여부가 Y 인 경우 수정/삭제할 수 없습니다.

글로벌 라이브러리를 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 글로벌 라이브러리 탭을 클릭하세요.
추가 버튼을 클릭하세요. 글로벌 라이브러리 추가 화면이 나타납니다.
내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

항목	설명
라이브러리명	라이브러리의 이름을 입력합니다.
유형	SCM으로 고정되어 변경 불가합니다.
라이브러리 URL	해당 라이브러리가 존재하는 Git 저장소 주소를 입력합니다.
디폴트 버전	해당 라이브러리가 존재하는 Git 저장소의 브랜치 명 또는 태그를 입력합니다.
아이디	해당 라이브러리 pull을 위한 아이디를 입력합니다.
비밀번호	해당 라이브러리 pull을 위한 비밀번호를 입력합니다.

표. 글로벌 라이브러리 추가 입력 항목

글로벌 라이브러리 상세보기

글로벌 라이브러리의 상세정보를 조회하려면 다음 절차를 따르세요.

툴 상세 페이지에서 글로벌 라이브러리 탭을 클릭하세요.
글로벌 라이브러리 목록에서 상세보기를 원하는 항목을 클릭하세요. 글로벌 라이브러리 상세 화면이 나타납니다.

참고

유형이 SCM인 경우 SCM 관련 정보가 노출됩니다.

필수 라이브러리 여부, 라이브러리명, 유형, 라이브러리 URL, 디폴트 버전, ID

글로벌 라이브러리 수정하기

글로벌 라이브러리를 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 글로벌 라이브러리 탭을 클릭하세요.
글로벌 라이브러리 목록에서 상세보기를 원하는 항목을 클릭하세요. 글로벌 라이브러리 상세 화면이 나타납니다.
수정 버튼을 클릭하세요.
내용 수정 후 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

글로벌 라이브러리 삭제하기

글로벌 라이브러리를 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 글로벌 라이브러리 탭을 클릭하세요.
글로벌 라이브러리 목록에서 삭제를 원하는 항목을 클릭하세요. 글로벌 라이브러리 상세 화면이 나타납니다.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

지원 테넌트/프로젝트그룹 관리하기

참고

툴 유형에 따라 탭 이름이 다르게 노출됩니다.

System Tool/Tenant Tool: 지원 테넌트
ProjectGroup Tool: 지원 정보

사용자는 해당 툴을 사용할 테넌트 또는 프로젝트그룹을 관리할 수 있습니다.

지원 테넌트 또는 프로젝트그룹을 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 테넌트 또는 지원 정보 탭을 클릭하세요.

참고

관리 소속인 테넌트/프로로젝트그룹에는 Primary 아이콘이 보여집니다.

지원 테넌트/프로젝트그룹 추가하기

지원 테넌트 또는 프로젝트그룹을 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 테넌트 또는 지원 정보 탭을 클릭하세요.
추가 버튼을 클릭하세요. 테넌트/프로젝트그룹 추가 팝업창이 열립니다.
내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

항목	설명
테넌트/프로젝트그룹	툴을 사용할 테넌트/프로젝트그룹을 선택하세요.
사용여부	해당 테넌트/프로젝트그룹에서 툴을 사용할지 여부를 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택하세요. 해당 설정은 아래의 툴 분류에서만 설정 가능합니다. SCM Repository Image Registry Code Quality Artifact Repository Helm Chart Repository Test Management Project Management Software

표. 지원 테넌트/프로젝트그룹 추가 입력 항목

지원 테넌트/프로젝트그룹 수정하기

지원 테넌트/프로젝트그룹을 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 테넌트 또는 지원 정보 탭을 클릭하세요.
지원 테넌트 또는 지원 정보 목록에서 사용여부와 신규생성 가능 여부를 선택하여 수정하세요.

관리 테넌트/프로젝트그룹 이관하기

관리 테넌트/프로젝트그룹을 이관하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 테넌트 또는 지원 정보 탭을 클릭하세요.
관리 테넌트 이관 또는 관리 프로젝트그룹 이관 버튼을 클릭하세요. 관리 테넌트 이관 또는 관리 프로젝트그룹 이관 팝업창이 열립니다.
이관 대상 테넌트 또는 프로젝트그룹을 선택 후 저장 버튼을 클릭하세요.

지원 테넌트/프로젝트그룹 삭제하기

관리 테넌트/프로젝트그룹을 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 테넌트 또는 지원 정보 탭을 클릭하세요.
삭제하려는 테넌트/프로젝트그룹의 체크박스를 선택하세요.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

참고

Primary로 지정된 테넌트/프로젝트그룹은 삭제할 수 없습니다.

지원 K8S 클러스터 관리하기

사용자는 해당 툴이 사용될 K8S 클러스터를 관리할 수 있습니다.

지원 K8S 클러스터를 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 K8S 클러스터 탭을 클릭하세요.

지원 K8S 클러스터 추가하기

지원 K8S 클러스터를 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 K8S 클러스터 탭을 클릭하세요.
지원 K8S 클러스터 페이지에서 추가 버튼을 클릭하세요. K8S 클러스터 추가 팝업창이 열립니다.
내용 입력 후 저장 버튼을 클릭하세요.

확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

항목	설명
K8S 클러스터	툴을 사용할 K8S 클러스터를 선택하세요.
사용여부	해당 테넌트/프로젝트그룹에서 툴을 사용할지 여부를 선택하세요.
신규생성 가능 여부	해당 테넌트/프로젝트그룹에서 신규 리파지토리 생성을 가능하게 할지 여부를 선택하세요. 해당 설정은 아래의 툴 분류에서만 설정 가능합니다. SCM Repository Image Registry Code Quality Artifact Repository Helm Chart Repository Test Management Project Management Software

표. 지원 K8S 클러스터 추가 입력 항목

지원 K8S 클러스터 수정하기

지원 K8S 클러스터를 수정하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 K8S 클러스터 탭을 클릭하세요.
지원 K8S 클러스터 목록에서 사용여부와 신규생성 가능 여부를 선택하여 수정하세요.

지원 K8S 클러스터 삭제하기

지원 K8S 클러스터를 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 지원 K8S 클러스터 탭을 클릭하세요.
지원 K8S 클러스터 목록에서 삭제할 K8S 클러스터의 체크박스를 선택하세요.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

툴 운영자 관리하기

툴 운영자를 관리하려면 다음 절차를 따르세요.

툴 상세 페이지에서 툴 운영자 탭을 클릭하세요.

툴 운영자 추가하기

툴 운영자를 추가하려면 다음 절차를 따르세요.

툴 상세 페이지에서 툴 운영자 탭을 클릭하세요.
추가 버튼을 클릭하세요. 툴 운영자 추가 팝업창이 열립니다.
운영자를 선택하고 저장 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

툴 운영자 삭제하기

툴 운영자를 삭제하려면 다음 절차를 따르세요.

툴 상세 페이지에서 툴 운영자 탭을 클릭하세요.
툴 운영자 목록에서 삭제할 항목의 체크박스를 선택하세요.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

Jenkins 권장 플러그인 관리하기

참고

툴이 Jenkins인 경우만, 플러그인 탭이 노출됩니다.

설치된 Jenkins의 버전과 권장 플러그인 설치 여부 및 버전 정보를 확인할 수 있으며, 권장 플러그인에 대하여 업데이트 및 설치를 할 수 있습니다.

툴 버전: Jenkins 버전 정보
권장 플러그인: 권장 플러그인 설치 여부 및 버전 정보

툴 버전 및 권장 플러그인 정보 확인하기

툴 버전 및 권장 플러그인 정보를 확인하려면 다음 절차를 따르세요.

툴 상세 페이지에서 기본정보 탭을 클릭하세요.
설치 및 업데이트가 필요한 권장플러그인 정보가 있다면 안내 팝업이 나타나고, 확인을 누르면 플러그인 탭으로 이동합니다.
툴 상세 페이지에서 플러그인 탭을 클릭하세요.
툴 버전, 권장 플러그인의 항목을 확인하세요.

권장 플러그인 설치하기

권장 플러그인을 설치하려면 다음 절차를 따르세요.

권장 플러그인 영역에서 설치 하고자 하는 플러그인의 설치 버튼을 선택하세요.
권장 플러그인 설치 팝업에서 확인 버튼을 선택하세요.
설치 요청이 완료되었다는 팝업이 나타나며, 실제 설치내용은 팝업의 링크를 통해 확인 가능합니다.

권장 플러그인 업데이트 하기

권장 플러그인을 업데이트 하려면 다음 절차를 따르세요.

권장 플러그인 영역에서 업데이트 하고자 하는 플러그인의 업데이트 버튼을 선택하세요.
권장 플러그인 업데이트 팝업에서 확인 버튼을 선택하세요.
설치 요청이 완료되었다는 팝업이 나타나며, 실제 설치내용은 팝업의 링크를 통해 확인 가능합니다.
업데이트 적용을 위해 Jenkins를 반드시 재기동 해주셔야 합니다.

툴 삭제하기

참고

프로젝트에서 사용 중인 툴은 삭제할 수 없습니다.

툴을 삭제하려면 다음 절차를 따르세요.

툴 페이지에서 삭제를 원하는 툴을 클릭하세요. 툴 상세 페이지로 이동합니다.
삭제 버튼을 클릭하세요.
확인 팝업창에서 확인 버튼을 클릭해서 완료하세요.

코드품질

App.템플릿