Een interne feed instellen als een upstream-bron

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

Azure Artifacts upstream-bronnen vereenvoudigen pakketbeheer door ontwikkelaars in staat te stellen pakketten van meerdere bronnen op te slaan in één feed. Wanneer een pakket voor het eerst vanuit een upstream-bron wordt geïnstalleerd, slaat Azure Artifacts automatisch een kopie op in uw feed om ervoor te zorgen dat er blijvende toegang is, zelfs als de upstream-bron tijdelijk niet beschikbaar is. Deze handleiding leidt u door het instellen van een interne feed vanuit dezelfde organisatie als een upstream-bron in Azure Artifacts.

Vereiste voorwaarden

Product Requirements
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.

Een feed maken

Als u nog geen feed hebt, volgt u deze stappen om er een te maken en algemene openbare registers toe te voegen als upstream-bronnen:

  1. Meld u aan bij Azure DevOps en ga naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens Feed maken.

  3. Voer een naam in voor de feed en kies de juiste instellingen voor zichtbaarheid en bereik .

  4. Selecteer Pakketten opnemen uit algemene openbare bronnen om algemene openbare registers toe te voegen als upstream-bronnen.

  5. Klik op Create wanneer je klaar bent.

Verbinding maken met uw feed

Gebruik de volgende stappen om uw project te configureren en te verifiëren met uw feed. In dit voorbeeld wordt een Rust-project gebruikt. Zie de koppelingen voor het instellen van projecten in de volgende sectie voor andere technologieën.

  1. Meld u aan bij Azure DevOps en ga naar uw project.

  2. Selecteer Artefacten, kies uw feed in de vervolgkeuzelijst en selecteer vervolgens Verbinding maken met feed.

    Een schermopname van het selecteren van een feed in de vervolgkeuzelijst in Azure Artifacts.

  3. Selecteer Cargo in het linkernavigatiedeelvenster.

  4. Kopieer in de sectie Project setup het eerste fragment en voeg het toe aan het bestand cargo/config.toml in uw bronopslagplaats. Het bestand config.toml moet er ongeveer als volgt uitzien:

    [registries]
    FEED_NAME = { index = "sparse+https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/Cargo/index/" }
    
  5. Een referentieprovider configureren

  6. Aanmelden bij het register

Projectopzet voor overige pakkettypen

Als u een andere technologie gebruikt, gebruikt u de onderstaande koppelingen om de juiste richtlijnen voor het instellen van projecten te volgen om verbinding te maken met uw feed:

Upstream-feed instellen

Volg deze stappen om een interne feed van dezelfde organisatie in te stellen als een upstream-bron:

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

  2. Selecteer Artefacten en selecteer vervolgens de feed die u eerder hebt gemaakt in de vervolgkeuzelijst van de feed.

  3. Selecteer hettandwielpictogram van de tandwielknop om naar feedinstellingen te navigeren.

  4. Selecteer Upstream-bronnen en selecteer Vervolgens Upstream toevoegen.

  5. Selecteer op het tabblad Typede Azure Artifacts-feed in deze organisatie.

  6. Selecteer op het tabblad Configuratie in het vervolgkeuzemenu Feed de feed die u wilt toevoegen als een upstream-bron. Selecteer de gewenste weergave en kies vervolgens de pakkettypen die u wilt opnemen en werk desgewenst de upstream-bronnaam bij.

  7. Selecteer Toevoegen wanneer u klaar bent.

    Een schermopname die laat zien hoe u een nieuwe interne feed toevoegt als een upstream-bron in Azure Artifacts.

  8. Selecteer Opslaan om uw wijzigingen toe te passen.

    Een schermopname die laat zien hoe u upstream-bronnen opslaat in Azure Artifacts.

Pakketten installeren vanuit upstream

In het volgende voorbeeld ziet u een scenario waarin Test_FeedCargoDemoFeed heeft geconfigureerd als een upstream-bron. Voor demonstratiedoeleinden is Test_Feed leeg en bevat geen pakketten.

Wanneer een samenwerker (of hoger) een pakket installeert vanuit Test_Feed dat beschikbaar is in de upstream CargoDemoFeed, kopieert Azure Artifacts dat pakket naar de downstream-Test_Feed en downloadt het als onderdeel van de normale cargo install stroom. Na deze eerste keer kopiëren hebben alle toekomstige downloads van dat pakket van Test_Feed alleen machtigingen voor feedlezer (of hoger) nodig, omdat deze latere downloads de downstreamfeed niet wijzigen. Alleen de eerste installatie kopieert het pakket van upstream naar downstream, zodat alleen voor de eerste actie verhoogde machtigingen zijn vereist.

  1. Meld u aan bij Azure DevOps en navigeer vervolgens naar het project dat als host fungeert voor de upstream-feed (in dit voorbeeld CargoDemoFeed).

  2. Selecteer Artefacten en selecteer vervolgens in de vervolgkeuzelijst de upstream-feed (CargoDemoFeed).

  3. Zoek het pakket dat u wilt installeren en noteer de naam ervan. In dit voorbeeld is atomic-waker de pakketnaam. U kunt ook rechtstreeks vanuit uw downstreamfeed in de gebruikersinterface van Azure Artifacts zoeken naar upstream-pakketten. Zie Zoekpakketten uit upstream-bronnen voor meer informatie.

  4. Navigeer naar de hoofdmap van uw project en open uw Cargo.toml. Voeg het pakket toe onder [afhankelijkheden].. Omdat dit een private crate-afhankelijkheid is, moet u de registernaam opgeven in uw Cargo.toml-bestand. Cargo gaat ervan uit dat crates.io als standaardregister tenzij anders is opgegeven. Voeg de afhankelijkheid als volgt toe:

    CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
    
    # Example:
    # [dependencies]
    # atomic-waker = { version = "1.1.2", registry = "Test_Feed" }
    
  5. Open een lokale opdrachtprompt, navigeer naar de hoofdmap van uw project en voer de volgende opdracht uit om uw project te bouwen en de krat te downloaden:

    cargo build
    
  6. Zodra de build is voltooid, keert u terug naar Azure DevOps>Artifacts en selecteert u uw verbruiksfeed (in dit voorbeeld Test_Feed).

  7. Controleer of het pakket dat u lokaal hebt geïnstalleerd, nu wordt weergegeven in uw downstreamfeed. Azure Artifacts slaat automatisch een kopie van het pakket op wanneer het wordt geïnstalleerd vanuit een upstream-bron.

    Een schermopname van een pakket dat is opgeslagen vanuit een interne upstream in Azure Artifacts.