DotNetCoreCLI@2 - .NET Core v2 feladat

Építs, teszteljen, csomagoljon vagy publikáljon egy .NET alkalmazást, vagy indítson egy egyedi .NET CLI parancsot.

Szintaxis

# .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 feedsToUse = 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 feedsToUse = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when feedsToUse = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when feedsToUse = 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. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber' | 'bySemVerBuildNumber'. 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. Working directory.

Bemenetek

azureSubscription - Azure Resource Manager kapcsolat
Bemeneti álnév:ConnectedServiceName . string.

Határozz meg egy Azure Resource Manager szolgáltatáskapcsolatot, amelyet munkaterhelés identitásszövetséggel konfigurálva használ AzurePipelinesCredential integrációs tesztekben. További információ: Az AzurePipelinesCredential használata integrációs tesztekben.

Jegyzet

Ez a bemenet csak a számítási feladatok identitás-összevonására konfigurált ARM-szolgáltatáskapcsolatokat támogatja.

command - Parancs
string. Szükséges. Engedélyezett értékek: build, push (nuget push), pack, publish, restore, run, test, custom. Alapértelmezett érték: build.

A futtatandó dotnet parancs. Adjon meg custom argumentumok hozzáadásához vagy az itt nem szereplő parancsok használatához.

Fontos

A NuGet Authenticate feladat az új, ajánlott módja az Azure Artifacts és más NuGet tárakon történő hitelesítésnek. A restore és push parancsok ebben a .NET Core CLI feladatban már nem vesznek fel új funkciókat, és csak kritikus hibákat javítanak. A részletekért tekintse meg a megjegyzéseket.

publishWebProjects - Webes projektek közzététele
boolean. Szabadon választható. Használja a command = publish. Alapértelmezett érték: true.

Ha ez a bemenet trueértékre van állítva, a projects tulajdonság értéke ki lesz hagyva, és a feladat megpróbálja megtalálni a webes projekteket az adattárban, és futtatja rajtuk a közzétételi parancsot. A webes projekteket egy web.config fájl vagy egy wwwroot mappa jelenléte azonosítja a címtárban. Ha nincs web.config fájl vagy wwwroot mappa hiányában, olyan projekteket választanak, amelyek web-SDK-t használnak, például Microsoft.NET.Sdk.Web.

projects - projekt(ek) vagy megoldás(ok) elérési útja
string. Szabadon választható. Használja a command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

