O que acontece quando uma task não finaliza corretamente no Runner ?

O Runner possui um tratamento interno para finalizar tasks em estado de erro quando:

• O erro não é reportado pelo código, ou

• Há um cancelamento forçado da task.

No entanto, em alguns cenários esse tratamento pode não ser acionado. Por exemplo:

• Se o Runner for encerrado de forma abrupta (reinício ou desligamento da máquina sem fechar o Runner previamente).

Nesses casos, a task pode permanecer no Orquestrador com status incorreto, como "Running".

Isso impacta as execuções seguintes ?

Não.
Se for apenas o status incorreto no Orquestrador, isso não afetará futuras execuções.

O problema é apenas visual/administrativo, mas você pode corrigir manualmente, logo abaixo veremos como manipular os dados via API e CLI para alterar esses status. 

Como corrigir o status de uma task parada no Orquestrador ?

Você pode alterar manualmente o status da task de duas formas:

1. Via API do Maestro

   • Exemplo na documentação da API
     

2. Via CLI (linha de comando) - Recomendado

   • Documentação CLI
     

Como finalizar uma task usando a CLI ?

1. Abra um terminal dentro pasta da BotCity.

2. Execute o comando abaixo (ajustando o taskId):
   

./BotCLI task finish -taskId "123" -totalItems 1 -processedItems 1 -failedItems 0
​

⚠️ Importante:

• Substitua "123" pelo ID da task que deseja alterar.

• O taskId pode ser obtido diretamente no Orquestrado
  

O que esse comando faz exatamente ?

• totalItems: Total de itens da task

• processedItems: Quantidade processada

• failedItems: Quantidade que falhou

Dessa forma, a task é marcada corretamente como concluída e não aparecerá mais como pendente.

👉 Assim, você garante que o status das tasks no Orquestrador esteja atualizado, mesmo em casos de interrupções abruptas do Runner.