프로젝트란 가상 공간인 스페이스 하위에 생성할 수 있는 최소 관리 단위로 하나의 스페이스에 여러 프로젝트를 추가하여 사용할 수 있습니다.
프로젝트 생성
1
프로젝트는 스페이스 관리자(Space Admin)가 생성할 수 있습니다.
2
[프로젝트 > 프로젝트 생성] 메뉴를 클릭하거나, [프로젝트 > 프로젝트 개요] 메뉴 우측 상단의 [프로젝트생성+] 버튼을 클릭하여 [프로젝트 생성] 메뉴로 이동합니다.
기본정보
프로젝트에서 사용할 프로젝트 ID 및 이름과 같은 기본정보를 입력합니다.
1프로젝트가 포함될 스페이스를 선택합니다. 스페이스는 사용자가 스페이스 관리자로 추가된 스페이스 목록에서 선택할 수 있습니다.
2프로젝트에서 사용할 아이디 값을 입력합니다. 프로젝트 아이디 입력 후 [중복체크] 버튼을 클릭하여 기존 사용 이력을 확인합니다.
3프로젝트 관리자를 설정합니다. 선택된 스페이스의 멤버로 속한 사용자 목록을 확인할 수 있으며 관리자로 등록할 사용자 체크 박스를 선택하여 추가합니다.
4프로젝트 카드 및 프로젝트 정보로 사용할 명칭을 입력합니다.
5프로젝트의 추가 정보를 입력합니다.
6[다음] 버튼 클릭 시 입력한 정보를 저장하고 [컨테이너구성] 탭으로 이동합니다.
프로젝트 아이디는 중복이 허용되지 않으므로 중복체크 과정이 반드시 필요합니다.
컨테이너 구성
프로젝트 내 WEB, WAS, DB 구분의 서버(컨테이너)를 자유롭게 구성할 수 있습니다. 단, DB는 프로젝트 별 MAX 1개만 생성할 수 있습니다.
1ID, 개발 및 운영 환경 서비스, Path 정보와 Resource를 설정합니다.
2프로젝트당 1개만 생성되며 ID 값은 고정되어 사용됩니다. 개발 및 운영 환경의 서비스와 STORAGE 용량, Resource를 설정합니다.
3[이전] 버튼 클릭 시 생성 중인 컨테이너 입력 정보를 저장하고 이전 화면(기본정보) 탭으로 이동합니다. 이 때 컨테이너 필수 입력 정보가 입력되지 않으면 이동되지 않습니다.
4[다음] 버튼 클릭 시 생성 중인 컨테이너 입력 정보를 저장하고 다음 화면(환경정보) 탭으로 이동합니다. 컨테이너 필수 정보가 모두 입력된 후 다음으로 이동할 수 있습니다.
WEB/WAS 서버(컨테이너)
1
WEB, WAS의 추가(+) 버튼을 클릭하여 새로운 서버(컨테이너)를 추가합니다. WEB, WAS는 제한 없이 사용할 수 있으며 입력 정보는 동일합니다
2
ID, 개발 및 운영 환경 서비스, Path 정보는 필수 입력 값 입니다.
ID와 Path 값은 프로젝트 별 중복 사용이 불가 하며 Path는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.
3
Resource 설정 상세[▼] 버튼을 클릭하여 Resource 값을 설정할 수 있습니다.
4
컨테이너 추가 시 Resource Request와 Limit 값은 포털에서 제공하는 기본 값(DEF)이 설정됩니다.
Resource Request값은 Resource Limit값 이상 설정할 수 있으며 Request값과 Limit 값 모두 상단에 표기된 Max 값 미만으로만 설정할 수 있습니다.
서버 별 Storage 정보를 사용할 수 있습니다. Storage 정보의 사용 체크 박스를 선택하면 저장소 타입과 마운드 경로가 활성화 되어 입력할 수 있습니다.
Storage 저장소 타입을 선택하고 마운트 경로를 입력합니다. 선택한 저장소 타입에 따라 제공 가능한 용량이 달라지며 Storage 마운트 경로는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.
각 컨테이너 행의 오른쪽 삭제[-] 버튼을 클릭하여 추가 중인 컨테이너를 삭제할 수 있습니다.
DB 컨테이너 추가
1
DB 컨테이너의 추가[+] 버튼을 클릭하여 새로운 컨테이너를 추가합니다.
2
개발 및 운영 환경 서비스와 서비스 별 STORAGE 값을 선택합니다. 개발 및 운영 환경 서비스는 필수 입력 값입니다.
프로젝트당 DB는 1개만 생성할 수 있으며 ID 값과 Path를 임의로 변경할 수 없습니다.
3
Resource 설정 오른쪽 상세[▼] 버튼을 클릭하여 Resource 값을 설정할 수 있습니다.
4
DB컨테이너 추가 시 개발 및 운영 환경의 Resource Request와 Limit 값은 포털에서 제공하는 기본값(DEF)이 설정됩니다.
환경별 Resource Request값은 Resource Limit값 이상 설정할 수 있으며 Request값과 Limit 값 모두 상단에 표기된 Max 값 미만으로만 설정 가능합니다.
DB 컨테이너 행의 오른쪽 삭제[-] 버튼을 클릭하여 추가중인 컨테이너를 삭제할 수 있습니다.
환경설정
프로젝트 추가 설정이 필요한 커스텀도메인, CORS 정보 및 환경 변수를 설정할 수 있습니다.
1사용자가 원하는 커스텀 도메인을 설정합니다.
2커스텀 도메인 변경시 서버간의 리소스 공유를 위해 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유)를 정보를 설정합니다.
3프로젝트에서 사용할 환경 변수 값을 관리합니다.
4[이전] 버튼 클릭 시 입력 정보를 저장하고 이전 화면(컨테이너 구성) 탭으로 이동합니다.
5[저장] 버튼 클릭 시 입력 정보를 저장하고 다음 화면(추가서비스) 탭으로 이동합니다.
커스텀도메인 설정
사용자가 원하는 도메인으로 PRD 환경의 URL을 변경하여 사용할 수 있습니다.
사용할 도메인 정보를 [프로젝트 환경정보 > 커스텀도메인정보]에 입력합니다. 도메인은 변경 전 사용하고자 하는 도메인 구매와 SSL 인증 완료 후 진행해 주세요.
도메인 설정 | 커스텀도메인 url |
---|---|
SSL 인증서 Key | 인증 완료된 SSL 인증서 Key 값 |
SSL 인증서 | 인증 완료된 SSL 인증서 값 |
커스텀 도메인이 설정되면 구분 별 컨테이너의 PRD 접속 주소가 변경됩니다.
만약 도메인 설정에 커스텀 도메인이 입력되지 않으면 구분 별 컨테이너의 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 체크 표시가 활성화 됩니다.
추가한 환경 변수 오른쪽에 위치한 삭제[-] 버튼을 클릭하여 환경 변수를 삭제합니다.
추가서비스 - XENI
TobeDevOps에서 제공하는 추가 서비스를 설정합니다. 현재는 화면(넥사크로)에서 엑셀 Import/Export 처리를 위한 XENI 만 구성되어 있습니다.
1
[+] 버튼을 클릭해 XENI 컨테이너를 추가합니다.
2
ID, 개발 및 운영 환경 서비스, Path 정보는 필수 입력 값 입니다.
ID와 Path 값은 프로젝트 별 중복 사용이 불가 하며 Path는 반드시 앞에 ‘/’ 를 추가하여 입력해 주세요.
각 행의 오른쪽 삭제[-] 버튼을 클릭하여 추가 중인 XENI를 삭제할 수 있습니다.
3
필수 입력 정보를 모두 입력한 뒤 [프로젝트생성] 버튼을 클릭하여 프로젝트를 생성합니다.
ID, Path 가 중복되었을 경우에는 다음과 같이 중복 오류 확인 팝업이 노출됩니다.
프로젝트 실행
프로젝트 생성이 진행되는 중에는 다음과 같이 [Creating] 상태의 프로젝트를 확인할 수 있습니다.
프로젝트가 정상적으로 생성되면 Creating에서 Running 상태(프로젝트 생성 완료)로 변경되고 [빌드 > 배포] 과정을 통해 컨테이너 생성 및 서비스 배포 과정이 자동으로 진행됩니다.
빌드 확인
프로젝트 생성이 완료되면 빌드가 자동으로 진행됩니다. [빌드] 메뉴에서 생성한 컨테이너 별 빌드 현황을 확인합니다.
1
화면 상단에 프로젝트 구분 탭을 사용하여 Running, Stop 상태의 프로젝트 목록을 각각 확인할 수 있으며 기본 상태 값은 [Running]입니다. [All] 탭 선택 시 전체 프로젝트 목록을 확인할 수 있습니다.
2
선택된 프로젝트의 서버(컨테이너) 콤보 박스를 선택하여 생성된 서버의 배포 환경 별 빌드 현황을 확인할 수 있습니다.
DB는 Git Repository가 생성되지 않고 바로 배포되므로 빌드 항목에서는 제외됩니다.
3
DEV(개발)의 빌드가 정상적으로 진행되면 Status 값이 [Passed]로 확인됩니다.
[Failed]의 경우 Stages 항목의 ⓧ 아이콘을 통해 실패 단계를 확인할 수 있습니다.
배포 확인
DEV(개발)의 빌드가 완료되면 다음 단계인 배포가 자동으로 진행됩니다. [배포] 메뉴에서 생성 요청한 서버의 배포 현황을 확인합니다.
프로젝트 카드의 콤보 박스를 선택하여 생성된 서버 별 배포 현황을 확인할 수 있습니다.
배포가 완료되고 생성된 서버의 DEV 환경에서 정상적으로 동작할 수 있으면 Synced to HEAD와 Healthy가 확인됩니다.
화면 확인
1
프로젝트 생성이 모두 완료 된 후 [프로젝트 > 프로젝트 개요] 메뉴의 서버(컨테이너) 정보 탭에서 DEV 환경의 주소를 클릭합니다.
2
기본 프로젝트 생성이 정상적으로 완료되면 새로운 브라우저 창에서 넥사크로 Demo 화면을 확인할 수 있습니다.
프로젝트 DB Storage 증감
DB 컨테이너 생성 시 자동으로 할당되는 DB Storage는 운영 유지 보수 단계에서 백업 후 별도의 서비스 지원을 통해 제공됩니다.
디스크 용량 관리는 현재 클라우드 콘솔 및 KUBECTL(쿠버네티스 접속)을 통하여 진행할 수 있습니다.
자세한 적용 방법은 시스템 구축 시 별도로 문의해 주세요.