Erros comuns em Velocidade de mudança para DevOps

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 16 min. de leitura

    • Identifique a causa raiz dos erros que ocorrem em Velocidade de mudança para DevOpse consulte as etapas correspondentes que podem resolvê-los.

    Conexão da ferramenta

    Esta tabela lista as etapas necessárias para resolver os erros que podem ocorrer ao selecionar o botão Enviar ou Conectar 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 do sistema glide.buildtag.last e tente novamente.
    1. Navegue até DevOps > Administração > Propriedades.
    2. Verifique se a propriedade glide.buildtag.last sys existe.
    3. Caso contrário, crie a propriedade glide.buildtag.last sys.
    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. Navegue até Todos > Conexões e credenciais > Aliases de conexão e credencial e abra o registro CreateDevOpsTool.
    2. Na lista relacionada Conexões, crie um registro e insira um nome para a conexão.
    3. No formulário Conexão, selecione a lista Pesquisa de campo de credencial 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 de 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 a 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 o link do registro de credenciais 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 de registro de credenciais e selecione Abrir em uma nova guia.
    2. Na página de registro de credenciais, insira as credenciais corretas nos campos Nome de usuário e Senha.
    3. Salve as mudanças e tente se conectar novamente à ferramenta.
    A ferramenta não pode ser criada porque o URL de conexão do alias CreateDevOpsTool está incorreto. Use o seguinte URL: https://<instancename> .service-now.com e tente novamente.
    1. Navegue até Todos > Conexões e credenciais > Aliases de conexão e credencial e abra o registro CreateDevOpsTool.
    2. No formulário Conexão, insira https:// <instance name> .service-now.com/ para a 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 de 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 com a funçãoconnection_admin pode criar um alias de conexão. Você deve entrar em contato com um usuário que tenha essa função, como um administrador, e obter o alias de conexão criado.
    A ferramenta não pode ser criada porque o<toolname> O nome da ferramenta 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 pode ser acessado 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 de DevOps. Crie um novo alias de conexão e credencial e tente novamente.

    Este erro ocorre na autenticação OAuth.

    1. Navegue até Todos > Conexões e credenciais > Aliases de conexão e credencial.
    2. Crie um novo alias com a aplicação como modelo de dados de DevOps.
    A ferramenta não pode ser criada devido a um problema técnico durante a criação do registro de credencial.
    1. Navegue 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 na autenticação OAuth.

    1. Use uma credencial diferente.
    2. Verifique se a credencial existente é usada por alguma conexão ativa.
    A ferramenta não pode ser criada devido a um problema técnico durante a criação do registro de conexão.
    1. Navegue até Todos > Automação de processos > Flow Designer > Execuções.
    2. Verifique a execução mais recente da ação sn_devops.create_connection_for_tool para saber os detalhes do erro.
    A ferramenta não pode ser criada pelos seguintes motivos:
    • O subfluxo de validação não está configurado e
    • Não existe um registro de capacidade de integração com o mesmo nome de subfluxo para a integração da ferramenta associada.
    Configure o subfluxo e crie o registro da 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. Navegue até Todos > Automação de processos > Flow Designer.
    2. Na página do Flow Designer, selecione a guia Subfluxos.
    3. Abra o registro Subfluxo de validação de demonstração de DevOps na lista.
    4. Na seção Ações, abra o registro Ação de validação de demonstração do DevOps selecionando o ícone Abrir ação no Designer de ações ( ícone Abrir ação no Action Designer).
    5. Selecione o menu Mais ações > Copiar ação.Copiar caixa de diálogo de ação
    6. Insira um novo nome para a ação e selecione a aplicação como Integrações de DevOpse selecione Copiar.
    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 no campo Caminho do recurso.Validar tela de ação
    9. Insira a versão da API da sua ferramenta personalizada no campo Parâmetros de consulta.
    10. Salve as mudanças.
    11. Publique a ação selecionando Publicar.
    12. Navegue de volta para o registro de Subfluxo de validação de demonstração de DevOps.
    13. Selecione o menu Mais ações > Copiar subfluxo.
    14. Insira um novo nome para o subfluxo e selecione a aplicação como Integrações de DevOpse selecione Copiar.
    15. No subfluxo copiado, exclua a ação de validação de demonstração do DevOps e adicione a ação que você criou na etapa 11.Adicionar novo registro de ação
      1. No campo Ação, selecione a ação que você criou na etapa 11.
      2. No campo aliasGR, selecione o registro Alias de conexão e credencial na seção Dados > Pesquisar registros.
      3. No campo de apiversion, selecione a versão da API na seção Dados > Entradas de subfluxo.
      4. Salve as mudanças.
    16. Publique o subfluxo selecionando Publicar.
    17. Navegue até DevOps > Integrações > Capacidades de integração e crie um registro com a ação Validar.

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

      Guia relacionada às capacidades de integração
    18. Associe o subfluxo criado na etapa 16 ao registro da capacidade de integração.
    A ferramenta não pode ser criada devido a um problema de conectividade. Verifique o<validate_subflow_name> subfluxo para obter mais detalhes e tente novamente.
    1. Navegue até Todos > Automação de processos > Flow Designer > Execuções.
    2. Verificar a execução mais recente de<validate_subflow_name> subfluxo 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/a 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.
    A URL de conexão está incorreta, verifique

    URL e tente novamente.

    		 Insira novamente o URL da ferramenta.
    A ferramenta não pode ser conectada porque o nome do slug da aplicação do GitHub está incorreto. Insira o nome correto do slug da aplicação do GitHub e tente novamente. Você pode encontrar o nome do slug da aplicação GitHub na página de configurações da sua aplicação GitHub. O nome do slug da aplicação GitHub é o nome compatível com URL da sua aplicação GitHub. Por exemplo, se você criou um app GitHub com o nome App de teste, o nome do slug do app GitHub compatível com URL correspondente será test-app. Na sua GitHub URL - "https://github.com/settings/apps/<test-app> ", " " é o nome do slug da aplicação GitHub. Para obter mais informações, consulte a documentação do GitHub.
    O valor da senha é muito longo e pode ficar 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 estendeu o tamanho dos tokens de API para contas da Atlassian. Você deve aumentar o valor máximo da senha para mais de 255 na tabela discovery_credentials para acomodar o tamanho de caractere estendido. Para obter mais informações, consulte o artigo KB1269878 da base de conhecimento e a documentação da 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 a instância da ferramenta estiver hospedada no local. Para obter mais informações sobre o MID Server, consulte Seleção de MID Server 
    Mismatch in tool URL:
