프로젝트

프로젝트란 가상 공간인 스페이스 하위에 생성할 수 있는 최소 관리 단위로 하나의 스페이스에 여러 프로젝트를 추가하여 사용할 수 있습니다.

프로젝트 생성

1

프로젝트는 스페이스 관리자(Space Admin)가 생성할 수 있습니다.

2

[프로젝트 > 프로젝트 생성] 메뉴를 클릭하거나, [프로젝트 > 프로젝트 개요] 메뉴 우측 상단의 [프로젝트생성+] 버튼을 클릭하여 [프로젝트 생성] 메뉴로 이동합니다.

이미지_2024-07-25_172149714

기본정보

프로젝트에서 사용할 프로젝트 ID 및 이름과 같은 기본정보를 입력합니다.

이미지_2024-07-25_172854885

1프로젝트가 포함될 스페이스를 선택합니다. 스페이스는 사용자가 스페이스 관리자로 추가된 스페이스 목록에서 선택할 수 있습니다.

2프로젝트에서 사용할 아이디 값을 입력합니다. 프로젝트 아이디 입력 후 [중복체크] 버튼을 클릭하여 기존 사용 이력을 확인합니다.

3프로젝트 관리자를 설정합니다. 선택된 스페이스의 멤버로 속한 사용자 목록을 확인할 수 있으며 관리자로 등록할 사용자 체크 박스를 선택하여 추가합니다.

4프로젝트 카드 및 프로젝트 정보로 사용할 명칭을 입력합니다.

5프로젝트의 추가 정보를 입력합니다.

6[다음] 버튼 클릭 시 입력한 정보를 저장하고 [컨테이너구성] 탭으로 이동합니다.

프로젝트 아이디는 중복이 허용되지 않으므로 중복체크 과정이 반드시 필요합니다.

이미지_2024-07-25_172635340

컨테이너 구성

프로젝트 내 WEB, WAS, DB 구분의 서버(컨테이너)를 자유롭게 구성할 수 있습니다. 단, DB는 프로젝트 별 MAX 1개만 생성할 수 있습니다.

이미지_2024-07-25_173947990

1ID, 개발 및 운영 환경 서비스, Path 정보와 Resource를 설정합니다.

2프로젝트당 1개만 생성되며 ID 값은 고정되어 사용됩니다. 개발 및 운영 환경의 서비스와 STORAGE 용량, Resource를 설정합니다.

3[이전] 버튼 클릭 시 생성 중인 컨테이너 입력 정보를 저장하고 이전 화면(기본정보) 탭으로 이동합니다. 이 때 컨테이너 필수 입력 정보가 입력되지 않으면 이동되지 않습니다.

4[다음] 버튼 클릭 시 생성 중인 컨테이너 입력 정보를 저장하고 다음 화면(환경정보) 탭으로 이동합니다. 컨테이너 필수 정보가 모두 입력된 후 다음으로 이동할 수 있습니다.

WEB/WAS 서버(컨테이너)

1

WEB, WAS의 추가(+) 버튼을 클릭하여 새로운 서버(컨테이너)를 추가합니다. WEB, WAS는 제한 없이 사용할 수 있으며 입력 정보는 동일합니다

이미지_2024-07-25_174532457

2

ID, 개발 및 운영 환경 서비스, Path 정보는 필수 입력 값 입니다.

ID와 Path 값은 프로젝트 별 중복 사용이 불가 하며 Path는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.

3

Resource 설정 상세[▼] 버튼을 클릭하여 Resource 값을 설정할 수 있습니다.

이미지_2024-07-25_174724898

4

컨테이너 추가 시 Resource Request와 Limit 값은 포털에서 제공하는 기본 값(DEF)이 설정됩니다.

Resource Request값은 Resource Limit값 이상 설정할 수 있으며 Request값과 Limit 값 모두 상단에 표기된 Max 값 미만으로만 설정할 수 있습니다.

이미지_2024-07-25_175036445

