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. 템플릿 선택하기

참고
애플리케이션 템플릿에 대한 자세한 내용은 App.템플릿을 참고하세요.

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

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

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

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

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

  1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목설명
    필터미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    검색검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

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

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

저장소 유형소스코드가 포함된 App. 템플릿
+
DevOps Console 등록 툴
소스코드가 포함된 App. 템플릿
+
DevOps Console 미등록 툴
소스코드가 미포함된(EnvironmentOnly)
App. 템플릿
+
DevOps Console 등록 툴
소스코드가 미포함된(Environment Only)
App. 템플릿
+
DevOps Console 미등록 툴
신규 저장소 생성XX
기존 저장소 사용XX
표. 신규 저장소 생성과 기존 저장소 사용 활성화 조건

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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 URLSonarQube URL을 선택하세요.
    품질 프로젝트명SonarQube의 프로젝트의 이름을 입력하세요.
    품질 프로젝트 KeySonarQube의 프로젝트의 Key를 입력하세요.
    인증정보인증정보를 입력
    • 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.
    표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

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

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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. yamlValues.yaml 내용을 수정하세요.
    • 헬름차트 설치 시 사용할 values.yaml 파일 입니다.
    표. 프로젝트 생성 배포 대상 환경 설정 항목

빌드 파이프라인 설정하기

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

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

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

  1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
    • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
    • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목
    설명
    빌드/배포 파이프라인빌드/배포 파이프라인 정보를 보여줍니다.
    구분개발/운영 구분을 선택하세요.
    • 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다.
    URL파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요.
    • 사용자가 사용가능한 Jenkins 가 나타납니다.
    빌드 에이전트파이프라인 빌드에 사용될 에이전트를 선택하세요.
    빌드 환경 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 명이 자동으로 등록됩니다.
    DockerfileDockerfile의 파일 내용을 확인 및 수정하세요.
    파이프라인 스크립트파이프라인 스크립트를 확인 및 수정하세요.
    표. 프로젝트 생성 사용자 정의 설정 항목
참고
Jenkins 파이프라인 스크립트에 대한 자세한 내용은 공식 사이트를 참고하세요.

프로젝트 생성 완료하기

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

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

  1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
  2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
  3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.
안내
생성 도중에 취소할 수 없으며, 정상적으로 프로젝트가 생성된 경우 확인 버튼이 활성화됩니다.

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 클러스터에서 조회된 클러스터 중 사용자가 접근 권한을 가진 네임스페이스만 선택할 수 있습니다.
    표. 프로젝트 생성 기본 정보 입력 항목

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

참고
애플리케이션 템플릿에 대한 자세한 내용은 App.템플릿을 참고하세요.

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

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

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

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

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

  1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목설명
    필터미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    검색검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

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

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

저장소 유형소스코드가 포함된 App. 템플릿
+
DevOps Console 등록 툴
소스코드가 포함된 App. 템플릿
+
DevOps Console 미등록 툴
소스코드가 미포함된(EnvironmentOnly)
App. 템플릿
+
DevOps Console 등록 툴
소스코드가 미포함된(Environment Only)
App. 템플릿
+
DevOps Console 미등록 툴
신규 저장소 생성XX
기존 저장소 사용XX
표. 신규 저장소 생성과 기존 저장소 사용 활성화 조건

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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 URLSonarQube URL을 선택하세요.
    품질 프로젝트명SonarQube의 프로젝트의 이름을 입력하세요.
    품질 프로젝트 KeySonarQube의 프로젝트의 Key를 입력하세요.
    인증정보인증정보를 입력
    • 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.
    표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

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

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목
    설명
    빌드/배포 파이프라인빌드/배포 파이프라인 정보를 보여줍니다.
    구분개발/운영 구분을 선택하세요.
    • 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다.
    URL파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요.
    • 사용자가 사용가능한 Jenkins 가 나타납니다.
    빌드 에이전트파이프라인 빌드에 사용될 에이전트를 선택하세요.
    빌드 환경 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 명이 자동으로 등록됩니다.
    DockerfileDockerfile의 파일 내용을 확인 및 수정하세요.
    파이프라인 스크립트파이프라인 스크립트를 확인 및 수정하세요.
    표. 프로젝트 생성 사용자 정의 설정 항목
참고
Jenkins 파이프라인 스크립트에 대한 자세한 내용은 공식 사이트를 참고하세요.

프로젝트 생성 완료하기

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

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

  1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
  2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
  3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.
안내
생성 도중에 취소할 수 없으며, 정상적으로 프로젝트가 생성된 경우 확인 버튼이 활성화됩니다.

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

