Skip to main content

Configuration de Git Large File Storage pour votre entreprise

Stockage Fichiers volumineux Git (Git LFS) est une extension open source de Git qui vous permet d’utiliser des fichiers volumineux de la même façon que d’autres fichiers texte.

À propos de Stockage Fichiers volumineux Git

Stockage Fichiers volumineux Git (Git LFS) est une extension open source de Git qui vous permet d’utiliser des fichiers volumineux de la même façon que d’autres fichiers texte. Vous pouvez utiliser Stockage Fichiers volumineux Git avec un seul dépôt, avec tous vos dépôts personnels ou d’organisation ou avec chaque dépôt de votre entreprise. Pour pouvoir activer Git LFS pour des dépôts ou des organisations spécifiques, vous devez activer Git LFS pour votre entreprise.

Par défaut, le client Stockage Fichiers volumineux Git stocke les ressources volumineuses sur le même serveur que celui qui héberge le référentiel Git. Lorsque Git LFS est activé sur votre instance GitHub Enterprise Server, les ressources volumineuses sont stockées sur la partition de données dans /data/user/storage.

Les utilisateurs ne peuvent pas envoyer les ressources Git LFS à GitHub Enterprise Server si Git LFS est désactivé sur l’entreprise ou le référentiel.

Pour plus d’informations, consultez « À propos du stockage de fichiers Git volumineux », « Gestion des fichiers volumineux » et le site de projet Stockage Fichiers volumineux Git.

Configuration de Stockage Fichiers volumineux Git pour votre entreprise

  1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.

    Capture d’écran du menu déroulant qui s’affiche lorsque vous cliquez sur la photo de profil sur GitHub Enterprise Server. L’option « Paramètres d’entreprise » est mise en évidence avec un contour orange foncé.

  2. Dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.

  3. Sous Policies , cliquez sur Options.

  4. Sous « Accès à Git LFS », sélectionnez le menu déroulant et cliquez sur Activé ou Désactivé.

Configuration de Stockage Fichiers volumineux Git pour un dépôt individuel

Remarque : Chaque dépôt hérite automatiquement des paramètres par défaut de l’organisation ou de l’utilisateur qui le possède. Vous ne pouvez pas remplacer le paramètre par défaut si le propriétaire du dépôt a appliqué le paramètre sur tous ses dépôts.

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
  3. Sous « Rechercher dans les utilisateurs, organisations, équipes, dépôts, gists et applications », tapez le nom du dépôt dans le champ de texte. Ensuite, à droite du champ, cliquez sur Rechercher. Capture d’écran de la page « Rechercher » des paramètres « Administrateur de site ». Le bouton pour rechercher dans les dépôts, intitulé « Rechercher », est mis en évidence avec un encadré orange.
  4. Sous « Résultats de la recherche – Dépôts », cliquez sur le nom du dépôt.
  5. Dans le coin supérieur droit de la page, cliquez sur Administrateur. Capture d’écran de l’en-tête de la page « Administrateur de site » pour un utilisateur ou un dépôt. L’onglet « Administrateur » est mis en évidence avec un encadré orange.
  6. Dans la barre latérale gauche, cliquez sur Administration. Capture d’écran de la barre latérale gauche de la page « Administrateur de site ». L’option de menu « Administration » est mise en évidence avec un encadré orange.
  7. Dans la section « Git LFS », à côté de « Activer/désactiver l’accès à Git LFS », cliquez sur Activer ou Désactiver.

Configuration de Stockage Fichiers volumineux Git pour chaque dépôt appartenant à un compte d’utilisateur ou à une organisation

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
  3. Sous « Rechercher dans les utilisateurs, organisations, équipes, dépôts, gists et applications », tapez le nom de l’utilisateur ou de l’organisation dans le champ de texte. Ensuite, à droite du champ, cliquez sur Rechercher. Capture d’écran de la page « Rechercher » des paramètres « Administrateur de site ». Le bouton permettant de rechercher dans les utilisateurs et les organisations, intitulé « Rechercher », est mis en évidence avec un encadré orange.
  4. Dans les résultats de recherche, cliquez sur le nom de l’utilisateur ou de l’organisation. Capture d’écran des résultats de la recherche « Comptes ». Dans la liste des correspondances, « user1 » est mis en surbrillance avec un contour orange.
  5. Dans le coin supérieur droit de la page, cliquez sur Administrateur. Capture d’écran de l’en-tête de la page « Administrateur de site » pour un utilisateur ou un dépôt. L’onglet « Administrateur » est mis en évidence avec un encadré orange.
  6. Dans la barre latérale gauche, cliquez sur Administration. Capture d’écran de la barre latérale gauche de la page « Administrateur de site ». L’option de menu « Administration » est mise en évidence avec un encadré orange.
  7. Dans la section « Git LFS », à côté de « Activer/désactiver l’accès à Git LFS », cliquez sur Activer ou Désactiver.

Configuration de Git Large File Storage pour utiliser un serveur tiers

Par défaut, le client Stockage Fichiers volumineux Git stocke les ressources volumineuses sur le même serveur que celui qui héberge le référentiel Git. Lorsque Git LFS est activé sur votre instance GitHub Enterprise Server, les ressources volumineuses sont stockées sur la partition de données dans /data/user/storage.

Les utilisateurs ne peuvent pas envoyer les ressources Git LFS à GitHub Enterprise Server si Git LFS est désactivé sur l’entreprise ou le référentiel.

  1. Désactivez Git LFS sur votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Configuration de Stockage Fichiers volumineux Git pour votre entreprise ».

  2. Créez un fichier de configuration de Git LFS pointant vers le serveur tiers.

    # Show default configuration
    $ git lfs env
    > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
    > git version 2.7.4 (Apple Git-66)
     
    > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic)
     
    # Create .lfsconfig that points to third party server.
    $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo
    $ git lfs env
    > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
    > git version 2.7.4 (Apple Git-66)
     
    > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none)
     
    # Show the contents of .lfsconfig
    $ cat .lfsconfig
    [remote "origin"]
    lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo
    
  3. Pour conserver la même configuration de Git LFS pour chaque utilisateur, commitez un fichier .lfsconfig personnalisé dans le dépôt.

    git add .lfsconfig
    git commit -m "Adding LFS config file"
    
  4. Migrez toutes les ressources existantes de Git LFS. Pour plus d’informations, consultez « Migration vers un autre serveur Stockage Fichiers volumineux Git ».

Migration vers un autre serveur Git Large File Storage

Avant de migrer vers un autre serveur Stockage Fichiers volumineux Git, vous devez configurer Git LFS pour utiliser un serveur tiers. Pour plus d’informations, consultez « Configuration de Stockage Fichiers volumineux Git pour utiliser un serveur tiers ».

  1. Configurez le dépôt avec un deuxième dépôt distant.

    $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo
     
    $ git lfs env
    > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
    > git version 2.7.4 (Apple Git-66)
     
    > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic)
    > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none)
    
  2. Récupérez (fetch) tous les objets de l’ancien dépôt distant.

    $ git lfs fetch origin --all
    > Scanning for all objects ever referenced...
    > ✔ 16 objects found
    > Fetching objects...
    > Git LFS: (16 of 16 files) 48.71 MB / 48.85 MB
    
  3. Poussez (push) tous les objets sur le nouveau dépôt distant.

    $ git lfs push NEW-REMOTE --all
    > Scanning for all objects ever referenced...
    > ✔ 16 objects found
    > Pushing objects...
    > Git LFS: (16 of 16 files) 48.00 MB / 48.85 MB, 879.10 KB skipped
    

Pour aller plus loin