Erros comuns em Velocidade de mudança para DevOps

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 16 min. de leitura

    • Identifique a causa raiz dos erros que ocorrem em Velocidade de mudança para DevOps e veja as etapas correspondentes que podem resolvê-las.

    Conexão da ferramenta

    Esta tabela lista as etapas necessárias para resolver os erros que podem ocorrer quando você seleciona Enviar ou Conecte botão após inserir os detalhes da ferramenta no processo de conexão da ferramenta:

    Mensagem Ação
    A ferramenta não pode ser criada porque o nome da ferramenta não foi inserido. Insira o nome da ferramenta e tente novamente. Insira novamente o nome da ferramenta.
    A ferramenta não pode ser criada porque a integração da ferramenta não foi selecionada. Selecione o valor de integração da ferramenta correto e tente novamente. Selecione o valor de integração da ferramenta correto.
    A ferramenta não pode ser criada porque a URL da ferramenta é inválida ou incorreta. Insira novamente o URL da ferramenta e tente novamente. Insira novamente o URL da ferramenta.
    A ferramenta não pode ser criada porque a versão da plataforma não pode ser determinada. Crie a propriedade glide.buildtag.last sys e tente novamente.
    1. Navegar até DevOps > Administração > Propriedades.
    2. Verifique se glide.buildtag.last sysa propriedade existe.
    3. Caso contrário, crie o. glide.buildtag.last syspropriedade.
    A ferramenta não pode ser criada porque a conexão da ferramenta CreateDevOps associada é inválida. Crie um alias de conexão válido e tente novamente.
    1. Navegar até Todas > Conexões e credenciais > Aliases de conexão e credencial e abra CreateDevOpsTool registro.
    2. Na lista relacionada Conexões, crie um registro e insira um nome para a conexão.
    3. No formulário Conexão, selecione Credencial lista de pesquisa de campo e selecione Novo para criar uma credencial de administrador.
    4. Selecione Credenciais de autenticação básica e insira um nome.
    5. Insira o nome de usuário e a senha do administrador (necessários para acessar as ferramentas em seu ambiente DevOps).

      Um usuário com a função connection_admin pode configurar uma conexão HTTP.

    6. No formulário Conexão, insira https://<instance name>.service-now.com/ Para o URL de conexão.
    A ferramenta não pode ser criada porque as credenciais do alias CreateDevOpsTool estão incorretas. Atualize o registro de credencial e tente novamente.
    1. Selecione registro de credencial link na mensagem. Se você estiver se conectando à ferramenta a partir da IU do espaço, clique com o botão direito do mouse no link do registro de credenciais e selecione Abrir em uma nova guia .
    2. Na página de registro de credenciais, insira as credenciais corretas em Nome de usuário e. Senha campos.
    3. Salve as mudanças e tente se conectar à ferramenta novamente.
    A ferramenta não pode ser criada porque a URL de conexão do alias CreateDevOpsTool está incorreta. Use o seguinte URL: https://<instancename>.service-now.com,and Tente novamente.
    1. Navegar até Todas > Conexões e credenciais > Aliases de conexão e credencial e abra CreateDevOpsTool registro.
    2. No formulário Conexão, insira https://<instance name>.service-now.com/ Para o URL de conexão.
    Para criar um alias de conexão, você precisa da função connection_admin. Entre em contato com o administrador do sistema. Este erro ocorre se o campo alias de conexão estiver vazio para um registro de ferramenta. Para criar a conexão da ferramenta, você precisa de um alias de conexão. Somente um usuário que tenha connection_admina função pode criar um alias de conexão. Você deve entrar em contato com um usuário com esta função, como um administrador, e obter o alias de conexão criado.
    A ferramenta não pode ser criada porque o nome da ferramenta <toolname> já existe. Insira um nome diferente e tente novamente. Use um nome diferente para a ferramenta.
    A ferramenta não pode ser criada porque o <toolname> não tem uma configuração de MID Server válida. Configure um MID Server válido e tente novamente.
    1. Se você estiver usando o espaço, verifique se o MID Server está em execução e acessível.
    2. Se você estiver usando o catálogo e o produtor de registro, verifique se o MID Server está em execução e acessível com a aplicação como DevOps e a capacidade como REST.
    A ferramenta não pode ser criada porque não há aliases de conexão e credenciais disponíveis para o escopo do Modelo de dados DevOps. Crie um novo alias de conexão e credencial e tente novamente.

    Este erro ocorre para autenticação OAuth.

    1. Navegar até Todas > Conexões e credenciais > Aliases de conexão e credencial.
    2. Crie um novo alias com a aplicação como Modelo de dados do DevOps .
    A ferramenta não pode ser criada devido a um problema técnico ao criar o registro de credencial.
    1. Navegar até Todos > Automação de processos > Flow Designer > Execuções.
    2. Verifique a execução mais recente do subfluxo sn_devops.devops_create_credentials para saber os detalhes do erro.
    A ferramenta não pode ser criada porque já existe uma combinação de credenciais e domínio referente a um registro ativo.

    Este erro ocorre para autenticação OAuth.

    1. Use uma credencial diferente.
    2. Verifique se a credencial existente é usada por qualquer conexão ativa.
    A ferramenta não pode ser criada devido a um problema técnico ao criar o registro de conexão.
    1. Navegar até Todos > Automação de processos > Flow Designer > Execuções.
    2. Verifique a execução mais recente de sn_devops.create_connection_for_toolação para saber os detalhes do erro.
    A ferramenta não pode ser criada pelos seguintes motivos:
    • O subfluxo Validar não está configurado, e.
    • Um registro de capacidade de integração com o mesmo nome de subfluxo não existe para a integração da ferramenta associada.
    Configure o subfluxo e crie o registro de capacidade de integração com a ação Validar e um nome de subfluxo para a integração da ferramenta e tente novamente.

    Este erro ocorre somente para integrações de ferramentas personalizadas.

    1. Navegar até Todos > Automação de processos > Flow Designer.
    2. Na página do Flow Designer, selecione Subfluxos guia.
    3. Abra o. Validação do subfluxo de demonstração do DevOps registro da lista.
    4. Na seção Ações, abra Demonstração do DevOps Validar ação Registre selecionando a ação Abrir no Designer de ações ( Ícone Abrir ação no Designer de açõesícone ).
    5. Selecione Menu Mais ações > Copiar ação .Caixa de diálogo Copiar ação
    6. Insira um novo nome para a ação e selecione a aplicação como Integrações de DevOps e selecione Cópia .
    7. Na ação copiada, selecione Entradas > Etapa REST .
    8. Na seção Detalhes da solicitação, insira o caminho do recurso da sua ferramenta personalizada em Caminho do recurso campo.Validar tela de ação
    9. Insira a versão da API da sua ferramenta personalizada no Parâmetros de consulta campo.
    10. Salve as mudanças.
    11. Publique a ação selecionando Publicar .
    12. Navegue de volta para Validação do subfluxo de demonstração do DevOps registro.
    13. Selecione Menu Mais ações > Copiar subfluxo .
    14. Insira um novo nome para o subfluxo e selecione a aplicação como Integrações de DevOps e selecione Cópia .
    15. No subfluxo copiado, exclua Demonstração do DevOps Validar ação e adicione a ação que você criou na etapa 11.Adicionar novo registro de ação
      1. Em Ação , selecione a ação que você criou na etapa 11.
      2. Em AliasGR , selecione o registro Alias de conexão e credencial em Dados > Pesquisar registros seção.
      3. Em apiversion selecione a versão da api em Entradas de dados > subfluxo seção.
      4. Salve as mudanças.
    16. Publique o subfluxo selecionando Publicar .
    17. Navegar até DevOps > Integrações > Capacidades de integração e criar um registro com Validar ação.

      Para obter mais informações, consulte Crie uma integração de ferramenta DevOps .

      Guia relacionada aos recursos de integração
    18. Associe o subfluxo que você criou na etapa 16 ao registro de capacidade de integração.
    A ferramenta não pode ser criada devido a um problema de conectividade. Verifique o subfluxo do <validate_subflow_name> para obter mais detalhes e tente novamente.
    1. Navegar até Todos > Automação de processos > Flow Designer > Execuções.
    2. Verifique a execução mais recente do subfluxo do <validate_subflow_name> para saber os detalhes do erro.
    As credenciais de autorização da ferramenta são inválidas. Insira credenciais válidas e tente novamente. Insira novamente o nome de usuário/senha corretos para a ferramenta.
    A ferramenta não pode ser criada porque não há resposta recebida do servidor. Insira um URL de ferramenta válido ou Verifique se o servidor está funcionando e tente novamente.
    1. Insira novamente o URL da ferramenta.
    2. Verifique o MID Server.
    O URL de conexão está incorreto, verifique

    URL e tente novamente.

    		 Insira novamente o URL da ferramenta.
    A ferramenta não pode ser conectada porque o nome do slug do aplicativo GitHub está incorreto. Insira o nome correto do slug do app GitHub e tente novamente. Você pode encontrar GitHub nome do slug da aplicação na página de configurações do seu GitHub aplicação. . GitHub O nome do slug da aplicação é o nome amigável para URL do seu GitHub aplicação. Por exemplo, se você criou um GitHub aplicação com o nome App de teste , O URL correspondente amigável GitHub o nome do slug da aplicação será test-app . Em seu GitHub"https://github.com/settings/apps/test-app", "test-app" é o. GitHub nome do slug da aplicação. Para obter mais informações, consulte Documentação do GitHub .
    O valor da senha é muito longo e pode ser truncado após a criptografia. Reduza o tamanho da senha ou aumente o tamanho do campo. A partir de 18 de janeiro de 2023, o Jira ampliou a duração dos tokens de API para contas Atlassian. Você deve aumentar o valor máximo da senha para mais de 255 na tabela discovery_credentials para acomodar o tamanho de caracteres estendido. Para obter mais informações, consulte KB1269878 artigo da base de conhecimento e. Documentação do Atlassian .
    Comportamento inesperado do host remoto: Redirecionamento circular para 'https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers'. Este erro pode ocorrer se você tentar se conectar a uma instância do BitBucket Cloud. O BitBucket Cloud não é compatível. Você deve usar uma instância do BitBucket Server para se conectar ao ServiceNow DevOps. Conecte-se à sua instância do BitBucket por meio de um MID Server. Um MID Server será necessário se sua instância de ferramenta estiver hospedada no local. Para obter mais informações sobre o MID Server, consulte Seleção DO MID Server
    URL da ferramenta incompatível: URL da ferramenta inserido na ServiceNow: https://<URL da instância Jenkins inserida> URL da ferramenta inserida no Jenkins: https://<Jenkins URL do local inserido no Jenkins> No Jenkins, em Gerenciar Jenkins > Sistema, verifique se a URL do Jenkins configurada é igual à URL da ferramenta inserida aqui. Consulte os erros de integração da ferramenta de solução de problemas.

    Este erro ocorre quando Jenkins URL inserida em DevOpsé diferente de Jenkins URL inserida em Jenkins instância.

    Do seu Jenkins instância, navegue até Gerenciar Jenkins > Sistema > Local do Jenkins. . URL do Jenkins inserido aqui deve corresponder a. URL da instância Jenkins inserido DevOps.

    Permissões de ferramenta

    Esta seção lista as etapas necessárias para resolver erros de permissão da ferramenta ao criar uma ferramenta DevOps usando playbooks do espaço. As diretrizes de verificação de permissão da ferramenta são exibidas em um pop-up quando você se conecta a uma ferramenta do espaço .

    Ação

    Se alguma permissão estiver ausente, execute as seguintes etapas:

    • Atualize as permissões para as credenciais fornecidas na ferramenta DevOps externa. Selecione Atualizar no pop-up para executar as verificações novamente.
    • Feche o pop-up, use credenciais diferentes e selecione Conecte novamente. O pop-up de verificação de permissão é exibido com os resultados das credenciais recém-inseridas.
    • Revise a coluna Impacto e, se o impacto não afetar seu caso de uso, selecione Continuar de qualquer forma.
    Se todas as verificações de permissão forem bem-sucedidas:
    Propriedade de tempo limite de verificação de permissão da ferramenta

    Durante o processo de conexão da ferramenta, o sistema executa validações de permissão em primeiro plano e restringe a página de conexão da ferramenta. Para cada validação de permissão, uma chamada de REST API é feita para ferramentas externas para avaliar a disponibilidade da permissão. O tempo de resposta da REST API pode variar com base nas configurações de rede. Para evitar atrasos, você pode especificar quanto tempo o sistema deve esperar para obter uma resposta de uma ferramenta externa antes de marcar a permissão como um erro. Você pode especificar esse tempo usando Tempo limite de verificação de permissão da ferramenta por registro (em milissegundos) propriedade (sn_devops.permission_check_timeout). Se você achar que algumas das verificações de permissão estão resultando em um erro, tente aumentar o valor do tempo limite e selecione Atualizar No pop-up Permissões.

    Notificação da ferramenta

    Esta tabela lista as etapas necessárias para resolver erros que podem ocorrer em cenários como recuperação de detalhes de confirmação, detalhes de execução de pipeline, detalhes de solicitação de extração e resumos de testes:

    Motivo Ação
    As credenciais de autorização são inválidas ou não têm as permissões mínimas necessárias.
    • Verifique se suas credenciais de ferramenta de terceiros têm os escopos necessários. Se você estiver usando a IU do espaço, poderá navegar até o registro da ferramenta e selecionar Mais ações ( Ícone Mais ações> Verificar permissões de credencial para saber mais sobre as permissões necessárias.
    • Verifique se você inseriu o nome de usuário/senha corretos para sua ferramenta de terceiros. Se você estiver usando a IU do espaço e quiser atualizar as credenciais da ferramenta, navegue até o registro da ferramenta e selecione Mais ações ( Ícone Mais ações> Verificar permissões de credencial. Para obter mais informações sobre como atualizar credenciais, consulte Atualize credenciais de ferramenta de terceiros em Velocidade de mudança para DevOps.
    Não há resposta do servidor. Verifique o status da conexão do servidor e tente novamente.
    • Verifique se o servidor da ferramenta DevOps está acessível e responsivo.
    • Se o MID Server estiver configurado, verifique se o servidor está ativo e em execução.
    Não é possível processar a solicitação. Verifique se o número máximo de instâncias associadas a um webhook foi excedido. Se você encontrou este erro no GitHub, verifique se você associou mais de 20 instâncias a um webhook.
    As credenciais de autorização não têm as permissões mínimas necessárias. Verifique se suas credenciais de ferramenta de terceiros têm os escopos necessários. Se você estiver usando a IU do espaço, poderá navegar até o registro da ferramenta e selecionar Mais ações ( Ícone Mais ações> Verificar permissões de credencial para saber mais sobre as permissões necessárias.
    A configuração do MID Server é inválida. Configure um MID Server válido e tente novamente. Verifique se o MID Server está em execução e acessível.
    A URL de conexão é inválida. Insira um URL válido e tente novamente.
    1. Navegar até Todas > Conexões e credenciais > Aliases de conexão e credencial e abra o registro de conexão e credencial necessário.
    2. Na lista relacionada Conexões, abra o relacionado Conexão formulário.
    3. Em Conexão , verifique se o URL de conexão da ferramenta de terceiros está correto.
    O limite de taxa foi excedido. Tente novamente após (0).

    Limite de taxa é o número de chamadas de API que um app ou usuário pode fazer em um determinado período. A limitação de taxa é uma técnica para limitar o tráfego de rede para ajudar a impedir que os usuários esgotem os recursos do sistema. Se o limite de taxa máximo permitido em sua ferramenta de terceiros tiver excedido, você poderá encontrar este erro.
    Suas credenciais não têm os escopos exigidos. Verifique se suas credenciais de ferramenta de terceiros têm os escopos necessários. Se você estiver usando a IU do espaço, poderá navegar até o registro da ferramenta e selecionar Mais ações ( Ícone Mais ações> Verificar permissões de credencial para saber mais sobre as permissões necessárias.

    Solicitação de mudança

    Esta tabela lista as etapas necessárias para resolver erros que podem ocorrer durante a criação da solicitação de mudança:

    Erro Ação
    A solicitação de mudança não pode ser criada porque o sinalizador de compatibilidade de tipo está desabilitado. Habilite o sinalizador de compatibilidade de tipo nas propriedades do sistema ou configure o modelo de mudança no registro de etapa na ServiceNow ou insira o sys ID do modelo de mudança apropriado no pipeline.
    • Navegue até Todos > Propriedades do sistema e habilite o. com.snc.change_management.change_model.type_compatibilitypropriedade, ou
    • Adicione o modelo de mudança no formulário Etapa ou atributos de mudança do pipeline.
    Não é possível criar a solicitação de mudança, uma vez que o tipo ou o modelo de mudança não está configurado para o pipeline. Adicione o modelo ou o tipo de mudança no formulário Etapa ou atributos de mudança do pipeline.

    Erros gerais

    Esta tabela lista as etapas necessárias para resolver alguns erros gerais que podem ocorrer ao trabalhar com a aplicação DevOps Change Velocity.

    Ocorrência Ação
    A solicitação de importação não está em andamento

    Se uma solicitação de importação permanecer no estado Solicitado por muito tempo durante a execução de uma importação para uma ferramenta (como Jenkins, Jira ou GitHub exclua a solicitação de importação e tente novamente.

    Nota:
    Exclua a solicitação existente para tentar importar novamente o mesmo intervalo.
    Falha na conexão da ferramenta

    Remova a barra final ( '/') no URL de conexão Campo no formulário Conexão HTTP.
    Nenhuma solicitação de mudança foi criada para um Jenkins trabalho em controle de mudanças Verifique se:
    • A integração da ferramenta em sua instância está configurada corretamente.
    • A tarefa foi sincronizada em sua instância.
    • Tarefas e etapas do app foram configuradas em sua instância.
    A criação de solicitação de mudança não será compatível se a tarefa estiver sob controle de mudanças:
    • Não faz parte de um pipeline (é uma tarefa autônoma, por exemplo).
    • É o primeiro no pipeline.
    • Está no pipeline, mas o usuário aciona manualmente ou faz check-out do SCM diretamente na tarefa sob controle de mudança (portanto, não aciona o pipeline desde o início).
    Jenkins não bloqueia o trabalho sob controle de mudança (não aguarda a aprovação da solicitação de mudança)

    Verifique se o Jenkins o local está configurado:

    Navegar até Jenkins > Gerenciar Jenkins > Configurar o sistema e fornecem o nome do host para URL do Jenkins . Jenkins Seção Local.

    Nota:
    Para evitar problemas de cache, clique em Salvar . URL do Jenkins o campo já contém um valor quando você abre o formulário pela primeira vez.
    Eventos que ocorrem no log de carga com o estado não conectado
    Se alguma das seguintes mudanças em uma conexão for feita manualmente (usando o modo de configuração manual), a conexão será desconectada automaticamente.
    • Alias associado à ferramenta
    • Tipo de ferramenta
    • Nova conexão HTTP ativa para o mesmo domínio adicionada ao alias
    • Conexão HTTP existente para o mesmo domínio ativada
    • URL de conexão da conexão HTTP
    • Credenciais da conexão HTTP
    • Usar MID Server Configuração na conexão HTTP

    Entre no modo de configuração manual e reconecte.
    Repetir eventos de entrada que falham ou apresentam erro devido a TimeoutException/FlowObjectAPIException da REST API
    Atualize o. Retry Errored Inbound Eventstrabalho agendado para tentar processar novamente os eventos de entrada que estão em Errorestado.
    • Atualize a lista de erros ou exceções para especificar as exceções para as quais você deseja repetir o processamento do evento.
    • Modifique o padrão Maximum Retrycontagem.
    Para obter mais informações, consulte Repetir eventos de entrada com erro.

    Execução de pipeline em ServiceNow DevOps Não avança e aguarda indefinidamente, já que as varreduras SonarQube não ocorrem devido à ausência da ferramenta SonarQube.

    O evento de entrada de qualidade de software exibe a seguinte mensagem de erro no campo Detalhes de processamento. "Verifique se a respectiva ferramenta SonarQube foi criada com sucesso. Caso contrário, crie a ferramenta SonarQube e tente o evento de entrada novamente."

    Para todas as etapas do SonarQube em verificações de qualidade de código, o usuário deve criar a ferramenta SonarQube no ServiceNow DevOps instância.

    Para obter mais informações, consulte SonarQube integração com Velocidade de mudança para DevOps.
    A IU do pipeline exibe links desfeitos entre as fases. Navegue até Execuções de tarefas E certifique-se de que a coluna Execuções ascendentes tenha as referências de link ascendentes apropriadas.