Storage 저장소 타입을 선택하고 마운트 경로를 입력합니다. 선택한 저장소 타입에 따라 제공 가능한 용량이 달라지며 Storage 마운트 경로는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.

DB 컨테이너 추가

1

DB 컨테이너의 추가[+] 버튼을 클릭하여 새로운 컨테이너를 추가합니다.

이미지_2024-07-25_175322282

2

개발 및 운영 환경 서비스와 서비스 별 STORAGE 값을 선택합니다. 개발 및 운영 환경 서비스는 필수 입력 값입니다.

프로젝트당 DB는 1개만 생성할 수 있으며 ID 값과 Path를 임의로 변경할 수 없습니다.

3

Resource 설정 오른쪽 상세[▼] 버튼을 클릭하여 Resource 값을 설정할 수 있습니다.

이미지_2024-07-25_175521597

4

DB컨테이너 추가 시 개발 및 운영 환경의 Resource Request와 Limit 값은 포털에서 제공하는 기본값(DEF)이 설정됩니다.

환경별 Resource Request값은 Resource Limit값 이상 설정할 수 있으며 Request값과 Limit 값 모두 상단에 표기된 Max 값 미만으로만 설정 가능합니다.

이미지_2024-07-25_175620480

환경설정

프로젝트 추가 설정이 필요한 커스텀도메인, CORS 정보 및 환경 변수를 설정할 수 있습니다.

이미지_2024-07-25_175654740

1사용자가 원하는 커스텀 도메인을 설정합니다.

2커스텀 도메인 변경시 서버간의 리소스 공유를 위해 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유)를 정보를 설정합니다.

3프로젝트에서 사용할 환경 변수 값을 관리합니다.

4[이전] 버튼 클릭 시 입력 정보를 저장하고 이전 화면(컨테이너 구성) 탭으로 이동합니다.

5[저장] 버튼 클릭 시 입력 정보를 저장하고 다음 화면(추가서비스) 탭으로 이동합니다.

커스텀도메인 설정

사용자가 원하는 도메인으로 PRD 환경의 URL을 변경하여 사용할 수 있습니다.

사용할 도메인 정보를 [프로젝트 환경정보 > 커스텀도메인정보]에 입력합니다. 도메인은 변경 전 사용하고자 하는 도메인 구매와 SSL 인증 완료 후 진행해 주세요.

도메인 설정

커스텀도메인 url

SSL 인증서 Key

인증 완료된 SSL 인증서 Key 값

SSL 인증서

인증 완료된 SSL 인증서 값

커스텀 도메인이 설정되면 구분 별 컨테이너의 PRD 접속 주소가 변경됩니다.

이미지_2024-07-25_180608767

만약 도메인 설정에 커스텀 도메인이 입력되지 않으면 구분 별 컨테이너의 PRD 접속 주소는 기본 설정됩니다.

SSL 인증서 Key, SSL 인증서는 텍스트로 입력하며 단순 정보로 시스템 내에서 별도 체크 되지 않습니다.

CORS 설정

커스텀 도메인 설정 시 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유)를 설정하여 서버 간 리소스를 공유합니다.

설정 값

설정 키 값

Origin

http://커스텀도메인 url

Method

GET,POST,HEAD,OPTIONS,PUT,DELETE

Header

If-Modified-Since,Referer,User-Agent,Pragma,Cache-Control,Expires,Content-Type,X-Requested-With,Accept,Origin,Access-Control-Request-Method,Access-Control-Request-Headers

Credential

True

환경변수 설정

환경 변수 정보 오른쪽 상단의 추가 버튼을 클릭하여 새로운 환경 변수를 생성합니다. 환경 변수는 Key와 Value 값을 설정하여 사용할 수 있으며 Key 값은 중복될 수 없습니다.

새로 추가된 환경 변수의 Key값 입력 시 validation 체크 표시가 활성화 됩니다.

이미지_2024-07-25_181237464

추가서비스 - XENI