참고
  • 사용자는 프로젝트 생성이 가능하도록 프로젝트그룹과 테넌트에 가입되어 있어야 합니다.
  • 프로젝트그룹 및 테넌트 가입 방법은 프로젝트그룹 생성하기를 참고하세요.
  • ArgoCD를 통한 배포는 사전에 ArgoCDGitOps 배포시 사용할 Git 저장소가 준비되어 있어야 합니다.
  • Devops Console에서는 기존에 구축된 ArgoCD와 이와 연계된 git 정보를 이용하여 배포하는 방식 입니다.

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

프로젝트 생성 시작하기

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

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

기본 정보 입력하기

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

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

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

App. 템플릿 선택하기

참고
애플리케이션 템플릿에 대한 자세한 내용은 App.템플릿을 참고하세요.

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

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

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

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

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

  1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목설명
    필터미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    검색검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

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

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

저장소 유형소스코드가 포함된 App. 템플릿
+
DevOps Console 등록 툴
소스코드가 포함된 App. 템플릿
+
DevOps Console 미등록 툴
소스코드가 미포함된(EnvironmentOnly)
App. 템플릿
+
DevOps Console 등록 툴
소스코드가 미포함된(Environment Only)
App. 템플릿
+
DevOps Console 미등록 툴
신규 저장소 생성XX
기존 저장소 사용XX
표. 신규 저장소 생성과 기존 저장소 사용 활성화 조건

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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 URLSonarQube URL을 선택하세요.
    품질 프로젝트명SonarQube의 프로젝트의 이름을 입력하세요.
    품질 프로젝트 KeySonarQube의 프로젝트의 Key를 입력하세요.
    인증정보인증정보를 입력
    • 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.
    표. 프로젝트 생성 코드 품질 설정 항목

이미지 저장소 설정하기

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

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  1. 이미지 저장소 항목에서 저장소 유형을 선택하세요.
  2. 신규 저장소 생성/기존 저장소 사용 선택 후 정보를 입력하세요.
  3. 인증정보를 입력 후 Connection Test 버튼을 클릭하세요.
  4. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목설명
    저장소 유형사용할 저장소 유형을 선택
    • 사용자가 사용가능한 Image Registry 툴의 유형들이 나타납니다.
    저장소 정보저장소 생성 방식을 선택하세요.
    • 신규 저장소 생성 시 프로젝트그룹명/프로젝트명으로 URL이 구성됩니다.
    인증 정보인증정보를 입력하세요.
    표. 프로젝트 생성 이미지 저장소 설정 항목

배포대상 환경 설정하기

참고

배포 대상 환경을 설정하려면 ArgoCDGitOps 배포시 사용할 Git 저장소가 준비되어야 합니다.
ArgoCD App 생성 방식 선택에 따라 입력값이 달라집니다.

  • 신규 App 생성
  • 기존 App 사용

신규 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 URLArgoCD 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 URLArgoCD 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 사용 설정 항목
참고
DevOps Console의 ArgoCD 배포 프로젝트는 Image Repo Key, Image Tag Key, Image Secret Key, Deploy Strategy Key에 등록된 정보를 변경하여 배포를 수행합니다.

빌드 파이프라인 설정하기

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

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

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

  1. 빌드 파이프라인 화면에서 IDP 연동 여부에 따라 분기됩니다.
    • IDP 연동 Jenkins의 경우 사용자 등록 확인을 위해 User Check 버튼을 클릭하세요.
    • IDP 미연동 Jenkins의 경우 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목
    설명
    빌드/배포 파이프라인빌드/배포 파이프라인 정보를 보여줍니다.
    구분개발/운영 구분을 선택하세요.
    • 개발/운영 구분에 따라 해당 파이프라인의 권한이 달라집니다.
    URL파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력하세요.
    • 사용자가 사용가능한 Jenkins 가 나타납니다.
    빌드 에이전트파이프라인 빌드에 사용될 에이전트를 선택하세요.
    빌드 환경 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 명이 자동으로 등록됩니다.
    DockerfileDockerfile의 파일 내용을 확인 및 수정하세요.
    파이프라인 스크립트파이프라인 스크립트를 확인 및 수정하세요.
    표. 프로젝트 생성 사용자 정의 설정 항목
참고
Jenkins 파이프라인 스크립트에 대한 자세한 내용은 공식 사이트를 참고하세요.

프로젝트 생성 완료하기

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

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

  1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
  2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
  3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.
