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