프로젝트란 가상공간인 스페이스 하위에 생성할 수 있는 최소 관리단위로 하나의 스페이스에는 여러개의 프로젝트를 추가하여 사용할 수 있습니다.
프로젝트 개요
[프로젝트 > 프로젝트 개요] 메뉴를 선택하여 사용자가 포함된 프로젝트 목록을 확인합니다.
화면 상단에 프로젝트 구분 탭을 사용하여 상태 별 프로젝트 목록을 확인할 수 있으며 기본 상태 값은 [Running]입니다. 그 외 Creating, Deleting 상태는 [All] 탭 선택 시 전체 프로젝트 목록에서 확인할 수 있습니다.
이미지_2024-07-29_130947902
프로젝트 목록은 프로젝트 상태 및 조건을 검색하여 사용할 수 있습니다.
사용 방법은 공통 그리드를 참고해 주세요.
프로젝트 목록에서는 프로젝트 이름, 상태, 사용 중인 CPU, 메모리 현황 등 기본 정보를 확인합니다.
이미지_2024-07-29_131151444
1내가 포함된 프로젝트를 즐겨찾기하여 사용할 수 있습니다.
2생성된 프로젝트가 속한 스페이스 명칭입니다.
3생성된 프로젝트가 속한 스페이스 아이디입니다.
4생성된 프로젝트 명칭입니다.
5생성된 프로젝트 아이디입니다.
6프로젝트 상태입니다. 프로젝트 생성 상태에 따라 5개(Running, Error, Stop, Creating, Deleting)의 상태 값이 있습니다.
7프로젝트 CPU의 현재 사용량입니다.
8프로젝트 Memory의 현재 사용량입니다.
9프로젝트 DB Storage의 현재 사용량입니다.
10프로젝트 관리자를 아이콘으로 확인합니다.
11프로젝트가 생성된 날짜와 시간입니다. 프로젝트 목록은 생성 일시 역순으로 정렬됩니다.
Running : 생성이 완료되어 사용할 수 있는 상태
Error : 생성 시 오류가 발생하여 사용할 수 없는 상태, 프로젝트 삭제 후 재 생성이 필요함
Stop : 정지되어 비활성화된 상태, Git Repository와 빌드 기능은 사용 가능하나 배포 기능은 사용할 수 없음
Creating : 생성 중인 상태, 생성 완료 후 Running 상태로 변경
Deleting : 삭제 중인 상태, 완전 삭제 시 리스트에서 삭제됨
프로젝트 구성
프로젝트 목록을 선택하면 하단에서 선택된 프로젝트의 세부 정보를 탭 별로 확인할 수 있습니다.
기본정보
선택된 프로젝트의 참여 권한(프로젝트 관리자, 멤버, 게스트)의 사용자 목록을 확인합니다.
이미지_2024-07-29_133104326
1프로젝트 아이디, 이름, 상태, 생성 일시 등의 기본 정보와 프로젝트 관리자 목록을 확인합니다.
2선택된 프로젝트의 참여 권한(프로젝트 멤버, 게스트)의 사용자 목록을 확인합니다.
서버정보
선택된 프로젝트에 생성된 서버 별 세부 정보를 확인합니다.
TobeDevOps에서는 프로젝트 생성 시 3 tier(Web, Was, DB) 구조로 사용할 수 있는 서버를 생성할 수 있으며 넥사크로에 최적화된 샘플이 포함됩니다.
서버명 | 배포 환경 | 설명 |
|---|---|---|
WEB | PRD | 프로젝트 운영용 웹 서버 환경 |
STG | 프로젝트 검증용 웹 서버 환경 | |
DEV | 프로젝트 개발용 웹 서버 환경 | |
WAS | PRD | 프로젝트 운영용 웹 애플리케이션 서버 환경 |
STG | 프로젝트 검증용 웹 애플리케이션 서버 환경 | |
DEV | 프로젝트 개발용 웹 애플리케이션 서버 환경 | |
DB | PRD | 프로젝트 운영용 DB 환경 (Master, Slave DB 이중화) |
DEV | 프로젝트 개발용 DB 환경 |
WEB과 WAS는 서버 별 운영(PRD), 검증(STG), 개발(DEV) 3개의 배포 환경이 자동으로 생성됩니다. 하지만 DB는 개발과 운영 2개의 배포 환경으로 자동 생성되며 이 중 운영 환경은 이중화(PRD-Primary, PRD-Secondary) 구성됩니다.
이미지_2024-07-29_134117196
1WEB 서버의 아이디, 개발/운영 서비스 종류, Path, GitLab과 배포 환경 별 연결 정보를 확인합니다.
2WAS 서버의 아이디, 개발/운영 서비스 종류, Path, GitLab과 배포 환경 별 연결 정보를 확인합니다.
3DB 서버의 개발/운영 서비스 종류와 접속 정보를 확인합니다. ID와 PW는 권한에 따라 배포 환경에 노출되는 정보가 달라집니다.
서버 정보 중 Resource 정보의 확장[▼] 버튼을 클릭하면 배포 환경 별 리소스 정보를 확인할 수 있습니다.
이미지_2024-07-29_134716000
환경정보
선택된 프로젝트의 커스텀 도메인 정보, CORS 정보 및 환경 변수 정보를 확인합니다.
이미지_2024-07-29_134832251
1사용자가 설정한 커스텀 도메인을 확인합니다.
2커스텀도메인 변경 시 서버 간의 리소스 공유를 위한 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유) 정보를 확인합니다.프로젝트에서 사용하는 환경 변숫값을 확인합니다.
추가정보
선택된 프로젝트에 생성된 XENI 서버 정보를 확인합니다.
TobeDevOps는 넥사크로에 최적화된 샘플이 기본 포함되며 샘플에서 파일 형태의 데이터 처리를 위해 XENI를 추가하여 엑셀 Export/Import 기능을 확인할 수 있습니다.
추가된 XENI 서버는 PRD(운영), 검증(STG), 개발(DEV) 3개의 배포 환경이 자동으로 생성됩니다.
서버 명 | 배포 환경 | 설명 |
|---|---|---|
XENI | PRD | 프로젝트 운영용 XENI 웹 애플리케이션 서버 환경 |
STG | 프로젝트 검증용 XENI 웹 애플리케이션 서버 환경 | |
DEV | 프로젝트 개발용 XENI 웹 애플리케이션 서버 환경 |
XENI 서버의 아이디, 개발/운영 서비스 종류, Path, GitLab과 배포 환경 별 연결 정보를 확인합니다.
이미지_2024-07-29_140155518
오토스케일링
선택된 프로젝트에서 사용중인 리소스 현황과 설정된 오토스케일링 정보를 확인합니다.
이미지_2024-07-29_141708377
1선택된 프로젝트와 스페이스 리소스 정보를 확인합니다.
2프로젝트에 구성된 서버의 배포 환경 별 할당량과 사용량 정보를 확인합니다.
서버의 상세 정보 확장[▼] 버튼을 클릭하여 배포 환경 별 정보를 확인합니다.
프로젝트15
DB는 WEB, WAS, XENI 서버와 다른 별개의 Storage 정보에서 할당량과 사용량을 확인합니다.
프로젝트 접속관리
프로젝트에 생성된 서버 내부에 직접 접근하거나 외부에서 사용 가능한 DB 접속 정보를 관리합니다.
선택된 프로젝트의 설정 버튼 목록에서 문서 모양 아이콘을 클릭하여 프로젝트 접속관리 화면으로 이동하며 게스트 권한은 접속 관리 아이콘이 노출되지 않습니다.
이미지_2024-07-29_144152661
서버 접속관리
프로젝트 개발 시 서버의 배포 환경 별 생성된 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를 선택하여 로그를 확인할 수 있습니다. 선택한 서버 환경의 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, 접속 가능 일시)를 확인합니다. 생성된 외부 접속 정보는 종료 일시 전 종료(EXIT) 버튼을 클릭하여 강제 접속 종료할 수 있습니다.
이미지_2024-07-29_150301269
프로젝트 수정
프로젝트 항목별 상세 내역을 수정할 수 있습니다. 프로젝트 수정은 프로젝트 관리자만 사용할 수 있는 메뉴로 이외의 권한은 수정 메뉴가 노출되지 않습니다.
선택된 프로젝트의 설정 버튼 목록에서 연필 모양 아이콘을 클릭하여 프로젝트 수정 화면으로 이동합니다.
이미지_2024-07-29_150443063
프로젝트 수정은 개요 화면에서 선택된 상세 정보 탭과 동일한 수정 탭으로 이동합니다.
만약 프로젝트 개요 화면의 기본 정보 탭에서 수정 버튼을 클릭하면 기본 정보 수정 탭으로 이동하고 서버 정보 탭에서는 서버 정보 수정 탭으로 이동합니다.
기본 정보 수정
[기본정보] 탭에서는 선택된 프로젝트의 기본 정보를 수정할 수 있습니다.
이미지_2024-07-29_150836044
1선택된 프로젝트의 이름, 관리자 및 상태를 변경할 수 있습니다.
2프로젝트에 포함될 멤버를 추가하거나 삭제할 수 있습니다.
3[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.
4[저장] 버튼 클릭 시 변경된 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.
선택된 탭의 정보가 변경되면 저장 버튼이 활성화됩니다. 만약 정보 변경 중 탭이나 메뉴를 이동하면 확인 팝업이 노출되고 [이동] 버튼 클릭 시 변경한 정보는 초기화 됩니다.
프로젝트 수정3
프로젝트 기본 수정에서는 프로젝트 상태를 변경할 수 있습니다. 프로젝트 상태는 활성, 정지 두 가지 상태가 있으며 변경 시 일부 시간(약 5분)이 소요됩니다.
프로젝트 수정2
프로젝트 정지 시 모든 서버의 배포가 중단됩니다. 단, DB 서버는 배포를 중단할 수 없으므로 프로젝트에 DB 서버만 추가되어 있으면 정지 상태 변경이 불가합니다.
이미지_2024-07-29_151216379
1프로젝트 정지 상태 변경 가능
2프로젝트 정지 상태 변경 불가
서버 정보 수정
[서버정보] 탭 에서는 프로젝트에 생성된 서버를 추가, 삭제, 수정할 수 있습니다. 단, DB는 프로젝트 당 MAX 1개만 생성할 수 있습니다.
이미지_2024-07-29_151559707
1WEB/WAS 서버를 추가/삭제하거나 Path 정보 및 Resource 설정을 변경할 수 있습니다.
2프로젝트에 생성된 DB는 삭제만 가능합니다.
3[취소] 버튼을 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.
4[저장] 버튼 클릭 시 변경 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.
서버 추가는 쿠버네티스에서 처리되므로 일정 시간이 소요됩니다.
서버 경로 변경
이미 생성된 서버의 Path 값을 변경할 수 있습니다. 아이디와 개발 및 운영 서비스는 새로 추가할 때만 설정할 수 있습니다.
이미지_2024-07-29_152140101
WEB 서버의 Path 변경 시(web -> web2) 배포 환경 별 연결 정보가 변경됩니다.
이미지_2024-07-29_153115075
모든 서버의 아이디와 Path 값은 중복이 허용되지 않으며 프로젝트에 사용되지 않은 값으로만 설정할 수 있습니다.
서버 추가
서버 정보 하단에 위치한 추가[+] 버튼을 클릭하여 새로운 서버를 생성합니다. 단, DB는 이미 생성된 경우 추가할 수 없으므로 DB가 존재하지 않은 경우만 추가 버튼이 노출됩니다.
이미지_2024-07-29_153339881
추가된 WEB과 WAS 서버의 아이디, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.
이미지_2024-07-29_153754720
DB 서버의 개발 및 운영 환경 서비스는 필수 입력 정보입니다. 서비스 선택 시 DB 서버의 아이디는 자동으로 입력됩니다.
프로젝트 수정9
서버 삭제
추가된 서버 별 정보 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 삭제할 수 있습니다.
이미지_2024-07-29_153901907
삭제 버튼 클릭 시 삭제하는 서버의 아이디를 확인하는 팝업이 오픈됩니다.
이미지_2024-07-29_154042835
삭제할 서버의 아이디 값을 입력해야 삭제 버튼이 활성화되며 삭제 후 별도의 추가 저장이 필요하지 않습니다. 단, 서버 삭제는 쿠버네티스 처리되므로 일정 시간이 소요됩니다.
서버 Resource 설정
서버 별 Resource 설정 확장[▼] 버튼을 클릭하여 Resource 값을 변경합니다.
이미지_2024-07-29_154336466
DB는 생성 시에만 Resource 설정할 수 있어 생성 후 사용자가 리소스를 임의로 변경할 수 없습니다. DB 서버의 Resource를 변경하고자 하는 경우 DB 서버 삭제 후 새로운 DB를 추가하여 설정해 주세요
배포 환경 별 Resource Request/Limit값을 설정합니다. Request는 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사용자가 원하는 커스텀 도메인을 설정합니다. 변경된 정보는 서버의 PRD 환경의 접속 주소로 변경됩니다.
2커스텀 도메인 변경 시 서버 간의 리소스 공유 위한 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유) 정보를 설정합니다.
3프로젝트에서 사용하는 환경 변숫값을 관리합니다.
4[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.
5[저장] 버튼 클릭 시 변경된 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.
환경변수 추가
환경 변수 정보 오른쪽 상단의 추가 버튼을 클릭하여 새로운 환경 변수를 생성합니다. 환경 변수는 Key와 Value 값을 설정하여 사용할 수 있으며 Key 값은 중복될 수 없습니다.
이미지_2024-07-29_155221098
새로 추가된 환경 변수의 Key값 입력 시 필수 입력 표시가 활성화 됩니다.
환경변수 삭제
생성된 환경 변수 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 환경 변수를 삭제합니다.
이미지_2024-07-29_155339747
삭제 버튼 클릭 시 별도의 알림 창이 노출되지 않으며 해당 목록에서 바로 삭제됩니다.
추가정보 수정
[추가정보] 탭에서는 TobeDevOps에서 제공하는 추가 서버 정보를 관리합니다. 현재는 클라이언트(넥사크로)에서 파일 형태의 데이터 처리를 위한 XENI 서비스만 제공합니다.
이미지_2024-07-29_155436056
1사용자가 입력한 서버 경로를 변경할 수 있습니다. 단, 서버 경로는 프로젝트 내 사용 이력이 없는 값만 사용할 수 있습니다.
2서버 정보 하단에 위치한 추가[+] 버튼을 클릭하여 새로운 XENI 서버를 생성합니다. 추가된 서버의 아이디, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.
3서버 정보 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 생성된 서버를 삭제합니다. 삭제 버튼 클릭 시 서버 아이디 확인 팝업이 노출되며 값을 입력해야 삭제 버튼이 활성화됩니다.
4[취소] 버튼 클릭 시 변경된 정보를 저장하지 않고 이전 화면(프로젝트 개요)으로 이동합니다.
5[저장] 버튼 클릭 시 변경 정보를 저장합니다. 저장 후 별도의 화면 이동은 발생하지 않습니다.
오토스케일링 수정
[오토스케일링] 탭에서는 리소스 Resource Request/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 값까지 자동으로 늘어납니다. ex)Memory Request 1GiB, 임계치 80% 설정 후 실제 사용량이 0.8GiB를 초과할 경우 Replica 갯수가 자동으로 증가됨
반대로 사용량이 Resource Request의 Resource 임계치 이하가 될 경우 pod 수가 Replica MIN 값까지 자동으로 줄어듭니다. ex)Memory Request 1GiB, 임계치 80% 설정 후 실제 사용량이 0.8GiB를 이하로 감소할 경우 Replica 갯수가 자동으로 감소됨
Resorce Limit 관리
Resource Limit는 배포 환경 별 사용할 수 있는 최대 할당량 값으로 Resource Limit Max 값 이하로 입력할 수 있습니다. (Resource Limit Max 값은 오토스케일링 영역 우측 상단에 표기되어 있습니다.)
오토스케일링 관리
오토스케일링 입력 규칙에 맞지 않거나 스페이스 잔여량 값이 할당량 대비 10%미만일 경우 경고 메시지가 노출되며 설정이 저장되지 않습니다.
이미지_2024-07-29_160616144
입력 규칙이 맞지 않으면 값 변경 시 오류 시 메시지가 노출됩니다.
이미지_2024-07-29_160649391
1Resource 임계치 혹은 Replica 값을 설정할 때에는 모든 정보를 설정해야 합니다.
2Replica의 MIN 값은 MAX 값보다 크게 설정할 수 없습니다.
단, DB 서버는 리소스를 임의로 변경할 수 없어 오토스케일링 입력창이 활성화되지 않습니다.
프로젝트 삭제
생성된 프로젝트를 삭제할 수 있습니다. 프로젝트 삭제는 프로젝트 관리자만 사용할 수 있는 메뉴로 프로젝트 관리자 외 권한에게는 삭제 메뉴가 노출되지 않습니다.
선택된 프로젝트의 설정 버튼 목록에서 휴지통 모양 아이콘을 클릭하여 프로젝트를 삭제합니다.
이미지_2024-07-29_160811526
삭제 버튼 클릭 시 삭제할 프로젝트의 아이디를 확인하는 팝업이 오픈됩니다.
이미지_2024-07-29_161412313
아이디 입력 후 삭제 버튼이 활성화되며 삭제 버튼 클릭 시 쿠버네티스에서 처리되므로 일정 시간이 소요됩니다. 프로젝트가 삭제될 경우 포털에서는 확인할 수 없지만 Git Repository는 유지됩니다.
프로젝트 내 생성된 서버가 존해하면 프로젝트를 삭제할 수 없습니다.
이미지_2024-07-29_161803975
넥사크로 Demo 사용 설명
TobeDevops에서는 제공하는 일부 서버 개발/운영 환경 서비스의 경우 넥사크로 Demo가 포함되어 빠른 개발 환경을 구축할 수 있습니다. 단, 넥사크로 Demo 사용을 위해서는 서비스 호출을 위한 필수 설정정보 세팅이 필요합니다.
Demo 제공 환경 서비스
WEB : nginx (넥사크로 UI Demo)
WAS : tomcat (넥사크로 API Demo)
XENI : tomcat (넥사크로 XENI Demo)
프로젝트 생성 후 필수 설정정보 세팅
프로젝트 생성 시 기본으로 제공되는 넥사크로 Demo의 정상 동작을 위해서는 필수 설정 정보를 세팅해야 하며 배포 환경에 따라 설정 정보가 달라집니다.
배포 환경 별 접근 권한이 달라집니다. 프로젝트 접근의 상세 정보는 프로젝트 권한 종류 에서 확인해 주세요.
DEV 개발 환경 설정정보 세팅
서비스(X-API) 연결 주소 설정
WEB 서버에 생성된 넥사크로 UI Demo의 서비스 호출 주소를 WAS 서버의 접속 주소로 설정합니다.
1
[프로젝트 구성 > 서버 정보 > WAS 구분 > 개발 환경의 URL 주소]를 확인합니다.
이미지_2024-07-29_164110694
2
서버 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.
이미지_2024-07-29_164137066
3
WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.
이미지_2024-07-29_164217363
4
넥사크로 UI Demo의 WAS 서비스 변수 값을 앞서 확인한 WAS 서버의 접속 주소로 설정하여 서비스를 호출할 수 있습니다.
Variable ID | 개발환경 | 접속 URL |
|---|---|---|
svc_dev | DEV | https://dev-apps.tobedevops.link/[space id]/[project id]/was |
5
변수의 초기 값 수정 후 Commit Changes하여 변경을 완료합니다.
이미지_2024-07-29_164538583
DB 접속 정보 설정
프로젝트에 생성된 DB 연동을 위해 DB 접속 정보를 설정합니다.
1
[프로젝트 구성 > 서버 정보 > DB 구분 > 개발 환경의 DB PW]를 확인합니다.
이미지_2024-07-29_164652953
2
DB 접속 정보 환경 변수를 추가하기 위해 [프로젝트 개요 > 프로젝트 관리 버튼 > 프로젝트 수정] 화면으로 이동합니다.
이미지_2024-07-29_164721056
3
프로젝트 수정 메뉴의 [환경 정보] 탭에서 [환경변수정보 > 추가] 버튼을 클릭합니다.
이미지_2024-07-29_164951174
4
추가된 환경 변수 행에 DB PW를 다음과 같은 Key-Value 값에 맞춰 입력 후 저장합니다.
Key | Value |
|---|---|
DB_DEV_PW | [DEV DB PW] |
5
키 값은 반드시 [DB_DEV_PW] 로 입력하고 Value 값에 패스워드 값을 입력합니다.
이미지_2024-07-29_165328920
XENI 연결 주소 설정
넥사크로 UI Demo에서 추가서비스로 제공되는 넥사크로 XENI Demo 사용 시 XENI 접속 주소를 설정합니다.
1
[프로젝트 구성 > 추가서비스 > XENI 구분 > 개발 환경의 URL]을 확인합니다.
이미지_2024-07-29_165752404
2
[추가 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.
이미지_2024-07-29_171239403
3
WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.
이미지_2024-07-29_171340403
4
넥사크로 샘플의 XENI 서비스 변수를 앞서 확인한 XENI URL 주소로 설정하여 서비스를 호출할 수 있습니다.
Variable ID | 개발환경 | 접속 URL |
|---|---|---|
xeni_dev | DEV | https://dev-apps.tobedevops.link/[space id]/[project id]/xeni |
5
변수의 초기값 수정 후 Commit Changes하여 변경을 완료합니다.
이미지_2024-07-29_171508006
STG, PRD 개발 환경 설정정보 세팅
서비스(X-API) 연결 주소 설정
WEB 서버에 생성된 넥사크로 UI Demo의 서비스 호출 주소를 WAS 서버의 접속 주소로 설정합니다.
1
[프로젝트 구성 > 서버 정보 > WAS 구분 > STG, PRD 개발 환경의 URL]을 확인합니다.
이미지_2024-07-29_171650852
2
[서버 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.
이미지_2024-07-29_171820978
3
WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.
이미지_2024-07-29_171939416
4
넥사크로 UI Demo의 검증, 운영 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 |
5
변수의 초기 값 수정 후 Commit Changes하여 변경을 완료합니다.
이미지_2024-07-29_172205260
DB 접속 정보 설정
프로젝트에 생성된 DB 연동을 위해 접속 정보를 설정합니다.
1
[프로젝트 구성 > 서버 정보 > DB 구분 > PRD-PRIMARY, PRD-SECONDARY의 DB ID&PW] 정보를 확인합니다.
이미지_2024-07-29_172335912
2
[서버 정보 > WAS 구분 > GIT URL] 주소를 클릭하여 WAS의 Git Repository로 이동합니다.
이미지_2024-07-29_172416318
3
WAS의 Repository 브랜치를 개발 브랜치로 선택하고 검증, 운영 환경 별 생성된 yml 파일을 편집 모드로 전환하여 수정합니다.
이미지_2024-07-29_172542194
4
넥사크로 샘플의 DB 접속 정보를 앞서 확인한 PRD-PRIMARY, PRD-SECONDARY의 DB ID&PW로 설정하여 DB를 연결할 수 있습니다.
개발 환경 | 편집 파일명 | DB 명 | DB Container ID |
|---|---|---|---|
STG | application_stg.yml | DB_PRD_MASTER | PRD-PRIMARY |
DB_PRD_SLAVE | PRD-SECONDARY | ||
PRD | application_prd.yml | DB_PRD_MASTER | PRD-PRIMARY |
DB_PRD_SLAVE | PRD-SECONDARY |
application_stg.yml, application_prd.yml 작성 방법
이미지_2024-07-29_172809906
5
변수 설정 완료 후 Commit Changes하여 변경을 완료합니다.
DB는 운영 환경에만 이중화 되어 PRD-PRIMARY, PRD-SECONDARY로 생성됩니다. Git에서 사용되는 검증과 운영 환경에 동일한 DB 정보를 설정합니다.
XENI 연결 주소 설정
넥사크로 UI Demo에서 추가서비스로 제공되는 넥사크로 XENI Demo 사용 시 XENI 접속 주소를 설정합니다.
1
[프로젝트 구성 > 추가서비스 > XENI 구분 > 검증, 운영 환경의 URL]을 확인합니다.
이미지_2024-07-29_173745371
2
[서버 정보 > WEB 구분 > GIT URL]을 클릭하여 WEB의 Git Repository로 이동합니다.
이미지_2024-07-29_173926884
3
WEB의 Repository 브랜치를 개발(develop) 브랜치로 선택하고 변경할 서비스 설정 파일(appvariables.xml)을 편집 모드로 전환합니다.
이미지_2024-07-29_174052629
4
넥사크로 UI Demo의 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 |
5
변수의 초기값 수정 후 Commit Changes하여 변경을 완료합니다.
이미지_2024-07-29_174222755
위와 같은 과정을 통해 각 배포 환경(DEV, STG, PRD)의 설정을 완료하면 제공된 넥사크로 Demo를 정상적으로 사용할 수 있습니다.
넥사크로 Demo는 기본적인 데이터 송/수신 처리 기능이 포함되어 있으며 데이터 넥사크로 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