DotNetCoreCLI@2 - .NET Core v2-taak

Bouw, test, pakket of publiceer een .NET-toepassing of voer een aangepaste .NET CLI-opdracht uit.

Syntaxis

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    #azureSubscription: # string. Alias: ConnectedServiceName. Azure Resource Manager connection. 
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Normal.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Normal.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack && command != pack && command != push && command != restore. Working directory.

Ingangen

azureSubscription - Azure Resource Manager-verbinding
Invoeralias: ConnectedServiceName. string.

Geef een Azure Resource Manager-serviceverbinding op die is geconfigureerd met federatie van workloadidentiteit voor het gebruik van AzurePipelinesCredential- in integratietests. Zie AzurePipelinesCredential gebruiken in integratietestsvoor meer informatie.

Notitie

Deze invoer ondersteunt alleen ARM-serviceverbindingen die zijn geconfigureerd voor het gebruik van workloadidentiteitsfederatie.

command - opdracht
string. Vereist. Toegestane waarden: build, push (nuget push), pack, publish, restore, run, test, custom. Standaardwaarde: build.

De dotnet-opdracht die moet worden uitgevoerd. Geef custom op om argumenten toe te voegen of gebruik een opdracht die hier niet wordt vermeld.

Belangrijk

De NuGet-verificatie taak is de nieuwe aanbevolen manier om te verifiëren met Azure Artifacts en andere NuGet-opslagplaatsen. De restore- en push opdrachten van deze .NET Core CLI-taak nemen geen nieuwe functies meer in beslag en er worden alleen kritieke fouten opgelost. Zie opmerkingen voor meer informatie.

publishWebProjects - Webprojecten publiceren
boolean. Facultatief. Gebruiken wanneer command = publish. Standaardwaarde: true.

Als deze invoer is ingesteld op true, wordt de waarde van de eigenschap projects overgeslagen en wordt de taak geprobeerd de webprojecten in de opslagplaats te vinden en de publicatieopdracht erop uit te voeren. Webprojecten worden geïdentificeerd door de aanwezigheid van een web.config-bestand of een wwwroot map in de map. Als er geen web.config bestand of een wwwroot map is, worden projecten die gebruikmaken van een web-SDK, zoals Microsoft.NET.Sdk.Web, geselecteerd.

