Git push 한 번으로 GPU 클러스터에 배포

• 서버는 amd64 입니다. ARM 전용 베이스 이미지는 동작하지 않습니다.
• 앱 컨테이너에는 영구 볼륨이 없습니다. 재시작하면 컨테이너 안에 쓴 파일이 사라지므로 데이터는 관리형 데이터베이스나 오브젝트 스토리지에 두세요. Postgres·Redis 템플릿은 디스크가 없는 실험용입니다.
• 이미지 레지스트리로 직접 push 는 지원하지 않습니다. Git 저장소에서 빌드하거나 공개 이미지 주소를 쓰세요.
• 로그인은 core.today 계정이고, 조직 가입은 소유자·관리자의 이메일 초대로만 이뤄집니다.
• 컨테이너 인자(args)·TCP 포트 공개는 아직 없습니다. 인자가 필요한 이미지는 두 줄 Dockerfile 로 감싸 빌드합니다.
• 프로젝트마다 공개 주소가 생기고 끌 수 없습니다. 내부에서만 쓸 서비스는 앱 자체의 인증을 켜 두세요. 같은 조직의 프로젝트끼리는 내부 주소로 통신합니다.
• docker-compose 파일을 그대로 받지는 않습니다. 서비스마다 프로젝트를 만들고 DB 는 관리형 데이터베이스로 옮깁니다(가이드에 순서가 있습니다).
• 데이터베이스 자동 백업은 PostgreSQL·Redis 계열과 오브젝트 스토리지에만 있습니다. 그 밖의 벡터·검색·그래프·에이전트 메모리 엔진은 복제 디스크로 보호되지만 시점 복원은 없습니다.

Dockerfile 이 없으면 어떻게 되나요?

Railpack 이 저장소를 보고 언어·프레임워크·패키지 매니저를 감지해 빌드합니다(Node·Python·Go·Rust·Ruby·PHP·Java·.NET·정적 사이트). 모노레포는 빌드·시작 명령만 지정하면 됩니다. 감지 결과는 빌드 로그 첫 부분에 표로 출력되고, 감지가 안 되면 Dockerfile 을 두면 됩니다.

앱은 어떤 포트에서 listen 해야 하나요?

프로젝트 설정의 컨테이너 포트입니다. 같은 값이 PORT 환경변수로도 들어오므로 PORT 를 읽어 listen 하면 됩니다. 플랫폼이 그 포트로 요청을 넘겨 주고 공개 주소는 항상 https 입니다.

내 도메인을 붙일 수 있나요?

프로젝트 설정의 커스텀 도메인에 호스트명을 추가하면 걸어야 할 CNAME 레코드가 나옵니다. 도메인의 DNS 에 그 레코드를 걸면 https 인증서까지 자동으로 붙습니다. 기본 주소는 설정 없이 바로 열립니다.

비공개 저장소도 되나요?

됩니다. 읽기 권한만 있는 토큰(GitHub fine-grained PAT 의 Contents: read 등)을 접근 토큰 칸에 넣으면 비밀값으로 따로 저장되고 소스를 가져오는 단계에서만 사용됩니다.

브랜치 미리보기는 어떻게 켜나요?

소스 설정에서 '브랜치 미리보기 환경' 을 켜고 웹훅을 등록합니다. 프로덕션 브랜치가 아닌 브랜치를 push 하면 <이름>--<브랜치>-<해시>.apps.core.today 에 올라가고, 브랜치를 삭제하면 환경도 지워집니다. 콘솔에서 수동으로 만들거나 지울 수도 있습니다.

로그는 얼마나 보관되나요?

실시간 로그는 지연 없이 바로 보이고, 모든 Pod 의 stdout 은 30일 보관됩니다. 보관 로그는 시간 범위·검색·Pod 필터로 조회하고 다운로드할 수 있으며, 삭제된 빌드의 단계 로그도 여기서 읽습니다.

GPU 종류를 고를 수 있나요?

네. 개수(0~4)와 함께 종류를 고를 수 있고, A100 은 한 장을 나눈 조각 단위로도 쓸 수 있습니다. 조각은 메모리와 연산이 다른 조각과 격리되고 요금도 그 비율만큼입니다. "아무 GPU" 로 두면 빈 자리에 배치되어 A100 과 V100 이 섞일 수 있으니, 그때는 fp16(--dtype half) 옵션을 함께 쓰세요(V100 은 bf16 미지원).

과금은 언제부터 시작되나요?

조직은 플랫폼 관리자가 예산(선불 크레딧)을 지급해야 프로젝트를 만들고 빌드할 수 있습니다. 사용량은 매시간 집계돼 예산에서 차감되며, 잔액이 0 이 되면 새 프로젝트·빌드·증설이 막히고 진행 중인 배치 작업은 일시 중지됩니다. 실행 중인 서비스는 멈추지 않습니다.

데이터베이스를 함께 올릴 수 있나요?

됩니다. 콘솔의 데이터베이스 메뉴에서 20종 가운데 골라 영구 디스크와 함께 만들고 프로젝트에 연결하면 접속 정보가 환경변수로 들어갑니다. PostgreSQL 계열(pgvector·ParadeDB·VectorChord·PostGIS)과 Redis 계열(Redis·Valkey·FalkorDB)은 매일, 오브젝트 스토리지와 LanceDB 저장소는 주 1회 자동 백업되고 콘솔에서 복원할 수 있습니다. 그 밖의 엔진은 자동 백업이 없으니 다시 만들 수 있는 데이터에 쓰세요. 템플릿 카탈로그의 Postgres·Redis 는 디스크가 없는 실험용입니다.

앱이 특정 PostgreSQL 확장을 요구하면요?

확장이 들어 있는 엔진을 고르면 됩니다. 기본 PostgreSQL 에는 pgvector 가, ParadeDB 에는 전문 검색(pg_search)이, VectorChord 에는 대규모 벡터 인덱스(vchord)가, PostGIS 에는 공간 데이터(postgis)가 더 들어 있습니다. 엔진은 만든 뒤에 바꿀 수 없으니 앱의 설치 문서에서 필요한 확장을 먼저 확인하세요.

docker-compose 로 돌리던 앱도 올릴 수 있나요?

됩니다. compose 파일을 그대로 받지는 않고, 화면·API·워커는 서비스마다 프로젝트로, DB 는 관리형 데이터베이스로, 볼륨에 쓰던 파일은 오브젝트 스토리지로 옮깁니다. 같은 조직 안에서는 프로젝트끼리 내부 주소로 통신합니다. 옮기는 순서와 자주 걸리는 지점은 가이드의 “서비스가 여러 개인 앱 올리기”에 있습니다.

더 자세한 설정과 문제 해결은 가이드에 있습니다 (로그인 없이 볼 수 있습니다).