Crie uma integração de ferramenta a partir do Mudança de DevOps Espaço

Crie uma integração de ferramenta a partir do Mudança de DevOps Espaço para integrar ferramentas adicionais de orquestração, planejamento e codificação que não estão disponíveis por padrão no Velocidade de mudança para DevOps aplicação.

Antes de Iniciar

Conclua as tarefas especificadas em Comece com Velocidade de mudança para DevOps.

Função necessária: sn_devops.admin ou sn_devops.tool_owner

Defina o escopo da aplicação como a aplicação personalizada.

Por Que e Quando Desempenhar Esta Tarefa

Assista a este vídeo para entender como criar uma integração de ferramenta a partir do Espaço de mudanças do DevOps.

Procedimento

1. Navegar até Espaços > Espaço de mudança de DevOps.
2. No espaço DevOps, navegue até Administração > Integrações > Integrações da ferramenta.
3. Selecione Novo.
   Como alternativa, você pode abrir um registro de integração de ferramenta existente e selecionar Editar (para uma integração de ferramenta personalizada que não é compatível com o sistema de base).

   Nota:

   Para ferramentas de planejamento que não são compatíveis com o sistema de base, você pode selecionar Editar No registro de integração da ferramenta para navegar até a etapa Transformação, na qual você pode adicionar qualquer campo adicional. Para ferramentas de planejamento compatíveis com o sistema de base, você pode selecionar Edite mapeamentos de campo para adicionar qualquer campo adicional. Para obter informações sobre como adicionar campos adicionais para ferramentas de planejamento compatíveis, consulte Adicionar campos personalizados para uma integração da ferramenta de planejamento.
   A etapa Detalhes é exibida.
4. Na etapa Detalhes da ferramenta, preencha o seguinte:

   Tabela 1. Campos de etapa de detalhes

   Campo	Descrição
   Rótulo da ferramenta	Nome da integração da ferramenta.
   Versão de integração	Versão da API da integração da ferramenta.

   
5. Opcional: Adicione uma imagem do logotipo da ferramenta selecionando Adicionar arquivo .
6. Na seção Capacidades do tipo de ferramenta, selecione a capacidade compatível com sua ferramenta no . campo.

   Capacidade	Descrição
   Orquestração	Ferramenta que automatizou e coordena a execução de processos complexos no ciclo de vida de desenvolvimento de software.
   Plano	Ferramenta que ajuda a planejar e gerenciar o ciclo de vida de desenvolvimento de software.
   Código	Ferramenta que ajuda os programadores a escrever, editar e gerenciar código.

   Nota:

   Uma ferramenta pode ser mapeada para vários recursos de tipo de ferramenta. A integração da ferramenta é compatível com recursos de orquestração, planejamento e código.
7. Selecione Avançar.
   Um registro de integração de ferramenta é criado.
8. Na etapa Ações, selecione as ações necessárias para os recursos da ferramenta selecionados na etapa anterior.
   Nota:

   Ações de capacidade da ferramenta são processos definidos que permitem que o Modelo de dados DevOps se comunique e importe dados da integração da ferramenta. Cada capacidade de tipo de ferramenta precisa de seu próprio conjunto de ações.
9. Selecione Avançar.
   Os registros de capacidade de integração para as ações selecionadas são criados com valores padrão.
10. Na etapa Configurações, adicione todas as configurações adicionais necessárias para sua ferramenta selecionando Adicionar campo .
    Os campos configurados aqui serão exibidos como parâmetros para o playbook sempre que você estiver integrando uma ferramenta.
11. Preencha os seguintes campos.

    Tabela 2. Configurações

    Campo	Descrição
    Nome do campo	Nome da configuração.
    Ordem	Sequência na qual esta configuração é processada.
    Rótulo	Rótulo da configuração.
    Obrigatório(a)	Se marcado como verdadeiro, aparecerá como um detalhe de conexão ao conectar uma instância desta integração de ferramenta.
    Tipo de campo	Tipo do campo, que pode ser cadeia de caracteres ou senha
    Valor padrão	Valor padrão desta configuração.
    Texto de ajuda	Se esta configuração for obrigatória, o texto de ajuda aparecerá para este campo nos detalhes da conexão ao conectar uma instância desta ferramenta.

12. Selecione Avançar.
    Um registro de configuração de integração de ferramenta é criado para o campo adicional.
13. Na etapa Transformação, revise a transformação de cada ação de capacidade da ferramenta e adicione qualquer campo personalizado à integração da ferramenta.
    Um script de transformação genérico é fornecido para cada ação de ferramenta. Você pode estender o script genérico que chama o mapeamento baseado em transformador ou criar transformadores de registro e mapeá-lo manualmente para os campos. Para estender, você pode criar um novo script estendendo a classe DevOpsGenericIntegrationHandlerSNC para substituir o método necessário e usar este script recém-criado no script de transformação.
    • Insira o endpoint da API do caminho do recurso no Caminho do recurso se você usar o script genérico.
    • Se ainda não estiver disponível, crie um transformador de registro para as ações Notificação, Descoberta e Importar para cada um dos recursos selecionando Crie um transformador de registro E adicione regras de transformador de registro para mapear campos em sua ferramenta para campos no Modelo de dados DevOps. Para obter informações sobre como criar um transformador de registro e mapeá-lo manualmente para o campo, consulte Adicionar campos personalizados para uma integração da ferramenta de planejamento.
14. Em Próximas etapas, você pode validar a integração da ferramenta conectando-se a uma instância da ferramenta por meio do Playbook Experience e também pode exibir o registro de integração da ferramenta.
    Nota:

    Ao selecionar Conecte-se a uma ferramenta , você verá a integração da ferramenta recém-criada na lista de ferramentas disponíveis para conexão.

O que Fazer Depois

Criação de webhooks para enviar eventos de entrada para a Velocidade de mudança do DevOps usando token

• Criação de webhooks para enviar eventos de entrada para a Velocidade de mudança do DevOps usando token
  Você deve criar webhooks para enviar eventos de entrada para a Velocidade de mudança do DevOps usando autenticação baseada em token.