설치와 첫 배포

CLI 를 설치합니다

npm i -g runlot
runlot login

runlot login은 브라우저를 열어 계정 로그인을 진행합니다. 발급된 토큰은 컨트롤 플레인 주소별로 ~/.runlot/credentials.json에 저장되며, 파일 권한은 0600으로 설정됩니다.

프로젝트를 만듭니다

npm create runlot@latest my-app
cd my-app

템플릿에는 runlot.json, src/index.ts, public/hello.txt, .gitignore와 필요한 디렉토리만 들어 있습니다. runlot.json, 워커 진입점, 정적 자산 디렉토리로 구성된 배포 설정을 한눈에 파악할 수 있도록 최소 구성으로 제공합니다.

디렉토리 이름은 프로젝트 이름으로 사용되며, 프로젝트 이름은 배포 주소의 첫 번째 라벨이 됩니다. 따라서 이름은 ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ 형식을 따라야 합니다. 형식에 맞지 않으면 생성 과정에서 안내합니다.

배포합니다

runlot deploy

명령은 번들을 만들고 업로드한 뒤 새 버전을 서비스합니다. 프로젝트가 아직 없으면 자동으로 생성하므로, 첫 배포 전에 별도로 프로젝트를 만들 필요가 없습니다.

배포가 완료되면 다음과 같은 주소가 표시됩니다.

my-app.me.runlot.app

주소 형식은 <프로젝트>.<조직>.runlot.app입니다. 이름 규칙은 배포 URL을 참고하세요.

데이터베이스를 켭니다

runlot.json에 한 줄을 적고 배포합니다. 켜는 명령은 없습니다. 배포가 선언을 읽어 없는 것을 만듭니다.

{
  "name": "my-app",
  "main": "src/index.ts",
  "database": true
}

runlot deploy

로그인과 파일 저장소도 같은 자리에 적습니다. 셋 중 필요한 것만 적어도 됩니다.

{
  "database": true,
  "auth": true,
  "storage": true
}

앱 인증에는 데이터베이스가 필요하므로 "auth": true만 적어도 데이터베이스를 함께 만듭니다. 배포 출력이 무엇을 만들었는지 말해 주고, 이미 있는 것은 다시 만들지 않습니다.

배포하면 워커에서 env.db, env.auth, env.storage를 바로 사용할 수 있습니다. 별도의 접속 문자열이나 시크릿을 설정할 필요가 없습니다. psql 접속 정보는 runlot pg connect에 있습니다.

다음에 읽을 것

• 프로젝트 구조 — runlot.json 과 진입점이 하는 일
• env.db — 데이터베이스를 쓰는 법
• 배포 URL — 주소가 정해지는 규칙