Listando e Gerenciando Tasks
A página /repositories/:repositoryId/tasks mostra execuções relacionadas ao repositório. Use-a para criar tasks, acompanhar trabalho em andamento, tentar novamente execuções interrompidas, baixar resultados concluídos ou remover registros.
Quando usar
- Use a página para revisar todas as tasks de um repositório.
- Use-a para acompanhar status e abrir detalhes de execução.
- Use-a para baixar resultados de tasks concluídas.
- Use-a para parar, reiniciar ou excluir uma task quando a ação estiver disponível.
Acessando tasks
Você pode abrir a lista de tasks pelas abas do workspace, pela ação recomendada na lista de repositórios ou pelo command palette quando um repositório está ativo.
Se entrar por uma rota global, selecione um repositório primeiro. O repositório precisa estar pronto para execução de tasks. Se nenhum repositório estiver disponível, a página orienta o retorno para a lista de repositórios.
Entenda a lista
A lista mostra as execuções do repositório selecionado. Você pode:
- Buscar tasks por nome, descrição, tipo, linguagem ou status.
- Filtrar por status.
- Criar uma nova task.
- Abrir o detalhe da task.
- Baixar o resultado de uma task concluída.
- Reiniciar uma task com falha, cancelada ou revogada.
- Parar uma task pendente ou em execução.
- Excluir uma task.
Status de task
PENDING: a task foi criada e aguarda execução.RUNNING,STARTED,RECEIVED,RETRY: a task está em andamento.SUCCESS: a task foi concluída e os resultados estão disponíveis.FAILURE: a task falhou.REVOKED: a task foi revogada.CANCELLED: a task foi cancelada.STOPPING: a parada foi solicitada.
Quando existem tasks pendentes ou em andamento, a lista atualiza automaticamente em intervalos. Mensagens de sucesso aparecem temporariamente e podem ser fechadas. Mensagens de erro permanecem visíveis até o usuário fechar, para facilitar a leitura do motivo.
Ações de task
- View: abre o detalhe e progresso da task.
- Download: baixa o pacote de resultado de uma task concluída.
- Stop: pede confirmação antes de parar uma task pendente ou em andamento.
- Restart: inicia uma nova tentativa para tasks com falha, canceladas ou revogadas.
- Delete: remove a task após confirmação.
Se a API bloquear uma nova task porque outra está pendente ou em execução, aguarde a task ativa terminar ou pare a execução antes de criar outra.
Sequência de status
Tasks normalmente saem de PENDING para estados do worker como RECEIVED, STARTED e RUNNING. Depois, podem concluir com SUCCESS, falhar com FAILURE, tentar novamente com RETRY, ou ir para STOPPING e CANCELLED quando o usuário solicita parada.
Tasks revogadas, com falha ou canceladas podem ser reiniciadas quando a ação estiver disponível. Antes de reiniciar, revise a mensagem de erro visível e os logs no detalhe da task.
Resultado esperado
A lista deve mostrar o estado atual das execuções e oferecer apenas ações compatíveis com cada status.