Tutorial: Verwenden von Upstreamquellen

Artikel
04/04/2024

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Mithilfe von Upstreamquellen in Ihrem Feed können Sie Ihre Anwendungsabhängigkeiten aus einem einzigen Feed verwalten. Die Verwendung von Upstreamquellen erleichtert das Verwenden von Paketen aus öffentlichen Registern, während Schutz vor Ausfällen oder kompromittierten Paketen besteht. Sie können auch Eigene Pakete in demselben Feed veröffentlichen und alle Ihre Abhängigkeiten an einem Ort verwalten.

In diesem Lernprogramm erfahren Sie, wie Sie upstream-Quellen in Ihrem Feed aktivieren und Pakete aus öffentlichen Registrierungen wie NuGet.org oder npmjs.com nutzen.

In diesem Lernprogramm lernen Sie Folgendes:

Erstellen Sie einen neuen Feed, und aktivieren Sie upstream-Quellen.
Richten Sie Ihre Konfigurationsdatei ein.
Führen Sie eine ursprüngliche Paketwiederherstellung aus, um Ihren Feed aufzufüllen.
Überprüfen Sie Ihren Feed, um die gespeicherte Kopie der Pakete anzuzeigen, die Sie aus der öffentlichen Registrierung verwendet haben.

Erstellen eines Feeds und Aktivieren von Upstreamquellen

Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.
Wählen Sie Artefakte und dann "Feed erstellen" aus, um einen neuen Feed zu erstellen.
Geben Sie einen Namen für Ihren Feed an, und wählen Sie dessen Sichtbarkeit aus. Stellen Sie sicher, dass Sie das Kontrollkästchen "Pakete aus allgemeinen öffentlichen Quellen einschließen" aktivieren, um Upstreamquellen zu aktivieren, und wählen Sie dann " Erstellen" aus, wenn Sie fertig sind.

Einrichten der Konfigurationsdatei

Nachdem wir nun unseren Feed erstellt haben, müssen wir die Konfigurationsdatei aktualisieren, um auf unseren Feed zu verweisen. Dazu müssen wir:

Abrufen der URL der Quelle
Aktualisieren der Konfigurationsdatei

Wählen Sie Artefakte aus, und wählen Sie dann Verbinden aus, um zu feeden.
Wählen Sie auf der linken Seite der Seite die npm-Registerkarte aus.
Befolgen Sie die Anweisungen im Abschnitt "Project-Setup ", um Die Konfigurationsdatei einzurichten.

Wenn Sie noch keine NPMRC-Datei haben, erstellen Sie eine neue datei im Stammverzeichnis Ihres Projekts (im selben Ordner wie Ihre package.json). Öffnen Sie Die neue NPMRC-Datei , und fügen Sie den Codeausschnitt ein, den Sie soeben im vorherigen Schritt kopiert haben.

Wählen Sie Artefakte und dann Ihren Feed aus der Dropdownliste aus.
Wählen Sie Verbinden aus, um zu feeden, und wählen Sie dann "Pip" unter dem Abschnitt "Python" aus.
Erstellen Sie eine virtuelle Umgebung , wenn Sie dies noch nicht getan haben.
Fügen Sie ihrer virtualenv eine datei pip.ini (Windows) oder pip.conf (Mac/Linux) hinzu, und fügen Sie den folgenden Codeausschnitt ein:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Wählen Sie Artefakte und dann Ihren Feed aus der Dropdownliste aus.
Wählen Sie Verbinden aus, um zu feeden, und wählen Sie dann Maven aus.

Fügen Sie den folgenden Codeausschnitt zu den <repositories> Abschnitten und <distributionManagement> Abschnitten in Ihrem pom.xml hinzu:

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Fügen Sie ihrer settings.xml Datei eine hinzu <server> :

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Erstellen Sie ein persönliches Zugriffstoken mit Dem Packen>von Lese- und Schreibbereichen, und fügen Sie Ihr persönliches Zugriffstoken in das <password> Tag in Ihrer settings.xml Datei ein.

Wählen Sie Artefakte und dann Ihren Feed aus der Dropdownliste aus.
Wählen Sie Verbinden aus, um zu feeden, und wählen Sie dann "Gradle" aus.

Fügen Sie den Repositorys und den Veröffentlichungsabschnitten in der Datei "build.gradle" den folgenden Codeausschnitt hinzu:

maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}

Fügen Sie ihrer settings.xml Datei eine hinzu <server> :

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Erstellen Sie ein persönliches Zugriffstoken mit Lese- und Schreibbereichen zum Packen>von Lese- und Schreibvorgängen. Fügen Sie Ihr persönliches Zugriffstoken in das <password> Tag in Ihrer settings.xml-Datei ein.

Pakete wiederherstellen

Nachdem Sie nun upstream-Quellen aktiviert und Ihre Konfigurationsdatei eingerichtet haben, können wir den Befehl "Paketwiederherstellung" ausführen, um die Upstreamquelle abzufragen und die Upstreampakete abzurufen.

Entfernen Sie den ordner node_modules aus Ihrem Projekt, und führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster mit erhöhten Rechten aus:

npm install --force

Hinweis

Das --force Argument erzwingt Pull-Remotes, auch wenn eine lokale Kopie vorhanden ist.