Configurar credenciais do Git e conectar um repositório remoto ao Azure Databricks

Este artigo descreve como configurar suas credenciais do Git no Databricks para que você possa conectar um repositório remoto usando pastas Git do Databricks (anteriormente Repos).

Para obter uma lista de provedores Git suportados (na nuvem e no local), leia Provedores Git suportados.

• Autenticar uma conta do GitHub
  • OAuth 2.0 (recomendado)
  • Limitação de EMU (Usuários Gerenciados) do GitHub Enterprise
  • PAT (token de acesso pessoal)
  • PAT (token de acesso pessoal refinado)
• Autenticar uma conta do GitLab usando um PAT (token de acesso pessoal)
• Autenticar o acesso a um repositório Microsoft Azure DevOps
• Autenticar o acesso a um repositório Atlassian BitBucket
  • Token de API (recomendado)
  • Token de acesso
  • Senha do aplicativo

Autenticar uma conta do GitHub

As informações a seguir se aplicam aos usuários do GitHub e do GitHub AE.

Por que usar o Aplicativo GitHub do Databricks em vez de um PAT?

As pastas Git do Databricks permitem que você escolha o Aplicativo Databricks GitHub para autenticação de usuário em vez de PATs se você estiver usando uma conta do GitHub hospedada. O Aplicativo GitHub tem os seguintes benefícios em relação a PATs:

• Ele utiliza o OAuth 2.0 para a autenticação de usuários. O tráfego do repositório OAuth 2.0 é criptografado para maior segurança.
• É mais fácil integrar (veja as etapas abaixo) e não exige o rastreamento individual de tokens.
• A renovação do token é tratada automaticamente.
• A integração pode ser definida com escopo para repositórios Git anexados específicos, permitindo um controle mais granular sobre o acesso.

Por integração padrão do OAuth 2.0, o Databricks armazena os tokens de acesso e atualização de um usuário. O GitHub gerencia todos os outros controles de acesso. Os tokens de acesso e atualização seguem as regras de expiração padrão do GitHub, com tokens de acesso expirando após 8 horas (o que minimiza o risco em caso de vazamento de credenciais). Os tokens de atualização têm um tempo de vida de 6 meses se não forem utilizados. As credenciais vinculadas expiram após 6 meses de inatividade, exigindo que os usuários as reconfigurem.

Opcionalmente, você pode criptografar tokens do Databricks usando CMK (chaves gerenciadas pelo cliente).

Vincular sua conta do GitHub usando o OAuth 2.0 (recomendado)

No Azure Databricks, vincule sua conta do GitHub na página Configurações do usuário:

1. No canto superior direito de qualquer página, clique no seu nome de usuário e selecione Configurações.

2. Selecione a guia Contas vinculadas.

3. Altere seu provedor para GitHub, selecione Vincular conta do Git e clique em Link.

   

4. A página de autorização do Aplicativo Databricks GitHub é exibida. Autorize o aplicativo do GitHub a concluir a instalação, o que permite que o Databricks atue em seu nome ao executar operações Git em pastas Git (como clonar um repositório). Consulte a documentação do GitHub para obter mais detalhes sobre a autorização do aplicativo.

   

5. Para permitir o acesso aos repositórios do GitHub, siga as etapas abaixo para instalar e configurar o aplicativo GitHub do Databricks.

Instalar e configurar o Aplicativo Databricks GitHub para permitir o acesso a repositórios

Você pode instalar e configurar o Aplicativo Databricks GitHub nos repositórios do GitHub que deseja acessar das pastas Git do Databricks. Consulte a documentação do GitHub para obter mais detalhes sobre a instalação do aplicativo.

1. Abra a página de instalação do Aplicativo Databricks GitHub.

2. Selecione a conta que possui os repositórios que você deseja acessar.

   

3. Se você não for o proprietário da conta, deverá solicitar que o proprietário da conta instale e configure o aplicativo para você.

4. Se você for o proprietário da conta, instale o aplicativo do GitHub. Instalá-lo fornece acesso de leitura e gravação ao código. O código só é acessado em nome dos usuários (por exemplo, quando um usuário clona um repositório em pastas Git do Databricks).

