문제 해결

가장 마주치기 쉬운 문제들에 대한 실용적인 해결책입니다.

인증 실패

명령어가 인증 오류를 반환하면, CLI가 어떤 신원(있다면)을 해석하고 있는지 확인하시기 바랍니다.

suya auth whoami     # calls the API and prints the resolved identity
suya auth status     # local auth status, no server call

에이전트와 CI의 경우, suya를 실행하는 셸에서 SUBAYA_API_KEY가 export되었는지 확인하시기 바랍니다.

echo "${SUBAYA_API_KEY:?SUBAYA_API_KEY is not set}"

자격 증명 우선순위를 기억하시기 바랍니다: --token 플래그가 우선하고, 그다음 SUBAYA_API_KEY, 그다음 로컬에 저장된 OAuth 토큰입니다. 오래전에 로그인했다면, 새로운 suya auth login이 로컬 토큰을 다시 설정합니다. 인증 및 API 키를 참고하시기 바랍니다.

명령어가 잘못된 호스트에 도달함

모든 명령어는 기본적으로 https://subaya-dev.com과 통신합니다. 요청이 실패하거나 예상치 못한 곳에 도달한다면, 부주의하게 --host를 전달하지 않았는지 확인하시기 바랍니다.

suya auth whoami --host https://subaya-dev.com

기본값이 아닌 API 엔드포인트를 대상으로 하려는 경우에만 --host를 재정의하시기 바랍니다.

`suya sim run`이 테스트벤치를 찾지 못함

--tb 경로는 셸의 작업 디렉터리 기준이 아니라 --source 트리 내에서 해석됩니다. 실행이 테스트벤치 누락을 보고하면, 업로드하는 소스 디렉터리 내부에서 경로가 해석되는지 확인하시기 바랍니다.

suya sim run --source . --tb tb/top_tb.sv --top top --tool ryusim

두 가지를 확인하시기 바랍니다.

--tb 경로가 --source 디렉터리 아래에 존재합니다.
--source 트리가 4 MB 이하입니다 — 제출하기 전에 빌드 산출물과 대용량 바이너리 파일을 정리하시기 바랍니다.

전체 시뮬레이션 체계는 CLI: sim를 참고하시기 바랍니다.

`suya repo connect` / `repo create` 실패

두 repo 명령어 모두 --installation을 통해 GitHub App installation id가 필요합니다.

suya repo connect --installation <id> --owner <o> --repo <r>
suya repo create  --installation <id> --name <n>

아직 installation id가 없다면, 먼저 GitHub App을 설치하시기 바랍니다 — GitHub 리포지토리 연결을 참고하시기 바랍니다. 현재 연결 상태는 다음으로 확인하시기 바랍니다.

suya repo status

오래된 CLI

명령어나 플래그가 누락되었거나, 동작이 이 문서와 일치하지 않는다면, CLI가 오래되었을 수 있습니다. 확인하고 업그레이드하시기 바랍니다.

suya version            # show version metadata
suya update --check     # report whether a newer release exists
suya update             # upgrade to the latest release

여전히 막혀 있습니까?

추가 진단을 위해 -v/--verbose로, 또는 기계가 읽을 수 있는 출력을 위해 --json으로 다시 실행하시기 바랍니다.
상태 페이지에서 서비스 상태를 확인하시기 바랍니다.
CLI 레퍼런스에서 전체 명령어 체계를 둘러보시기 바랍니다.