Concepts de packages

Voici quelques concepts et termes à connaître lors de la gestion, de la publication ou de la consommation de packages dans CodeCatalyst.

Packages

Un package est un ensemble qui inclut à la fois le logiciel et les métadonnées nécessaires à l'installation du logiciel et à la résolution des dépendances. CodeCatalyst prend en charge le format de package npm.

Un package comprend :

• Un nom (par exemple, webpack c'est le nom d'un package npm populaire)

• Un espace de noms facultatif (par exemple, @types dans@types/node)

• Un ensemble de versions (par exemple,1.0.0,1.0.1,1.0.2)

• Métadonnées au niveau du package (par exemple, balises npm dist)

Espaces de noms de packages

Certains formats de package prennent en charge les noms de packages hiérarchiques afin d'organiser les packages en groupes logiques et d'éviter les collisions de noms. Les packages portant le même nom peuvent être stockés dans différents espaces de noms. Par exemple, npm prend en charge les étendues, et le package npm @types/node a une portée @types et un nom de. node Il existe de nombreux autres noms de packages dans le @types champ d'application. Dans CodeCatalyst, la portée (« types ») est appelée espace de noms du package, et le nom (« nœud ») est appelé nom du package. Pour les packages Maven, l'espace de noms du package correspond au Maven GroupID. Le package Maven org.apache.logging.log4j:log4j possède un groupID (espace de noms de package) org.apache.logging.log4j et un artifactID (nom du package). log4j Certains formats de package tels que Python ne prennent pas en charge les noms hiérarchiques avec un concept similaire à npm scope ou Maven GroupID. Si vous n'avez aucun moyen de regrouper les noms de packages, il peut être plus difficile d'éviter les collisions de noms.

Versions du package

Une version de package identifie la version spécifique d'un package, telle que@types/node@12.6.9. Le format et la sémantique du numéro de version varient en fonction des différents formats de package. Par exemple, les versions du package npm doivent être conformes à la spécification de version sémantique. Dans CodeCatalyst, une version de package comprend l'identifiant de version, package-version-level les métadonnées et un ensemble de ressources.

Assets

Un actif est un fichier individuel stocké dans CodeCatalyst lequel est associé à une version de package, tel qu'un fichier npm ou un .tgz fichier Maven POM ouJAR.

Référentiels de packages

Un référentiel de CodeCatalyst packages contient un ensemble de packages, qui contiennent des versions de packages, chacune correspondant à un ensemble de ressources. Les référentiels de packages sont polyglottes, ce qui signifie qu'un seul référentiel peut contenir tous les types de packages pris en charge. Chaque dépôt de packages expose des points de terminaison permettant de récupérer et de publier des packages à l'aide d'outils tels que le NuGet CLIs (nuget,dotnet), le npmCLI, le Maven CLI (mvn) et le Python CLIs (et). pip twine Pour plus d'informations sur les quotas de packages dans CodeCatalyst, notamment le nombre de référentiels de packages pouvant être créés dans chaque espace, consultezQuotas pour les packages.

Vous pouvez lier un dépôt de packages à un autre en le définissant comme un dépôt amont. Lorsqu'un dépôt est défini comme un dépôt amont, vous pouvez utiliser n'importe quel package en amont ainsi que tous les référentiels en amont supplémentaires de la chaîne. Pour de plus amples informations, veuillez consulter Référentiels en amont.

Les référentiels Gateway sont un type spécial de référentiel de packages qui extrait et stocke les packages provenant d'autorités de packages externes officielles. Pour de plus amples informations, veuillez consulter Référentiels Gateway.

Référentiels en amont

Vous pouvez l'utiliser CodeCatalyst pour créer une relation en amont entre deux référentiels de packages. Un référentiel de packages est situé en amont d'un autre lorsque les versions de packages qu'il contient sont accessibles depuis le point de terminaison du référentiel de packages du référentiel en aval. Avec une relation en amont, le contenu des deux référentiels de packages est efficacement fusionné du point de vue du client.

Par exemple, si un gestionnaire de packages demande une version de package qui n'existe pas dans un référentiel, il CodeCatalyst recherchera alors la version du package dans les référentiels en amont configurés. Les référentiels en amont sont recherchés dans l'ordre dans lequel ils sont configurés et, une fois qu'un package est trouvé, la recherche CodeCatalyst s'arrête.

Référentiels Gateway

Un dépôt de passerelle est un type spécial de dépôt de packages connecté à une autorité de package externe officielle prise en charge. Lorsque vous ajoutez un référentiel de passerelle en tant que référentiel en amont, vous pouvez consommer des packages provenant de l'autorité officielle des packages correspondante. Votre référentiel en aval ne communique pas avec le référentiel public, mais tout est intermédiaire par le référentiel de passerelle. Les packages consommés de cette manière sont stockés à la fois dans le référentiel de passerelle et dans le référentiel en aval qui a reçu la demande initiale.

Les référentiels Gateway sont prédéfinis, mais ils doivent être créés dans chaque projet pour être utilisés. La liste suivante contient tous les référentiels de passerelle qui peuvent être créés CodeCatalyst et l'autorité de package à laquelle ils sont connectés.

• npm-public-registry-gatewayfournit des packages npm de npmjs.com.

• maven-central-gatewayfournit des packages Maven à partir du référentiel Maven Central.

• google-android-gatewayfournit des packages Maven à partir de Google Android.

• commonsware-gateway fournit des packages Maven à partir de. CommonsWare

• gradle-plugins-gatewayfournit des packages Maven à partir de Gradle Plugins.

• nuget-gallery-gatewayfournit des NuGet packages provenant de la NuGet galerie.

• pypi-gateway fournit des packages Python à partir de l'index des packages Python.