ntro CLI
전역 옵션·인증·로컬 상태
ntro의 공통 플래그, 자격 증명 우선순위와 앱 연결 파일을 안내합니다.
ntro의 모든 명령은 다음 공통 옵션을 받습니다.
| 옵션 | 의미 |
|---|---|
--api <url> | Control API 주소. 플래그 → NITROSHIP_API_URL → 저장된 controlUrl → https://api.nitroship.co 순서입니다. |
--identity <url> | Identity issuer 주소. 플래그 → NITROSHIP_IDENTITY_URL → https://auth.nitroship.co 순서입니다. |
--token <token> | API Bearer 토큰. NITROSHIP_TOKEN보다 우선합니다. |
--team <id|slug> | 명령에서 사용할 팀을 선택합니다. 저장된 로그인에서는 선택한 팀이 없으면 서버 기본 팀을 사용합니다. |
--json | 지원하는 명령의 성공 결과를 JSON으로 표시합니다. 오류 출력은 텍스트입니다. |
--verbose | HTTP 응답의 request-id를 표준 오류에 표시합니다. |
--help, --version | 도움말과 CLI 버전을 표시합니다. |
인증은 명시적인 --token → NITROSHIP_TOKEN → 저장된 OIDC 로그인 순서입니다. CLI는 저장된 access JWT가 만료되면 refresh token으로 갱신합니다. ntro login은 기기 승인 방식이며, 자동화에는 ntro_ API 토큰을 사용합니다. ntro logout은 저장된 refresh token을 철회하고 로컬 자격을 지웁니다.
자격 정보는 기본적으로 ~/.nitroship/credentials.json에 저장합니다. NITROSHIP_CONFIG_DIR를 지정하면 해당 디렉터리 아래의 credentials.json을 사용합니다. 디렉터리 권한은 0700, 파일은 0600입니다. 인증 파일을 저장소에 추가하지 않습니다.
ntro link <appId|slug>는 현재 디렉터리의 .nitroship/project.json에 앱과 팀의 ID를 기록합니다. deploy [dir]는 배포할 디렉터리의 링크를 읽지만 다른 명령은 현재 작업 디렉터리의 링크를 읽습니다. 다른 팀의 앱을 사용하거나 링크한 앱의 팀이 바뀐 경우 다시 연결합니다.
ntro apps create my-app
ntro link my-app
ntro deploy . --prod