Listando e Gerenciando Processos
A página de processos em /repositories/:repositoryId/processes mostra as execuções relacionadas a um repositório. Use-a para criar processos, acompanhar o trabalho atual, repetir execuções interrompidas, baixar resultados concluídos ou remover registros de processos.
Quando usar
- Revisar todos os processos de um repositório.
- Acompanhar status e abrir os detalhes de execução.
- Baixar resultados de processos concluídos.
- Parar, reiniciar ou excluir um processo quando a ação estiver disponível.
Antes de começar
- Confirme a organização ativa.
- Abra um repositório com a pré-análise concluída.
- Verifique se não há um processo conflitante já pendente ou em execução.
Acessando os processos
Você pode abrir a lista de processos a partir de:
- A aba Processos no workspace do repositório.
- A ação recomendada na página de repositórios.
- O 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. Se nenhum repositório estiver disponível, a página o leva de volta à lista de repositórios.
Entenda a lista
A lista mostra as execuções do repositório selecionado. Você pode:
- Buscar por nome, descrição, tipo, idioma ou status.
- Filtrar por status.
- Criar um novo processo.
- Abrir os detalhes de um processo.
- Baixar o resultado de um processo concluído.
- Reiniciar um processo com falha, cancelado ou revogado.
- Parar um processo em execução ou pendente.
- Excluir um processo.
Status de processo
Os processos podem ter os seguintes status:
PENDING: criado e aguardando execução.RUNNING,STARTED,RECEIVED,RETRY: em andamento.SUCCESS: concluído e com resultados disponíveis.FAILURE: falhou.REVOKED: revogado.CANCELLED: cancelado.STOPPING: a aplicação está parando um processo em execução.
Quando há processos pendentes ou em andamento, a lista se atualiza automaticamente em intervalos. Mensagens de sucesso aparecem temporariamente e podem ser dispensadas. Mensagens de erro permanecem visíveis até você fechá-las, para que o motivo possa ser lido antes de repetir.
Ações de processo
As ações disponíveis dependem do status:
- Visualizar: abre a tela de detalhes e progresso do processo.
- Baixar: baixa o pacote de resultado de um processo bem-sucedido.
- Parar: pede confirmação antes de parar um processo em execução ou pendente.
- Reiniciar: inicia uma nova tentativa para um processo com falha, cancelado ou revogado.
- Excluir: remove o processo após confirmação.
Se a API bloquear um novo processo porque outro está pendente ou em execução, aguarde o processo ativo terminar ou pare-o antes de criar outro.
Sequência de status do processo
Os processos costumam ir de PENDING para estados do worker como RECEIVED, STARTED e RUNNING. Depois podem terminar com SUCCESS, falhar com FAILURE, repetir com RETRY ou passar por STOPPING e CANCELLED quando é solicitada uma parada.
Processos revogados, com falha ou cancelados podem ser reiniciados quando a ação está disponível. Antes de reiniciar, revise a mensagem de erro visível e os logs na tela de detalhes do processo.
Comportamento da base de conhecimento
A execução de processos alimenta a base de conhecimento do repositório. A documentação posterior pode se beneficiar de informações coletadas em execuções anteriores, e os resultados baixados podem incluir conteúdo cumulativo dependendo das opções selecionadas.
Resultado esperado
A lista deve mostrar o estado atual das execuções e oferecer apenas ações compatíveis com cada status.