모든 youka 명령은 동일한 전역 플래그 세트를 지원합니다. 이 플래그들은 출력 모드, 입력 처리, 대기 동작, 그리고 대상 API를 제어합니다.
플래그
JSON 엔벨로프
--json를 사용하면, CLI는 stdout에 정확히 하나의 엔벨로프만 출력하고 그 외에는 아무것도 출력하지 않습니다.
성공:
실패:
종료 코드:
스크립팅을 위해 엔벨로프를 jq로 파이프하세요: youka project show $ID --json | jq '.data.state'.
JSON 바디 전달
모든 create 또는 update 명령은 전체 요청 바디를 위해 --body를 지원합니다. 명령줄에서 큰 JSON을 이스케이프하는 대신 이를 사용하세요.
비동기 작업 대기
--wait는 생성된 리소스를 대신 폴링하여 최종 상태를 반환합니다. --wait 없이 실행하면, 작업이 큐에 등록되는 즉시 명령이 반환됩니다.
스크립트에서는 --wait와 --quiet를 함께 사용해 진행 바는 숨기면서도 JSON 결과는 계속 출력할 수 있습니다.
멱등성
--idempotency-key를 전달하면 쓰기 명령을 안전하게 재시도할 수 있습니다. 동일한 키를 동일한 페이로드와 함께 재사용하면, 중복을 생성하는 대신 원래 결과를 반환합니다.
타임아웃 이후 에이전트가 재시도할 수 있는 상황이라면 언제든 멱등성 키를 사용하세요.
환경 변수
다음 단계