안내
생성 도중에 취소할 수 없으며, 정상적으로 프로젝트가 생성된 경우 확인 버튼이 활성화됩니다.

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. 배포 방식 을 선택하세요.
  5. 각 입력 완료 후 시작 버튼을 클릭하세요.

App. 템플릿 선택하기

참고
애플리케이션 템플릿에 대한 자세한 내용은 App.템플릿을 참고하세요.

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

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

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

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

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

  1. 애플리케이션 템플릿 화면에서 템플릿 명을 입력하여 선택하려는 애플리케이션 템플릿 카드를 선택 후 클릭하세요.
  2. 다음 버튼이 활성화되면 다음 버튼을 클릭하세요.
    항목설명
    필터미리 정의된 필터를 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    검색검색을 통해 애플리케이션 템플릿을 쉽게 찾을 수 있습니다.
    표. 프로젝트 생성 애플리케이션 템플릿 항목

코드 저장소 설정하기

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

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

저장소 유형소스코드가 포함된 App. 템플릿
+
DevOps Console 등록 툴
소스코드가 포함된 App. 템플릿
+
DevOps Console 미등록 툴
소스코드가 미포함된(EnvironmentOnly)
App. 템플릿
+
DevOps Console 등록 툴
소스코드가 미포함된(Environment Only)
App. 템플릿
+
DevOps Console 미등록 툴
신규 저장소 생성XX
기존 저장소 사용XX
표. 신규 저장소 생성과 기존 저장소 사용 활성화 조건

참고
인증정보는 한번 저장되면 다음부터 저장된 인증정보 사용 을 통해 계정정보를 입력하지 않고 Connection Test를 수행할 수 있습니다.

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

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

  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 URLSonarQube URL을 선택하세요.
    품질 프로젝트명SonarQube의 프로젝트의 이름을 입력하세요.
    품질 프로젝트 KeySonarQube의 프로젝트의 Key를 입력하세요.
    인증정보인증정보를 입력
    • 새로운 사용자 생성하거나 기존 인증정보를 사용할 수 있습니다.
    표. 프로젝트 생성 코드 품질 설정 항목

아티팩트 저장소 설정하기

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

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

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

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

배포대상 환경 설정하기

참고

배포대상 설정을 위해 VM서버그룹/VM서버가 등록되어 있어야 합니다.

등록 방법 및 자세한 사항은 VM서버 그룹을 참고하세요.

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

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

빌드 파이프라인 설정하기

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

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

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

  1. 빌드 파이프라인 설정 단계에서 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
  2. 다음 버튼이 활성화 되면 다음 버튼을 클릭하세요.
    항목설명
    빌드/배포 파이프라인빌드/배포 파이프라인 정보를 보여줍니다.
    구분개발/운영 구분을 선택
    URL파이프라인을 구성할 Jenkins 선택 후, Job 이름을 입력
    • 사용자가 사용 가능한 Jenkins 가 나타납니다.
    빌드 에이전트파이프라인 빌드에 사용될 에이전트를 선택
    빌드 환경 OS빌드 에이전트가 실행되는 환경의 OS 정보를 표시 합니다.
    인증 정보Jenkins의 인증정보를 입력하세요.
    환경 변수 설정Jenkins 파이프라인에 등록될 환경변수를 설정하세요.
    배포 결과 수신자빌드 파이프라인 완료 후 결과를 수신할 사용자를 선택하세요.
    표. 빌드 파이프라인 설정 입력 항목

사용자 정의 설정하기

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

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

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

프로젝트 생성 완료하기

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

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

  1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
  2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
  3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.
안내
생성 도중에 취소할 수 없으며, 정상적으로 프로젝트가 생성된 경우 확인 버튼이 활성화됩니다.

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

참고
  • 사용자는 프로젝트 생성이 가능하도록 프로젝트그룹과 테넌트에 가입되어 있어야 합니다.
  • 프로젝트그룹 및 테넌트 가입 방법은 프로젝트그룹 생성하기를 참고하세요.

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

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

프로젝트 생성 시작하기

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

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

기본 정보 입력하기

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

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

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

프로젝트 생성 완료하기

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

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

  1. 요약정보 화면에서 정보 확인 후 완료 버튼을 클릭하세요.
  2. 프로젝트 생성 팝업창이 열리며 프로젝트 생성이 진행됩니다.
  3. 프로젝트 생성이 완료된 후 확인 버튼을 클릭하면 프로젝트 페이지로 이동합니다.
안내
생성 도중에 취소할 수 없으며, 정상적으로 프로젝트가 생성된 경우 확인 버튼이 활성화됩니다.