문서
앱 (도커)
앱은 도커 이미지를 배포하면 주소와 HTTPS까지 함께 열리는 실행 단위입니다. 서버를 따로 만들 필요가 없습니다. 환경변수는 봉인해 보관하고, 볼륨 데이터는 다시 배포해도 남으며, 정지와 삭제는 요금이 서로 다르게 멈춥니다.
만들고 배포하기
POST /v1/apps
{ "slug": "myshop" }
POST /v1/apps/<id>/deploy
{ "image": "ghcr.io/me/myshop:v1.2.0" }
태그를 정확히 적으세요. latest 로 두면 나중에 이미지가 바뀌어도
언제 무엇이 바뀌었는지 알 수 없고, 되돌릴 수도 없습니다.
환경변수
봉인해서 보관하고 컨테이너에만 넣어 줍니다.
PUT /v1/apps/<id>/secrets
{ "secrets": { "DATABASE_URL": "postgres://..." } }
저장한 값은 다시 볼 수 없습니다. 확인이 필요하면 새 값으로 덮어써 주세요.
비공개 이미지
도커 허브·GitHub(ghcr.io)·GitLab·우리 Git 저장소의 비공개 이미지도 올릴 수 있습니다. 앱에 저장소 열쇠(아이디 + 토큰)를 한 번 등록하면 다음 배포부터 그 열쇠로 받습니다. 콘솔의 앱 카드에서 비공개 이미지를 눌러도 됩니다.
PUT /v1/apps/<id>/registry
{ "server": "ghcr.io", "username": "me", "password": "ghp_읽기전용토큰" }
POST /v1/apps/<id>/deploy
{ "image": "ghcr.io/me/private-app:v1.0.0" }
읽기 전용 토큰을 쓰세요. 비밀번호보다 안전하고, 필요 없어지면 저장소 쪽에서 바로 끊을 수 있습니다.
저장한 토큰은 다시 볼 수 없고, 이미지를 받을 때만 쓰며 앱 안 환경변수로는 넣지 않습니다.
server 를 비우면 이미지 이름에서 알아냅니다.
정지와 삭제는 다릅니다
- 정지 — 주소와 데이터는 그대로이고 실행 시간 요금이 0원이 됩니다. 언제든 다시 시작합니다. 자리를 계속 차지하는 슬롯·볼륨 요금은 삭제할 때까지 부과됩니다
- 삭제 — 접속이 끊기고 볼륨 데이터도 함께 사라집니다. 모든 요금이 멈춥니다
자주 묻는 질문
-
정지와 삭제는 무엇이 다른가요?
정지는 주소와 데이터를 그대로 두고 실행 시간 요금만 0원이 되며, 슬롯·볼륨 요금은 계속 부과됩니다. 삭제는 접속이 끊기고 볼륨 데이터도 함께 사라지며 모든 요금이 멈춥니다.
-
이미지 태그를 latest 로 써도 되나요?
권하지 않습니다. latest 로 두면 나중에 이미지가 바뀌어도 언제 무엇이 바뀌었는지 알 수 없고 되돌릴 수도 없습니다. 태그를 정확히 적어 주세요.
-
저장한 환경변수를 다시 확인할 수 있나요?
확인할 수 없습니다. 봉인해서 보관하고 컨테이너에만 넣어 주기 때문에, 값이 필요하면 새 값으로 덮어써 주셔야 합니다.