TobeDevOps에서 제공하는 추가 서비스를 설정합니다. 현재는 화면(넥사크로)에서 엑셀 Import/Export 처리를 위한 XENI 만 구성되어 있습니다.

1

[+] 버튼을 클릭해 XENI 컨테이너를 추가합니다.

이미지_2024-07-25_181322624

2

ID, 개발 및 운영 환경 서비스, Path 정보는 필수 입력 값 입니다.

이미지_2024-07-25_181351538

ID와 Path 값은 프로젝트 별 중복 사용이 불가 하며 Path는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.

3

필수 입력 정보를 모두 입력한 뒤 [프로젝트생성] 버튼을 클릭하여 프로젝트를 생성합니다.

이미지_2024-07-25_181603500

ID, Path 가 중복되었을 경우에는 다음과 같이 중복 오류 확인 팝업이 노출됩니다.

이미지_2024-07-25_181656457

프로젝트 실행

프로젝트 생성이 진행되는 중에는 다음과 같이 [Creating] 상태의 프로젝트를 확인할 수 있습니다.

이미지_2024-07-25_181730610

프로젝트가 정상적으로 생성되면 Creating에서 Running 상태(프로젝트 생성 완료)로 변경되고 [빌드 > 배포] 과정을 통해 컨테이너 생성 및 서비스 배포 과정이 자동으로 진행됩니다.

빌드 확인

프로젝트 생성이 완료되면 빌드가 자동으로 진행됩니다. [빌드] 메뉴에서 생성한 컨테이너 별 빌드 현황을 확인합니다.

1

화면 상단에 프로젝트 구분 탭을 사용하여 Running, Stop 상태의 프로젝트 목록을 각각 확인할 수 있으며 기본 상태 값은 [Running]입니다. [All] 탭 선택 시 전체 프로젝트 목록을 확인할 수 있습니다.

이미지_2024-07-25_181858732

2

선택된 프로젝트의 서버(컨테이너) 콤보 박스를 선택하여 생성된 서버의 배포 환경 별 빌드 현황을 확인할 수 있습니다.

이미지_2024-07-25_182112040

DB는 Git Repository가 생성되지 않고 바로 배포되므로 빌드 항목에서는 제외됩니다.

3

DEV(개발)의 빌드가 정상적으로 진행되면 Status 값이 [Passed]로 확인됩니다.

이미지_2024-07-25_182237096

[Failed]의 경우 Stages 항목의 ⓧ 아이콘을 통해 실패 단계를 확인할 수 있습니다.

배포 확인

DEV(개발)의 빌드가 완료되면 다음 단계인 배포가 자동으로 진행됩니다. [배포] 메뉴에서 생성 요청한 서버의 배포 현황을 확인합니다.

프로젝트 카드의 콤보 박스를 선택하여 생성된 서버 별 배포 현황을 확인할 수 있습니다.

배포가 완료되고 생성된 서버의 DEV 환경에서 정상적으로 동작할 수 있으면 Synced to HEAD와 Healthy가 확인됩니다.

이미지_2024-07-25_182552779

화면 확인

1

프로젝트 생성이 모두 완료 된 후 [프로젝트 > 프로젝트 개요] 메뉴의 서버(컨테이너) 정보 탭에서 DEV 환경의 주소를 클릭합니다.

이미지_2024-07-25_182708419

2

기본 프로젝트 생성이 정상적으로 완료되면 새로운 브라우저 창에서 넥사크로 Demo 화면을 확인할 수 있습니다.

이미지_2024-07-25_182727996

프로젝트 DB Storage 증감

DB 컨테이너 생성 시 자동으로 할당되는 DB Storage는 운영 유지 보수 단계에서 백업 후 별도의 서비스 지원을 통해 제공됩니다.

디스크 용량 관리는 현재 클라우드 콘솔 및 KUBECTL(쿠버네티스 접속)을 통하여 진행할 수 있습니다.

자세한 적용 방법은 시스템 구축 시 별도로 문의해 주세요.