Pakketten promoten en feedweergaven beheren

Artikel
10/22/2024

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

Met feedweergaven kunnen gebruikers de zichtbaarheid van pakketten beheren door bepaalde 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 wordt standaard geleverd met drie weergaven: @Local, @Prerelease en @Release. De @Local weergave is de standaardweergave en bevat alle gepubliceerde pakketten en pakketten die zijn opgeslagen vanuit upstream-bronnen. Alle weergaven ondersteunen NuGet, npm, Maven, Python, Cargo en Universal Packages.

Notitie

Azure Artifacts biedt alleen ondersteuning voor het publiceren en herstellen van pakketten vanuit de standaardweergave: @Local. U kunt niet rechtstreeks publiceren naar de @Prerelease - of @Release weergaven.

Pakketten promoveren

Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.
Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.
Selecteer het pakket dat u wilt promoveren en selecteer vervolgens Niveau verhogen.
Selecteer een weergave in de vervolgkeuzelijst en selecteer Vervolgens Niveau verhogen.

Belangrijk

Pakketdegradatie wordt niet ondersteund. Zodra een pakket is gepromoveerd, kan het niet meer worden teruggezet naar een eerdere weergave.

Pakketten promoveren met behulp van de REST API

Naast het gebruik van de gebruikersinterface van Azure Artifacts kunt u ook pakketten promoveren met behulp van de REST API.

De aanvraagbody moet worden opgemaakt als een JSON Patch-document dat de weergave toevoegt aan het einde van de weergavematrix. Zie de aan de slag met de REST API en de REST API-voorbeelden voor meer informatie.

Feed met organisatiebereik:

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

Projectbereikfeed:

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

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie NuGet - Pakketversie bijwerken voor meer informatie.

Feed met organisatiebereik:

PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/npm/{packageName}/versions/{packageVersion}?api-version=7.1

Projectbereikfeed:

PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/npm/{packageName}/versions/{packageVersion}?api-version=7.1

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie Npm - Update Package voor meer informatie.

Feed met organisatiebereik:

PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/pypi/packages/{packageName}/versions/{packageVersion}?api-version=7.1

Projectbereikfeed:

PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/pypi/packages/{packageName}/versions/{packageVersion}?api-version=7.1

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie Python - Pakketversie bijwerken voor meer informatie.

Feed met organisatiebereik:

PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

Projectbereikfeed:

PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie Maven - Pakketversie bijwerken voor meer informatie.

Feed met organisatiebereik:

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

Projectbereikfeed:

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

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie Cargo - Update Package Version voor meer informatie.

Feed met organisatiebereik:

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

Projectbereikfeed:

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

Gebruik JsonPatchOperation om de hoofdtekst van uw aanvraag samen te stellen. Zie Universal - Update Package Version voor meer informatie.

Voorbeelden

curl
Powershell

$ curl -X "PATCH" "https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1" \
-h 'Content-Type: application/json' \
-u ':${PAT}' \
-d $'{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "{viewName}"
  }
}'

$uri = "https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "{viewName}"
    }
} | ConvertTo-Json

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

Notitie

Alle feedweergaven in een openbaar project zijn toegankelijk voor iedereen op internet.

Weergaven beheren

Azure Artifacts biedt drie standaardweergaven: @Local, @Prerelease en @Release. U kunt ook nieuwe weergaven maken en bestaande weergaven beheren door deze rechtstreeks vanuit de instellingen van uw feed te wijzigen of te verwijderen.

Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.
Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.
Selecteer het tandwielpictogram uiterst rechts om toegang te krijgen tot de instellingen van uw feed.
Selecteer Weergaven, selecteer een weergave en selecteer vervolgens Bewerken om de weergave te bewerken. Als u een nieuwe weergave wilt toevoegen, selecteert u De weergave Toevoegen.
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.