Integrações criadas pelo usuário no Velocidade de mudança para DevOps
As integrações criadas pelo usuário são para integrar ferramentas adicionais de planejamento, codificação e teste que não estão disponíveis por padrão na aplicação Velocidade de mudança para DevOps.
A aplicação Velocidade de mudança para DevOps inclui definições de ferramentas para integrar alguns planejamentos comuns, codificação e DevOps integração da ferramenta de teste, mas você também pode configurar integrações criadas pelo usuário para ferramentas adicionais em seu ambiente de DevOps.
Objetos de integração
DevOps A integração da ferramenta consiste nesses objetos.
Ações de capacidade da ferramenta
- AçãoConectar :
Ao se conectar, o subfluxo da ferramenta específica é chamado e o estado da conexão é atualizado. A mensagem de status da conexão é mostrada no formulário.
Consulte Subfluxo da capacidade de conexão para obter mais detalhes.
- Açãode descoberta :
Ao descobrir, um registro de solicitação de importação é criado e o subfluxo da ferramenta específica é chamado (conforme definido no registro da capacidade de integração). Os camposDetalhe e Status no registro de Solicitação de importação são atualizados com o número de itens descobertos, atualizados e com falha.
A carga transformada consiste em uma matriz de objetos como uma cadeia de caracteres JSON. Os elementos variam de acordo com o tipo de ferramenta.
Consulte Subfluxo de capacidade de descoberta para obter mais detalhes.
- Açãode importação :
A ação de importação não é compatível com a funcionalidade de importação histórica.
- Açãode pesquisa :
O fluxo principal de pesquisa é fornecido para oferecer suporte ao tipo de ferramenta de artefato em um subfluxo criado pelo desenvolvedor de integração.
- Açãode notificação (webhook):
A ferramenta de origem é configurada manualmente (pelo desenvolvedor de integração) para enviar dados brutos para a instância ServiceNow. A carga bruta é transformada em um objeto JSON padrão usando um subfluxo.
Consulte o Subfluxo da capacidade de notificação e o endpoint DevOps - POST /devops/tool/{capability} da API DevOps para obter mais detalhes.
Nota:Se um subfluxo não for especificado, ocorrerá o processamento padrão de notificações (a carga original será copiada automaticamente para a carga transformada).Este comportamento é útil quando os dados transacionais da ferramenta são compatíveis com ServiceNow DevOps como estão.
Consulte as cargas padrão esperadas em Subfluxo da capacidade de notificação para obter mais detalhes.
DevOps visão geral da configuração de integração
A configuração de integração da ferramenta pode ser concluída pelo desenvolvedor de integração e pelo administrador DevOps.
- Desenvolvedor de integrações
- Crie um registro de integração de ferramenta em DevOps para definir a ferramenta que você está integrando (ferramenta de origem).
- Crie um Workflow Studio subfluxo para coletar e transformar dados da ferramenta que você está integrando (ferramenta de origem).
- Crie um registro de mapeamento de capacidade da ferramenta em DevOps para mapear o registro de integração da ferramenta para a capacidade do tipo de ferramenta.Nota:O recurso Notificações (webhook) é compatível. As capacidades de conexão e descoberta também são compatíveis.
- Crie um registro de capacidade de integração em DevOps para especificar a ação da capacidade do tipo de ferramenta.
- Administrador da DevOps
- Crie um registro de ferramenta (planejamento, codificação ou teste) em DevOps para se conectar à ferramenta que você está integrando (ferramenta de origem).Nota:O registro de integração da ferramenta deve ser especificado no campo Ferramenta do registro da ferramenta.
- Configure a ferramenta de origem com o webhook e as credenciais.
- Crie um registro de ferramenta (planejamento, codificação ou teste) em DevOps para se conectar à ferramenta que você está integrando (ferramenta de origem).
Eventos de entrada
Um evento de entrada serve como uma área de preparação para o fluxo de notificações que oferece suporte ao reprocessamento de cargas com falha. Ou seja, um registro em estado de erro de uma integração ou transformação com falha pode ser repetido.
Se um registro de evento de entrada estiver no estado de erro, o fluxo não conseguiu inserir o registro nas tabelas principais DevOps.
Erros comuns podem ser resolvidos com essas ações.
| Erro | Ação |
|---|---|
| Campos obrigatórios ausentes | A carga transformada não corresponde à carga padrão. Consulte as cargas padrão e JSON fornecidas. |
| Repositório não marcado para acompanhamento | A confirmação não pode ser inserida. O administrador DevOps precisa rastrear o repositório. |
| [Subfluxo] não foi publicado no escopo da aplicação [app_scope] | O subfluxo foi criado, mas ainda não foi publicado. |
| Exceção de tempo limite | O subfluxo leva mais tempo do que o valor definido na propriedade: com.glide.hub.flow_api.default_execution_time Consulte FlowAPI - executeSubflowQuick (nome da cadeia de caracteres, entradas do mapa, tempo limite do número) para obter mais detalhes. Nota: A execução do subfluxo excede o valor definido no campo Tempo limite no registro da Capacidade de integração. |
| Não foi encontrado um subfluxo correspondente para a capacidade de notificação e a integração da ferramenta [tool_integration_sys_id] | O fluxo não conseguiu encontrar o subfluxo correspondente. Verifique o procedimento de configuração da integração. |
| A carga não corresponde à capacidade esperada. | A carga original (carga que está sendo enviada) é um tipo de capacidade diferente da capacidade do tipo de ferramenta configurada no mapeamento de capacidade da ferramenta. O tipo de carga útil deve corresponder à capacidade do tipo de ferramenta configurada na integração da ferramenta. |
- A ferramenta de origem não passou o ID da ferramenta como um parâmetro de consulta.
- A ferramenta de origem passou um ID de ferramenta, mas não há ID de ferramenta correspondente na instância.
Mapeamentos de ferramentas
Uma ferramenta pode ser mapeada para vários recursos.
| Integração da Ferramenta | Capacidade do tipo de ferramenta | Mapeamento de capacidade da ferramenta | |
|---|---|---|---|
|
|
Planejar
Código
Orquestração
Teste
|
|
Um mapeamento de capacidade da ferramenta pode ser mapeado para várias ações.
| Mapeamento de capacidade da ferramenta | Ação da Ferramenta | Capacidade de integração | |
|---|---|---|---|
|
|
Agile Development 2.0
Azure DevOps
Bitbucket
GitHub
GitHub Empresarial
GitLab
Jenkins
Jira
Rally
|
|
Vários tipos de teste podem ser mapeados para cada integração de ferramenta.
| Tipo de Teste | Integração da Ferramenta | Mapeamento de tipo de teste |
|---|---|---|
Unidade: JUnit, XUnit, NUnit, teste de unidade Funcional:
Desempenho: carregar |
|
Azure DevOps
Jenkins
GitLab
GitHub e GitHub Enterprise
|