A használni kívánt .csproj vagy .sln fájl(ok) elérési útja. Használhat helyettesítő karaktereket (például **/*.csproj minden .csproj fájlhoz az összes almappában). További információ: fájlmegfeleltetési minták hivatkozása.

Ez az elérési út az adattár gyökeréhez viszonyítva, a workingDirectory beállítástól függetlenül.

custom - Egyéni parancs
string. command = customesetén kötelező.

A végrehajtáshoz dotnet.exe átadni kívánt parancs. Az elérhető parancsok teljes listáját a dotnet CLI dokumentációjában találja,.

arguments - argumentumok
string. Szabadon választható. Használja a command = build || command = publish || command = run || command = test || command = custom.

A kijelölt parancs argumentumait adja meg. Például buildkonfiguráció, kimeneti mappa és futtatókörnyezet. Az argumentumok a kijelölt parancstól függenek.

Ez a bemenet jelenleg csak a build, publish, run, testés customargumentumait fogadja el . Ha olyan parancs argumentumait szeretné hozzáadni, amely nem szerepel a listán, használja a custom.

restoreArguments - argumentumok
string. Szabadon választható. Használja a command = restore.

A restore parancsnak továbbadandó további argumentumokat írja le.

publishTestResults - Teszteredmények és kódlefedettségi közzététele
boolean. Szabadon választható. Használja a command = test. Alapértelmezett érték: true.

Ha engedélyezi ezt a beállítást, test results TRX-fájlt hoz létre a $(Agent.TempDirectory), és az eredmények közzé lesznek téve a kiszolgálón.

VSTest esetén ez az opció a parancssori argumentumokhoz kapcsolódik --logger trx --results-directory $(Agent.TempDirectory) . A Microsoft.Testing.Platform esetében, ha tesztfutóként global.jsonészlelik , ez az opció hozzáadódik --report-trx --results-directory $(Agent.TempDirectory) a parancssori argumentumokhoz.

A kód lefedettséget úgy lehet gyűjteni, ha a parancssori argumentumokhoz hozzáadjuk a --collect "Code coverage" (VSTest esetén) vagy --coverage (Microsoft.Testing.Platform esetén) opciót.

testRunTitle - tesztelési cím
string. Szabadon választható. Használja a command = test.

Megadja a tesztfuttatás nevét.

zipAfterPublish - Zip által közzétett projektek
boolean. Szabadon választható. Használja a command = publish. Alapértelmezett érték: true.

Ha ez a bemenet trueértékre van állítva, a közzétételi parancs által létrehozott mappák tömörítve lesznek és törölve lesznek.

modifyOutputPath - Projekt mappanevének hozzáadása az elérési út közzétételéhez
boolean. Szabadon választható. Használja a command = publish. Alapértelmezett érték: true.

Ha ez a bemenet trueértékre van állítva, a közzétételi parancs által létrehozott mappákban a projektfájl neve előtagot kap a mappanevekhez, amikor a kimeneti elérési út explicit módon meg van adva az argumentumokban. Ez akkor hasznos, ha több projektet szeretne közzétenni ugyanabban a mappában.

feedsToUse - használni kívánt hírcsatornák
Bemeneti álnév:selectOrConfig . string. command = restoreesetén kötelező. Engedélyezett értékek: select (Itt kiválasztom a hírcsatornát), config (A NuGet.confighírcsatornái). Alapértelmezett érték: select.

Választhatsz egy feedet a Azure Artifacts és/vagy NuGet.org közül, vagy egy nuget.config fájlt a forráskód tártáradban be, és beállíthatod az útvonalát a nugetConfigPath bemenet segítségével.

Használj csomagokat ebből a Azure Artifacts feedből. Válassz a legördülő menüből, vagy írd be a [project name/]feed name.
Bemeneti álnév:feedRestore . string. Szabadon választható. Használja a feedsToUse = select && command = restore.

Tartalmazza a kiválasztott hírcsatornát a létrehozott NuGet.config. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt kiválaszthassa a hírcsatornát. projectName / feedName projekthatókörű hírcsatornákhoz használhatók. A szervezet hatókörébe tartozó hírcsatornákhoz csak FeedName használható. Megjegyzés: Ez a test parancs esetében nem támogatott.

includeNuGetOrg - Csomagok használata NuGet.org
boolean. Szabadon választható. Használja a feedsToUse = select && command = restore. Alapértelmezett érték: true.

Tartalmazza a létrehozott NuGet.orgNuGet.config.

nugetConfigPath - elérési út a NuGet.config
string. Szabadon választható. Használja a feedsToUse = config && command = restore.

Az adattár NuGet.config, amely meghatározza azokat a hírcsatornákat, amelyekből a csomagokat vissza szeretné állítani.

externalFeedCredentials - szervezeten/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti álnév:externalEndpoints . string. Szabadon választható. Használja a feedsToUse = config && command = restore.

A kijelölt NuGet.confighelyen felsorolt külső regisztrációs adatbázisokhoz használandó szolgáltatáskapcsolat neve. Az ugyanazon szervezeten vagy gyűjteményen belüli hírcsatornák esetében hagyja üresen ezt a bemenetet; a rendszer automatikusan használja a build hitelesítő adatait.

noCache - Helyi gyorsítótár- letiltása
boolean. Szabadon választható. Használja a command = restore. Alapértelmezett érték: false.

Megakadályozza, hogy a NuGet a helyi gép gyorsítótáraiból származó csomagokat használ.

restoreDirectory - Célkönyvtár
Bemeneti álnév:packagesDirectory . string. Szabadon választható. Használja a command = restore.

Azt a mappát adja meg, amelyben a csomagok telepítve vannak. Ha nincs megadva mappa, a rendszer visszaállítja a csomagokat az alapértelmezett NuGet-csomaggyorsítótárba.

verbosityRestore - Bőbeszédűség
string. Szabadon választható. Használja a command = restore. Engedélyezett értékek: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Alapértelmezett érték: Normal.

Megadja a restore parancs kimenetében megjelenő részletesség mennyiségét.

packagesToPush - NuGet-csomag(ok) elérési útja a közzétételéhez
Bemeneti álnév:searchPatternPush . string. command = pushesetén kötelező. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/*.nupkg.

A feltöltendő fájlok nupkg egyező mintája vagy elérési útja. Több mintát is elválaszthat pontosvesszővel, és negatívvá teheti a mintákat a !előtaggal. Példa: **/*.nupkg;!**/*.Tests.nupkg.

nuGetFeedType - Célcsatorna helye
string. command = pushesetén kötelező. Engedélyezett értékek: internal (Ez a szervezet/gyűjtemény), external (külső NuGet-kiszolgáló (más szervezeteket/gyűjteményeket is beleértve)). Alapértelmezett érték: internal.

Megadja, hogy a célcsatorna belső vagy külső-e.

publishVstsFeed - Cél hírcsatorna
Bemeneti álnév:feedPublish . string. command = push && nuGetFeedType = internalesetén kötelező.

A szervezetben üzemeltetett hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt kiválaszthassa a hírcsatornát.

publishPackageMetadata - Folyamat metaadatainak közzététele
boolean. Szabadon választható. Használja a command = push && nuGetFeedType = internal. Alapértelmezett érték: true.

Társítja a buildelési/kiadási folyamat metaadatait (run #, forráskódadatok) a csomaghoz.

publishFeedCredentials - NuGet-kiszolgáló
Bemeneti álnév:externalEndpoint . string. command = push && nuGetFeedType = externalesetén kötelező.

A NuGet szolgáltatáskapcsolat, amely a külső NuGet-kiszolgáló hitelesítő adatait tartalmazza.

packagesToPack - csproj- vagy nuspec-fájl(ok) elérési útja a
Bemeneti álnév:searchPatternPack . string. command = packesetén kötelező. Alapértelmezett érték: **/*.csproj.

A .csproj vagy .nuspec csomagolni kívánt fájlok keresésének mintája.

Több mintát is elválaszthat pontosvesszővel, és negatívvá teheti a mintákat úgy, hogy előtagot ad !. Példa: **/*.csproj;!**/*.Tests.csproj.

configuration - konfigurációja
Bemeneti álnév:configurationToPack . string. Szabadon választható. Használja a command = pack. Alapértelmezett érték: $(BuildConfiguration).

.csproj fájl használatakor ez a bemenet határozza meg a csomagolandó konfigurációt.

packDirectory - Csomagmappa
Bemeneti álnév:outputDir . string. Szabadon választható. Használja a command = pack. Alapértelmezett érték: $(Build.ArtifactStagingDirectory).

Az a mappa, ahol a csomagok létrejönnek. Ha ez a mappa üres, a csomagok a csproj fájl mellett jönnek létre.

nobuild - Ne hozzon létre
boolean. Szabadon választható. Használja a command = pack. Alapértelmezett érték: false.

Azt adja meg, hogy a tevékenység nem hozza létre a projektet a csomagolás előtt. Ez a feladat a --no-build parancs build paraméterének felel meg.

includesymbols - Szimbólumok belefoglalása
boolean. Szabadon választható. Használja a command = pack. Alapértelmezett érték: false.

Szimbólum NuGet-csomagokat hoz létre. Ez a feladat a --include-symbols parancssori paraméternek felel meg.

includesource - Forrás belefoglalása
boolean. Szabadon választható. Használja a command = pack. Alapértelmezett érték: false.

Tartalmazza a csomag forráskódját. Ez a feladat a --include-source parancssori paraméternek felel meg.

versioningScheme - Csomag automatikus verziószámozási
string. command = packesetén kötelező. Engedélyezett értékek: off, byPrereleaseNumber (Használja a dátumot és az időt), byEnvVar (Használj egy környezeti változót), byBuildNumber (Használd a build számot), bySemVerBuildNumber (Használd a teljes SemVer build számot). Alapértelmezett érték: off.

Ez a feladat nem használható a hivatkozott projektekben. Ha Use the date and timeválaszt, ez létrehoz egy SemVer--kompatibilis verziót, amely X.Y.Z-ci-datetime, ahol X, Yés Zválaszt.

Ha Use an environment variableválaszt, ki kell választania egy környezeti változót, és meg kell győződnie arról, hogy tartalmazza a használni kívánt verziószámot.

Ha a Use the build numberválasztja, akkor a buildszámmal fogja verziószámba foglalni a csomagot. Megjegyzés: A Optionsalatt állítsa be a buildszám formátumát $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).

