Paquetes

PlaidCloud Git incluye un registro de paquetes integrado para artefactos distribuibles y Git Large File Storage (LFS) para archivos binarios grandes dentro de sus repositorios.

Acerca del registro de paquetes

El registro de paquetes es por propietario y admite una amplia variedad de formatos de ecosistemas: npm, PyPI, Maven, NuGet, RubyGems, imágenes de contenedor y más. Los paquetes son privados para su espacio de trabajo y solo pueden acceder a ellos los miembros autenticados.

Cada tipo de paquete tiene su propio punto de conexión en:

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

donde <type> es el identificador del ecosistema (por ejemplo, npm, pypi o maven).

Autenticarse en el registro

Las operaciones del administrador de paquetes usan su nombre de usuario de PlaidCloud Git y un token de acceso personal como contraseña. Consulte Repositorios para saber cómo crear un token.

Publicar un paquete

Los pasos varían según el ecosistema, pero el patrón es el mismo: apunte su administrador de paquetes a la URL del registro y ejecute su comando de publicación estándar.

Para npm, agregue un archivo .npmrc a su proyecto para limitar el ámbito de los paquetes al registro:

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

Luego publique como de costumbre:

npm publish

Para PyPI, Maven, NuGet y otros ecosistemas, configure el repositorio o el origen de la herramienta con la URL del registro correspondiente y use el comando de publicación estándar de esa herramienta (por ejemplo, twine upload, mvn deploy o dotnet nuget push).

Instalar un paquete

Apunte su administrador de paquetes a la misma URL del registro e instale como de costumbre. Con el .npmrc anterior en su lugar:

npm install @you/my-package

Para otros ecosistemas, agregue el registro como un origen adicional en la configuración de su herramienta y use su comando de instalación estándar.

Archivos grandes con Git LFS

Git LFS mantiene su repositorio ágil al reemplazar en el historial los archivos grandes o binarios por punteros ligeros y almacenar los datos del archivo por separado. LFS está habilitado en todos los repositorios de PlaidCloud Git.

Instale el cliente de LFS una sola vez en su equipo:
Ventana de terminal
```
git lfs install
```
Indique a LFS qué patrones de archivo debe rastrear, desde dentro de su repositorio:
Ventana de terminal
```
git lfs track "*.parquet"
```
Esto crea o actualiza .gitattributes. Confirme ese archivo:
Ventana de terminal
```
git add .gitattributes
git commit -m "Track Parquet files with LFS"
```
Agregue y envíe como de costumbre: los archivos coincidentes se cargan a LFS automáticamente:
Ventana de terminal
```
git add data/large-dataset.parquet
git commit -m "Add dataset"
git push origin main
```