이 문서에서 다루는 내용
핵심 개념
- 개념
- 프로젝트
- 고객이 관리하는 것
- 함께 연결할 서비스와 데이터베이스를 묶는 작업 공간
- 개념
- 서비스
- 고객이 관리하는 것
- GitHub 저장소에서 빌드해 HTTP로 실행하는 웹 앱 또는 API
- 개념
- 배포
- 고객이 관리하는 것
- 특정 소스와 설정으로 서비스를 빌드하고 실행한 한 번의 시도
- 개념
- 데이터베이스
- 고객이 관리하는 것
- 선택한 서비스에 연결하는 관리형 PostgreSQL
- 개념
- 도메인
- 고객이 관리하는 것
- 서비스의 기본 주소 또는 고객이 소유한 커스텀 주소
| 개념 | 고객이 관리하는 것 |
|---|---|
| 프로젝트 | 함께 연결할 서비스와 데이터베이스를 묶는 작업 공간 |
| 서비스 | GitHub 저장소에서 빌드해 HTTP로 실행하는 웹 앱 또는 API |
| 배포 | 특정 소스와 설정으로 서비스를 빌드하고 실행한 한 번의 시도 |
| 데이터베이스 | 선택한 서비스에 연결하는 관리형 PostgreSQL |
| 도메인 | 서비스의 기본 주소 또는 고객이 소유한 커스텀 주소 |
빈 프로젝트에서 시작하기
- 첫 행동
- GitHub 저장소 배포
- 언제 선택하나요?
- 저장소의 앱을 바로 배포할 때
- 다음 단계
- 저장소와 실제 브랜치를 선택하고 배포 설정 확인
- 첫 행동
- 빈 서비스 만들기
- 언제 선택하나요?
- 서비스를 먼저 만들고 소스를 나중에 연결할 때
- 다음 단계
- 배포 탭의 소스 연결하기 또는 설정의 소스 영역에서 GitHub 저장소 연결
- 첫 행동
- PostgreSQL 만들기
- 언제 선택하나요?
- 데이터베이스부터 준비할 때
- 다음 단계
- ACTIVE 확인 후 필요한 서비스에 연결
| 첫 행동 | 언제 선택하나요? | 다음 단계 |
|---|---|---|
| GitHub 저장소 배포 | 저장소의 앱을 바로 배포할 때 | 저장소와 실제 브랜치를 선택하고 배포 설정 확인 |
| 빈 서비스 만들기 | 서비스를 먼저 만들고 소스를 나중에 연결할 때 | 배포 탭의 소스 연결하기 또는 설정의 소스 영역에서 GitHub 저장소 연결 |
| PostgreSQL 만들기 | 데이터베이스부터 준비할 때 | ACTIVE 확인 후 필요한 서비스에 연결 |
프로젝트 화면 사용하기
상단의 활동에서 프로젝트 배포 기록을 보고,새 리소스에서 GitHub 저장소, 빈 서비스 또는 PostgreSQL을 추가합니다. AI 하자점검, 데이터베이스, 도메인과 프로젝트 설정은더보기 메뉴에서 엽니다.
캔버스에서 서비스나 데이터베이스를 선택하면 오른쪽 플로팅 패널에서 배포, 변수, 로그, 설정과 연결 정보를 확인할 수 있습니다. 패널을 닫아도 캔버스의 리소스 배치는 유지됩니다. 데이터베이스 연결선은 다음 배포에서 실제로 환경변수를 받는 서비스를 뜻합니다.
빈 서비스
이름과 기본 주소만 먼저 만들 수 있지만, 실제 배포를 시작하려면 GitHub 저장소를 연결해야 합니다. 서비스의 배포 탭에서
소스 연결하기를 누르거나 설정의 소스 영역에서 저장소와 실제 브랜치를 선택하세요. 첫 행동 선택을 취소해도 프로젝트 화면에서 다시 시작할 수 있습니다.변경과 삭제
- 환경변수와 Root Directory, Build Command, Start Command, Healthcheck Path는 저장 후 새 배포가 성공해야 현재 서비스에 적용됩니다.
- 저장 전 변경, 저장됐지만 배포 적용을 기다리는 변경, 현재 ACTIVE 배포에 적용된 상태를 구분해 표시합니다.
- Auto Deploy 켜기·끄기는 저장 즉시 이후 GitHub push부터 적용되며 설정 변경만으로 새 배포를 시작하지 않습니다.
- 진행 중인 배포가 있으면 수동 재배포·재시도·롤백·삭제가 제한될 수 있습니다. Auto Deploy push는 가장 최신 커밋 한 건이 다음 배포로 대기해 선행 배포 종료 후 자동 시작합니다.
- 데이터베이스를 삭제하기 전에 연결된 서비스와 필요한 백업을 확인하세요.
- 서비스를 삭제하면 공개 URL과 연결이 더 이상 작동하지 않을 수 있습니다.