프로젝트

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

프로젝트 생성

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

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

이미지_2024-07-25_172149714

기본정보

프로젝트에서 사용할 프로젝트 아이디, 이름과 같은 기본 정보를 입력하고 프로젝트 관리자를 등록합니다.

이미지_2024-07-25_172854885

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

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

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

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

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

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

이미지_2024-07-25_172635340

서버구성

서버별 추가[+] 버튼을 클릭하여 새로운 서버를 생성합니다.

운영자7

추가된 서버의 정보를 설정하고 다음 단계로 이동합니다.

이미지_2024-07-25_173947990

1WEB과 WAS 서버의 아이디, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.

2DB 서버의 개발 및 운영 환경 서비스는 필수 입력 정보입니다.

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

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

WEB/WAS 서버 추가

추가한 서버의 필수 입력 값을 설정합니다. WEB, WAS는 제한 없이 사용할 수 있으며 입력 정보는 동일합니다

운영자8

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

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

이미지_2024-07-25_174724898

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

운영자10

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

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

이미지_2024-07-25_175036445

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

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

운영자12

DB 서버 추가

DB 서버의 필수 입력 값을 설정합니다. 서비스 선택 시 서버 아이디는 자동으로 입력됩니다.

운영자13

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

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

이미지_2024-07-25_175521597

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

운영자15

환경별 Resource Request값은 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, 교차 출처 리소스 공유)를 설정하여 서버 간 리소스를 공유합니다.

CORS 설정 예시

설정 값

설정 키 값

Origin

https://커스텀도메인 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값 입력 시 필수 입력 표시가 활성화 됩니다.

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

이미지_2024-07-25_181237464

추가정보

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

추가[+] 버튼을 클릭해 XENI 서버를 추가합니다.

이미지_2024-07-25_181322624

추가한 XENI 서버의 정보를 설정하고 프로젝트를 생성을 완료합니다.

운영자3.png24

1XENI 서버의 아이디, 개발 및 운영 환경 서비스, Path는 필수 입력 정보 입니다.

2[이전] 버튼 클릭 시 생성 중인 서버 정보를 저장하고 이전 화면(환경설정) 탭으로 이동합니다. 이 때 필수 입력 정보가 입력되지 않으면 이동되지 않습니다.

3[다음] 버튼 클릭 시 생성 중인 서버 정보를 저장하고 프로젝트를 생성합니다. 필수 정보가 모두 입력된 후 다음으로 이동할 수 있습니다.

추가한 서버의 필수 입력 값을 설정합니다. 추가 서버의 수는 제한 없이 사용할 수 있습니다.

운영자19

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

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

프로젝트 생성 시 일부 시간이 소요되며 프로젝트 생성이 완료된 후 서버 생성이 진행됩니다. 프로젝트의 실행 상태가 되어도 서버 생성이 완료된 후 서버를 확인할 수 있습니다.

운영자34

프로젝트 실행

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

이미지_2024-07-25_181730610

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

운영자26

빌드 확인

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

운영자27

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

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

이미지_2024-07-25_182237096

프로젝트에 서버를 추가하면 DEV 환경은 자동 빌드 후 배포 되지만 STG, PRD 환경은 Merge 후 수동 빌드가 필요합니다. 자세한 설명은 브랜치 Merge를 확인해 주세요.

배포 확인

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

운영자29

DEV 환경은 빌드 후 자동 배포되지만 STG, PRD 환경은 빌드 완료 후 수동 배포가 필요합니다. 자세한 설명은 배포 관리를 확인해 주세요.

화면 확인

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

이미지_2024-07-25_182708419

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

이미지_2024-07-25_182727996

프로젝트 DB Storage 증감

DB 서버 생성 시 자동으로 할당되는 DB Storage의 디스트 용량 관리는 운영 시 유지 보수 단계에서 추가 논의가 필요합니다.