Integrar Jira em Velocidade de mudança para DevOps — Espaço
Conecte-se à instância do Jira Servidor ou Jira Nuvem do Espaço de mudança de DevOps para descobrir planos disponíveis e registrar webhooks para rastrear projetos, histórias, recursos e épicos.
Antes de Iniciar
Conclua as tarefas especificadas no tópico Comece com Velocidade de mudança para DevOps.
Função necessária: sn_devops.admin ou sn_devops.tool_owner
Procedimento
-
Navegar até e use uma das seguintes opções para abrir o Playbook para integração Jira.
Opção Etapas Página inicial - Selecione Conectar uma ferramenta.
- No modal Conectar a uma ferramenta, selecione Jira na categoria Plano.
Módulo de aplicações - Selecione Aplicações (
) na navegação primária. - Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte Criar uma aplicação - Espaço.
- No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta.
- No modal Conectar a uma ferramenta, selecione Jira na categoria Plano.
Módulo de ferramentas - Selecione Ferramentas (
) na navegação primária. - Na lista Capacidade, selecione Planejamento.
- Selecione Conectar uma ferramenta.
- No modal Conectar a uma ferramenta, selecione Jira.
Importante:Se você quiser descobrir e rastrear objetos de ferramenta, como planos, ao se conectar à ferramenta, deverá conectar sua ferramenta a partir do módulo Aplicação. -
Conecte-se à instância do Jira Server ou Jira Cloud.
Jira Servidor - Na lista Plataforma, selecione Jira Server.
- No campo Nome da ferramenta, insira um nome para a ferramenta.
Este nome é usado para identificar sua instância Jira na lista de ferramentas conectadas a Velocidade de mudança para DevOps.
Jira Nuvem - Na lista Plataforma, selecione Jira Cloud.
- No campo Nome da ferramenta, insira um nome para a ferramenta.
Este nome é usado para identificar sua instância Jira na lista de ferramentas conectadas a Velocidade de mudança para DevOps.
-
Conclua a conexão com a ferramenta Jira usando o playbook.
-
Insira os detalhes da conexão.
Jira Servidor - Insira o URL da instância do servidor Jira.
- Na lista Tipo de credencial, selecione o tipo de autenticação que você deseja usar para se conectar ao servidor Jira.
-
Autoriz. básica
- 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.
- Insira a senha ou o token de acesso para acessar esta instância.
- Insira o nome de usuário do servidor Jira.
- Chave de API
Insira o token de API para acessar a instância.
-
- 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
Jira Nuvem - Insira o URL da sua instância de nuvem Jira.Nota:Se você selecionar o tipo de credencial como OAuth 2.0 com 3LO na próxima etapa, deverá inserir a URL da instância do Jira no seguinte formato:
Para obter informações sobre como obter o valor do ID de nuvem, consulte Obtain the value of Cloud ID.https://api.atlassian.com/ex/jira/<Cloud-ID> - Selecione o tipo de credencial como Autenticação básica ou OAuth 2.0 com 3LO.
Autoriz. básica
- 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.
- Insira a senha ou o token de acesso para acessar esta instância.
OAuth 2.0 com 3LO
Pré-requisitos:Selecione um registro de credencial OAuth 2.0 existente no campo 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 Criação de um registro de credencial para 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 seu nome de usuário Jira do Cloud.
- 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
-
As verificações de permissão são executadas nas credenciais que você inseriu.
As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Inserir 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 se não tiver todas as permissões necessárias.
-
Insira os detalhes da conexão.
-
Especifique o acesso para a ferramenta.
- Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.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 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 funções DevOps : pode exibir a ferramenta.
Nota:Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com a função de proprietário da ferramenta DevOps poderão editar a ferramenta. - Se você optar por controlar o acesso à ferramenta, a opção Todos os proprietários de app podem exibir e associar objetos de ferramenta a aplicações ficará disponível para seleção.
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.
- Selecione Atribuir.
- Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.
-
Para enviar dados em tempo real entre DevOps e sua instância Jira, selecione Configurar.
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. Se você optar por configurar os webhooks manualmente para uma ferramenta Jira criada usando a autenticação baseada em OAuth 2.0, um webhook duplicado poderá ser criado.
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.
Para configurar manualmente, selecione Configurar manualmente. Para obter mais informações, consulte Configurar webhooks em Jira manualmente.
Importante:- Se você estiver se conectando pela página inicial ou pelo módulo Ferramentas, a conexão será concluída e você será direcionado para a página Resumo.
- Se você estiver se conectando do módulo Aplicações, os planos disponíveis na sua instância do JIRA serão descobertos. Você pode rastrear e importar dados históricos deles.
-
Selecione os planos para acompanhar.
Selecione os planos para os quais você deseja rastrear atualizações e associar à aplicação.
Depois que a integração da ferramenta for concluída, os itens de trabalho somente para esses planos selecionados serão importados automaticamente.
Selecione Avançar.
Se você quiser importar dados do plano, selecione o intervalo de datas e selecione Enviar.
Você pode importar até 90 dias de dados.
-
Na página Resumo, selecione Exibir registro da ferramenta para revisar os detalhes da instância conectada e os planos descobertos a partir dela.
Resultado
Você integrou com sucesso sua ferramenta Jira a 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 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.
- Os dados de projeto e versão descobertos não são atualizados ou rastreados em tempo real.
- Atribua grupos para controlar o acesso à ferramenta usando o campo Mantido por.
- Verifique as permissões de credencial e atualize as credenciais da ferramenta. Para mais detalhes, consulte Verifique as permissões e atualize as credenciais das ferramentas — Espaço.
- Na guia 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 Associar objetos de ferramenta a aplicações - Espaço.