projects - pad naar project(en) of oplossing(en)
string. Facultatief. Gebruiken wanneer command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Het pad naar de .csproj of .sln bestanden die moeten worden gebruikt. U kunt jokertekens gebruiken (bijvoorbeeld **/*.csproj voor alle .csproj bestanden in alle submappen). Zie de bestandskoppelingspatronenvoor meer informatie.

Dit pad is relatief ten opzichte van de hoofdmap van de opslagplaats, ongeacht de instelling workingDirectory.

custom - aangepaste opdracht
string. Vereist wanneer command = custom.

De opdracht die moet worden doorgegeven aan dotnet.exe voor uitvoering. Zie de dotnet CLI-documentatievoor een volledige lijst met beschikbare opdrachten.

arguments - argumenten
string. Facultatief. Gebruiken wanneer command = build || command = publish || command = run || command = test || command = custom.

Hiermee geeft u de argumenten voor de geselecteerde opdracht. Bouw bijvoorbeeld configuratie, uitvoermap en runtime. De argumenten zijn afhankelijk van de geselecteerde opdracht.

Deze invoer accepteert momenteel alleen argumenten voor build, publish, run, testen custom. Als u argumenten wilt toevoegen voor een opdracht die niet wordt vermeld, gebruikt u custom.

restoreArguments - argumenten
string. Facultatief. Gebruiken wanneer command = restore.

Hiermee schrijft u de extra argumenten die moeten worden doorgegeven aan de opdracht restore.

publishTestResults - Testresultaten en codedekking publiceren
boolean. Facultatief. Gebruiken wanneer command = test. Standaardwaarde: true.

Als u deze optie inschakelt, wordt een test results TRX-bestand in $(Agent.TempDirectory)gegenereerd en worden de resultaten gepubliceerd op de server.

Met deze optie worden --logger trx --results-directory $(Agent.TempDirectory) toegevoegd aan de opdrachtregelargumenten.

Codedekking kan worden verzameld door de --collect "Code coverage" optie toe te voegen aan de opdrachtregelargumenten.

titel van testRunTitle - testuitvoering
string. Facultatief. Gebruiken wanneer command = test.

Geeft een naam op voor de testuitvoering.

zipAfterPublish - gepubliceerde zip-projecten
boolean. Facultatief. Gebruiken wanneer command = publish. Standaardwaarde: true.

Als deze invoer is ingesteld op true, worden mappen die door de opdracht Publiceren zijn gemaakt, gezipt en verwijderd.

modifyOutputPath - de mapnaam van het project toevoegen om het pad te publiceren
boolean. Facultatief. Gebruiken wanneer command = publish. Standaardwaarde: true.

Als deze invoer is ingesteld op true, krijgen mappen die zijn gemaakt met de opdracht Publiceren, de naam van het projectbestand voorafgegaan aan de mapnamen wanneer het uitvoerpad expliciet in argumenten wordt opgegeven. Dit is handig als u meerdere projecten naar dezelfde map wilt publiceren.

feedsToUse - feeds om te gebruiken
Invoeralias: selectOrConfig. string. Vereist wanneer command = restore. Toegestane waarden: select (feed(s) die ik hier selecteer), config (Feeds in mijn NuGet.config). Standaardwaarde: select.

U kunt hier een feed selecteren uit Azure Artifacts en/of NuGet.org, of u kunt een nuget.config bestand doorvoeren in uw opslagplaats voor broncode en het pad instellen met behulp van de nugetConfigPath invoer.

vstsFeed - Pakketten uit deze Azure Artifacts-feed gebruiken. Selecteer in de vervolgkeuzelijst of voer [projectnaam/]feednaam in.
Invoeralias: feedRestore. string. Facultatief. Gebruiken wanneer selectOrConfig = select && command = restore.

Bevat de geselecteerde feed in de gegenereerde NuGet.config. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een feed te selecteren. projectName / feedName worden gebruikt voor feeds met projectbereik. Alleen FeedName wordt gebruikt voor feeds binnen het bereik van de organisatie. Opmerking: dit wordt niet ondersteund voor de opdracht test.

includeNuGetOrg - Pakketten uit NuGet.org gebruiken
boolean. Facultatief. Gebruiken wanneer selectOrConfig = select && command = restore. Standaardwaarde: true.

Bevat NuGet.org in de gegenereerde NuGet.config.

nugetConfigPath - pad naar NuGet.config
string. Facultatief. Gebruiken wanneer selectOrConfig = config && command = restore.

De NuGet.config in uw opslagplaats waarin de feeds worden opgegeven waaruit pakketten moeten worden hersteld.

externalFeedCredentials - referenties voor feeds buiten deze organisatie/verzameling
Invoeralias: externalEndpoints. string. Facultatief. Gebruiken wanneer selectOrConfig = config && command = restore.

De referenties die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.configbevinden. Laat deze invoer leeg voor feeds in deze organisatie/verzameling; de referenties van de build worden automatisch gebruikt.

noCache - lokale cache uitschakelen
boolean. Facultatief. Gebruiken wanneer command = restore. Standaardwaarde: false.

Hiermee voorkomt u dat NuGet pakketten uit caches van lokale machines gebruikt.

restoreDirectory - doelmap
Invoeralias: packagesDirectory. string. Facultatief. Gebruiken wanneer command = restore.

Hiermee geeft u de map waarin pakketten worden geïnstalleerd. Als er geen map is opgegeven, worden pakketten hersteld in de standaard NuGet-pakketcache.

verbosityRestore - uitgebreidheids-
string. Facultatief. Gebruiken wanneer command = restore. Toegestane waarden: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Standaardwaarde: Normal.

Hiermee geeft u de hoeveelheid details op die wordt weergegeven in de uitvoer voor de opdracht restore.

packagesToPush - Pad naar NuGet-pakketten om te publiceren
Invoeralias: searchPatternPush. string. Vereist wanneer command = push. Standaardwaarde: $(Build.ArtifactStagingDirectory)/*.nupkg.

Het patroon dat overeenkomt met of het pad naar nupkg bestanden die moeten worden geüpload. Meerdere patronen kunnen worden gescheiden door een puntkomma en u kunt een patroon negatief maken door het voorvoegsel te voorzien van !. Voorbeeld: **/*.nupkg;!**/*.Tests.nupkg.

nuGetFeedType - locatie van doelfeed
string. Vereist wanneer command = push. Toegestane waarden: internal (deze organisatie/verzameling), external (externe NuGet-server (inclusief andere organisaties/verzamelingen)). Standaardwaarde: internal.

Hiermee geeft u op of de doelfeed intern of extern is.

publishVstsFeed - doelfeed
Invoeralias: feedPublish. string. Vereist wanneer command = push && nuGetFeedType = internal.

Hiermee geeft u een feed op die wordt gehost in deze organisatie. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een feed te selecteren.

publishPackageMetadata - metagegevens van pijplijn publiceren
boolean. Facultatief. Gebruiken wanneer command = push && nuGetFeedType = internal && command = push. Standaardwaarde: true.

Koppelt de metagegevens van deze build-/release-pijplijn (uitvoeren #, broncodegegevens) aan het pakket.

publishFeedCredentials - NuGet-server
Invoeralias: externalEndpoint. string. Vereist wanneer command = push && nuGetFeedType = external.

De NuGet -serviceverbinding die de referenties van de externe NuGet-server bevat.

packagesToPack - pad naar csproj- of nuspec-bestanden om in te pakken
Invoeralias: searchPatternPack. string. Vereist wanneer command = pack. Standaardwaarde: **/*.csproj.

Het patroon om te zoeken naar .csproj of .nuspec bestanden die moeten worden ingepakt.

U kunt meerdere patronen scheiden met een puntkomma en u kunt een patroon negatief maken door het voorvoegsel te voorzien van !. Voorbeeld: **/*.csproj;!**/*.Tests.csproj.

configuration - configureren voor pakket
Invoeralias: configurationToPack. string. Facultatief. Gebruiken wanneer command = pack. Standaardwaarde: $(BuildConfiguration).

Wanneer u een .csproj-bestand gebruikt, geeft deze invoer de configuratie op die moet worden verpakt.

packDirectory - pakketmap
Invoeralias: outputDir. string. Facultatief. Gebruiken wanneer command = pack. Standaardwaarde: $(Build.ArtifactStagingDirectory).

De map waarin pakketten worden gemaakt. Als deze map leeg is, worden er pakketten gemaakt naast het csproj-bestand.

nobuild - geen bouwen
boolean. Facultatief. Gebruiken wanneer command = pack. Standaardwaarde: false.

Hiermee geeft u op dat de taak het project niet bouwt voordat het wordt verpakt. Deze taak komt overeen met de parameter --no-build van de opdracht build.

includesymbols - symbolen opnemen
boolean. Facultatief. Gebruiken wanneer command = pack. Standaardwaarde: false.

Hiermee maakt u symbool NuGet-pakketten. Deze taak komt overeen met de --include-symbols opdrachtregelparameter.

includesource - Bron opnemen
boolean. Facultatief. Gebruiken wanneer command = pack. Standaardwaarde: false.

Bevat broncode in het pakket. Deze taak komt overeen met de --include-source opdrachtregelparameter.

versioningScheme - automatische pakketversiebeheer
string. Vereist wanneer command = pack. Toegestane waarden: off, byPrereleaseNumber (De datum en tijd gebruiken), byEnvVar (Een omgevingsvariabele gebruiken), byBuildNumber (het buildnummer gebruiken). Standaardwaarde: off.

Deze taak kan niet worden gebruikt bij opgenomen projecten waarnaar wordt verwezen. Als u Use the date and timekiest, wordt hiermee een SemVer--compatibele versie gegenereerd die is opgemaakt als X.Y.Z-ci-datetime waar u X, Yen Zkiest.

Als u Use an environment variablekiest, moet u een omgevingsvariabele selecteren en ervoor zorgen dat deze het versienummer bevat dat u wilt gebruiken.

Als u Use the build numberkiest, wordt het buildnummer gebruikt om uw pakket te versiebeheer. Opmerking: Onder Optionsstelt u de notatie van het buildnummer in op $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).

