Integrar Jira. Velocidade de mudança para DevOps. Espaço

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

    • Conecte-se ao seu Jira Servidor ou Jira Instância de nuvem do Espaço de mudanças do DevOps para descobrir planos disponíveis e registrar webhooks para rastrear projetos, histórias, recursos e épicos.

    Antes de Iniciar

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

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

    Procedimento

    1. Navegar até Espaços > Espaço de mudança de DevOps E use uma das seguintes opções para abrir o Playbook para integrar Jira.
      OpçãoEtapas
      Página inicial
      1. Selecione Conecte uma ferramenta .
      2. No  modal Conectar a uma ferramenta, selecione Jira em Plano categoria.
      Módulo de aplicações
      1. Selecione Aplicações ( Ícone de aplicações.na navegação primária.
      2. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte app-create-workspace.html.
      3. No  painel Ações recomendadas, selecione  Conecte uma ferramenta  cartão.
      4. No  modal Conectar a uma ferramenta, selecione Jira em Plano categoria.
      Módulo de ferramentas
      1. Selecione Ferramentas ( Ícone Ferramentas.na navegação primária.
      2. Na lista Capacidade, selecione Planejamento .
      3. Selecione Conecte uma ferramenta .
      4. No  modal Conectar a uma ferramenta, selecione JIRA .
      Importante:
      Se você quiser descobrir e rastrear objetos de ferramenta, como planos, ao se conectar à ferramenta, será preciso conectar sua ferramenta do módulo de aplicação.
    2. Conecte-se ao seu Jira Servidor ou Jira Instância de nuvem.
      Jira Servidor
      1. Em Plataforma , selecione Servidor JIRA .
      2. Em Nome da ferramenta , insira um nome para a ferramenta.

        Este nome é usado para identificar seu Jira instância da lista de ferramentas conectadas a. Velocidade de mudança para DevOps.

      Conecte-se ao servidor Jira.
      Jira Nuvem
      1. Em Plataforma , selecione JIRA Cloud .
      2. Em Nome da ferramenta , insira um nome para a ferramenta.

        Este nome é usado para identificar seu Jira instância da lista de ferramentas conectadas a. Velocidade de mudança para DevOps.

      Conecte-se à nuvem do Jira.
    3. Selecione Avançar.

      . DevOps a página do playbook é aberta para ajudar você a concluir as tarefas de integração.

    4. Conclua a conexão com seu Jira ferramenta que usa o playbook.
      1. Insira os detalhes da conexão.
        Jira Servidor
        1. Insira seu Jira URL da instância do servidor.
        2. Em Tipo de credencial , selecione o tipo de autenticação que você deseja usar para se conectar ao seu Jira servidor.

          • Autoriz. básica

            1. Insira seu Jira nome de usuário do servidor.
              Nota:
              . Jira o usuário que você usa aqui deve ter Jira Permissões de administradores.
            2. Insira a senha ou o token de acesso para acessar esta instância.

            Insira os detalhes básicos de autenticação do servidor Jira.

          • Chave de API

            Insira o token de API para acessar a instância.

            Insira o token de API do servidor Jira.

        3. . Jira a instância está anexada a um MID Server. selecione MID Server e insira seus detalhes.

          Para obter mais informações sobre o MID Server, consulte Seleção DO MID Server

        Jira Nuvem
        1. Insira seu Jira URL da instância em nuvem.
          Nota:
          Se você selecionar o tipo de credencial como OAuth 2,0 com 3LO Na próxima etapa, insira a URL da instância do Jira no seguinte formato: 
          https://api.atlassian.com/ex/jira/<Cloud-ID>
          Para obter informações sobre como obter o valor do ID da nuvem, consulte Obtain the value of Cloud ID.
        2. Selecione o tipo de credencial como Autenticação básica ou OAuth 2,0 com 3LO .

          Autoriz. básica

          1. Insira seu Jira Nome de usuário da nuvem.
            Nota:
            . Jira o usuário que você usa aqui deve ter Jira Permissões de administradores.
          2. Insira a senha ou o token de acesso para acessar esta instância. Insira os detalhes da instância do Jira Cloud para autenticação básica

          OAuth 2.0 com 3LO

          Pré-requisitos:
          • Crie um registro de credencial para o Jira Cloud
          Selecione um registro de credencial OAuth 2,0 existente no Credencial ou selecione Criar registro de credencial OAuth 2,0 para criar um novo registro. Para obter instruções sobre como criar um novo registro de credencial, consulte Crie um registro de credencial para o Jira Cloud .
          Nota:
          • A opção para criar um novo OAuth 2,0 só estará disponível se você tiver a função de administrador de conexão e OAuth.
          • Somente registros que não estão em uso e configurados para o Jira Cloud podem ser selecionados como um registro de credencial existente.
          Insira os detalhes da instância do Jira Cloud para autenticação OAuth 2,0
        3. . Jira a instância está anexada a um MID Server. selecione MID Server e insira seus detalhes.

          Para obter mais informações sobre o MID Server, consulte Seleção DO MID Server

      2. Selecione Conecte .

        Se a conexão for bem-sucedida, a ferramenta será criada no Velocidade de mudança para DevOps e conectado ao seu Jira instância.

      3. As verificações de permissão são executadas nas credenciais inseridas.
        As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Insira as credenciais novamente . Para obter informações detalhadas sobre todas as permissões necessárias, consulte Permissões do Jira em Permissões necessárias para DevOps ferramentas.

        Você pode optar por continuar com a conexão da ferramenta, mesmo que não tenha todas as permissões necessárias.

        Verificações de permissão para se conectar ao Jira.

    5. Especifique o acesso para a ferramenta.
      1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no Mantido por campo.
        As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles.
        • DevOps Função de proprietário da ferramenta: Pode exibir e editar a ferramenta.
        • DevOps Função de proprietário da aplicação: Pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas de pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
        • DevOps Função de administrador: Pode editar todas as ferramentas.
        • Outro DevOps Funções: Pode exibir a ferramenta.
        Nota:
        Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com DevOps A função de proprietário da ferramenta poderá editar a ferramenta.
      2. Se você optar por controlar o acesso à ferramenta, o Todos os proprietários de aplicações podem exibir e associar objetos de ferramenta a aplicações a opção se torna disponível para seleção.

        Esta opção permite que todos os usuários tenham DevOps Função de proprietário da aplicação para acessar a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas de pipeline (se aplicável) dos objetos da ferramenta.

      3. Selecione Atribuir.

        Especifique o acesso à ferramenta.

    6. Para enviar dados em tempo real entre DevOps e seu Jira instância, selecione Configurar .
      Esta ação faz o seguinte:
      • Registra um webhook entre seu Jira e. ServiceNow e habilita a transferência de dados em tempo real entre os dois.
      • Se você conectou sua ferramenta Jira usando a autenticação baseada no OAuth 2,0, os webhooks serão criados para o app de integração OAuth 2,0 no Jira quando você configurar automaticamente, enquanto se você tiver se conectado usando autenticação básica, os webhooks serão criados para todos os seus projetos no Jira. Se você optar por configurar os webhooks manualmente para uma ferramenta Jira criada usando a autenticação baseada no OAuth 2,0, um webhook duplicado poderá ser criado.

      Todos os descobertos Jira Os projetos são listados como planos.

      Se você optar por não configurar agora, poderá habilitar a pesquisa noturna mais tarde para buscar dados para quaisquer planos rastreados definindo Enable Pollingpropriedade do sistema para Sim .

      Configure a instância do Jira.

      Para configurar manualmente, selecione Configurar manualmente . Para obter mais informações, consulte config-webhooks-jira-manually.html.

      Importante:
      • Se você estiver se conectando a partir da página inicial ou do módulo Ferramentas, a conexão estará concluída e você será direcionado para a página Resumo.
      • Se você estiver se conectando a partir do módulo Aplicações, os planos disponíveis em sua instância do Jira serão descobertos. Você pode rastrear e importar dados históricos deles.
    7. Selecione os planos a serem rastreados.

      1. Selecione os planos para os quais você deseja rastrear atualizações e associar à aplicação.

        Após a conclusão da integração da ferramenta, os itens de trabalho somente para esses planos selecionados serão importados automaticamente.

      2. Selecione Avançar.

        Selecione planos do Jira para rastrear.

      3. Se você quiser importar dados do plano, selecione o intervalo de datas e selecione Enviar .

        Você pode importar até 90 dias de dados.

        Importar dados do plano.

    8. Em Resumo , selecione Exibir registro da ferramenta para revisar os detalhes da instância conectada e os planos descobertos a partir dela.

      Resumo da conexão.

    Resultado

    Você integrou com sucesso seu Jira ferramenta para Velocidade de mudança para DevOps.

    O que Fazer Depois

    Na página de registro da ferramenta, você pode:

    • Veja os detalhes e o status da ferramenta.
    • Descobrir planos e. Configurar webhooks.
      Nota:
      • Por padrão, os projetos são descobertos em um conjunto de 50 para Jira Nuvem. 50 é o limite máximo de paginação compatível com Jira. Se você quiser reduzir esse valor, edite a respectiva constante no script DevOpsCommonConstants.
      • Os dados do projeto e da versão descobertos não são atualizados ou rastreados em tempo real.
    • Atribua grupos para controlar o acesso à ferramenta usando Mantido por campo.
    • Verifique as permissões de credencial e atualize as credenciais da ferramenta. Para mais detalhes, consulte Verifique permissões e atualize credenciais para ferramentas: Espaço.
    • Em Planos selecione um plano para exibir seus detalhes, como itens de trabalho importados, recursos e outros.
    • Para importar dados históricos dos planos, associe os planos a uma aplicação e importe os dados. Para obter mais informações, consulte Associe objetos de ferramenta a aplicações - Espaço.
    Nota:
    Não é recomendável atualizar a chave do projeto para projetos em Jira. Se a chave do projeto for atualizada, os nomes dos objetos atualizados não serão refletidos em Velocidade de mudança para DevOps. Somente quando o objeto é atualizado em Jira, o novo nome será refletido em Velocidade de mudança para DevOps.