Delen via


Pakketten promoten en feedweergaven beheren

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

Met feedweergaven kunnen ontwikkelaars de zichtbaarheid van pakketten beheren door sommige pakketten te delen terwijl anderen privé blijven. Elke weergave filtert de feed om een subset van pakketten weer te geven op basis van specifieke criteria die voor die weergave zijn gedefinieerd.

Azure Artifacts bevat standaard drie weergaven: @Local, @Prerelease en @Release. De @Local weergave is de standaardweergave en bevat alle gepubliceerde pakketten, samen met pakketten die zijn opgeslagen vanuit upstream-bronnen. Alle weergaven ondersteunen NuGet, npm, Maven, Python, Cargo en Universal Packages.

U kunt de standaardweergave wijzigen inweergaven>. Als u de standaardweergave wijzigt, is het echter niet toegestaan om direct naar die weergave te publiceren. Pakketten kunnen alleen worden gepubliceerd naar de basisfeed, waar ze beschikbaar zijn in de @Local weergave.

Vereiste voorwaarden

Product Requirements
Azure DevOps - Een Azure DevOps-organisatie en een project.
- Een Azure Artifacts feed.

Een pakket upgraden naar een weergave

Notitie

Je moet een feeduitgever (inzender) of een feedeigenaar zijn om pakketten te promoveren naar een overzicht.

Volg deze stappen om een pakket te promoveren naar een specifieke weergave in uw feed:

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

  2. Selecteer Artefactenen selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer het pakket dat u wilt promoveren, en selecteer Promoveren.

  4. Selecteer een weergave in de vervolgkeuzelijst en selecteer vervolgens nogmaals Promoot.

    Een schermopname die laat zien hoe u een pakket promoveert naar een weergave in Azure Artifacts.

Belangrijk

Azure Artifacts biedt geen ondersteuning voor pakketdegradatie. Zodra een pakket is gepromoveerd, kan het niet meer worden teruggezet naar een vorige weergave.

Een pakket promoveren met behulp van de REST API

Als u een pakket wilt promoveren met behulp van de REST API, verzendt u een PATCH-aanvraag met een aanvraagbody die is opgemaakt als een JSON Patch-document . Hiermee wordt de doelweergave (bijvoorbeeld Prerelease) toegevoegd aan de weergavematrix van het pakket.

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

  2. Maak een Persoonlijk Toegangstoken met Packaging>Lezen, Schrijven, & Beheren scope.

  3. Kopieer de eindpunt-URL, vervang deze in een van de onderstaande voorbeelden (PowerShell of curl) en voer de opdracht uit om het pakket naar de gewenste weergave te promoveren.

  • Feed voor de hele organisatie:

    https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1
    
  • Projectgebaseerde feed

    https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1
    

Zie JsonPatchOperation en NuGet - Update Package Version voor meer informatie.

  • feed met verzamelingsbereik:

    https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1
    
  • Projectgebaseerde feed

    https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1
    

Zie JsonPatchOperation en NuGet - Update Package Version voor meer informatie.

Voorbeelden

Vervang de tijdelijke aanduidingen door uw persoonlijke toegangstoken, eindpunt-URL en weergavenaam en voer vervolgens de opdracht uit om uw pakket naar de gewenste weergave te promoveren:

$env:PAT = "YOUR_PERSONAL_ACCESS_TOKEN"
$uri = "YOUR_URL"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "YOUR_VIEW_NAME"
    }
} | ConvertTo-Json

Invoke-RestMethod -Uri $uri -Method Patch -Headers $headers -Body $body

Notitie

Alle feedweergaven in een openbaar project zijn openbaar toegankelijk en kunnen door iedereen op internet worden bekeken.

Weergaven beheren

Azure Artifacts bevat standaard drie weergaven: @Local, @Prerelease en @Release. U kunt ook extra weergaven maken en bestaande weergaven beheren door ze een andere naam te geven of te verwijderen uit de instellingen van uw feed

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

  2. Selecteer Artefactenen selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer het tandwielpictogram om de instellingen van uw feed te openen.

    Een schermopname die laat zien hoe u toegang  krijgen tot feedinstellingen in Azure Artifacts.

  4. Selecteer Weergaven, kies een weergave en selecteer Vervolgens Bewerken om deze te wijzigen. Als u een nieuwe weergave wilt maken, selecteert u De weergave Toevoegen.

    Een schermopname die laat zien hoe u feedweergaven toevoegt, bewerkt of verwijdert.

  5. Kies Opslaan wanneer u klaar bent.

Belangrijk

Als u voor openbare feeds de toegangsmachtigingen van een weergave wijzigt in Specifieke personen, is die weergave niet meer beschikbaar als een upstream-bron.