Saída e códigos de saída

A saída da CLI do Nodaro é legível no terminal por padrão e legível por máquina com --json. Com --watch, um comando de execução aguarda até a execução terminar e informa o resultado no código de saída, então um shell script ou um job de CI pode tomar decisões com base nele.

Tabelas e JSON

Sem --json, um comando list imprime uma pequena tabela ASCII, e um comando get imprime um bloco JSON formatado. Todos os comandos de leitura aceitam --json e, com ele, imprimem o payload completo, pronto para o jq:

nodaro projects list --json | jq '.[].id'
nodaro workflows run wf_abc --json

Acompanhar uma execução com --watch

Um comando de execução retorna assim que o Nodaro aceita a execução. Adicione --watch para continuar consultando a execução periodicamente até ela terminar:

nodaro workflows run wf_abc --watch
nodaro nodes run generate-image --param prompt="a snow leopard" --watch --poll-interval 1000

--watch funciona nos comandos de execução, como workflows run, apps run e nodes run, em executions get e nos comandos de geração dos grupos de entidades e de mídia. --poll-interval define o tempo entre duas consultas, em milissegundos.

Códigos de saída

Com --json, a CLI imprime o payload e retorna sem definir os códigos 2, 3 e 130. Nesse modo, use o campo status da saída nas condições do script:

status=$(nodaro workflows run wf_abc --watch --json | jq -r '.status')

Quando o token está ausente, expirado ou inválido, a CLI avisa, sugere nodaro auth login e sai com o código 1. Para outros erros da API, ela imprime a mensagem e o código do erro. Os códigos estão listados em Erros.

Quando um job fica retido para revisão

Algumas implantações revisam as gerações antes de liberá-las. Em uma implantação assim, um job pode entrar no status pending_review. O trabalho está feito, os créditos continuam reservados, e uma pessoa decide se libera o resultado.

O status não muda sozinho, então o --watch interrompe a consulta periódica. Ele imprime awaiting review (a human decision is pending; not a failure) e sai com o código 3.

• Não execute a requisição de novo. Uma duplicata também ficaria retida.
• Verifique mais tarde com nodaro jobs get <id>. O job termina em um destes três estados:

nodaro nodes run generate-image --param prompt="..." --watch
case $? in
  0) echo "released" ;;
  3) echo "awaiting review, check back later" ;;
  *) echo "failed" ;;
esac