Integrar Jira em Velocidade de mudança para DevOps — Clássico

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Conecte sua instância do Jira Servidor ou Jira Nuvem para descobrir, configurar e importar projetos e itens de trabalho, como histórias, épicos e recursos.

    Antes de Iniciar

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

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

    Procedimento

    1. Conecte-se à instância do Jira Server ou Jira Cloud.
      1. Navegar até DevOps > Ferramentas > Criar novo (legado).
      2. Insira os detalhes para se conectar à sua instância Jira.
        Jira Servidor
        1. No campo Nome da ferramenta, insira um nome para a ferramenta.
        2. No campo Integração da ferramenta, pesquise e selecione Jira.
        3. Insira o URL da instância do servidor Jira.
        4. Na lista Tipo de credencial, selecione o tipo de autenticação que você deseja usar para se conectar ao servidor Jira.

          • Autoriz. básica

            1. Insira o nome de usuário do servidor Jira.
              Nota:
              O usuário Jira que você usa aqui deve ter as permissões de administrador Jira.
            2. Insira a senha ou o token de acesso para acessar esta instância.
          • Chave de API

            Insira o token de API para acessar a instância.
        Jira Nuvem
        1. No campo Nome da ferramenta, insira um nome para a ferramenta.
        2. No campo Integração da ferramenta, pesquise e selecione Jira Nuvem.
        3. no campo URL da ferramenta, insira a Jira URL da instância de nuvem.
        4. No campo Tipo de credencial, selecione Autenticação básica ou OAuth 2.0.

          Autoriz. básica

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

          OAuth 2.0

          Pré-requisitos:
          No campo Credencial da ferramenta, selecione um registro de credencial da ferramenta OAuth 2.0 existente.
          Nota:
          Somente registros que não estão em uso e configurados para o Jira Cloud podem ser selecionados como um registro de credencial existente.

        Para obter uma lista de todas as permissões necessárias nas credenciais para se conectar a Jira, consulte Jira permissões em Permissões necessárias para DevOps ferramentas.

      3. Opcional: Se sua instância Jira estiver anexada a um MID Server, selecione a opção MID Server e insira seus detalhes.

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

      4. Selecione Enviar.

      A ferramenta é conectada automaticamente usando um alias de conexão e a conexão da ferramenta HTTP (credencial de autenticação básica).

    Após a criação bem-sucedida da ferramenta, você será direcionado para a página de registro da ferramenta.
    1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por na guia Acesso.

      As tarefas que os usuários nos grupos podem executar dependem das funções atribuídas a eles.

      Função Descrição
      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 pode associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
      DevOps Função de administrador Pode editar todas as ferramentas.
      Outras DevOps funções Pode exibir a ferramenta.
      Nota:
      Somente grupos que contêm usuários com funções DevOps estão disponíveis para seleção no campo Mantido por.

      A opção Todos os proprietários de app podem exibir e associar objetos de ferramenta a aplicações se torna disponível para seleção se você optar por restringir o acesso à ferramenta. Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.

    2. Selecione Descobrirpara descobrir todos os projetos existentes de Jira.
      Nota:
      Por padrão, os projetos são descobertos em um conjunto de 50 para a nuvem Jira. 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.
    3. Selecione Configurar para configurar os webhooks.
      Esta ação faz o seguinte:
      • Registra um webhook entre as instâncias Jira e ServiceNow e permite a transferência de dados em tempo real entre as duas.
      • Se você conectou sua ferramenta Jira usando a autenticação baseada em OAuth 2.0, os webhooks serão criados para o app de integração OAuth 2.0 em Jira quando você configurar automaticamente, enquanto que se você se conectou usando autenticação básica, os webhooks serão criados para todos os seus projetos em Jira.

      Todos os Jira projetos descobertos são listados como Planos.

      Se você optar por não configurar agora, poderá habilitar a pesquisa noturna posteriormente para buscar dados para todos os planos rastreados definindo a propriedade do sistema Enable Polling como Sim.
      Nota:
      Se você não tiver privilégios de administrador para Jira para permitir a configuração automática da URL do webhook, solicite que o administrador Jira configure isso para você. Esta ação exigiria a criação e a configuração da URL do webhook manualmente na instância da ferramenta. Depois que o webhook for configurado na ferramenta, selecione Entrar no modo de configuração manual para se conectar a Jira manualmente e saia do modo de configuração manual.
    4. Selecione o link relacionado Importarpara importar dados históricos de Jira projetos.

      Itens de trabalho importados são adicionados às listas relacionadas correspondentes.

      Nota:
      Se a chave de um projeto for atualizada no Jira, os nomes de objeto atualizados não serão refletidos em Velocidade de mudança para DevOps. Somente quando o objeto for atualizado em Jira, o novo nome será refletido em Velocidade de mudança para DevOps.