명령 레퍼런스
공개 ntro 명령, 인자, 전용 옵션과 Vercel 호환 별칭을 확인합니다.
명령을 인자 없이 실행하거나 존재하는 디렉터리를 ntro <dir>로 전달하면 배포할 수 있습니다. 모든 명령에는 전역 옵션이 적용됩니다. 아래 표에는 해당 명령의 전용 플래그만 나열합니다. 명령 그룹의 플래그는 하위 명령에 상속됩니다.
로그인·상태·업데이트
| 명령 | 전용 옵션과 동작 |
|---|---|
ntro login | --no-browser: 확인 URL·코드를 표시하고 브라우저를 자동으로 열지 않습니다. |
ntro logout | refresh token을 철회하고 로컬 자격 정보를 지웁니다. |
ntro whoami | 현재 사용자와 이메일 인증 상태를 확인합니다. |
ntro status | API 상태와 로그인 상태를 확인합니다. |
ntro healthcheck | API의 /healthz를 확인합니다. |
ntro update | --check: 새 버전만 조회합니다. 별칭 upgrade를 지원합니다. |
팀·앱
| 명령 | 인자·전용 옵션과 동작 |
|---|---|
ntro teams list | 참여 팀을 조회합니다. |
ntro teams create <name> | --slug <slug>를 선택적으로 지정합니다. 이름에서 슬러그를 생성할 수 없으면 필수입니다. |
ntro teams switch <team> | 기본 팀을 변경합니다. |
ntro teams members list | 선택 팀의 멤버를 조회합니다. |
ntro teams members add <email> | --role owner|member|billing|viewer가 필수입니다. 기존 사용자를 추가합니다. |
ntro teams members role <user> <role> | 사용자 ID 또는 이메일로 역할을 변경합니다. |
ntro teams members remove <user> | 사용자 ID 또는 이메일로 멤버를 제거합니다. |
ntro switch [team] | teams switch 별칭입니다. 인자가 없으면 대화형으로 선택합니다. |
ntro apps list | 선택 팀의 앱을 조회합니다. |
ntro apps create <slug> | 앱을 만듭니다. |
ntro apps show <id|slug> | 앱 정보를 표시합니다. |
ntro apps delete <id> | 앱 삭제를 확인합니다. 비대화형에서는 --yes가 필요합니다. |
ntro link <appId|slug> | 현재 디렉터리에 앱을 연결합니다. |
teams의 별칭은 team, apps의 별칭은 project|projects입니다. 목록에는 ls, 삭제에는 해당 명령의 rm|remove 별칭을 사용할 수 있습니다. 멤버 추가·변경·삭제는 팀 owner가 실행합니다.
배포·로그
| 명령 | 인자·전용 옵션과 동작 |
|---|---|
ntro deploy [dir] 또는 ntro [dir] | --app <id|slug>, --prod, --preview, --target production|preview, --no-wait, --timeout <duration>, --yes, --regions <comma-list>, --tier standard|large, --min-instances <0..32>, --max-instances <1..32>, --image sha256:<digest>, --skip-build, --bundle-dir <dir>, --entrypoint '<command ...>'. |
ntro deployments list | --app <id|slug>(그룹 상속), --target production|preview로 목록을 필터합니다. |
ntro deployments show <short-id|id> | --app <id|slug>(그룹 상속)로 배포를 조회합니다. |
ntro ls | --app, --target: deployments list의 최상위 별칭이며 list로도 호출할 수 있습니다. |
ntro inspect <short-id|id> | --app, --logs: deployments show 후 선택적으로 배포 이벤트를 출력합니다. |
ntro redeploy <short-id|id> | --app, --prod 또는 --preview: 기존 준비된 배포에서 새 배포를 만듭니다. |
ntro promote <short-id|id> | --app: 준비된 배포를 프로덕션으로 승격합니다. |
ntro rollback <short-id> | --app, --yes: 이전 배포로 되돌립니다. |
ntro logs <short-id|id> | --app, --follow: 배포 이벤트를 표시하거나 이어받습니다. |
ntro registry login | Docker 로그인 명령을 출력만 합니다. 출력에 자격이 포함되므로 공유 로그에 남기지 않습니다. |
--prod, --preview, --target은 함께 사용할 수 없습니다. 첫 배포는 프로덕션, 이후 기본값은 프리뷰입니다. 배포는 기본적으로 최대 10분 동안 준비 완료/실패를 기다리고 --no-wait는 업로드 직후 반환합니다. --regions 등 컴퓨트 옵션은 Next.js 배포를 참고합니다. --image와 --bundle-dir는 함께 사용할 수 없고 --bundle-dir에는 --entrypoint가 필요합니다. --skip-build는 이미 빌드한 관리형 Next.js 결과에만 사용합니다.
도메인·환경 변수·캐시
| 명령 | 인자·전용 옵션과 동작 |
|---|---|
ntro domains add <hostname> | 그룹 --app <id|slug>: 도메인을 등록합니다. |
ntro domains list | 그룹 --app: DNS와 인증서 상태를 조회합니다. |
ntro domains verify <hostname> | 그룹 --app, --wait, --timeout <duration>: 소유권 확인을 요청하고 필요하면 기다립니다. |
ntro domains remove <hostname> | 그룹 --app, --yes: 도메인을 해제합니다. |
ntro env ls [production|preview] | 그룹 --app: 값 목록을 조회합니다. list 별칭을 지원합니다. |
ntro env add <KEY> [production|preview] | 그룹 --app, --sensitive, --no-sensitive, --force: 값을 입력받아 저장합니다. |
ntro env rm <KEY> [production|preview] | 그룹 --app, --yes: 변수를 삭제합니다. remove 별칭을 지원합니다. |
ntro env pull [file] | 그룹 --app, --environment production|preview, --yes: 읽을 수 있는 값을 파일에 씁니다. |
ntro env run -- <cmd> [args...] | 그룹 --app, --environment production|preview: 읽을 수 있는 값을 자식 명령에 적용합니다. |
ntro purge <url|/path> | --app, --wait, --yes: 정확한 URL/경로 하나를 무효화합니다. 인자 대신 --prefix <path>, --glob <pattern>, --all 중 하나를 사용할 수 있습니다. |
domains list와 domains remove에는 ls, rm 별칭이 있습니다. 환경 변수의 대상은 production|preview만 지원하며 기본적으로 secret으로 저장합니다. 환경 변수, 커스텀 도메인, 캐시 무효화를 참고합니다.
사용량·청구
| 명령 | 전용 옵션과 동작 |
|---|---|
ntro usage | --from <YYYY-MM-DD|RFC3339>, --to <YYYY-MM-DD|RFC3339>, --by region|app|day: 팀의 사용량과 예상 금액을 확인합니다. |
ntro billing | 팀 플랜·결제 상태를 확인합니다. |
ntro invoices | 팀의 청구서 목록을 확인합니다. |
세 명령 모두 공통 --team <id|slug>를 사용할 수 있습니다. 사용량과 청구를 참고합니다.