versionEnvVar - Környezeti változó
string. versioningScheme = byEnvVar && command = packesetén kötelező.

Megadja a változó nevét $, $envvagy %nélkül.

majorVersion - Őrnagy
Bemeneti álnév:requestedMajorVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 1.

Az XX.Y.Z.

minorVersion - Kiskorú
Bemeneti álnév:requestedMinorVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

Az YX.Y.Z.

patchVersion - Folt
Bemeneti álnév:requestedPatchVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

Az ZX.Y.Z.

buildProperties - További buildtulajdonságok
string. Szabadon választható. Használja a command = pack.

Pontosvesszővel elválasztott token = value párok listáját adja meg, ahol a $token$ fájlban lévő .nuspec minden előfordulása a megadott értékre lesz lecserélve. Az értékek idézőjelekben sztringek lehetnek.

verbosityPack - Bőbeszédűség
string. Szabadon választható. Használja a command = pack. Engedélyezett értékek: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Alapértelmezett érték: Normal.

Megadja a pack parancs kimenetében megjelenő részletesség mennyiségét.

workingDirectory - Munkakönyvtár
string. Szabadon választható. Használja a command != restore && command != push && command != pack.

Az aktuális munkakönyvtár, amelyen a szkript fut. Empty az adattár (build) vagy összetevők (kiadás) gyökere, amely $(System.DefaultWorkingDirectory).

