Zelfstudie: upstream-bronnen gebruiken

Artikel
04/04/2024

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

Door upstream-bronnen in uw feed te gebruiken, kunt u de afhankelijkheden van uw toepassing beheren vanuit één feed. Door upstream-bronnen te gebruiken, kunt u eenvoudig pakketten van openbare registers gebruiken en tegelijkertijd bescherming bieden tegen storingen of gecompromitteerde pakketten. U kunt ook uw eigen pakketten publiceren naar dezelfde feed en al uw afhankelijkheden op één locatie beheren.

Deze zelfstudie begeleidt u bij het inschakelen van upstream-bronnen in uw feed en het verbruiken van pakketten uit openbare registers, zoals NuGet.org of npmjs.com.

In deze zelfstudie leert u het volgende:

Maak een nieuwe feed en schakel upstream-bronnen in.
Stel uw configuratiebestand in.
Voer een eerste pakketherstel uit om uw feed te vullen.
Controleer uw feed om de opgeslagen kopie weer te geven van de pakketten die u hebt gebruikt vanuit het openbare register.

Een feed maken en upstream-bronnen inschakelen

Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.
Selecteer Artefacten en selecteer Vervolgens Feed maken om een nieuwe feed te maken.
Geef een naam op voor uw feed en kies de zichtbaarheid ervan. Schakel het selectievakje Pakketten opnemen uit algemene openbare bronnen in om upstream-bronnen in te schakelen en selecteer Vervolgens Maken wanneer u klaar bent.

Het configuratiebestand instellen

Nu we onze feed hebben gemaakt, moeten we het configuratiebestand bijwerken om naar onze feed te verwijzen. Hiervoor moeten we het volgende doen:

De URL van de bron ophalen
Het configuratiebestand bijwerken

Selecteer Artefacten en selecteer vervolgens Verbinding maken die u wilt invoeren.
Selecteer aan de linkerkant van de pagina het npm-tabblad .
Volg de instructies in de sectie Project-installatie om uw configuratiebestand in te stellen.

Als u nog geen NPMRC-bestand hebt, maakt u een nieuw bestand in de hoofdmap van uw project (in dezelfde map als uw package.json). Open het nieuwe NPMRC-bestand en plak het fragment dat u zojuist in de vorige stap hebt gekopieerd.

Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.
Selecteer Verbinding maken om te feeden en selecteer vervolgens pip onder de sectie Python.
Maak een virtuele omgeving als u dit nog niet hebt gedaan.
Voeg een bestand pip.ini (Windows) of pip.conf (Mac/Linux) toe aan uw virtualenv en plak het volgende fragment:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.
Selecteer Verbinding maken om te voeren en selecteer vervolgens Maven.

Voeg het volgende fragment toe aan de <repositories> secties en <distributionManagement> secties in uw pom.xml:

<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>

Voeg een <server> toe aan uw settings.xml-bestand:

<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>

Maak een persoonlijk toegangstoken met lees>- en schrijfbereiken verpakken en plak uw persoonlijke toegangstoken in de <password> tag in uw settings.xml bestand.

Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.
Selecteer Verbinding maken om te voeren en selecteer vervolgens Gradle.

Voeg het volgende fragment toe aan de opslagplaatsen en publicatiesecties in uw build.gradle-bestand:

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

Voeg een <server> toe aan uw settings.xml-bestand:

<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>

Maak een persoonlijk toegangstoken met lees- en schrijfbereiken voor pakketten>. Plak uw persoonlijke toegangstoken in de tag in uw <password> settings.xml-bestand.

Pakketten herstellen

Nu u upstream-bronnen hebt ingeschakeld en uw configuratiebestand hebt ingesteld, kunnen we de opdracht voor pakketherstel uitvoeren om een query uit te voeren op de upstream-bron en de upstream-pakketten op te halen.

Verwijder de node_modules map uit uw project en voer de volgende opdracht uit in een opdrachtpromptvenster met verhoogde bevoegdheid:

npm install --force

Notitie

Het --force argument dwingt pull-afstandsbedieningen af, zelfs als er een lokale kopie bestaat.