용어집

세대

데이터베이스의 백업 한 건으로, epoch/seq 형식(예: 3/17)으로 식별됩니다. 각 백업은 변경된 부분만 담으므로, 보존 창 안의 어느 시점으로든 복원할 수 있습니다. 무료 플랜은 7일, 프로 플랜은 30일입니다. 자세한 내용은 백업과 복원을 참고하세요.

epoch

프로젝트 데이터베이스의 계보 번호입니다. 데이터베이스가 복원되거나 다른 노드로 이동할 때마다 1씩 증가합니다. 같은 프로젝트 안에서도 epoch가 다르면 데이터 계보가 다른 것이므로, 이전 epoch에서 온 요청은 거부됩니다.

워커에서 현재 값을 읽을 수 있습니다.

const { project, epoch } = await env.db.identity();

Runlot-Epoch 요청 헤더에서도 확인할 수 있습니다.

슬롯

노드가 프로젝트 하나에 할당하는 실행 단위입니다. 슬롯 하나는 프로세스 하나, 포트 하나, 데이터 디렉터리 하나를 갖습니다. 프로젝트를 어느 노드의 어느 슬롯에 배치할지 정하는 것을 **배치(placement)**라고 합니다.

자동 정지(park)

요청이 일정 시간(기본 5분) 없으면 워커 프로세스를 종료하는 것입니다. 데이터는 보존되며, 새 요청이 들어오면 프로젝트가 자동으로 다시 시작됩니다. 자세한 내용은 중지와 재개를 참고하세요.

이는 관리자가 설정하는 정지(suspended) 상태와는 다릅니다. 자동 중지는 다음 요청으로 해제되지만, 관리자가 정지시킨 프로젝트는 수동으로 정지를 해제해야 합니다.

콜드

노드에서 프로세스만 중지하는 것과 달리, 데이터베이스가 외부 스토리지로 옮겨진 상태입니다. 노드의 디스크 공간이 부족해지면 데이터베이스를 암호화하여 외부에 보관합니다. 다시 불러오는 데는 약 6~7초가 걸립니다. 자세한 내용은 재활성화를 참고하세요.

wire

PostgreSQL 프로토콜로 데이터베이스에 직접 연결합니다. 주소는 <project>--<org>.wire.runlot.app:5433이며, psql과 PostgreSQL 드라이버가 이 연결을 사용합니다. 워커의 env.db와 동일한 데이터베이스에 접속하지만 동작 방식은 다릅니다. wire 연결은 세션을 유지하는 반면, env.db는 호출마다 새 세션을 사용합니다.

프런트

들어오는 요청의 대상 프로젝트를 결정하고, 접근 제어를 확인하며, 필요하면 프로젝트를 재시작하는 계층입니다. runlot-* 헤더도 이 계층에서 추가됩니다. HTTP 요청과 wire 요청 모두 front를 거칩니다.

org

프로젝트를 소유하고 결제 및 권한 설정을 보유하는 단위입니다. 배포 주소의 두 번째 레이블은 조직 슬러그입니다(예: my-app.me.runlot.app의 me). 팀과 역할을 참고하세요.

배포와 버전

runlot deploy를 실행할 때마다 하나의 버전이 생성됩니다. 배포 기록은 보존되며, runlot rollback으로 이전 버전 중 하나를 다시 활성화할 수 있습니다.

접근 제어와 인증

• 접근 제어 — 누가 배포 자체에 접근할 수 있는지 결정합니다(public, org, password).
• 인증 — 애플리케이션에 가입한 사용자를 관리합니다(env.auth).

이 둘은 서로 다른 계층에서 동작합니다. 접근 제어를 참고하세요.