Packages

PlaidCloud Git inclut un registre de packages intégré pour les artefacts distribuables, ainsi que Git Large File Storage (LFS) pour les gros fichiers binaires au sein de vos dépôts.

À propos du registre de packages

Le registre de packages est propre à chaque propriétaire et prend en charge un large éventail de formats d’écosystème : npm, PyPI, Maven, NuGet, RubyGems, images de conteneur, et plus encore. Les packages sont privés pour votre espace de travail et accessibles uniquement aux membres authentifiés.

Chaque type de package dispose de son propre point de terminaison sous :

https://git.example.plaidcloud.com/api/packages/you/<type>

où <type> est l’identifiant de l’écosystème (par exemple npm, pypi ou maven).

S’authentifier auprès du registre

Les opérations du gestionnaire de packages utilisent votre nom d’utilisateur PlaidCloud Git et un jeton d’accès personnel en guise de mot de passe. Consultez Dépôts pour savoir comment créer un jeton.

Publier un package

Les étapes varient selon l’écosystème, mais le principe est le même : faites pointer votre gestionnaire de packages vers l’URL du registre et exécutez sa commande de publication standard.

Pour npm, ajoutez un fichier .npmrc à votre projet afin de limiter la portée des packages au registre :

@you:registry=https://git.example.plaidcloud.com/api/packages/you/npm/
//git.example.plaidcloud.com/api/packages/you/npm/:_authToken=YOUR_TOKEN

Publiez ensuite comme d’habitude :

npm publish

Pour PyPI, Maven, NuGet et les autres écosystèmes, configurez le paramètre de dépôt ou de source de l’outil avec l’URL de registre correspondante et utilisez la commande de publication standard de cet outil (par exemple twine upload, mvn deploy ou dotnet nuget push).

Installer un package

Faites pointer votre gestionnaire de packages vers la même URL de registre et installez comme d’habitude. Avec le fichier .npmrc ci-dessus en place :

npm install @you/my-package

Pour les autres écosystèmes, ajoutez le registre comme source supplémentaire dans la configuration de votre outil et utilisez sa commande d’installation standard.

Gros fichiers avec Git LFS

Git LFS préserve la rapidité de votre dépôt en remplaçant dans l’historique les fichiers volumineux ou binaires par des pointeurs légers et en stockant séparément les données des fichiers. LFS est activé pour chaque dépôt PlaidCloud Git.

Installez une seule fois le client LFS sur votre machine :
Fenêtre de terminal
```
git lfs install
```
Indiquez à LFS quels motifs de fichiers suivre, depuis l’intérieur de votre dépôt :
Fenêtre de terminal
```
git lfs track "*.parquet"
```
Cela crée ou met à jour .gitattributes. Validez ce fichier :
Fenêtre de terminal
```
git add .gitattributes
git commit -m "Track Parquet files with LFS"
```
Ajoutez et poussez normalement : les fichiers correspondants sont téléversés automatiquement vers LFS :
Fenêtre de terminal
```
git add data/large-dataset.parquet
git commit -m "Add dataset"
git push origin main
```