Aller au contenu principal
Dernière mise à jour le

Configurez l’intégration Git pour les dossiers Git

Cette page décrit comment configurer l'intégration Git pour les dossiers Git Databricks, y compris les identifiants, la connectivité réseau et les fonctionnalités de sécurité. Pour créer un dossier Git et start à travailler avec les opérations Git, consultez Créer et gérer des dossiers Git.

important

Utilisez les dossiers Git pour le développement interactif. Pour les déploiements CI/CD et de production, utilisez les Declarative Automation Bundles avec des artefacts versionnés et la fédération d’identité de charge de travail. Consultez CI/CD avec des dossiers Git Databricks et Que sont les Declarative Automation Bundles ?.

Prérequis​

Avant de commencer, confirmez les points suivants :

remarque

Vous pouvez cloner des repositories distants publics sans identifiants Git. Pour modifier un repository distant public ou pour travailler avec des repositories privés, configurez les informations d'identification Git avec des autorisations d' écriture .

Ajouter des identifiants Git​

Pour configurer les identifiants Git dans Databricks :

  1. Cliquez sur votre nom d'utilisateur dans la barre supérieure du workspace Databricks et sélectionnez **Paramètres**.
  2. Cliquez sur **Comptes liés**.
  3. Cliquez sur Ajouter un identifiant Git .
  4. Sélectionnez votre fournisseur Git dans le menu déroulant. Certains fournisseurs proposent une liaison de compte OAuth, tandis que d'autres exigent un jeton d'accès personnel (PAT). Si vous liez votre compte à l'aide d'OAuth, terminez le flux d'authentification et passez à la dernière étape.
  5. Saisissez votre adresse e-mail dans le champ **Adresse e-mail du fournisseur Git**.
  6. Collez votre PAT dans le champ Jeton . Pour des instructions sur la création d'un PAT, consultez Connectez votre fournisseur Git à Databricks. Si votre organisation a activé la SSO SAML dans GitHub, autorisez votre jeton d'accès personnel pour la SSO.
  7. Cliquez sur Enregistrer .

Vous pouvez également gérer les identifiants Git à l'aide de l'API Databricks Repos.

Azure DevOps​

L'intégration Git ne prend pas en charge les jetons Microsoft Entra ID. Vous devez utiliser un jeton d'accès personnel Azure DevOps. Consultez Jeton d'accès personnel.

Multiples identifiants Git par utilisateur​

Databricks permet à chaque utilisateur de stocker plusieurs identifiants Git, vous pouvez ainsi utiliser différents fournisseurs ou comptes sans avoir à changer d’identifiants.

Databricks data intelligence platform

Sélectionnez les identifiants pour les dossiers Git​

Chaque dossier Git peut utiliser un identifiant spécifique pour les Opérations Git. Pour changer l'identifiant d'un dossier Git :

  1. Ouvrez le dossier Git et accédez à l'onglet Paramètres Git .
  2. Sous **Identifiant Git**, sélectionnez un identifiant dans le menu déroulant.
  3. Cliquez sur Enregistrer .

sélectionner un identifiant

Comment fonctionnent les identifiants default​

Chaque fournisseur Git prend en charge une seule authentification Git par default par utilisateur. Databricks utilise automatiquement cette default credential pour :

  • Jobs
  • Opérations de l'API Repos
  • Opérations des dossiers Git (lorsqu'aucun identifiant spécifique n'est sélectionné)

Le premier identifiant que vous créez pour un fournisseur devient automatiquement le default. Pour modifier votre identifiant default :

  1. Accédez à Paramètres utilisateur > Comptes associés .
  2. Cliquez sur le kebab Icône du menu kebab. à côté de l'identifiant que vous souhaitez définir default.
  3. Sélectionnez Définir default .

Limitations​

  • Les Jobs qui nécessitent un identifiant Git non default pour un Service Principal doivent utiliser un Service Principal.
  • L'application Databricks GitHub autorise un seul identifiant lié.
  • Chaque utilisateur peut avoir un maximum de 10 identifiants Git.

