서버 구축
해당 과정을 진행하기 위해서는 CoBiz 압축 패키지 파일이 필요합니다.
CoBiz는 다수의 로봇을 실시간으로 제어하고 관제하기 위해 중앙 관제 서버를 필요로 합니다. 이 문서에서는 CoBiz 서버를 구축하는 방법에 대해 안내합니다.
시스템 요구사항
CoBiz 서버를 구축하기 위해서는 다음과 같은 시스템 요구사항을 충족해야 합니다.
하드웨어 최소 사양
| CPU | RAM | Storage | Network |
|---|---|---|---|
| 8 Core | 32GB | 1TB SSD | 100Mbps |
OS
- Ubuntu 20.04 LTS 이상
Docker
Docker와 Docker Compose가 설치되어 있지 않다면 Docker 설치 가이드를 참고하여 설치해 주세요.
CoBiz는 Docker를 사용하여 서버를 구축합니다. 따라서 Docker와 Docker Compose가 설치되어 있어야 합니다.
- Docker Engine
24.0이상 - Docker Compose
2.x이상
docker-compose.yml 설정
운용 환경에 맞게 설정을 변경하기 위해 docker-compose.yml 파일을 수정합니다. docker-compose.yml 파일은 압축 파일에 포함되어 있습니다.
server
CoBiz 서버의 기능을 활용하기 위해서는 다음 환경변수들을 설정해야 합니다.
server:
container_name: server
image: <image_name>
---
environment:
---
- COBIZ_JWT_SECRET=<jwt_secret>
- IMAGE_STORAGE_BASE_URL=https://lg.moth:3000/storage/
COBIZ_JWT_SECRET
CoBiz 서버는 JWT(Json Web Token)를 사용하여 사용자 인증을 처리합니다. JWT를 안전하게 생성하기 위해서는 비밀키를 재설정하는 것을 권장합니다. 설정하지 않으면 기본 설정된 값으로 사용됩니다.
IMAGE_STORAGE_BASE_URL
이미지를 조회하기 위한 URL입니다. 변경하지 않으면 docker-compose.yml에 기본 설정된 값으로 사용됩니다. minio등 외부 스토리지를 연동하는 경우 수정이 필요합니다.
Docker 이미지 로드
CoBiz 서버를 구축하기 위해서는 CoBiz 서버 이미지를 로드해야 합니다. 다음 명령어를 통해 이미지를 로드할 수 있습니다.
$ docker load -i cobiz-images.tar
서버 실행
다음 명령어를 통해 서버를 실행할 수 있습니다.
docker-compose up -d
실행 중인 서버를 종료할 때는 다음 명령어를 입력합니다.
docker-compose down