Aan de slag met NuGet-pakketten in Azure Artifacts

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

Met Azure Artifacts kunnen ontwikkelaars NuGet-pakketten publiceren en downloaden uit verschillende bronnen, zoals feeds en openbare registers. Met Azure Artifacts kunt u feeds maken die privé kunnen zijn, zodat u pakketten kunt delen met uw team en specifieke gebruikers, of openbaar, zodat u ze open kunt delen met iedereen op internet.

In dit artikel leert u het volgende:

  • Een nieuwe feed maken
  • Uw project instellen en verbinding maken met uw feed
  • NuGet-pakketten publiceren
  • Pakketten downloaden van uw feed

Vereisten

Een feed maken

Azure Artifacts biedt twee soorten feeds: feeds met projectbereik en binnen organisatiebereik gerichte feeds. Als u een openbare feed wilt maken, maakt u eerst een feed met projectbereik en past u vervolgens de zichtbaarheidsinstellingen aan van het project dat als host fungeert voor uw feed naar openbaar. Hierdoor is uw projectgerichte feed effectief toegankelijk voor het publiek.

  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. Voer een beschrijvende naam in voor uw feed en definieer de zichtbaarheid (waarmee wordt aangegeven wie pakketten in de feed kan bekijken). Geef het bereik van uw feed op en als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje Upstream-bronnen in.

  4. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een behoeftefeed maakt.

Notitie

Standaard is voor nieuw gemaakte feeds de buildservice van hun project ingesteld op Feed en Upstream Reader (Samenwerker).

Azure Artifacts is vooraf geïnstalleerd in TFS 2018. Als dit de eerste keer is dat u uw feed gebruikt, wordt u mogelijk gevraagd een licentie toe te wijzen.

  1. Navigeer naar uw project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Selecteer Build & Release en selecteer Vervolgens Pakketten.

  3. Selecteer + Nieuwe feed om een nieuwe feed te maken.

  4. Geef een betekenisvolle naam en beschrijving op voor uw feed. Geef de machtigingen op voor wie kan lezen en wie kan bijdragen, en bepaal of externe pakketten moeten worden opgenomen.

  5. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een nieuwe feed maakt in TFS 2018.

Verbinding maken om te voeren

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

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

  3. Selecteer Verbinding maken om te voeren.

    Een schermopname van de knop Verbinding maken met feed.

  4. Selecteer NuGet.exe. Als dit de eerste keer is dat u Azure Artifacts met Nuget.exe gebruikt, moet u ervoor zorgen dat u alle vereisten hebt geïnstalleerd.

  5. Volg de instructies in de sectie Project setup om uw nuget.config-bestand te configureren.

    Een schermopname die laat zien hoe u uw project instelt.

  1. Navigeer naar uw project http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Selecteer Build- en releasepakketten>.

  3. Selecteer uw feed in de vervolgkeuzelijst.

  4. Selecteer Verbinding maken om te voeren.

    Een schermopname van de knop Verbinding maken met feed in TFS.

  5. Selecteer NuGet en volg de instructie om verbinding te maken met uw feed.

    Een schermopname die laat zien hoe u verbinding maakt met uw feed in TFS.

Pakketten downloaden

1. Haal de bron-URL van de feed op

  1. Navigeer naar uw project en selecteer vervolgens Artefacten en selecteer vervolgens uw feed.

  2. Selecteer Verbinding maken om te feeden en selecteer vervolgens Visual Studio in het linkernavigatievenster.

  3. Kopieer de bron-URL .

    Een schermopname van de bron-URL.

  1. Selecteer Build en Release en selecteer Vervolgens Pakketten.

  2. Selecteer uw feed in de vervolgkeuzelijst.

  3. Selecteer Verbinding maken om te feeden en kopieer vervolgens de bron-URL.

    Een schermopname van de bron-URL van het pakket in TFS.

2. Visual Studio instellen

  1. Selecteer Extra in Visual Studio en vervolgens Opties.

  2. Vouw de sectie NuGet Pakketbeheer uit en selecteer vervolgens Pakketbronnen.

  3. Voer de naam van de feed en de bron-URL in en selecteer vervolgens het groene (+) teken om een bron toe te voegen.

  4. Als u upstream-bronnen in uw feed hebt ingeschakeld, schakelt u het selectievakje nuget.org uit.

  5. Selecteer OK wanneer u klaar bent.

    Een schermopname van het instellen van Visual Studio in Windows.

3. Pakketten downloaden

  1. Klik in Visual Studio met de rechtermuisknop op uw project en selecteer NuGet-pakketten beheren.

  2. Selecteer Bladeren en selecteer vervolgens uw feed in het vervolgkeuzemenu Pakketbron .

    Een schermopname die laat zien hoe u de feedbron selecteert.

  3. Gebruik de zoekbalk om te zoeken naar pakketten uit uw feed.

Notitie

Het gebruik van NuGet Package Explorer om te zoeken naar pakketten in upstreams wordt niet ondersteund.

Pakketten publiceren

Voer de volgende opdracht uit om uw pakket naar uw feed te publiceren. U kunt elke tekenreeks gebruiken voor het argument ApiKey .

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>