Configurer l'identité de commit Git​

Votre identité de commit Git détermine comment les commits effectués depuis Databricks apparaissent dans votre fournisseur Git. Lorsque vous effectuez un commit via les dossiers Git Databricks, votre fournisseur Git doit vous identifier comme l'auteur. Configurez votre adresse e-mail afin que :

  • Les commits apparaissent dans votre profil de fournisseur Git
  • Votre photo de profil et votre nom s'affichent correctement.
  • Vous recevez le crédit approprié pour les contributions
  • Les membres de l'équipe peuvent suivre qui a effectué chaque modification

Comment l'identité de commit fonctionne​

Lorsque vous configurez les identifiants Git avec une adresse e-mail :

  • E-mail : Devient l'e-mail de l'auteur (GIT_AUTHOR_EMAIL et GIT_COMMITTER_EMAIL) pour tous les commits.
  • **Nom d'utilisateur :** Devient le nom du committer ( GIT_AUTHOR_NAME GIT_COMMITTER_NAMEet)

Si vous ne spécifiez pas d’adresse e-mail, Databricks utilise votre nom d’utilisateur Git comme adresse e-mail. Cela peut empêcher une attribution correcte des commits dans votre fournisseur Git.

Exemple de commit dans l'historique Git :

commit 480ee5b0214e4d46db2da401a83794c5f5c5d375 (HEAD -> main)
Author: GitHub-username <your.email@example.com>
Date:   Fri Sep 26 00:38:23 2025 -0700

    My commit message

Exemple dans le Fournisseur Git :

Commit Git affichant l&#39;identité de l&#39;auteur avec le nom d&#39;utilisateur et l&#39;e-mail

remarque

Si vous avez créé des identifiants Git avant que la configuration des e-mails ne soit disponible, votre champ d'e-mail utilise par default votre nom d'utilisateur. Mettez-le à jour avec votre adresse e-mail réelle pour une attribution de commit correcte.

Informations d'identification GitHub liées​

Si vous utilisez des identifiants Git liés via l'application Databricks GitHub, Databricks configure automatiquement votre e-mail et votre identité Git. Si votre identité n'est pas définie correctement, Approuvez les autorisations requises ou reliez votre compte GitHub pour obtenir les autorisations appropriées.

Configurer la connectivité réseau​

Les dossiers Git nécessitent une connectivité réseau à votre fournisseur Git. La plupart des configurations fonctionnent sur Internet sans configuration supplémentaire. Cependant, vous pourriez avoir besoin d'une configuration supplémentaire si vous avez :

  • Listes d'autorisation IP sur votre fournisseur Git
  • Serveurs Git auto-hébergés (GitHub Enterprise, Bitbucket Server, GitLab Self-managed)
  • Hébergement de réseau privé

Les dossiers Git dotés d'accès Git CLI exécutent les opérations Git basées sur l'interface utilisateur sur compute serverless. Les administrateurs du Workspace doivent s'assurer que le compute serverless peut atteindre votre fournisseur Git.

Pour connecter le compute Serverless à un serveur Git privé, configurez une configuration de la connectivité réseau (NCC) avec des règles d'Endpoint privé. Consultez Configurer le Git Privé Serverless Databricks pour les étapes de configuration. Vous n’avez pas besoin d’activer la préversion du Git Privé Serverless pour utiliser la connectivité NCC.

Pour activer le compute serverless, voir Se connecter au compute serverless.

Configurer les listes d'autorisation IP​

Si votre serveur Git est accessible via Internet mais utilise une liste d'autorisation IP, comme les listes d'autorisation GitHub:

  1. Trouvez l'adresse IP de traduction d'adresses réseau (NAT) de votre plan de contrôle Databricks pour votre région sur clouds et régions Databricks.
  2. Ajoutez cette adresse IP à la liste d'adresses IP autorisées de votre serveur Git.

Configurer les serveurs Git privés​

Si vous hébergez un serveur Git privé, consultez Configurer la connectivité Git privée pour les dossiers Git de Databricks ou contactez votre équipe de compte Databricks pour obtenir des instructions de configuration.

