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 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. 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.
# .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. 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. Working directory.
# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    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.
  # 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. 
    #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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. 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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.
# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    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). 
    #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.
  # 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. 
    #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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. 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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.

Bemenetek

azureSubscription - Azure Resource Manager kapcsolat
Bemeneti alias: . .

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.


parancs
. Szükséges. Engedélyezett értékek: , (nuget push), , , , , , . Alapértelmezett érték: .

A futtatandó dotnet parancs. Adjon meg 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.


Webes projektek közzététele
. Szabadon választható. Használja a . Alapértelmezett érték: .

Ha ez a bemenet értékre van állítva, a 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 fájl vagy egy 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.


projekt(ek) vagy megoldás(ok) elérési útja
. Szabadon választható. Használja a .

A használni kívánt vagy fájl(ok) elérési útja. Használhat helyettesítő karaktereket (például minden 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 beállítástól függetlenül.


projekt(ek) elérési útja
. Szabadon választható. Használja a .

A használni kívánt fájl(ok) elérési útja. Használhat helyettesítő karaktereket (például minden 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 beállítástól függetlenül.


Egyéni parancs
. esetén kötelező.

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


argumentumok
. Szabadon választható. Használja a .

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 , , , és argumentumait fogadja el . Ha olyan parancs argumentumait szeretné hozzáadni, amely nem szerepel a listán, használja a .


argumentumok
. Szabadon választható. Használja a .

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


Teszteredmények és kódlefedettségi közzététele
. Szabadon választható. Használja a . Alapértelmezett érték: .

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

VSTest esetén ez az opció a parancssori argumentumokhoz kapcsolódik . A Microsoft.Testing.Platform esetében, ha tesztfutóként észlelik , ez az opció hozzáadódik a parancssori argumentumokhoz.

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


tesztelési cím
. Szabadon választható. Használja a .

Megadja a tesztfuttatás nevét.


Zip által közzétett projektek
. Szabadon választható. Használja a . Alapértelmezett érték: .

Ha ez a bemenet é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.


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

Ha ez a bemenet é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.


használni kívánt hírcsatornák
Bemeneti alias: . . esetén kötelező. Engedélyezett értékek: (Itt kiválasztom a hírcsatornát), (A NuGet.confighírcsatornái). Alapértelmezett érték: .

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 alias: . . Szabadon választható. Használja a .

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


vstsFeed - Használj csomagokat ebből a Azure Artifacts feedből
Bemeneti alias: . . Szabadon választható. Használja a .

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


Csomagok használata NuGet.org
. Szabadon választható. Használja a . Alapértelmezett érték: .

Tartalmazza a létrehozott .


elérési út a NuGet.config
. Szabadon választható. Használja a .

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


szervezeten/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti alias: . . Szabadon választható. Használja a .

A kijelölt helyen 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.


Helyi gyorsítótár- letiltása
. Szabadon választható. Használja a . Alapértelmezett érték: .

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


Célkönyvtár
Bemeneti alias: . . Szabadon választható. Használja a .

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.


részletességi
. Szabadon választható. Használja a . Engedélyezett értékek: , , , , , . Alapértelmezett érték: .

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


részletességi
. Szabadon választható. Használja a . Engedélyezett értékek: , , , , , . Alapértelmezett érték: .

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


NuGet-csomag(ok) elérési útja a közzétételéhez
Bemeneti alias: . . esetén kötelező. Alapértelmezett érték: .

A feltöltendő fájlok 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: .


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

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


Célcsatorna
Bemeneti alias: . . eseté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.


Folyamat metaadatainak közzététele
. Szabadon választható. Használja a . Alapértelmezett érték: .

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


NuGet-kiszolgáló
Bemeneti alias: . . esetén kötelező.

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


csproj- vagy nuspec-fájl(ok) elérési útja a
Bemeneti alias: . . esetén kötelező. Alapértelmezett érték: .

A vagy 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: .


konfigurációja
Bemeneti alias: . . Szabadon választható. Használja a . Alapértelmezett érték: .

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


Csomagmappa
Bemeneti alias: . . Szabadon választható. Használja a . Alapértelmezett érték: .

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


Ne hozzon létre
. Szabadon választható. Használja a . Alapértelmezett érték: .

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


Szimbólumok belefoglalása
. Szabadon választható. Használja a . Alapértelmezett érték: .

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


Forrás belefoglalása
. Szabadon választható. Használja a . Alapértelmezett érték: .

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


Csomag automatikus verziószámozási
. esetén kötelező. Engedélyezett értékek: , (Használja a dátumot és az időt), (Használj egy környezeti változót), (Használd a build számot), (Használd a teljes SemVer build számot). Alapértelmezett érték: .

Ez a feladat nem használható a hivatkozott projektekben. Ha választ, ez létrehoz egy SemVer--kompatibilis verziót, amely , ahol , és választ.

Ha vá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 választja, akkor a buildszámmal fogja verziószámba foglalni a csomagot. Megjegyzés: A alatt állítsa be a buildszám formátumát .


Csomag automatikus verziószámozási
. esetén kötelező. Engedélyezett értékek: , (Dátum és idő használata), (Környezeti változó használata), (A buildszám használata). Alapértelmezett érték: .

Ez a feladat nem használható a hivatkozott projektekben. Ha választ, ez létrehoz egy SemVer--kompatibilis verziót, amely , ahol , és választ.

Ha vá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 választja, akkor a buildszámmal fogja verziószámba foglalni a csomagot. Megjegyzés: A alatt állítsa be a buildszám formátumát .


környezeti változó
. esetén kötelező.

Megadja a változó nevét , vagy nélkül.



Bemeneti alias: . . esetén kötelező. Alapértelmezett érték: .

A X.Y.Z .


kisebb
Bemeneti alias: . . esetén kötelező. Alapértelmezett érték: .

A X.Y.Z .


patch
Bemeneti alias: . . esetén kötelező. Alapértelmezett érték: .

A X.Y.Z .


További buildtulajdonságok
. Szabadon választható. Használja a .

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


részletességi
. Szabadon választható. Használja a . Engedélyezett értékek: , , , , , . Alapértelmezett érték: .

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


részletességi
. Szabadon választható. Használja a . Engedélyezett értékek: , , , , , . Alapértelmezett érték: .

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


Munkakönyvtár
. Szabadon választható. Használja a .

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


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

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 SYSTEM_ACCESSTOKEN kell beállítani.

Az alábbi példa a tevékenység bemenetét mutatja be. és 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 parancs, beleértve a , és implicit lépést tartalmaz. Ez akkor is sikertelen lesz a hitelesített hírcsatornákon, ha egy korábbi lépésben sikeres 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 jelzőt a szövegmezőhöz.

Ezenkívül a parancs nem ismeri fel a vagy argumentumokat, és az így megadott hírcsatornák nem lesznek belefoglalva a létrehozott fájlba az implicit lépés futtatásakor. Javasoljuk, hogy egy explicit lépést használjon a csomagok visszaállításához. A parancs tiszteletben tartja a és 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 NuGet-visszaállítást vagy -hozzáférést biztosító különböző parancsok létrehoznak egy speciális ideiglenes fájlt, amely NuGet-hitelesítést ad hozzá az Azure Artifacts NuGet-hírcsatornákhoz. 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 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 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 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 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 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 beküldésre

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'

Példák csomagra

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

Példák visszaállítása

#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
Követelmények Egyik sem
képességek 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
Változók beállítása Bármely
Ügynök verziója 2.144.0 vagy újabb
Tevékenységkategória Épít
Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva Ügynök
Követelmények Egyik sem
képességek 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
Változók beállítása Bármely
Ügynök verziója 2.115.0 vagy újabb
Tevékenységkategória Épít