npm-shrinkwrap - En ligne dans le Cloud

PROGRAMME:

Nom

npm-emballage rétractable - Verrouiller les versions de dépendance

SYNOPSIS

film rétractable npm

DESCRIPTION

Cette commande verrouille les versions des dépendances d'un package afin que vous puissiez contrôler
quelles versions exactes de chaque dépendance seront utilisées lors de l'installation de votre package. Les
package.json fichier est toujours requis si vous souhaitez utiliser NPM installer.

Par défaut, NPM installer installe récursivement les dépendances de la cible (comme spécifié dans
package.json), en choisissant la dernière version disponible qui satisfait les dépendances
modèle de sever. Dans certaines situations, en particulier lors de l'expédition d'un logiciel où chaque changement
est étroitement géré, il est souhaitable de spécifier complètement chaque version de chaque dépendance
récursivement afin que les builds et déploiements ultérieurs ne prennent pas par inadvertance des versions plus récentes
versions d'une dépendance qui satisfont le modèle semver. Spécification d'un serveur spécifique
modèles dans chaque dépendance package.json faciliterait cela, mais ce n'est pas toujours
possible ou souhaitable, comme lorsqu'un autre auteur possède le package npm. Il est également possible de
vérifier les dépendances directement dans le contrôle de source, mais cela peut être indésirable pour d'autres
les raisons.

À titre d'exemple, considérons le package A :

{
"nom": "A",
"version": "0.1.0",
"dépendances": {
"B": "<0.1.0"
}
}

paquet B :

{
"nom": "B",
"version": "0.0.1",
"dépendances": {
"C": "<0.1.0"
}
}

et paquet C :

{
"nom": "C",
"version": "0.0.1"
}

S'il s'agit des seules versions de A, B et C disponibles dans le registre, alors un NPM
installer A va installer:

[email protected]
`-- [email protected]
`-- [email protected]

Toutefois, si [email protected] est publié, puis un nouveau NPM installer A va installer:

[email protected]
`-- [email protected]
`-- [email protected]

en supposant que la nouvelle version n'a pas modifié les dépendances de B. Bien sûr, la nouvelle version de B
pourrait inclure une nouvelle version de C et un certain nombre de nouvelles dépendances. Si de tels changements sont
indésirable, l'auteur de A pourrait spécifier une dépendance sur [email protected]. Cependant, si l'auteur de A
et l'auteur de B ne sont pas la même personne, il n'y a aucun moyen pour l'auteur de A de dire qu'il ou
elle ne veut pas extraire les versions nouvellement publiées de C lorsque B n'a pas du tout changé.

Dans ce cas, l'auteur de A peut exécuter

film rétractable npm

Cela génère npm-shrinkwrap.json, qui ressemblera à ceci :

{
"nom": "A",
"version": "1.1.0",
"dépendances": {
"B": {
"version": "1.0.1",
"de": "B@^1.0.0",
"résolu": "https://registry.npmjs.org/B/-/B-1.0.1.tgz",
"dépendances": {
"C": {
"version": "1.0.1",
"de": "org/C#v1.0.1",
"resolved": "git://github.com/org/C.git#5c380ae319fc4efe9e7f2d9c78b0faa588fd99b4"
}
}
}
}
}

La commande Shrinkwrap a verrouillé les dépendances en fonction de ce qui est actuellement
installé dans node_modules. Le comportement d'installation est modifié en :

1. L'arborescence des modules décrite par le film rétractable est reproduite. Cela signifie reproduire le
structure décrite dans le fichier, en utilisant les fichiers spécifiques référencés dans "résolu" si
disponible, revenant à la résolution normale du package en utilisant "version" si ce n'est pas le cas.

2. L'arbre est parcouru et toutes les dépendances manquantes sont installées de la manière habituelle.

En utilisant emballé Forfaits
L'utilisation d'un emballage sous film plastique n'est pas différente de l'utilisation de tout autre emballage : vous pouvez NPM
installer à la main, ou ajoutez une dépendance à votre package.json déposer et NPM installer le

Développement emballé Forfaits
Pour emballer un package existant :

1. course NPM installer dans la racine du paquet pour installer les versions actuelles de tous
dépendances.

2. Validez que le package fonctionne comme prévu avec ces versions.

3. course NPM film rétractable, ajouter npm-shrinkwrap.json sur git et publiez votre package.

Pour ajouter ou mettre à jour une dépendance dans un package emballé :

1. course NPM installer dans la racine du paquet pour installer les versions actuelles de tous
dépendances.

2. Ajoutez ou mettez à jour des dépendances. NPM installer --enregistrer chaque paquet nouveau ou mis à jour
individuellement pour mettre à jour le package.json et le film rétractable. Notez qu'ils doivent être
explicitement nommé pour être installé : en cours d'exécution NPM installer sans arguments sera
reproduire simplement le film rétractable existant.

3. Vérifiez que le package fonctionne comme prévu avec les nouvelles dépendances.

4. Engagez le nouveau npm-shrinkwrap.json, et publiez votre package.

Vous pouvez utiliser l'aide npm obsolète pour afficher les dépendances avec les nouvelles versions disponibles.

Autre Remarques
Un fichier d'emballage doit être cohérent avec le package package.json fichier. NPM film rétractable
échouera si les dépendances requises ne sont pas déjà installées, car cela entraînerait un
film rétractable qui ne fonctionnerait pas réellement. De même, la commande échouera s'il y a
paquets superflus (non référencés par package.json), car cela indiquerait que
package.json n'est pas correcte.

Depuis que NPM film rétractable est destiné à verrouiller vos dépendances pour une utilisation en production,
Dépendances dev ne sera pas inclus sauf si vous définissez explicitement le --dev drapeau quand tu cours
NPM film rétractable. Si installé Dépendances dev sont exclus, alors npm affichera un avertissement.
Si vous souhaitez qu'ils soient installés avec votre module par défaut, pensez à les ajouter
à dépendances à la place.

Si l'emballage rétractable A dépend de l'emballage rétractable B, l'emballage rétractable B ne sera pas
utilisé dans le cadre de l'installation de A. Cependant, comme le film rétractable de A est construit à partir de
une installation valide de B et spécifie de manière récursive toutes les dépendances, le contenu de B's
le film rétractable sera implicitement inclus dans le film rétractable de A.

Avertissements
Si vous souhaitez verrouiller les octets spécifiques inclus dans un package, par exemple pour avoir
100% de confiance dans la possibilité de reproduire un déploiement ou une build, alors vous devez vérifier
vos dépendances dans le contrôle de source, ou poursuivre un autre mécanisme qui peut vérifier
le contenu plutôt que les versions.

Utiliser npm-shrinkwrap en ligne à l'aide des services onworks.net