Handhabung von np-Tags - CodeArtifact

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Handhabung von np-Tags

Unterstützung von npm-RegisternTags, die String-Aliase für Paketversionen sind. Sie können Tags verwenden, um anstelle von Versionsnummern einen Alias bereitzustellen. Beispielsweise haben Sie möglicherweise ein Projekt mit mehreren Entwicklungsströmen und verwenden ein anderes Tag (z.stable,beta,dev,canary) für jeden Stream. Weitere Informationen finden Sie unterDist-Tagauf der npm-Website.

Standardmäßig verwendet npm daslatesttag, um die aktuelle Version eines Pakets zu identifizieren.npm install pkg(ohne@versionoder@tagspecifier) installiert das neueste Tag. In der Regel verwenden Projekte das neueste Tag nur für stabile Release-Versionen. Andere Tags werden für Unstable- oder Prerelease-Versionen verwendet.

Tags mit dem npm-Client bearbeiten

Die Dreinpm dist-tagbefehle (add,rm, undls) in CodeArtifact-Repositorys identisch funktionieren wie imStandard-npm-Registrierungaus.

npm tags und die CopyPackageVersions-API

Wenn Sie dasCopyPackageVersionsAPI zum Kopieren einer NPM-Paketversion, alle Tags, die diese Version aliasieren, werden in das Ziel-Repository kopiert. Wenn eine Version, die kopiert wird, ein Tag hat, das ebenfalls im Ziel vorhanden ist, legt der Kopiervorgang den Tag-Wert im Ziel-Repository so fest, dass er dem Wert im Quell-Repository entspricht.

Angenommen, sowohl das Repository S als auch das Repository D enthalten eine einzige Version desweb-helperPaket mit dem neuesten Tag, das wie in dieser Tabelle gezeigt festgelegt wurde.

Ablage Package name Package-Tags

S

web-helper

neueste(Alias für Version 1.0.1)

D

web-helper

neueste(Alias für Version 1.0.0)

CopyPackageVersionswird aufgerufen, um zu kopierenweb-helper1.0.1 von S bis D. Nach Abschluss der Operation wird derlatestmarkieren Sie aufweb-helperAliase im -Repository 1.0.1, nicht 1.0.0.

Wenn Sie nach dem Kopieren die Tags ändern müssen, verwenden Sie dasnpm dist-tagBefehl, um Tags direkt im Ziel-Repository zu ändern. Weitere Informationen zuCopyPackageVersionsAPI, sieheKopieren von Paketen zwischen Repositorysaus.

npm-Tags und Upstream-Repositorys

Wenn npm die Tags für ein Paket anfordert und Versionen dieses Pakets auch in einem Upstream-Repository vorhanden sind, führt CodeArtifact die Tags zusammen, bevor sie an den Client zurückgegeben werden. Ein Repository mit dem Namen R verfügt beispielsweise über ein Upstream-Repository mit dem Namen U. Die folgende Tabelle zeigt die Tags für ein Paket mit dem Namenweb-helperdas ist in beiden Repositorys vorhanden.

Ablage Package name Package-Tags

R

web-helper

neueste(Alias für Version 1.0.0)

U

web-helper

Alpha(Alias für Version 1.0.1)

In diesem Fall, wenn der npm-Client die Tags für denweb-helper-Paket aus dem Repository R, es erhält sowohl dasneuesteundAlphaStichworte. Die Versionen, auf die die Tags verweisen, ändern sich nicht.

Wenn das gleiche Tag auf demselben Paket sowohl im Upstream- als auch im Downstream-Repository vorhanden ist, verwendet CodeArtifact das Tag, das imstromaufwärts-Repository. Angenommen, die Tags aufWebhelperwurden geändert, um wie folgt auszusehen.

Ablage Package name Package-Tags

R

web-helper

neueste(Alias für Version 1.0.0)

U

web-helper

neueste(Alias für Version 1.0.1)

In diesem Fall, wenn der npm-Client die Tags für das Paket abruftWeb-Hilfsprogrammaus dem Repository RneuesteTag wird den Alias der Version1.0.1denn das ist es, was im Upstream-Repository ist. Dies macht es einfach, neue Paketversionen in einem Upstream-Repository zu verwenden, die noch nicht in einem Downstream-Repository vorhanden sind, indemnpm updateaus.

Die Verwendung des Tags im Upstream-Repository kann problematisch sein, wenn neue Versionen eines Pakets in einem Downstream-Repository veröffentlicht werden. Sagen Sie zum Beispiel, dass das neueste Tag auf dem PaketWeb-Hilfsprogrammist sowohl in R als auch in U gleich.

Ablage Package name Package-Tags

R

web-helper

neueste(Alias für Version 1.0.1)

U

web-helper

neueste(Alias für Version 1.0.1)

Wenn Version 1.0.2 auf R veröffentlicht wird, aktualisiert npmneuesteTag auf 1.0.2.

Ablage Package name Package-Tags

R

web-helper

neueste(Alias für Version 1.0.2)

U

web-helper

neueste(Alias für Version 1.0.1)

Der npm-Client sieht diesen Tag-Wert jedoch nie, da der Wert vonneuestein U ist 1.0.1. Ausführen vonnpm installgegen das Repository R installiert unmittelbar nach der Veröffentlichung 1.0.2 1.0.1 anstelle der gerade veröffentlichten Version. Um die zuletzt veröffentlichte Version zu installieren, müssen Sie die genaue Paketversion wie folgt angeben.

npm install web-helper@1.0.2