versionEnvVar - omgevingsvariabele
string. Vereist wanneer versioningScheme = byEnvVar && command = pack.

Hiermee geeft u de naam van de variabele zonder $, $envof %.

majorVersion - primaire
Invoeralias: requestedMajorVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 1.

De X in versie X.Y.Z.

minorVersion - secundaire
Invoeralias: requestedMinorVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 0.

De Y in versie X.Y.Z.

patchVersion - Patch-
Invoeralias: requestedPatchVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 0.

De Z in versie X.Y.Z.

buildProperties - Aanvullende buildeigenschappen
string. Facultatief. Gebruiken wanneer command = pack.

Hiermee geeft u een lijst van token = value paren, gescheiden door puntkomma's, waarbij elk exemplaar van $token$ in het .nuspec bestand wordt vervangen door de opgegeven waarde. Waarden kunnen tekenreeksen tussen aanhalingstekens zijn.

verbosityPack - uitgebreidheids-
string. Facultatief. Gebruiken wanneer command = pack. Toegestane waarden: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Standaardwaarde: Normal.

Hiermee geeft u de hoeveelheid details op die wordt weergegeven in de uitvoer voor de opdracht pack.

workingDirectory - werkmap
string. Facultatief. Gebruiken wanneer command != restore && command != push && command != pack && command != pack && command != push && command != restore.

