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

프로젝트 개요

[프로젝트 > 프로젝트 개요] 메뉴를 선택하여 사용자가 포함된 프로젝트 카드를 확인합니다.

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

이미지_2024-07-29_130947902

Running : 생성이 완료되어 사용할 수 있는 상태

Error : 생성 시 오류가 발생하여 사용할 수 없는 상태, 프로젝트 삭제 후 재 생성이 필요함

Stop : 정지되어 비활성화된 상태, Git Repository와 빌드 기능은 사용 가능하나 배포 기능은 사용할 수 없음

Creating : 생성 중인 상태, 생성 완료 후 Running 상태로 변경

Deleting : 삭제 중인 상태, 완전 삭제 시 리스트에서 삭제됨

프로젝트 카드에서는 프로젝트 이름과 프로젝트가 속한 스페이스 이름, 생성된 서버(컨테이너) 별 수, 사용 중인 리소스 현황, 상태 등 기본 정보를 확인할 수 있으며 권한에 따라 변경 관리할 수 있는 아이콘이 노출됩니다.

이미지_2024-07-29_131151444

1프로젝트의 상태를 확인합니다. 프로젝트 생성 상태에 따라 5개(Running, Error,Stop, Creating, Deleting)의 상태 값이 있습니다.

2프로젝트가 생성된 날짜와 시간을 확인합니다. 프로젝트 카드 목록은 생성일시 역순으로 기본 정렬되며 유저 팝업에서 정렬 순서를 변경할 수 있습니다.

3[프로젝트 관리] 버튼으로 프로젝트를 수정하거나 삭제할 수 있습니다.

4생성된 프로젝트 명칭을 확인합니다.

5프로젝트가 속한 스페이스의 명칭을 확인합니다.

6프로젝트 CPU의 현재 사용량을 확인합니다.

7프로젝트 Memory의 현재 사용량을 확인합니다.

8프로젝트 DB Storage의 현재 사용량을 확인합니다.

9프로젝트에 생성된 서버 별 수를 확인합니다.

프로젝트 카드는 프로젝트 참여자로 속한 사용자에게 노출되며 권한에 따라 프로젝트 카드 오른쪽 상단에 위치한 [프로젝트 관리] 버튼의 종류가 다릅니다.

이미지_2024-07-29_132332458

1프로젝트 관리자 : 톱니 바퀴 모양 아이콘으로 클릭 시 프로젝트 세부 메뉴 팝업을 오픈합니다.

2프로젝트 멤버 : 문서 모양의 아이콘으로 클릭 시 프로젝트 접속관리 화면으로 이동합니다.

3게스트 : 아이콘이 노출되지 않습니다.

프로젝트 구성

프로젝트 카드를 선택하여 상세정보를 확인하는 프로젝트 구성 메뉴로 이동합니다.

프로젝트 기본 정보

[기본 정보] 탭에서는 선택된 프로젝트의 기본 정보를 확인합니다.

이미지_2024-07-29_133104326

1프로젝트 ID, 이름, 상태, 생성 일시 등의 기본 정보와 프로젝트 관리자 목록을 확인합니다.

2선택된 프로젝트의 참여 권한(프로젝트 멤버, 게스트)의 사용자 목록을 확인합니다.

3[수정] 버튼 클릭 시 프로젝트 수정 화면으로 전환됩니다. 프로젝트 관리자에게만 노출됩니다.

컨테이너 정보

[컨테이너 정보] 탭에서는 프로젝트에 생성된 서버(컨테이너) 별 상세 정보를 확인합니다.

TobeDevOps에서는 프로젝트 생성 시 3 tier(Web, Was, DB) 구조로 사용할 수 있는 서버를 생성할 수 있으며 넥사크로에 최적화된 샘플이 포함됩니다.

서버(컨테이너) 명	배포 환경	설명
WEB	PRD	프로젝트 운영
	STG	프로젝트 검증
	DEV	프로젝트 개발
WAS	PRD	프로젝트 운영
	STG	프로젝트 검증
	DEV	프로젝트 개발
DB	PRD	프로젝트 검증, 운영 (PRD Master, Slave DB)
DB	DEV	프로젝트 개발 (DEV DB)