requestTimeout - Csomagletöltési kérelem időtúllépésének beállítása
string. Alapértelmezett érték: 300000.

Biztosíts időtúlzási értéket a feladat által a .NET csomag eléréséhez szükséges HTTP kérésekhez. Az érték ezredmásodpercben van. Az alapértelmezett érték 300000 ezredmásodperc (5 perc). Nem lehet több, mint 6000000 ezredmásodperc (10 perc).

Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Egyik sem.

Megjegyzések

Fontos

A NuGet Authenticate feladat az új, ajánlott módja az Azure Artifacts és más NuGet tárakon történő hitelesítésnek. A restore és push parancsok ebben a .NET Core CLI feladatban már nem vesznek fel új funkciókat, és csak kritikus hibákat javítanak.

Az AzurePipelinesCredential használata integrációs tesztekben

A Azure Identity könyvtárak a .NET, C++, Go, Java, JavaScript és Python számára támogatják a munkaterhelés identitásföderációját, így a AzureCLI@2 és AzurePowerShell@5 feladatokból futtatott kód autentikálható Microsoft Entra ID-vel (például a hozzáféréshez Azure) a AzurePipelinesCredential osztályt használva.

Sok ügyfél Azure SDK klienskönyvtárakat használ integrációs tesztekhez, amelyeket más feladatokból hívnak elő. A DotNetCoreCLI@2, Maven@4 és VSTest@3 feladatok hozzáférhetnek Azure erőforrásokhoz a AzurePipelinesCredential osztály segítségével.

A connectedServiceName tulajdonságot beállíthatod egy Azure szolgáltatáskapcsolatra, amelyet workload identity federation-rel konfigurálsz. A AzurePipelinesCredentialSYSTEM_ACCESSTOKEN kell beállítani.

Az alábbi példa a connectedServiceName tevékenység DotNetCoreCLI@2 bemenetét mutatja be. VSTest@3 és Maven@4 használata hasonló.

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

További információért a AzurePipelinesCredential-ról lásd: Javítsa biztonsági helyzetet a Azure szolgáltatási kapcsolatokban AzurePipelinesCredential segítségével.