De huidige werkmap waarin het script wordt uitgevoerd. Empty is de hoofdmap van de opslagplaats (build) of artefacten (release), die $(System.DefaultWorkingDirectory)is.

requestTimeout - Time-out voor pakketdownloadaanvraag instellen
string. Standaardwaarde: 300000.

Geef een time-outwaarde op voor HTTP-aanvragen die door de taak worden uitgevoerd om het .NET-pakket te verkrijgen. De waarde is in milliseconden. De standaardwaarde is 300000 milliseconden (5 minuten). Kan niet meer dan 600000 milliseconden (10 minuten) zijn.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Belangrijk

De NuGet-verificatie taak is de nieuwe aanbevolen manier om te verifiëren met Azure Artifacts en andere NuGet-opslagplaatsen. De restore- en push opdrachten van deze .NET Core CLI-taak nemen geen nieuwe functies meer in beslag en er worden alleen kritieke fouten opgelost.

AzurePipelinesCredential gebruiken in integratietests

De Azure Identity-bibliotheken voor .NET, C++, Go, Java, JavaScript en Python ondersteuning bieden voor federatie van workloadidentiteiten, zodat code die wordt uitgevoerd vanuit de AzureCLI@2- en AzurePowerShell@5-taken, kan worden geverifieerd met Microsoft Entra-id (bijvoorbeeld voor toegang tot Azure) met behulp van de AzurePipelinesCredential-klasse.

Veel klanten gebruiken Azure SDK-clientbibliotheken in integratietests die worden aangeroepen vanuit andere taken. De DotNetCoreCLI@2-, Maven@4- en VSTest@3-taken hebben toegang tot Azure-resources met behulp van de AzurePipelinesCredential-klasse.

U kunt de eigenschap connectedServiceName instellen op een Azure-serviceverbinding die is geconfigureerd met federatie van workloadidentiteit. Voor de AzurePipelinesCredential moet SYSTEM_ACCESSTOKEN worden ingesteld.

In het volgende voorbeeld ziet u de connectedServiceName invoer voor de DotNetCoreCLI@2 taak. VSTest@3 en Maven@4 gebruik is vergelijkbaar.

- task: DotNetCoreCLI@2
  inputs:
    command: 'run'
    connectedServiceName: <Azure service connection configured with workload identity federation>
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Zie Beveiligingspostuur verbeteren in Azure-serviceverbindingen met AzurePipelinesCredentialvoor meer informatie over AzurePipelinesCredential.

Waarom kan mijn build-, publicatie- of teststap pakketten niet herstellen?

