ntro CLI
종료 코드
스크립트에서 ntro가 왜 실패했는지 종료 코드로 구분하는 방법입니다.
ntro는 끝날 때 숫자 하나(종료 코드)를 돌려줍니다. CI나 스크립트에서 $?로 확인하면 실패 원인을 나눠 처리할 수 있습니다.
| 코드 | 뜻 | 확인할 것 |
|---|---|---|
0 | 성공 | — |
1 | 그 밖의 오류 (빌드 실패, 배포 실패, 대기 시간 초과 등) | 빌드 로그: ntro builds logs |
2 | 명령 사용법·인자·옵션이 잘못됨 | ntro <명령> --help |
3 | API가 401 또는 403을 돌려줌 | 로그인·토큰이 유효한지, 그 팀에 권한이 있는지 |
4 | API가 400 또는 422를 돌려줌 | 보낸 값이 올바른지 |
5 | API가 409를 돌려줌 | 현재 상태와 충돌하는 요청인지 (예: 앱이 남은 팀 삭제) |
6 | 네트워크 오류 | 인터넷 연결, 프록시 설정 |
오류 메시지 읽기
- 오류는
--json을 써도 표준 오류(stderr)에 텍스트로 나옵니다. stdout의 JSON만 파싱하면 됩니다. - 서버가 돌려준 오류는 가능하면
<코드>: <메시지>형식입니다. - 사용법 오류에는 간단한 사용법과
--help안내가, 일부 API 오류에는 다음에 실행할 명령이 함께 나옵니다. - 요청이 너무 많아
429를 받았고 서버가 대기 시간을 알려 줬다면, 몇 초 뒤에 다시 시도하면 되는지 함께 표시합니다.
인증 오류가 날 때
- API 토큰이 만료됨: 콘솔에서 새 토큰을 만드세요.
- 로그인이 만료됨:
ntro login으로 다시 로그인하세요.