Tool URL entered in ServiceNow below: https://<URL of the Jenkins instance you entered>
Tool URL entered in Jenkins: https://<Jenkins location URL entered in Jenkins>
In Jenkins, under Manage Jenkins > System, check that your configured Jenkins URL is the same as the Tool URL entered here.
See the troubleshooting tool on-boarding errors.

    Este erro ocorre quando a URL Jenkins inserida em DevOps é diferente da URL Jenkins inserida na sua instância Jenkins.

    Em sua instância Jenkins, navegue até Gerenciar Jenkins > Sistema > Local do Jenkins. A URL do Jenkins inserida aqui deve corresponder à URL da instância do Jenkins inserida em 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 de DevOps usando playbooks de 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 das credenciais fornecidas na ferramenta de DevOps externa. Selecione Atualizar no pop-up para executar as verificações novamente.
    • Feche o pop-up, use credenciais diferentes e selecione Conectar novamente. O pop-up de verificação de permissão aparece com os resultados das credenciais recém-inseridas.
    • Revise a coluna de impacto e, se o impacto não afetar seu caso de uso, selecione Continuar mesmo assim.
    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 de acordo com as configurações de rede. Para evitar atrasos, você pode especificar quanto tempo o sistema deve aguardar para obter uma resposta de uma ferramenta externa antes de marcar a permissão como um erro. Você pode especificar esse tempo usando a propriedade Tempo limite de verificação de permissão da ferramenta por registro (em milissegundos) (sn_devops.permission_check_timeout). Se você descobrir 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 recuperar detalhes de confirmação, detalhes de execução de pipeline, detalhes de solicitação de extração, resumos de teste:

    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 as credenciais da 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 selecionarMais ações ( ícone Mais ações) > Verificar permissões de credencial para saber sobre as permissões necessárias.
    • Verifique se você inseriu o nome de usuário/senha corretos para a 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) > Atualizar credenciais. Para obter mais informações sobre como atualizar credenciais, consulte Atualizar credenciais da 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 de DevOps está acessível e dinâmico.
    • Se o MID Server estiver configurado, verifique se o servidor está funcionando.
    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 as credenciais da 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 selecionarMais ações ( ícone Mais ações) > Verificar permissões de credencial para saber 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 uma URL válida e tente novamente.
    1. Navegue até Todos > 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 formulário Conexão relacionado.
    3. No formulário 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}.

    O limite de taxa é o número de chamadas de API que um app ou usuário pode fazer dentro de um determinado período de tempo. 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 máximo de taxa permitido na ferramenta de terceiros tiver excedido, você poderá encontrar este erro.
    Suas credenciais não têm os escopos exigidos. Verifique se as credenciais da 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 selecionarMais ações ( ícone Mais ações) > Verificar permissões de credencial para saber 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 da etapa na ServiceNow ou insira o SYS ID do modelo de mudança apropriado no pipeline.
    • Navegue até Todos > Propriedades do sistemae habilite a propriedade com.snc.change_management.change_model.type_compatibility, ou
    • Adicione o modelo de mudança no formulário de Etapa ou mude os atributos 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 de mudança ou digite no formulário Etapa ou mude os atributos 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 Velocidade de mudança para DevOps.

    Problema 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, Jiraou 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 à direita ('/') no campo URL de conexão no formulário de conexão HTTP.
    Nenhuma solicitação de mudança foi criada para um trabalho Jenkins sob controle de mudança 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 da aplicação 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ça:
    • Não faz parte de um pipeline (é uma tarefa autônoma, por exemplo).
    • É o primeiro no pipeline.
    • Está dentro do pipeline, mas o usuário aciona manualmente ou faz o 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 local Jenkins está configurado:

    Navegar até Jenkins > Gerenciar Jenkins > Configurar sistema e forneça o nome do host para o campo URL do Jenkins na seção Jenkins Local.

    Nota:
    Para evitar problemas de cache, clique em Salvar mesmo se o campo URL do Jenkins já contiver um valor quando você abrir o formulário pela primeira vez.
    Eventos que ocorrem no log de carga com estado Não conectado
    Se qualquer uma das seguintes mudanças para uma conexão 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 ativado
    • URL de conexão da conexão HTTP
    • Credenciais da conexão HTTP
    • Use a configuração MID Server na conexão HTTP

    Entre no modo de configuração manual e reconecte-se.
    Repetir eventos de entrada com falha ou erro devido a TimeoutException/FlowObjectAPIException da REST API
    Atualize o trabalho agendado Retry Errored Inbound Events para tentar novamente o processamento de eventos de entrada que estão no estado Error.
    • Atualize a lista de erros ou exceções para especificar exceções para as quais você deseja tentar novamente o processamento de eventos.
    • Modifique a contagem Maximum Retry padrão.
    Para obter mais informações, consulte Repetir eventos de entrada com erro.

    A execução do pipeline em ServiceNow DevOps não avança e aguarda indefinidamente, pois as verificações do SonarQube não ocorrem devido à ausência da ferramenta SonarQube.

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

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

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