De meeste dotnet opdrachten, waaronder build, publishen test een impliciete restore stap bevatten. Dit mislukt ten opzichte van geverifieerde feeds, zelfs als u een geslaagde dotnet restore in een eerdere stap hebt uitgevoerd, omdat in de vorige stap de gebruikte referenties zijn opgeschoond.

U kunt dit probleem oplossen door de vlag --no-restore toe te voegen aan het tekstvak Arguments.

Bovendien herkent de opdracht test de argumenten feedRestore of vstsFeed niet en worden feeds die op deze manier zijn opgegeven, niet opgenomen in het gegenereerde NuGet.config-bestand wanneer de impliciete restore stap wordt uitgevoerd. Het wordt aanbevolen om een expliciete dotnet restore stap te gebruiken om pakketten te herstellen. De opdracht restore respecteert de argumenten feedRestore en vstsFeed.

Waarom krijg ik NU1507-waarschuwingen met pakketbrontoewijzing, hoewel bij het bouwen op mijn computer er geen waarschuwingen zijn?

De verschillende opdrachten die een NuGet-herstel uitvoeren of toegang krijgen tot een NuGet-feed bouwen een speciaal tijdelijk NuGet.config-bestand waarmee NuGet-verificatie voor Azure Artifacts NuGet-feeds wordt toegevoegd. De manier waarop dit wordt gedaan, is in strijd met het schema dat pakketbrontoewijzing gebruikt om de pakketten toe te wijzen aan de bronnen en de configuratie van pakketbrontoewijzing in het NuGet.config-bestand in uw opslagplaats te breken. Als u dit conflict wilt omzeilen, kunt u de NuGet-verificatietaak taak gebruiken om de aangepaste opdracht te verifiëren en daarna om de gewenste dotnet-opdracht aan te roepen zonder de NuGet.config wijziging.

# Authenticate Azure DevOps NuGet feed
- task: NuGetAuthenticate@1
  displayName: 'Authenticate Azure DevOps NuGet feed'

# Restore project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'restore'

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'build'
    arguments: '--no-restore'

Waarom moet ik een NuGet.configinchecken?

Het controleren van een NuGet.config in broncodebeheer zorgt ervoor dat een belangrijk stukje informatie dat nodig is voor het bouwen van uw project, de locatie van de pakketten, beschikbaar is voor elke ontwikkelaar die uw code uitcheckt.

In situaties waarin een team van ontwikkelaars aan een groot aantal projecten werkt, is het echter ook mogelijk om een Azure Artifacts-feed toe te voegen aan de globale NuGet.config op de computer van elke ontwikkelaar. In deze situaties wordt deze configuratie gerepliceerd met behulp van de optie Feeds I select here in de NuGet-taak.

Probleemoplossing

Project dat Entity Framework gebruikt, werkt niet meer op gehoste agents

.NET Core heeft geen EF(Entity Framework) ingebouwd. U moet EF installeren voordat u begint met de uitvoering of global.json toevoegen aan het project met de vereiste .NET Core SDK-versie. Dit zorgt ervoor dat de juiste SDK wordt gebruikt om een EF-project te bouwen. Als de vereiste versie niet aanwezig is op de computer, voegt u de UseDotNetV2 taak toe aan uw pijplijn om de vereiste versie te installeren. Zie De Entity Framework Core-runtime ophalenvoor meer informatie.

Voorbeelden

• Build-voorbeelden
• Push-voorbeelden
• Push-voorbeelden
• Pack-voorbeelden
• Voorbeelden publiceren
• voorbeelden van herstellen
• voorbeelden testen

Voorbeelden van build

Een project bouwen

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Meerdere projecten bouwen

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Pushvoorbeelden

NuGet-pakketten naar interne feed pushen

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

NuGet-pakketten naar externe feed pushen

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Voorbeelden van pack

Een NuGetPackage inpakken in een specifieke uitvoermap

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Een symboolpakket inpakken

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Voorbeelden publiceren

Projecten publiceren naar de opgegeven map

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Voorbeelden van herstellen

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Testvoorbeelden

Tests uitvoeren in uw opslagplaats

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

Eisen

Eis	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Enig
variabelen instellen	Enig
Agentversie	2.144.0 of hoger
Taakcategorie	Bouwen