WEB과 WAS는 서버 별 운영(PRD), 검증(STG), 개발(DEV) 3개의 배포 환경이 자동으로 생성됩니다. 하지만 DB는 개발과 운영 2개의 배포 환경으로 자동 생성되며 이 중 운영 환경은 이중화(PRD-Primary, PRD-Secondary) 구성됩니다.

이미지_2024-07-29_134117196

1ID, 개발/운영 서비스 종류, Path, WEB의 GitLab과 배포 환경 별 연결 정보를 확인합니다.

2ID, 개발/운영 서비스 종류, Path, WAS의 GitLab과 배포 환경 별 연결 정보를 확인합니다.

3ID, 서비스 종류, 배포 환경 별 생성된 DB의 접속 정보를 확인합니다. ID와 PW는 권한에 따라 배포 환경에 노출되는 정보가 달라집니다.

4[수정] 버튼 클릭 시 프로젝트 수정 화면으로 전환됩니다. 프로젝트 관리자에게만 노출됩니다.

서버 정보 중 Resource 정보의 확장[▼] 버튼을 클릭하여 배포 환경 별 리소스 정보를 확인합니다.

이미지_2024-07-29_134716000

환경 정보

[환경정보] 탭에서는 커스텀 도메인 정보, CORS 정보 및 환경 변수 정보를 확인합니다.

이미지_2024-07-29_134832251

1사용자가 원하는 도메인으로 변경한 접속 도메인을 확인합니다.

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

3사용자가 추가한 환경 변수 정보를 확인합니다.

4[수정] 버튼 클릭 시 프로젝트 수정 화면으로 전환됩니다. 프로젝트 관리자에게만 노출됩니다.

추가 서비스

[추가 서비스] 탭에서는 프로젝트에 생성된 XENI 서버(컨테이너) 정보를 확인합니다.

TobeDevOps는 넥사크로에 최적화된 샘플이 기본 포함되며 샘플에서 파일 형태의 데이터 처리를 위해 XENI를 추가하여 엑셀 Export/Import 기능을 확인할 수 있습니다.

추가된 XENI 서버는 PRD(운영), 검증(STG), 개발(DEV) 3개의 배포 환경이 자동으로 생성됩니다.

서버(컨테이너) 명	배포 환경	설명
XENI	PRD	프로젝트 운영
	STG	프로젝트 검증
	DEV	프로젝트 개발

이미지_2024-07-29_140155518

1ID, 개발/운영 서비스 종류, Path, GitLab과 배포 환경 별 연결 정보를 확인합니다.

2프로젝트 관리자에게만 노출되는 버튼으로 수정 버튼 클릭 시 프로젝트 수정 화면으로 전환됩니다.

오토스케일링

[오토스케일링] 탭에서는 프로젝트 전체 리소스 사용 현황과 설정된 오토스케일링 정보를 확인합니다.

이미지_2024-07-29_141708377

1선택된 프로젝트와 포함된 스페이스 리소스 정보를 확인합니다.

2프로젝트에 구성된 서버의 배포 환경 별 할당량과 사용량 정보를 확인합니다.

3수정 버튼 프로젝트 관리자에게만 노출되는 버튼으로 수정 버튼 클릭 시 프로젝트 수정 화면으로 전환됩니다.

DB는 WEB, WAS, XENI 서버와 다른 별개의 Storage 정보에서 할당량과 사용량을 확인합니다.

리소스 사용 현황

이미지_2024-07-29_142255494

1컨테이너가 사용하는 리소스 종류로 CPU, Memory로 구분됩니다.

2스페이스에 최대로 할당될 수 있는 전체 리소스 값을 확인합니다.

3선택한 프로젝트의 할당량이 포함되지 않은 스페이스 잔여값을 확인합니다.

4생성된 서버 별 전체 할당량의 총 합을 확인합니다.

5선택한 프로젝트에 설정된 오토스케일링 MIN/MAX 값을 확인합니다.

6스페이스 가용량에서 현 프로젝트 할당량을 제외한 값으로 오토스케일링 적용되지 않았을 때의 스페이스 잔여값을 확인합니다.

7스페이스 가용량에서 현 프로젝트의 오토스케일링(MIN/MAX)이 적용되었을 때의 스페이스 잔여값을 확인합니다.

8DB에 구성된 배포 환경으로 개발, 운영으로 분류됩니다.

9DB 생성 시 적용된 사용 가능 값을 확인합니다.

10배포 환경 별 사용중인 값을 확인합니다.