Miért nem sikerül visszaállítani a csomagokat a buildelési, közzétételi vagy tesztelési lépésemmel?

A legtöbb dotnet parancs, beleértve a build, publishés test implicit restore lépést tartalmaz. Ez akkor is sikertelen lesz a hitelesített hírcsatornákon, ha egy korábbi lépésben sikeres dotnet restore futtatott, mert a korábbi lépés megtisztította a használt hitelesítő adatokat.

A probléma megoldásához adja hozzá a --no-restore jelzőt a Arguments szövegmezőhöz.

Ezenkívül a test parancs nem ismeri fel a feedRestore vagy vstsFeed argumentumokat, és az így megadott hírcsatornák nem lesznek belefoglalva a létrehozott NuGet.config fájlba az implicit restore lépés futtatásakor. Javasoljuk, hogy egy explicit dotnet restore lépést használjon a csomagok visszaállításához. A restore parancs tiszteletben tartja a feedRestore és vstsFeed argumentumokat.

Miért kapok NU1507-figyelmeztetéseket csomagforrás-leképezési bár a gépemen való építéskor nincsenek figyelmeztetések?

A különböző parancsok, amelyek NuGet visszaállítást végeznek vagy NuGet feedhez hozzáférnek, egy speciális ideiglenes NuGet.config fájlt hoznak létre, amely hozzáadja a NuGet hitelesítést az azure artefakták NuGet feedekhez. Ennek módja ütközik azzal a sémával, amelyet a Csomagforrás-leképezés a csomagok forráshoz való leképezéséhez használ, és megszakítja a csomagforrás-leképezés konfigurációját az adattár NuGet.config fájljában. Az ütközés megkerüléséhez használhatja a NuGet Authenticate feladatot a hitelesítéshez, majd az egyéni parancsot a kívánt dotnet parancs meghívásához a NuGet.config módosítás nélkül.

# 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'

Miért érdemes bejelentkeznem egy NuGet.config?

A NuGet.config forráskövetésbe való ellenőrzése biztosítja, hogy a projekt létrehozásához szükséges legfontosabb információk – a csomagok helye – minden fejlesztő számára elérhetők, amely ellenőrzi a kódot.

Azonban olyan helyzetekben, amikor egy fejlesztőcsapat nagy körű projekteken dolgozik, lehetséges egy Azure Artifacts feedet hozzáadni a globális NuGet.config-hez minden fejlesztő gépén. Ezekben az esetekben a NuGet-feladat Feeds I select here lehetőségével replikálja ezt a konfigurációt.

Hibaelhárítás

Az Entity Frameworkt használó projekt leállt a üzemeltetett ügynökökön

A .NET Core nem rendelkezik beépített Entity Framework(EF) rendszerrel. Vagy telepítened kell az EF-t a végrehajtás előtt, vagy hozzá kell adnod a global.json-t a szükséges .NET Core SDK verzióval. Ez biztosítja, hogy a megfelelő SDK-t használja az EF-projekt létrehozásához. Ha a szükséges verzió nem található a gépen, adja hozzá a UseDotNetV2 feladatot a folyamathoz a szükséges verzió telepítéséhez. További információért lásd: Get the Entity Framework Core runtime.

Példák

• Példák összeállítása
• példák leküldéses
• példák leküldéses
• Csomag példák
• Példák közzététele
• visszaállítási példák
• Példák tesztelése

Példák összeállítása

Projekt létrehozása

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

Több projekt létrehozása

# 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.

példák leküldéses

NuGet-csomagok leküldése belső hírcsatornába

# 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-csomagok leküldése külső hírcsatornába

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

Csomag példák

NuGetPackage csomagolása egy adott kimeneti könyvtárba

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

Szimbólumcsomag csomagolása

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

Példák közzététele

Projektek közzététele a megadott mappában

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

visszaállítási példák

#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

Példák tesztelése

Tesztek futtatása az adattárban

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

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva	Ügynök
Demands	Egyik sem
Capabilities	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármely
Beállítható változók	Bármely
Ügynök verziója	2.144.0 vagy újabb
Tevékenységkategória	Épít