Cette page a été traduite par l'API Cloud Translation.
Switch to English

Utiliser des packages Node.js

Artifact Registry est compatible avec les packages Node.js que vous gérez avec npm.

La gestion des packages est disponible en version alpha. Elle n'est disponible que pour les utilisateurs alpha et peut ne pas inclure toutes les fonctionnalités disponibles pour la gestion des conteneurs. Pour demander à participer à la version alpha, remplissez le formulaire d'inscription.

Présentation

Pour vous familiariser avec les packages Node.js dans Artifact Registry, vous pouvez consulter le guide de démarrage rapide.

Pour en savoir plus, consultez les informations suivantes :

  1. Si vous débutez avec npm, découvrez comment fonctionnent les concepts suivants :
  2. Créer un dépôt npm pour vos packages.
  3. Accordez des autorisations au compte qui se connectera au dépôt. Les comptes de service pour les intégrations courantes avec Artifact Registry disposent d'autorisations par défaut pour les dépôts du même projet.
  4. Configurer npm pour s'authentifier auprès du dépôt.
  5. Découvrir comment gérer les packages.

Utiliser des champs d'application

Un champ d'application npm est un libellé pour le regroupement des packages. Les champs d'application sont nécessaires lorsque vous travaillez avec plusieurs registres npm, ce qui inclut :

  • Publier et installer des packages dans différents registres sans avoir à passer d'un registre à un autre. Par exemple, vos compilations peuvent inclure des packages du registre npm public et d'un dépôt Artifact Registry.
  • Publier les mêmes packages dans plusieurs dépôts Artifact Registry sur différents projets Google Cloud et d'autres registres npm sans conflit de noms de packages.

Nous vous recommandons de toujours définir un champ d'application pour vos dépôts. Si vous ne spécifiez pas de champ d'application lorsque vous publiez ou installez un package, npm utilise le registre par défaut configuré, tel que le registre npm public.

Vous définissez le champ d'application de chaque dépôt Artifact Registry dans le fichier de configuration .npmrc. Les mêmes identifiants pour l'authentification s'appliquent à l'ensemble des dépôts.

L'exemple suivant montre la configuration de deux dépôts Artifact Registry dans différents projets.

  • Le champ d'application @blue correspond au dépôt du projet blue-project.
  • Le champ d'application @green correspond au dépôt du projet green-project.
@blue:registry=https://us-central1-npm.pkg.dev/blue-project/blue-npm-repo/
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:always-auth=true

@green:registry=https://us-central1-npm.pkg.dev/green-project/green-npm-repo/
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:always-auth=true

Une fois authentifié auprès d'Artifact Registry, vous pouvez importer un package dans un dépôt spécifique à l'aide du champ d'application approprié. Par exemple, la commande suivante importe un package dans blue-npm-repo dans le projet blue-project :

npm publish @blue/blue-npm-repo

Pour en savoir plus sur les champs d'application, consultez la documentation npm.

Stockage des identifiants

Les paramètres utilisés pour l'authentification sont stockés dans les fichiers de configuration npm. Ces fichiers sont nommés .npmrc. Les paramètres suivants sont utilisés pour Artifact Registry.

  • Identifiants pour le registre npm public

    Stockez les identifiants pour le registre npm public (https://registry.npmjs.org/) dans le fichier de configuration par utilisateur afin qu'ils ne soient pas disponibles pour les autres utilisateurs. Ce fichier se trouve dans votre répertoire d'accueil utilisateur ou est défini avec le paramètre npm --userconfig ou la variabe d'environnement $NPM_CONFIG_USERCONFIG. Les outils Artifact Registry pour l'authentification avec les dépôts Artifact Registry se trouvent dans le registre npm public.

  • Paramètres pour se connecter à des dépôts Artifact Registry

    Vous pouvez stocker les paramètres de dépôt Artifact Registry dans l'un des fichiers de configuration npm suivants :

    • Fichier de configuration par projet. Ce fichier .npmrc se trouve généralement dans le même répertoire que le fichier package.json de votre projet npm. Il s'agit de la solution la plus simple.

    • Fichier de configuration par utilisateur. Ce fichier se trouve dans votre répertoire d'accueil utilisateur ou est défini avec le paramètre npm --userconfig ou la variabe d'environnement $NPM_CONFIG_USERCONFIG.

    • Fichier de configuration global, $PREFIX/etc/npmrc. Pour obtenir la valeur de $PREFIX, exécutez la commande npm prefix -g.

Conservez tout registre par défaut existant configuré dans votre fichier npmrc. La valeur par défaut est généralement définie sur le registre npm public à l'adresse https://registry.npmjs.org/.

Pour vérifier la valeur de registre par défaut actuelle, exécutez la commande suivante :

npm get registry

Pour en savoir plus sur les fichiers de configuration npm, consultez la documentation sur les fichiers de configuration npm.