11DB 이중화 여부를 확인합니다. 운영 환경의 DB는 생성 시 이중화 구조로 생성됩니다.

오토스케일링이 설정되기 전에는 상단의 초기 할당량을 기준으로 계산됩니다. 초기 할당량은 서버 구분에 따라 다르게 설정되며 WEB, WAS, XENI는 동일합니다.

오토스케일링 정보

이미지_2024-07-29_143659499

1프로젝트에 추가된 서버 별 정보를 확인합니다. DB는 생성 후 리소스 관련 정보를 변경할 수 없으므로 현재 사용중인 값만 확인할 수 있습니다.

2생성된 서버 ID를 확인합니다.

3서버의 배포 환경 별 정보를 확인합니다.

4배포 환경 별 사용중인 리소스 값을 Replica, CPU, Memory로 확인합니다.

5각 배포 환경에 할당된 값을 확인합니다.

6각 배포 환경에서 사용할 수 있는 최대 값을 확인합니다.

7배포 환경 별 Resource Request 값이 스케일 인/아웃 되는 기준 값을 %로 확인합니다.

8스케일 인/아웃 시 사용할 수 있는 최소/최대 pod 수를 확인합니다.

프로젝트 접속 관리

프로젝트에 생성된 서버(컨테이너) 내부에 직접 접근하거나 외부에서 사용 가능한 DB 접속 정보를 관리합니다. 프로젝트 권한에 따라 접근 방법이 달라지며 게스트 권한은 접속 관리 메뉴를 사용할 수 없습니다.

이미지_2024-07-29_144152661

1프로젝트 멤버 : 문서 모양 버튼을 클릭하여 프로젝트 접속 관리 화면으로 이동합니다.

2프로젝트 관리자 : 톱니 바퀴 모양을 클릭하여 열린 팝업 중 [프로젝트 접속 관리]를 선택하여 해당 화면으로 이동합니다.

서버(컨테이너) Shell 및 Log 확인

프로젝트 개발 시 서버의 배포 환경 별 생성된 pod의 Shell 접속과 로그 확인을 포털을 통해 사용할 수 있습니다.

서버의 상세 정보 확장[▼] 버튼을 클릭하여 배포 환경 별 정보를 확인합니다.

이미지_2024-07-29_144708796

Shell 접속하기

접속할 배포 환경의 [Shell > Open] 버튼을 클릭하여 동작중인 pod 목록을 확인하고 pod ID를 선택하여 접속할 수 있습니다. 선택한 pod의 Shell 접속은 브라우저 새 창을 통해 확인할 수 있습니다.

이미지_2024-07-29_145015464

pod ID 값은 [TobeDevOps - ArgoCD 연동 규칙]에서 확인할 수 있습니다.

Log 확인하기

접속할 배포 환경의 [Log > View] 버튼을 클릭하여 pod 목록을 확인하고 pod ID를 선택하여 로그를 확인할 수 있습니다. 선택한 pod의 Log는 브라우저 새 창을 통해 확인할 수 있습니다.

이미지_2024-07-29_145207274

이미지_2024-07-29_145220288

DB Port Forwarding

생성된 DB의 Port Forwarding을 설정하여 외부에서 접근할 수 있습니다. DB의 Port Forwarding 생성은 프로젝트 관리자만 사용할 수 있습니다.

이미지_2024-07-29_145930198

DB를 구성하는 pod(DEV, PRD-Secondary, PRD-Primary) 별 Host와 Port를 갖는 Port Forwarding을 생성할 수 있습니다. 단, 새로운 접속 정보는 기존 접속이 종료 후 다시 생성할 수 있습니다.

종료 일시를 지정하여 외부에서 접근할 수 있는 Host url과 port를 생성합니다. 종료 일시의 달력 이미지를 클릭하여 오픈 된 팝업 화면에서 종료 날짜와 시간을 입력하고 확인을 클릭합니다.

이미지_2024-07-29_150132582

종료 일시를 확인하고 Port Forwarding [Create] 버튼을 클릭하여 외부에서 사용할 수 있는 Host와 port를 생성합니다.

이미지_2024-07-29_150213568

DataBase 접속 정보

Port Forwarding을 통해 생성한 외부 접속 정보(Host, Port, 접속 가능 일시)를 확인합니다.

이미지_2024-07-29_150301269

