사용자는 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. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.