Zelfstudie: upstream-bronnen gebruiken

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

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten en selecteer Vervolgens Feed maken om een nieuwe feed te maken.

   

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

   

Notitie

Als u een feed van een andere organisatie wilt toevoegen als een upstream-bron, moet de eigenaar van de doelfeed de doelweergave delen met Alle feeds en personen in organisaties die zijn gekoppeld aan mijn Microsoft Entra-tenant door te navigeren naar feedinstellingenweergaven>> Selecteer de knop met het beletselteken aan de rechterkant voor de opgegeven weergave >Bewerken.

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:

1. De URL van de bron ophalen
2. Het configuratiebestand bijwerken

npm

1. Selecteer Artefacten en selecteer vervolgens Verbinding maken met feed.

   

2. Selecteer aan de linkerkant van de pagina het npm-tabblad .

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

NuGet

1. Selecteer Artefacten en selecteer vervolgens uw feed.

2. Selecteer Verbinding maken met feed en kies NuGet.exe.

   

3. Kopieer het XML-fragment in de sectie Projectinstallatie .

4. Maak een nieuw bestand met de naam nuget.config in de hoofdmap van uw project.

5. Plak het XML-fragment in het configuratiebestand.

Pit

1. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

2. Selecteer Verbinding maken met feed en selecteer pip onder de sectie Python.

   

3. Maak een virtuele omgeving als u dit nog niet hebt gedaan.

4. 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/
   

Maven

1. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

2. Selecteer Verbinding maken met feed en selecteer vervolgens Maven.

   

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

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

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

Gradle

1. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

2. Selecteer Verbinding maken met feed en selecteer Vervolgens Gradle.

   

3. 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)
       }
   }
   

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

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

npm

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

npm install --force

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Notitie

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

NuGet

1. Uw lokale cache wissen:

   nuget locals -clear all
   

2. Uw NuGet-pakketten herstellen:

   nuget.exe restore
   

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

dotnet

Voer de volgende opdracht uit in de projectmap:

dotnet restore --interactive

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Python

Voer de volgende opdracht uit in de projectmap:

pip install

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Maven

Voer de volgende opdracht uit in de projectmap:

mvn install

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Gradle

Voer de volgende opdracht uit in de projectmap:

gradle build

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Lading

Voer de volgende opdracht uit in de projectmap:

cargo build

Uw feed moet nu een opgeslagen kopie hebben van alle pakketten die u hebt geïnstalleerd vanuit upstream.

Verwante artikelen:

• Upstream-bronnen instellen
• Universal Packages upstream-bronnen
• Feedmachtigingen
• Pakketten publiceren naar NuGet.org