생성된 외부 접속 정보는 종료 일시 전 종료(EXIT) 버튼을 클릭하여 강제 접속 종료할 수 있습니다.

프로젝트 수정

프로젝트 항목별 상세 내역을 수정할 수 있습니다. 프로젝트 수정은 관리자만 사용할 수 있는 메뉴로 프로젝트 관리자 외 권한은 수정 메뉴가 노출되지 않습니다.

이미지_2024-07-29_150443063

1좌측 메뉴에서 [프로젝트 > 프로젝트 개요]를 선택하여 프로젝트 개요 화면으로 이동합니다.

2프로젝트 카드의 톱니 모양 아이콘을 클릭하여 세부 메뉴 팝업을 오픈합니다.

3프로젝트 세부 메뉴 팝업 중 [프로젝트 수정]을 선택하여 해당 화면으로 이동합니다.

프로젝트 수정은 각 상세 정보 화면 오른쪽 하단의 [수정]버튼을 클릭하여 이동한 화면과 동일합니다.

프로젝트 기본 정보 수정

[기본 정보] 탭에서는 선택된 프로젝트의 기본 정보를 수정할 수 있습니다.

이미지_2024-07-29_150836044

1선택된 프로젝트의 이름, 관리자 및 상태를 변경할 수 있습니다.

2프로젝트에 포함될 멤버를 추가하거나 삭제할 수 있습니다.

