Configure o Jira para ingestão.
Beta
Esse recurso está em Beta.
Esta página descreve como configurar o Jira para ingestão de dados no Databricks.
Pré-requisitos
Para importar dados do Jira, você precisa do seguinte:
- Um ambiente Jira cloud ou um ambiente Jira on-premises com a versão 8.22.x ou posterior.
- privilégios de administrador do espaço de trabalho ou privilégio
CREATE CONNECTIONno metastore Unity Catalog . - Credenciais OAuth 2.0 para seu ambiente Jira.
Configure o Jira para OAuth.
Prepare sua instância do Jira para ingestão. Você pode adicionar os escopos necessários a um aplicativo OAuth existente ou criar um novo aplicativo. Para autenticação OAuth máquina a máquina (M2M) no Jira Cloud, configure uma account de serviço. Consulte Account de serviço do Jira Cloud (M2M).
Jira Cloud
-
Opcionalmente, clique em Criar > Integração OAuth 2.0 para criar um novo aplicativo OAuth. Se preferir usar um aplicativo OAuth existente, adicione os escopos necessários definidos nas etapas 5 e 6.
-
Dê um nome à integração e clique em Criar .
-
Acesse Permissões > API do Jira (em Escopos da API ) > Adicionar .
-
Clique em Escopos Clássicos > Editar Escopos e, em seguida, adicione os seguintes escopos ao aplicativo OAuth:
read:jira-work, read:jira-user -
Clique em Escopos granulares > Editar escopos e, em seguida, adicione os seguintes escopos ao aplicativo OAuth.
Nem todos os escopos OAuth são necessários para todas as tabelas do Jira. Se sua organização não puder conceder determinados escopos (como escopos de nível administrativo), você ainda poderá importar as tabelas que não dependem deles. Consulte a lista de tabelas de origem do Jira compatíveis com a ingestão para verificar quais escopos são necessários para cada tabela.
read:project-role:jira, read:project-category:jira, read:user:jira, read:avatar:jira, read:sprint:jira-software, read:workflow:jira, read:board-scope:jira-software, read:issue-details:jira, read:project:jira, read:audit-log:jira, read:issue-security-level:jira, read:issue-security-scheme:jira, read:board-scope.admin:jira-software, read:group:jira, read:application-role:jira -
Acesse Autorização > Adicionar e insira o URI de redirecionamento da seguinte forma:
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.htmlPor exemplo:
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
Acesse as Configurações e anote o ID do Cliente e o Segredo do Cliente . Você usará isso para criar uma conexão.
Account de serviço do Jira Cloud (M2M)
Utilize esta configuração para a autenticação OAuth machine-to-machine (M2M). O Databricks se autentica como uma account de serviço do Atlassian com o fluxo de credenciais de cliente OAuth, portanto ninguém faz login interativamente. O M2M é compatível apenas com o Jira Cloud.
- Na Administração da Atlassian, selecione sua organização e vá para Diretório > Contas de serviço .
- Crie um serviço account ou selecione uma existente.
- Clique em Criar credenciais > OAuth 2.0 e, em seguida, clique em Próximo .
- Selecione os mesmos escopos clássicos e granulares que os passos 5 e 6 na lista Jira Cloud. O Databricks não solicita escopos no fluxo de credenciais do cliente, portanto, o access token obtém apenas os escopos que você atribui à credencial.
- Crie a credencial e anote o ID do cliente e o Segredo do cliente . Você usa esses para criar uma conexão. O Atlassian não mostra o segredo do cliente novamente, portanto, armazene-o com segurança.
- Dê ao serviço account acesso ao Jira e as permissões de projeto necessárias para ler os dados que você deseja ingerir, como Projetos de navegação . Escopos não substituem permissões do Jira.
Para obter detalhes, consulte Criar uma credencial OAuth 2.0 para contas de serviço na documentação da Atlassian.
Jira on-premises
Configurar OAuth
-
Abra a Administração do Jira .
-
Acesse os Aplicativos pelo ícone de configurações no canto superior direito.
-
Acesse Aplicativos > Links de Aplicativos para ver uma lista dos links de aplicativos criados.
-
Opcionalmente, clique em Criar link para criar um novo link de aplicativo. Se preferir usar um aplicativo OAuth existente, adicione os escopos necessários.
-
Selecione "Aplicação Externa" como o tipo de aplicação e "Entrada" como a direção. Em seguida, clique em Continuar .
-
Forneça um nome para seu aplicativo externo e insira o URL de redirecionamento da seguinte forma:
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.htmlPor exemplo:
https://my-databricks-account.cloud.databricks.com/login/oauth/lakehousefederation.html -
Defina as permissões do aplicativo como Administrador . Em seguida, clique em Salvar .
-
Anote o ID do Cliente e a Chave Secreta do Cliente . Você usará isso para criar uma conexão.
Habilitar a exclusão de problemas nos logsde auditoria on-premises
Estes os passos aplicam-se apenas quando você define use_audit_logs como true no jira_options do pipeline para acompanhar exclusões da tabela issues. Para obter mais informações, consulte Rastrear exclusões para a tabela de problemas.
Às vezes, as exclusões de problemas não estão presentes nos logs de auditoria em uma instância on-premises . Para aumentar a abrangência log de auditoria nesses cenários:
- Acesse Administração do Jira > Sistema .
- Abra logsde auditoria em Solução de problemas, à esquerda, e defina estas três áreas como Avançado :
- Configuração e administração global
- Configuração e administração local
- Atividade do usuário final