5. Opcionalmente, você pode conceder acesso a apenas um subconjunto de repositórios selecionando a opção Somente selecionar repositórios.

Limitação de EMU (Usuários Gerenciados) do GitHub Enterprise

Como identificar uma conta da EMU

Sua conta do GitHub será uma conta EMU se:

• Seu nome de usuário termina com _<enterprise-name> (por exemplo, john.doe_databricks)
• Seu perfil do GitHub exibe "Gerenciado por [Nome da Organização]"

Conectar-se ao GitHub usando um token de acesso pessoal

No GitHub, siga estas etapas para criar um token de acesso pessoal que permita o acesso aos seus repositórios:

1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.
2. Clique em Configurações de desenvolvedor.
3. Clique em Tokens de acesso pessoal>Tokens (clássico).
4. Clique em Gerar novo token (clássico).
5. Insira uma nota que descreve para que serve o token.
6. Selecione o escopo repo e o escopo workflow e clique em Gerar token. Você precisará do escopo do fluxo de trabalho se o repositório tiver fluxos de trabalho do GitHub Action.
7. Copie o token para a área de transferência. Insira esse token no Azure Databricks em configurações de Usuário > Contas vinculadas.

Para usar o logon único, consulte Autorizando um token de acesso pessoal para uso com o logon único do SAML.

Conectar-se ao GitHub usando um PAT (token de acesso pessoal) refinado

Como prática recomendada, use um PAT refinado que conceda acesso apenas aos recursos que você acessará em seu projeto. No GitHub, siga essas etapas para criar um PAT refinado que permita acesso aos seus repositórios:

1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Configurações.

2. Clique em Configurações de desenvolvedor.

3. Clique em Tokens de acesso pessoal>Tokens refinados.

4. Clique em Gerar novo token.

   

5. Configure seu novo token refinado a partir das seguintes configurações:

   • Nome do token: Forneça um nome de token exclusivo. Anote-o em algum lugar para que você não se esqueça ou perca- o!

   • Descrição: Adicione um pequeno texto descrevendo a finalidade do token.

   • Proprietário do recurso: O padrão é seu ID GitHub atual. Defina isso como a organização do GitHub que possui o(s) repositório(s) que você acessará.

   • Expiração: Selecione o período de expiração do token. O valor padrão é 30 dias.

   • Em Acesso ao repositório, escolha o escopo de acesso do seu token. Como prática recomendada, selecione apenas os repositórios que você usará para controle de versão da pasta Git.

   • Em Permissions, configure os níveis de acesso específicos concedidos por esse token para os repositórios e conta com os quais você trabalhará. Para obter mais detalhes sobre os grupos de permissão, leia Permissões necessárias para tokens de acesso pessoal refinados na documentação do GitHub.

     Defina as permissões de acesso para Conteúdos como Leitura e Gravação. (Você encontra o escopo Conteúdos em Permissões de repositório.) Para obter detalhes sobre esse escopo, consulte a documentação do GitHub sobre o escopo Conteúdos.

     

6. Clique em Gerar token.

7. Copie o token para a área de transferência. Insira esse token no Azure Databricks em configurações de Usuário > Contas vinculadas.

GitLab

No GitLab, siga estas etapas para criar um PAT (token de acesso pessoal) que permita o acesso aos seus repositórios:

1. No GitLab, clique no ícone do usuário no canto superior esquerdo da tela e selecione Preferências.

2. Clique em Tokens de Acesso na barra lateral.

3. Clique em Adicionar novo token na seção Tokens de acesso pessoal da página.

   

4. Insira um nome para o token.

5. Selecione os escopos específicos para fornecer acesso marcando as caixas dos níveis de permissão desejados. Para mais detalhes sobre as opções de escopo, leia a documentação do GitLab sobre escopos PAT.

6. Clique em Criar token de acesso pessoal.

7. Copie o token para a área de transferência. Insira esse token no Azure Databricks em Configurações de Usuário > Contas vinculadas.

Confira a documentação do GitLab para saber como criar e gerenciar tokens de acesso pessoal.

