배포·협업
서버·백엔드 배포
Git·Docker 이미지·Docker Compose, 루트 폴더와 포트, 설정 수정과 재배포.
01
배포 방식 고르기
Spring·Node.js·Python 등 백엔드나 데이터베이스와 함께 동작하는 서비스를 올릴 때 사용합니다. Git 기반 런타임, Docker 이미지 또는 Docker Compose 중 프로젝트에 맞는 방식을 고릅니다.
02
Git과 이미지 설정
Git은 저장소·브랜치·Root Directory·런타임·실행 명령을 확인합니다. 저장소의 server 폴더만 쓸 때는 상대 경로 server를 지정하세요. Docker 이미지는 실행할 이미지와 컨테이너 내부 서비스 포트를 지정합니다. 사이트에서 제공하는 런타임·프리셋 중 실제 프로젝트에 맞는 것을 선택합니다.
03
Docker Compose 설정
여러 컨테이너가 필요하면 Compose 모드를 선택합니다. Compose File 경로, 외부 연결을 받을 Gateway Service 이름, 컨테이너 포트와 CPU·RAM·저장 공간을 확인합니다. 예를 들어 api-gw가 HTTP를 8000번으로 제공한다면 서비스 이름과 내부 포트를 그 값으로 입력합니다. 실제 저장소의 Compose 정의와 일치해야 합니다.
04
공개 범위와 주소
Private·School·Public의 접속 범위를 읽고 필요한 범위를 고릅니다. Public 서버의 기본 주소는 설정한이름.server.cbgpu.com입니다. 관리자의 배포 승인 단계를 별도로 기다리는 방식은 아니지만 계정 확인과 자원·설정 조건은 충족해야 합니다.
05
설정만 저장과 재배포
프로젝트 상세의 설정 수정에서 “설정만 저장” 또는 “저장 후 재배포”를 구분하세요. 저장만 한 값은 다음 배포에 적용됩니다. Git 재배포는 설정된 저장소·브랜치에서 코드를 가져와 실행합니다. 로컬 컴퓨터에서 수정만 하고 Git에 올리지 않은 코드는 포함되지 않습니다.
06
볼륨과 실패 로그
데이터베이스·업로드 파일은 적절한 영구 볼륨에 보관하고 별도로 백업하세요. 재배포는 데이터 이전 작업을 자동으로 대신하지 않습니다. Compose가 unhealthy이면 실패 서비스명, 상태·컨테이너 로그와 헬스체크 출력을 확인하세요. 실패를 고치기 위해 데이터 볼륨부터 지우지 마세요.