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.

Dans cet article

À 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

Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
Dans la barre latérale du compte d’entreprise, cliquez sur Stratégies.
Sous Policies , cliquez sur Options.
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.

À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
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.
Sous « Résultats de la recherche – Dépôts », cliquez sur le nom du dépôt.
Dans le coin supérieur droit de la page, cliquez sur Administrateur.
Dans la barre latérale gauche, cliquez sur Administration.
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

À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
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.
Dans les résultats de recherche, cliquez sur le nom de l’utilisateur ou de l’organisation.
Dans le coin supérieur droit de la page, cliquez sur Administrateur.
Dans la barre latérale gauche, cliquez sur Administration.
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.

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

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)
&nbsp;
> Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic)
&nbsp;
# 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)
&nbsp;
> Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none)
&nbsp;
# Show the contents of .lfsconfig
$ cat .lfsconfig
[remote "origin"]
lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo

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"
```
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 ».

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
&nbsp;
$ 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)
&nbsp;
> 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)

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

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

Site du projet Stockage Fichiers volumineux Git