O GitLab também fornece suporte para acesso refinado usando “Project Access Tokens”. Você pode usar tokens de acesso do projeto para definir o escopo do acesso a um projeto GitLab. Para obter mais detalhes, leia a documentação do GitLab sobre tokens de acesso do Project.

Azure DevOps Services

Conecte-se a um repositório do Azure DevOps usando o Microsoft Entra ID

A autenticação com o Azure DevOps Services é feita automaticamente quando você autentica usando o Microsoft Entra ID. A organização do Azure DevOps Services precisa estar vinculada ao mesmo locatário do Microsoft Entra ID que o Databricks. O endpoint de serviço do Microsoft Entra ID deve estar acessível a partir das sub-redes privada e pública do espaço de trabalho do Databricks. Para obter mais informações, consulte Implantar o Azure Databricks em sua Rede Virtual do Azure (Injeção de VNet).

No Azure Databricks, defina seu provedor Git para Azure DevOps Services na página Configurações do Usuário:

1. No canto superior direito de qualquer página, clique no seu nome de usuário e selecione Configurações.

2. Selecione a guia Contas vinculadas.

3. Mude seu provedor para Azure DevOps Services.

   

Conectar-se a um repositório de DevOps do Azure usando um token

As etapas a seguir mostram como conectar um repositório do Azure Databricks a um repositório do Azure DevOps quando eles não estiverem na mesma locação do Microsoft Entra ID.

O ponto de extremidade de serviço do Microsoft Entra ID deve estar acessível a partir da sub-rede privada e pública do workspace do Databricks. Para obter mais informações, consulte Implantar o Azure Databricks em sua Rede Virtual do Azure (Injeção de VNet).

Obtenha um token de acesso para o repositório no Azure DevOps:

1. Acesse dev.azure.com e entre na organização de DevOps que contém o repositório ao qual você deseja conectar o Azure Databricks.
2. No lado superior direito, clique no ícone Configurações do usuário e selecione Tokens de acesso pessoais.
3. Clique em + Novo Token.
4. Insira informações no formulário:
   1. Nomeie o token.
   2. Selecione o nome da organização, que é o nome do repositório.
   3. Definir a data de expiração.
   4. Escolha o escopo necessário, como acesso completo.
5. Copie o token de acesso exibido.
6. Insira esse token no Azure Databricks em Configurações de Usuário > Contas vinculadas.
7. Em nome de usuário ou email do provedor Git, insira o endereço de email usado para fazer logon na organização do DevOps.

Bitbucket

O Azure Databricks dá suporte à autenticação do Bitbucket usando tokens de API, tokens de acesso e senhas de aplicativo. Recomendamos tokens de API para usuários e tokens de acesso para um principal de serviço.

Token de API (recomendado)

Para gerar um token de API do Bitbucket com escopo, siga a documentação do Bitbucket.

O token de API deve ter read:repository:bitbucket e write:repository:bitbucket escopos.

Adicione seu token à credencial do provedor do Bitbucket no Azure Databricks em Configurações de Usuário > Contas vinculadas.

Token de acesso

Os tokens de acesso do Bitbucket fornecem autenticação com escopo para repositórios, projetos ou espaços de trabalho. Elas são destinadas principalmente para fins de CI/CD, portanto, recomendamos que elas sejam recomendadas para uma entidade de serviço. Para criar um token de acesso, consulte a documentação do Bitbucket sobre tokens de acesso.

Adicione seu token de acesso a uma credencial de provedor bitbucket de entidade de serviço no Azure Databricks, consulte Usar uma entidade de serviço para automação com pastas Git do Databricks.

Senha do aplicativo

Ao adicionar uma senha de aplicativo à credencial do provedor do Bitbucket no Azure Databricks, você deve especificar seu nome de usuário do Bitbucket no campo de nome de usuário do provedor Git (opcional) em contas vinculadas de configurações > de usuário.

Outros provedores Git

Se o provedor Git não estiver listado, selecionar "GitHub" e fornecer o PAT obtido do seu provedor Git geralmente funcionará, mas não há garantia de que funcione.