Fonctionnalités de sécurité​

Les dossiers Git Databricks incluent les fonctionnalités de sécurité suivantes pour protéger votre code et vos identifiants :

Chiffrer les identifiants Git​

Utilisez AWS Key Management Service (KMS) pour chiffrer les jetons d'accès personnels Git et les autres informations d'identification Git avec vos propres clés de chiffrement (clés gérées par le client).

Pour plus d'informations, consultez Clés gérées par le client pour les services gérés.

Listes blanches d'URL Git​

Les administrateurs de workspace peuvent restreindre l'accès des utilisateurs aux repositories distants. Cela permet d'éviter l'exfiltration de code et d'imposer l'utilisation de repositories approuvés.

Configurer une liste d'autorisation d'URL Git​

Pour configurer une liste d'autorisation :

  1. Cliquez sur votre nom d'utilisateur dans la barre supérieure du workspace Databricks et sélectionnez **Paramètres**.

  2. Cliquez sur Développement .

  3. Sélectionnez une option d'**Autorisation de liste d'URL Git** :

    • **Désactivé (aucune restriction) :** Aucune application de la liste d'autorisation.
    • Restreindre le clonage, le Commit et l’envoi aux Git repositories autorisés : restreint toutes les opérations aux URL de la liste d’autorisations.
    • Only Restrict Commit & Push to Allowed Git repositories: Restreint uniquement les opérations d'écriture. Le clonage et l'extraction restent non restreints.

  4. Cliquez sur l'icône de modification Icône de modification à côté de **Liste d'autorisation d'URL Git : liste vide**.

  5. Saisissez une liste de préfixes d'URL séparés par des virgules. Databricks utilise la correspondance de préfixe (non sensible à la casse) pour autoriser l'accès aux repository. Les caractères génériques ne sont pas pris en charge.

    Exemples :

    • https://github.com - Autorise tous les repository GitHub
    • https://github.com/CompanyName - Restreint à une organisation spécifique
    • https://dev.azure.com/CompanyName - Limité à l'organisation Azure DevOps

    N'entrez pas d'URL avec des noms d'utilisateur ou des jetons d'authentification, car ils pourraient être répliqués globalement et empêcher vos utilisateurs de travailler avec les dossiers Git.

  6. Cliquez sur Enregistrer .

L'enregistrement d'une nouvelle liste écrase la liste d'autorisation existante. Les modifications peuvent prendre jusqu'à 15 minutes pour prendre effet.

Contrôle d'accès​

remarque

Seul le plan Premium ou supérieur inclut le contrôle d'accès.

Contrôlez qui peut accéder aux dossiers Git dans votre Workspace en définissant les autorisations. Les autorisations s'appliquent à tout le contenu d'un dossier Git. Attribuez l'un des niveaux d'autorisation suivants :

  • NO PERMISSIONS: Pas d'accès au dossier Git
  • CAN READ: Afficher uniquement les fichiers
  • CAN RUN: Afficher et exécuter des fichiers
  • CAN EDIT: Afficher, exécuter et modifier des fichiers
  • CAN MANAGE: contrôle total, y compris le partage et la suppression

Pour obtenir des informations détaillées sur les autorisations des dossiers Git, consultez Listes de contrôle d’accès des dossiers Git.

Journalisation d'audit​

Lorsque vous activez la journalisation d'audit, Databricks consigne toutes les opérations des dossiers Git, y compris :

  • Création, mise à jour ou suppression de dossiers Git
  • Répertorier les dossiers Git dans un workspace
  • Synchronisation des modifications entre les dossiers Git et les repository distants

Détection des secrets​

Les dossiers Git analysent automatiquement le code à la recherche d’informations d’identification exposées avant les commits. Il vous avertit s'il détecte :

  • Identifiants de clé d'accès AWS commençant par AKIA
  • Autres modèles d'identifiants sensibles

Ressources supplémentaires​

Après avoir configuré les dossiers Git, explorez ces sujets connexes :

Sur cette page