3[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.

4[저장] 버튼 클릭 시 변경된 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.

프로젝트 기본 수정에서는 프로젝트 상태를 변경할 수 있습니다. 프로젝트 상태는 활성, 정지 두 가지 상태가 있으며 변경 시 일부 시간(약 5분)이 소요됩니다.

프로젝트에 DB 서버만 추가되어 있으면 정지할 수 없습니다.

이미지_2024-07-29_151216379

1프로젝트 정지 상태 변경 가능 : DB 외 모든 서비스 서버의 배포가 중단됩니다.

2프로젝트 정지 상태 변경 불가 : DB 서버는 배포를 중단할 수 없으므로 DB만 존재할 경우 프로젝트를 정지할 수 없습니다.

컨테이너 정보 수정

[컨테이너 정보]탭 에서는 프로젝트에 생성된 서버(컨테이너)를 추가, 삭제, 수정할 수 있습니다. 단, DB는 프로젝트 당 MAX 1개만 생성할 수 있습니다.

이미지_2024-07-29_151559707

1WEB/WAS 서버(컨테이너)를 추가/삭제하거나 Path 정보 및 Resource 설정을 변경할 수 있습니다.

2프로젝트에 생성된 DB는 삭제만 가능합니다.

3[취소] 버튼을 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.

4[저장] 버튼 클릭 시 변경 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.

서버 추가는 쿠버네티스에서 처리되므로 일정 시간이 소요됩니다.

서버(컨테이너) Path 변경

이미 생성된 서버의 Path 값을 변경할 수 있습니다. ID, 개발 및 운영 서비스는 새로 추가할 때만 설정할 수 있습니다.

이미지_2024-07-29_152140101

WEB 서버의 Path 변경 시(web -> web2) 배포 환경 별 연결 정보가 변경됩니다.

이미지_2024-07-29_153115075

모든 서버의 ID, Path 값은 중복이 허용되지 않습니다. 프로젝트에서 기존에 사용되지 않은 값으로만 설정할 수 있습니다.

서버(컨테이너) 추가

서버 정보 하단에 위치한 추가[+] 버튼을 클릭하여 새로운 서버를 생성합니다. 단, DB는 이미 생성된 경우 추가할 수 없으므로 DB가 존재하지 않은 경우만 추가 버튼이 노출됩니다.

이미지_2024-07-29_153339881

추가된 서버의 ID, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.

이미지_2024-07-29_153754720

서버(컨테이너) 삭제

추가된 서버 별 정보 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 삭제할 수 있습니다.

이미지_2024-07-29_153901907

삭제 버튼 클릭 시 삭제하는 ID를 확인하는 팝업이 오픈됩니다.

이미지_2024-07-29_154042835

삭제할 서버(컨테이너)의 ID 값을 입력해야 삭제 버튼이 활성화되며, 삭제 버튼 클릭 시 별도의 저장 과정이 필요하지 않으나 쿠버네티스에서 처리되어 일정 시간이 소요됩니다.

서버(컨테이너) Resource 설정

서버 별 Resource 설정 확장[▼] 버튼을 클릭하여 Resource 값을 변경합니다.

이미지_2024-07-29_154336466

DB는 생성 시에만 Resource 설정할 수 있어 생성 후 사용자가 리소스를 임의로 변경할 수 없습니다. DB 서버의 Resource는 삭제 후 새로운 DB를 추가하여 설정해 주세요

배포 환경 별 Resource Request(리소스 할당량) 값과 Resource Limit(리소스 최대 사용값) 값을 설정합니다.
Resource Request는 Resource Limit 이상 설정할 수 없으며 Request값과 Limit 값 모두 상단에 표기된 Max 값 미만으로 설정 가능합니다.

이미지_2024-07-29_154456118

DB 서버는 리소스를 임의로 변경할 수 없어 입력창이 활성화되지 않습니다.

WEB과 WAS 서버는 별도의 Storage를 사용할 수 있습니다. Storage 정보의 사용 체크박스를 선택하면 저장소 타입과 마운드 경로가 활성화 되어 설정할 수 있습니다.

Storage 저장소 타입을 선택하고 마운트 경로를 입력합니다.

이미지_2024-07-29_154623599

선택한 저장소 타입에 따라 제공 가능한 용량이 달라지며 Storage 마운트 경로는 반드시 ‘/’로 시작해야합니다.

환경정보 수정

[환경정보] 탭에서는 커스텀 도메인, CORS 정보 및 환경 변수를 수정하거나 추가할 수 있습니다.

이미지_2024-07-29_154826357

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

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

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

4[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.

5[저장] 버튼 클릭 시 변경된 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.

환경변수 추가

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

이미지_2024-07-29_155221098

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

환경변수 삭제

생성된 환경 변수 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 환경 변수를 삭제합니다.

이미지_2024-07-29_155339747

삭제 버튼 클릭 시 별도의 알림 창이 노출되지 않으며 해당 목록에서 바로 삭제됩니다.

추가서비스 수정

[추가서비스] 탭에서는 TobeDevOps에서 제공하는 추가 서비스를 관리합니다. 현재는 클라이언트(넥사크로)에서 파일 형태의 데이터 처리를 위한 XENI 서비스만 제공합니다.

이미지_2024-07-29_155436056

1XENI 서버의 Path 값을 변경할 수 있습니다. 단, Path는 프로젝트 내 사용 이력이 없는 값만 사용할 수 있습니다.

2서버 정보 하단에 위치한 추가[+] 버튼을 클릭하여 새로운 XENI 서버를 생성합니다. 추가된 서버의 ID, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.

3서버 정보 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 생성된 서버를 삭제합니다. 삭제 버튼 클릭 시 서버(컨테이너) ID 확인 팝업이 노출되며 삭제할 ID 값을 입력해야 삭제 버튼이 활성화됩니다.

4[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.

5[저장] 버튼 클릭 시 변경 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.

오토스케일링 수정

[오토스케일링] 탭에서는 리소스 Resource Request값과 Resource Limit값 그리고 배포 환경 별 오토스케일 설정 값을 변경할 수 있습니다. 변경한 값의 합이 스페이스 잔여량을 초과하지 않도록 오토스케일링 입력 시 주의가 필요하며 DB는 오토스케일링 설정이 불가합니다.

배포 환경 별 오토스케일링 정보가 수정되면 리소스 사용 현황 정보에 프로젝트 오토스케일링 설정량과 스페이스 잔여량이 자동으로 계산되어 반영됩니다.

이미지_2024-07-29_155923078

1선택된 프로젝트의 리소스 정보를 확인합니다.

2프로젝트에 구성된 서버의 배포 환경 별 할당량과 사용량 정보를 확인합니다.

3[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.

4[저장] 버튼 클릭 시 변경 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.

Resorce Request 관리

Resource Request는 배포 환경 별 할당된 값으로 오토스케일링 설정 시 Resource 임계치의 기준이 되며 Resource Request는 Resource Limit 값을 초과하여 입력할 수 없습니다.

배포 환경 별 실제 사용량이 Resource Request 값의 Resource 임계치 이상이 될 경우 pod 수가 Replica MAX 값까지 자동으로 늘어납니다.
반대로 사용량이 Resource Request의 Resource 임계치 이하가 될 경우 pod 수가 Replica MIN 값까지 자동으로 줄어듭니다.

Resorce Limit 관리

Resource Limit는 배포 환경 별 사용할 수 있는 최대 값으로 오토스케일링 설정된 각 배포 환경 별 최대 Resource Limit는 설정된 Resource Limit Max 값 미만으로 입력할 수 있습니다. (Resource Limit Max 값은 오토스케일링 영역 우측 상단에 표기되어 있습니다.)

오토스케일링 관리

오토스케일링 설정 시 스페이스 잔여량이 남지 않은 경우이거나 오토스케일링 입력 규칙이 맞지 않으면 값을 변경할 수 없습니다.

스페이스 오토스케일링 MAX 값이 0 또는 음수 값 일 때 경고 팝업이 노출됩니다.

이미지_2024-07-29_160616144

입력 규칙이 맞지 않으면 값 변경 시 오류 시 메시지가 노출됩니다.

이미지_2024-07-29_160649391

1Resource 임계치 혹은 Replica 값을 설정할 때에는 모든 정보를 설정해야 합니다.

2Replica의 MIN 값은 MAX 값보다 크게 설정할 수 없습니다.

프로젝트 삭제

생성된 프로젝트를 삭제할 수 있습니다. 프로젝트 삭제는 프로젝트 관리자만 사용할 수 있는 메뉴로 프로젝트 관리자 외 권한에게는 삭제 메뉴가 노출되지 않습니다.

이미지_2024-07-29_160811526

1좌측 메뉴에서 [프로젝트 > 프로젝트 개요]를 선택하여 프로젝트 개요 화면으로 이동합니다.

2프로젝트 카드의 톱니 모양 아이콘 클릭하여 세부 메뉴 팝업을 오픈합니다.

3프로젝트 세부 메뉴 팝업 중 [프로젝트 삭제]를 선택하여 해당 프로젝트를 삭제합니다.

삭제 버튼 클릭 시 삭제할 프로젝트의 ID 값을 확인합니다.

이미지_2024-07-29_161412313

ID 입력 후 삭제 버튼이 활성화되며 삭제 버튼 클릭 시 쿠버네티스에서 처리되므로 일정 시간이 소요됩니다. 프로젝트가 완전히 삭제될 때까지 Deleting 상태로 변경됩니다.

프로젝트가 문제 없이 삭제될 경우 더 이상 포털에서는 확인할 수 없지만 Git Repository는 유지됩니다.

프로젝트 내 생성된 서버가 있을 경우 프로젝트를 삭제할 수 없습니다.

이미지_2024-07-29_161803975

프로젝트에 서버(컨테이너)가 포함되어 있으면 삭제할 수 없습니다. 포함된 세부 구성을 모두 삭제 후 진행해 주세요.

넥사크로 Demo 사용 설명

TobeDevops에서는 프로젝트의 Web 서버 추가 시 넥사크로 Demo가 포함되어 빠른 개발 환경을 구축할 수 있습니다. 단, 넥사크로 Demo 사용을 위해서는 서비스 호출을 위한 필수 설정정보 세팅이 필요합니다.

프로젝트 생성 후 필수 설정정보 세팅

프로젝트 생성 시 기본으로 제공되는 넥사크로 샘플의 정상 동작을 위해서는 필수 설정 정보를 세팅해야 하며 배포 환경에 따라 설정 정보가 달라집니다.

배포 환경 별 접근 권한이 달라집니다. 프로젝트 접근의 상세 정보는 프로젝트 권한 종류 에서 확인해 주세요.

DEV 개발 환경 설정정보 세팅

서비스(X-API) 연결 주소 설정

프로젝트에 생성된 넥사크로 샘플의 서비스 호출 주소를 WAS 서버의 접속 주소로 설정합니다.

[프로젝트 구성 > 컨테이너 정보 > WAS 구분 > 개발 환경의 URL 주소]를 확인합니다.

이미지_2024-07-29_164110694

[컨테이너 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.

이미지_2024-07-29_164137066

WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.

이미지_2024-07-29_164217363

넥사크로 샘플의 WAS 서비스 변수 값을 앞서 확인한 WAS 서버의 접속 주소로 설정하여 서비스를 호출할 수 있습니다.

Variable ID	개발환경	접속 URL
svc_dev	DEV	https://dev-apps.tobedevops.link/[space id]/[project id]/was

변수의 초기 값 수정 후 Commit Changes하여 변경을 완료합니다.

이미지_2024-07-29_164538583

DB 접속 정보 설정

프로젝트에 생성된 DB 연동을 위해 DB 접속 정보를 설정합니다.

[프로젝트 구성 > 컨테이너 정보 > DB 구분 > 개발 환경의 DB PW]를 확인합니다.

이미지_2024-07-29_164652953

DB 접속 정보 환경 변수를 추가하기 위해 [프로젝트 개요 > 프로젝트 관리 버튼 > 프로젝트 수정] 화면으로 이동합니다.

이미지_2024-07-29_164721056

프로젝트 수정 메뉴의 [환경 정보] 탭에서 [환경변수정보 > 추가] 버튼을 클릭합니다.

이미지_2024-07-29_164951174

추가된 환경 변수 행에 DB PW를 다음과 같은 Key-Value 값에 맞춰 입력 후 저장합니다.

Key	Value
DB_DEV_PW	[DEV DB PW]

키 값은 반드시 [DB_DEV_PW] 로 입력하고 Value 값에 패스워드 값을 입력합니다.

이미지_2024-07-29_165328920

XENI 연결 주소 설정

추가서비스로 제공되는 XENI 사용 시 XENI 접속 주소를 설정합니다.

[프로젝트 구성 > 추가서비스 > XENI 구분 > 개발 환경의 URL]을 확인합니다.

이미지_2024-07-29_165752404

[컨테이너 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.

이미지_2024-07-29_171239403

WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.

이미지_2024-07-29_171340403

넥사크로 샘플의 XENI 서비스 변수를 앞서 확인한 XENI URL 주소로 설정하여 서비스를 호출할 수 있습니다.

Variable ID	개발환경	접속 URL
xeni_dev	DEV	https://dev-apps.tobedevops.link/[space id]/[project id]/xeni

변수의 초기값 수정 후 Commit Changes하여 변경을 완료합니다.

이미지_2024-07-29_171508006

STG, PRD 개발 환경 설정정보 세팅

서비스(X-API) 연결 주소 설정

프로젝트에 생성된 넥사크로 샘플의 서비스 호출 주소를 WAS 접속 주소로 설정합니다.

[프로젝트 구성 > 컨테이너 정보 > WAS 구분 > STG, PRD 개발 환경의 URL]을 확인합니다.

이미지_2024-07-29_171650852

[컨테이너 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.

이미지_2024-07-29_171820978

WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.

이미지_2024-07-29_171939416

넥사크로 샘플의 검증, 운영 WAS 서비스 변수 값을 앞서 확인한 WAS 서버의 접속 주소로 설정하여 서비스를 호출할 수 있습니다.

Variable ID	개발환경	접속 URL
svc_stg	STG	https://stg-apps.tobedevops.link/[space id]/[project id]/was
svc_app	PRD	https://apps.tobedevops.link/[space id]/[project id]/was

변수의 초기 값 수정 후 Commit Changes하여 변경을 완료합니다.

이미지_2024-07-29_172205260

DB 접속 정보 설정

프로젝트에 생성된 DB 연동을 위해 접속 정보를 설정합니다.

[프로젝트 구성 > 컨테이너 정보 > DB 구분 > PRD-PRIMARY, PRD-SECONDARY의 DB ID&PW] 정보를 확인합니다.

이미지_2024-07-29_172335912

[컨테이너 정보 > WAS 구분 > GIT URL] 주소를 클릭하여 WAS의 Git Repository로 이동합니다.

이미지_2024-07-29_172416318

WAS의 Repository 브랜치를 개발 브랜치로 선택하고 검증, 운영 환경 별 생성된 yml 파일을 편집 모드로 전환하여 수정합니다.

이미지_2024-07-29_172542194

넥사크로 샘플의 DB 접속 정보를 앞서 확인한 PRD-PRIMARY, PRD-SECONDARY의 DB ID&PW로 설정하여 DB를 연결할 수 있습니다.

개발 환경	편집 파일명	DB 명	DB Container ID
STG	application_stg.yml	DB_PRD_MASTER	PRD-PRIMARY
STG	application_stg.yml	DB_PRD_SLAVE	PRD-SECONDARY
PRD	application_prd.yml	DB_PRD_MASTER	PRD-PRIMARY
PRD	application_prd.yml	DB_PRD_SLAVE	PRD-SECONDARY

application_stg.yml, application_prd.yml 작성 방법

이미지_2024-07-29_172809906

변수 설정 완료 후 Commit Changes하여 변경을 완료합니다.

DB는 운영 환경에만 이중화 되어 PRD-PRIMARY, PRD-SECONDARY로 생성됩니다. Git에서 사용되는 검증과 운영 환경에 동일한 DB 정보를 설정합니다.

XENI 연결 주소 설정

추가서비스로 제공되는 XENI 사용 시 XENI 접속 주소를 설정합니다.

[프로젝트 구성 > 추가서비스 > XENI 구분 > 검증, 운영 환경의 URL]을 확인합니다.

이미지_2024-07-29_173745371

[컨테이너 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.

이미지_2024-07-29_173926884

WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.

이미지_2024-07-29_174052629

넥사크로 샘플의 STG, PRD 환경 별 XENI 서비스 변수를 앞서 확인한 XENI URL 주소로 설정하여 서비스를 호출할 수 있습니다.

Variable ID	개발환경	접속 URL
xeni_stg	STG	https://stg-apps.tobedevops.link/[space id]/[project id]/xeni
xeni_app	PRD	https://apps.tobedevops.link/[space id]/[project id]/xeni

변수의 초기값 수정 후 Commit Changes하여 변경을 완료합니다.

이미지_2024-07-29_174222755

위와 같은 과정을 통해 각 배포 환경(DEV, STG, PRD)의 설정을 완료하면 제공된 넥사크로 샘플을 정상적으로 사용할 수 있습니다.

넥사크로 샘플은 기본적인 데이터 송/수신 처리 기능이 포함되어 있습니다.

데이터 송/수신 처리 샘플은 넥사크로 X-API를 사용한 샘플과 X-API를 사용하지 않은 JSON 통신 샘플이 제공됩니다.

X-API 사용

서버와 넥사크로 데이터 처리를 위해 필요한 기능을 제공하는 X-API는 서버 모듈 형태로 제공되며 데이터 처리, 첨부파일, Excel 파일 업로드/다운로드 기능에 X-API가 사용됩니다

데이터 처리

DB 데이터를 조회하고 수정된 데이터를 저장합니다. 화면의 데이터는 각 컬럼 별로 검색하여 사용할 수 있도록 구성되어 있습니다. 제공된 샘플의 Transaction 함수는 서비스 호출 시 X-API가 사용됩니다.

이미지_2024-07-29_174644874

첨부파일

제공된 샘플은 FileUpTransfer, FileDownTransfer 오브젝트를 사용하여 파일을 업/다운로드합니다. 파일 전송/저장 후 파일 정보 Dataset으로 반환할 때 X-API가 사용됩니다.

이미지_2024-07-29_174735127

Excel Export/Import

XENI 서버 추가 시 엑셀에 포함된 데이터를 그리드 컴포넌트로 가져오거나 그리드에 연결된 데이터를 엑셀로 내보냅니다.

제공된 샘플은 ExcelImportObject/ExcelExportObject 오브젝트를 사용하며 엑셀 데이터와 Dataset 데이터의 변환 처리 시 nexacro-xeni API가 사용됩니다.

이미지_2024-07-29_174848767

Non X-API 사용

서버와 넥사크로의 JSON 통신를 위해 X-API를 사용하지 않은 샘플로 데이터 처리, 첨부파일 기능을 확인할 수 있습니다. 화면의 Dataset 정보를 JSON Object로 변환하여 통신합니다.

데이터 처리

DB 데이터를 조회하고 수정된 데이터를 저장합니다. 화면의 데이터는 각 컬럼 별로 검색하여 사용할 수 있도록 구성되어 있습니다. 제공된 샘플에서 JSON 통신을 위해 사용한 DataObject의 request 함수는 X-API를 사용하지 않습니다.

이미지_2024-07-29_181217244

데이터 처리 방법은 프로젝트 내 lib 폴더 > JsonTransaction.xjs 파일을 참고해 주세요.

첨부파일

제공된 샘플은 FileUpTransfer, FileDownTransfer 오브젝트를 사용하였으며 파일을 전송하거나 파일을 다운로드합니다.

업/다운로드 한 파일 정보를 JSON 형태로 변환하여 처리합니다.

이미지_2024-07-29_181238095