배포·협업
프론트엔드 배포
Git 저장소를 연결해 웹사이트를 올리고 로그·설정·재배포 확인하기.
01
어떤 프로젝트에 쓰나요?
HTML·CSS·JavaScript, Vite, Astro, Next.js 등 웹사이트 프론트엔드를 배포할 때 사용합니다. API 서버나 여러 백엔드 컨테이너가 필요한 프로젝트는 서버 배포도 함께 살펴보세요.
02
저장소와 루트 폴더
Add New Project에서 GitHub 저장소 URL, 프로젝트 이름과 브랜치를 입력합니다. 비공개 저장소는 읽기 권한이 있는 GitHub 토큰이 필요합니다. 소스가 저장소 안의 하위 폴더에 있으면 Root Directory를 그 상대 경로로 지정합니다. 예를 들어 저장소의 web 폴더라면 web을 입력합니다.
03
빌드 설정과 환경변수
감지된 프레임워크, 설치·빌드 명령과 Output Directory를 확인하고 Deploy를 누릅니다. 브라우저에 포함되는 환경변수에는 비밀키를 넣지 마세요. API 키처럼 서버에서만 쓰는 값과 공개해도 되는 값을 구분합니다.
04
주소·상태·로그
기본 주소는 설정한이름.front.cbgpu.com입니다. 프로젝트의 배포 목록과 빌드 로그에서 설치·빌드·실행 중 어느 단계가 실패했는지 확인합니다. 초기 HTTPS 준비에 시간이 걸릴 수 있습니다.
05
업데이트와 복원
설정한 브랜치의 변경을 자동으로 확인하는 자동 배포 옵션을 사용할 수 있습니다. 수동 배포도 프로젝트의 설정된 저장소·브랜치를 기준으로 합니다. 코드 수정 후 실제 배포 커밋과 로그를 확인하고, 제공되는 정상 배포 복원 기능을 사용해 이전 결과를 다시 지정할 수 있습니다.