DotNetCoreCLI@2 — zadanie platformy .NET Core w wersji 2

Skompiluj, przetestuj, spakuj lub opublikuj aplikację .NET albo uruchom niestandardowe polecenie interfejsu wiersza polecenia platformy .NET.

Składnia

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

Wejścia

azureSubscription - połączenia usługi Azure Resource Manager
Alias wejściowy: ConnectedServiceName. string.

Określ połączenie usługi Azure Resource Manager skonfigurowane z federacją tożsamości obciążenia do używania AzurePipelinesCredential w testach integracji. Aby uzyskać więcej informacji, zobacz Use AzurePipelinesCredential in integration tests.

Nuta

Te dane wejściowe obsługują tylko połączenia usługi ARM skonfigurowane do używania federacji tożsamości obciążenia.

command - polecenia
string. Wymagane. Dozwolone wartości: build, push (wypychanie nuget), pack, publish, restore, run, test, custom. Wartość domyślna: build.

Polecenie dotnet do uruchomienia. Określ custom, aby dodać argumenty lub użyć polecenia, które nie ma na liście tutaj.

Ważny

zadanie uwierzytelniania nuGet jest nowym zalecanym sposobem uwierzytelniania za pomocą usługi Azure Artifacts i innych repozytoriów NuGet. Polecenia restore i push tego zadania interfejsu wiersza polecenia platformy .NET Core nie przyjmują już nowych funkcji i są rozwiązywane tylko krytyczne usterki. Zobacz uwagi, aby uzyskać szczegółowe informacje.

publishWebProjects - Publikowanie projektów internetowych
boolean. Fakultatywny. Użyj polecenia , gdy command = publish. Wartość domyślna: true.

Jeśli te dane wejściowe są ustawione na true, wartość właściwości projects zostanie pominięta, a zadanie próbuje znaleźć projekty internetowe w repozytorium i uruchomić polecenie publikowania na nich. Projekty sieci Web są identyfikowane przez obecność pliku web.config lub folderu wwwroot w katalogu. W przypadku braku pliku web.config lub folderu wwwroot projekty korzystające z zestawu SDK sieci Web, takie jak Microsoft.NET.Sdk.Web, są zaznaczone.

projects - ścieżka do projektów lub rozwiązań
string. Fakultatywny. Użyj polecenia , gdy command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Ścieżka do plików .csproj lub .sln do użycia. Można użyć symboli wieloznacznych (np. **/*.csproj dla wszystkich plików .csproj we wszystkich podfolderach). Aby uzyskać więcej informacji, zobacz dokumentację dopasowywania plików .

Ta ścieżka jest względna względem katalogu głównego repozytorium niezależnie od ustawienia workingDirectory.

polecenia niestandardowego
string. Wymagane, gdy command = custom.

Polecenie do przekazania do dotnet.exe do wykonania. Aby uzyskać pełną listę dostępnych poleceń, zobacz dokumentację interfejsu wiersza polecenia platformy dotnet.

arguments - argumenty
string. Fakultatywny. Użyj polecenia , gdy command = build || command = publish || command = run || command = test || command = custom.

Określa argumenty dla wybranego polecenia. Na przykład konfiguracja kompilacji, folder wyjściowy i środowisko uruchomieniowe. Argumenty zależą od wybranego polecenia.

Te dane wejściowe obecnie akceptują tylko argumenty dla build, publish, run, testi custom. Jeśli chcesz dodać argumenty dla polecenia, które nie ma na liście, użyj custom.

restoreArguments - argumenty
string. Fakultatywny. Użyj polecenia , gdy command = restore.

Zapisuje dodatkowe argumenty, które mają zostać przekazane do polecenia restore.

publishTestResults - publikowanie wyników testów i pokrycia kodu
boolean. Fakultatywny. Użyj polecenia , gdy command = test. Wartość domyślna: true.

Włączenie tej opcji spowoduje wygenerowanie test results pliku TRX w $(Agent.TempDirectory), a wyniki zostaną opublikowane na serwerze.

Ta opcja dołącza --logger trx --results-directory $(Agent.TempDirectory) do argumentów wiersza polecenia.

Pokrycie kodu można zebrać, dodając opcję --collect "Code coverage" do argumentów wiersza polecenia.

testRunTitle - tytuł przebiegu testu
string. Fakultatywny. Użyj polecenia , gdy command = test.

Zawiera nazwę przebiegu testu.

zipAfterPublish - opublikowane projekty zip
boolean. Fakultatywny. Użyj polecenia , gdy command = publish. Wartość domyślna: true.

Jeśli te dane wejściowe zostaną ustawione na true, foldery utworzone przez polecenie publikowania zostaną spakowane i usunięte.

modifyOutputPath - Dodaj nazwę folderu projektu, aby opublikować ścieżkę
boolean. Fakultatywny. Użyj polecenia , gdy command = publish. Wartość domyślna: true.

Jeśli te dane wejściowe są ustawione na true, foldery utworzone przez polecenie publikowania będą miały prefiks nazwy pliku projektu do ich nazw folderów, gdy ścieżka wyjściowa jest określona jawnie w argumentach. Jest to przydatne, jeśli chcesz opublikować wiele projektów w tym samym folderze.

kanały informacyjne feedsToUse - do korzystania z
Alias wejściowy: selectOrConfig. string. Wymagane, gdy command = restore. Dozwolone wartości: select (kanały informacyjne, które wybieram tutaj), config (kanały informacyjne w moim NuGet.config). Wartość domyślna: select.

Możesz wybrać źródło danych z usługi Azure Artifacts i/lub NuGet.org tutaj lub zatwierdzić plik nuget.config do repozytorium kodu źródłowego i ustawić jego ścieżkę przy użyciu danych wejściowych nugetConfigPath.

vstsFeed - Użyj pakietów z tego źródła danych usługi Azure Artifacts. Wybierz z listy rozwijanej lub wprowadź ciąg [nazwa projektu/]nazwa kanału informacyjnego.
Alias wejściowy: feedRestore. string. Fakultatywny. Użyj polecenia , gdy selectOrConfig = select && command = restore.

Zawiera wybrane źródło danych w wygenerowanych NuGet.config. Aby wybrać źródło danych, musisz mieć zainstalowane i licencjonowane zarządzanie pakietami. projectName / feedName są używane dla źródeł danych o zakresie projektu. Tylko FeedName jest używany dla źródeł danych o zakresie organizacji. Uwaga: nie jest to obsługiwane w przypadku polecenia test.

includeNuGetOrg - Używanie pakietów z NuGet.org
boolean. Fakultatywny. Użyj polecenia , gdy selectOrConfig = select && command = restore. Wartość domyślna: true.

Zawiera NuGet.org w wygenerowanych NuGet.config.

ścieżka nugetConfigPath - do NuGet.config
string. Fakultatywny. Użyj polecenia , gdy selectOrConfig = config && command = restore.

NuGet.config w repozytorium, który określa źródła danych, z których mają być przywracane pakiety.

externalFeedCredentials - poświadczenia dla źródeł danych spoza tej organizacji/kolekcji
Alias wejściowy: externalEndpoints. string. Fakultatywny. Użyj polecenia , gdy selectOrConfig = config && command = restore.

Poświadczenia do użycia w rejestrach zewnętrznych znajdujących się w wybranej NuGet.config. W przypadku kanałów informacyjnych w tej organizacji/kolekcji pozostaw te dane wejściowe puste; poświadczenia kompilacji są używane automatycznie.

noCache - Wyłącz lokalną pamięć podręczną
boolean. Fakultatywny. Użyj polecenia , gdy command = restore. Wartość domyślna: false.

Zapobiega używaniu pakietów NuGet z pamięci podręcznych maszyn lokalnych.

katalogu docelowego
Alias wejściowy: packagesDirectory. string. Fakultatywny. Użyj polecenia , gdy command = restore.

Określa folder, w którym są instalowane pakiety. Jeśli nie określono żadnego folderu, pakiety zostaną przywrócone do domyślnej pamięci podręcznej pakietów NuGet.

verbosityRestore - szczegółowość
string. Fakultatywny. Użyj polecenia , gdy command = restore. Dozwolone wartości: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Wartość domyślna: Normal.

Określa ilość szczegółów wyświetlanych w danych wyjściowych polecenia restore.

packagesToPush - ścieżka do pakietów NuGet w celu opublikowania
Alias wejściowy: searchPatternPush. string. Wymagane, gdy command = push. Wartość domyślna: $(Build.ArtifactStagingDirectory)/*.nupkg.

Wzorzec dopasowania lub ścieżki do plików nupkg do przekazania. Wiele wzorców może być rozdzielonych średnikami i można utworzyć wzorzec ujemny, prefiksując go za pomocą !. Przykład: **/*.nupkg;!**/*.Tests.nupkg.

lokalizacji kanału informacyjnego
string. Wymagane, gdy command = push. Dozwolone wartości: internal (ta organizacja/kolekcja), external (zewnętrzny serwer NuGet (w tym inne organizacje/kolekcje)). Wartość domyślna: internal.

Określa, czy źródło danych docelowych jest wewnętrzne, czy zewnętrzne.

kanału informacyjnego docelowego
Alias wejściowy: feedPublish. string. Wymagane, gdy command = push && nuGetFeedType = internal.

Określa źródło danych hostowane w tej organizacji. Aby wybrać źródło danych, musisz mieć zainstalowane i licencjonowane zarządzanie pakietami.

publishPackageMetadata - publikowanie metadanych potoku
boolean. Fakultatywny. Użyj polecenia , gdy command = push && nuGetFeedType = internal && command = push. Wartość domyślna: true.

Kojarzy metadane tego potoku kompilacji/wydania (uruchom #, informacje o kodzie źródłowym) z pakietem.

serwera NuGet
Alias wejściowy: externalEndpoint. string. Wymagane, gdy command = push && nuGetFeedType = external.

Połączenie usługi NuGet zawierające poświadczenia zewnętrznego serwera NuGet.

packagesToPack - ścieżka do plików csproj lub nuspec do spakowania
Alias wejściowy: searchPatternPack. string. Wymagane, gdy command = pack. Wartość domyślna: **/*.csproj.

Wzorzec do wyszukiwania plików .csproj lub .nuspec do spakowania.

Można oddzielić wiele wzorców średnikami i utworzyć wzorzec ujemny, prefiksując go za pomocą !. Przykład: **/*.csproj;!**/*.Tests.csproj.

konfiguracja configuration - do pakietu
Alias wejściowy: configurationToPack. string. Fakultatywny. Użyj polecenia , gdy command = pack. Wartość domyślna: $(BuildConfiguration).

W przypadku korzystania z pliku .csproj dane wejściowe określają konfigurację pakietu.

packDirectory - folder pakietu
Alias wejściowy: outputDir. string. Fakultatywny. Użyj polecenia , gdy command = pack. Wartość domyślna: $(Build.ArtifactStagingDirectory).

Folder, w którym zostaną utworzone pakiety. Jeśli ten folder jest pusty, pakiety zostaną utworzone wraz z plikiem csproj.

nobuild - Nie kompiluj
boolean. Fakultatywny. Użyj polecenia , gdy command = pack. Wartość domyślna: false.

Określa, że zadanie nie skompiluje projektu przed pakowaniem. To zadanie odpowiada parametrowi --no-build polecenia build.

includesymbols - dołączanie symboli
boolean. Fakultatywny. Użyj polecenia , gdy command = pack. Wartość domyślna: false.

Tworzy symbol pakietów NuGet. To zadanie odpowiada parametrowi wiersza polecenia --include-symbols.

includesource - uwzględnij źródłowe
boolean. Fakultatywny. Użyj polecenia , gdy command = pack. Wartość domyślna: false.

Zawiera kod źródłowy w pakiecie. To zadanie odpowiada parametrowi wiersza polecenia --include-source.

versioningScheme - automatyczne przechowywanie wersji pakietów
string. Wymagane, gdy command = pack. Dozwolone wartości: off, byPrereleaseNumber (użyj daty i godziny), byEnvVar (użyj zmiennej środowiskowej), byBuildNumber (użyj numeru kompilacji). Wartość domyślna: off.

Tego zadania nie można używać z dołączonymi projektami, do których odwołuje się odwołanie. Jeśli wybierzesz Use the date and time, spowoduje to wygenerowanie wersji zgodnej ze standardem SemVer w formacie X.Y.Z-ci-datetime, w której wybierzesz opcję X, Yi Z.

Jeśli wybierzesz Use an environment variable, musisz wybrać zmienną środowiskową i upewnić się, że zawiera numer wersji, którego chcesz użyć.

Jeśli wybierzesz Use the build number, użyje numeru kompilacji do wersji pakietu. Uwaga: W obszarze Optionsustaw format numeru kompilacji na $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).

versionEnvVar - zmiennej środowiskowej
string. Wymagane, gdy versioningScheme = byEnvVar && command = pack.

Określa nazwę zmiennej bez $, $envlub %.

majorVersion - Główne
Alias wejściowy: requestedMajorVersion. string. Wymagane, gdy versioningScheme = byPrereleaseNumber && command = pack. Wartość domyślna: 1.

X w wersji X.Y.Z.

minorVersion - pomocnicza
Alias wejściowy: requestedMinorVersion. string. Wymagane, gdy versioningScheme = byPrereleaseNumber && command = pack. Wartość domyślna: 0.

Y w wersji X.Y.Z.

poprawki
Alias wejściowy: requestedPatchVersion. string. Wymagane, gdy versioningScheme = byPrereleaseNumber && command = pack. Wartość domyślna: 0.

Z w wersji X.Y.Z.

buildProperties - dodatkowe właściwości kompilacji
string. Fakultatywny. Użyj polecenia , gdy command = pack.

Określa listę par token = value rozdzielonych średnikami, gdzie każde wystąpienie $token$ w pliku .nuspec zostanie zastąpione daną wartością. Wartości mogą być ciągami w cudzysłowie.

verbosityPack - szczegółowość
string. Fakultatywny. Użyj polecenia , gdy command = pack. Dozwolone wartości: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Wartość domyślna: Normal.

Określa ilość szczegółów wyświetlanych w danych wyjściowych polecenia pack.

katalogu roboczego
string. Fakultatywny. Użyj polecenia , gdy command != restore && command != push && command != pack && command != pack && command != push && command != restore.

Bieżący katalog roboczy, w którym jest uruchamiany skrypt. Empty jest katalogem głównym repozytorium (kompilacja) lub artefaktami (wydanie), które jest $(System.DefaultWorkingDirectory).

requestTimeout - Ustawianie limitu czasu dla żądania pobierania pakietu
string. Wartość domyślna: 300000.

Podaj wartość limitu czasu dla żądań HTTP, które zadanie wykonuje w celu uzyskania pakietu .NET. Wartość jest wyrażona w milisekundach. Wartość domyślna to 300000 milisekund (5 minut). Nie może przekraczać 600000 milisekund (10 minut).

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Ważny

zadanie uwierzytelniania nuGet jest nowym zalecanym sposobem uwierzytelniania za pomocą usługi Azure Artifacts i innych repozytoriów NuGet. Polecenia restore i push tego zadania interfejsu wiersza polecenia platformy .NET Core nie przyjmują już nowych funkcji i są rozwiązywane tylko krytyczne usterki.

Korzystanie z elementu AzurePipelinesCredential w testach integracji

Biblioteki tożsamości platformy Azure dla platformy .NET, C++, Go, JavaScript i Python zapewniają obsługę federacji tożsamości obciążenia, dlatego kod wykonywany z AzureCLI@2 i AzurePowerShell@5 zadania mogą uwierzytelniać się przy użyciu identyfikatora Entra firmy Microsoft (na przykład w celu uzyskania dostępu do platformy Azure) przy użyciu klasy AzurePipelinesCredential.

Wielu klientów korzysta z bibliotek klienckich zestawu Azure SDK w testach integracji wywoływanych z innych zadań. Zadania DotNetCoreCLI@2, Maven@4 i VSTest@3 mogą uzyskiwać dostęp do zasobów platformy Azure przy użyciu klasy AzurePipelinesCredential.

Właściwość connectedServiceName można ustawić na połączenie usługi platformy Azure skonfigurowane z federacją tożsamości obciążenia. AzurePipelinesCredential wymaga ustawienia SYSTEM_ACCESSTOKEN.

W poniższym przykładzie przedstawiono dane wejściowe connectedServiceName zadania DotNetCoreCLI@2. VSTest@3 i użycie Maven@4 jest podobne.

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

Aby uzyskać więcej informacji na temat AzurePipelinesCredential, zobacz Zwiększanie poziomu zabezpieczeń w połączeniach usługi platformy Azure za pomocą usługi AzurePipelinesCredential.

Dlaczego mój krok kompilacji, publikowania lub testu nie może przywrócić pakietów?

Większość poleceń dotnet, w tym build, publishi test zawiera niejawny krok restore. Nie powiedzie się to w przypadku uwierzytelnionych kanałów informacyjnych, nawet jeśli uruchomiono pomyślnie dotnet restore we wcześniejszym kroku, ponieważ wcześniejszy krok zostanie oczyszczony z użytych poświadczeń.

Aby rozwiązać ten problem, dodaj flagę --no-restore do pola tekstowego Arguments.

Ponadto polecenie test nie rozpoznaje argumentów feedRestore ani vstsFeed, a kanały informacyjne określone w ten sposób nie zostaną uwzględnione w wygenerowanych plikach NuGet.config po uruchomieniu niejawnego kroku restore. Zaleca się użycie jawnego kroku dotnet restore do przywracania pakietów. Polecenie restore uwzględnia argumenty feedRestore i vstsFeed.

Dlaczego otrzymuję ostrzeżenia nu1507 z mapowania źródła pakietów chociaż podczas kompilowania na mojej maszynie nie ma żadnych ostrzeżeń?

Różne polecenia, które wykonują przywracanie nuGet lub dostęp do źródła danych NuGet, tworzą specjalny tymczasowy plik NuGet.config, który dodaje uwierzytelnianie NuGet dla źródeł danych NuGet artefaktów platformy Azure. Ten sposób jest w konflikcie ze schematem używanym przez mapowanie źródła pakietów do mapowania pakietów na źródła i przerywa konfigurację Mappin źródła pakietów w pliku NuGet.config w repozytorium. Aby obejść ten konflikt, możesz użyć zadania NuGet Uwierzytelnij do uwierzytelniania, a następnie polecenia niestandardowego w celu wywołania żądanego polecenia dotnet bez modyfikacji NuGet.config.

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

Dlaczego warto zaewidencjonować NuGet.config?

Sprawdzenie NuGet.config w kontroli źródła gwarantuje, że kluczowy element informacji potrzebny do skompilowania projektu — lokalizacji jego pakietów — jest dostępny dla każdego dewelopera, który wyewidencjonuje kod.

Jednak w sytuacjach, w których zespół deweloperów pracuje nad dużym zakresem projektów, można również dodać kanał informacyjny usługi Azure Artifacts do globalnej NuGet.config na maszynie każdego dewelopera. W takich sytuacjach użycie opcji Feeds I select here w zadaniu NuGet replikuje tę konfigurację.

Rozwiązywanie problemów

Projekt korzystający z programu Entity Framework przestał działać na hostowanych agentach

Platforma .NET Core nie ma wbudowanego programu Entity Framework(EF). Przed rozpoczęciem wykonywania programu EF należy zainstalować program EF lub dodać global.json do projektu z wymaganą wersją zestawu .NET Core SDK. Zapewni to, że poprawny zestaw SDK jest używany do kompilowania projektu EF. Jeśli wymagana wersja nie jest obecna na maszynie, dodaj zadanie UseDotNetV2 do potoku, aby zainstalować wymaganą wersję. Aby uzyskać więcej informacji, zobacz Get the Entity Framework Core runtime.

Przykłady

• przykłady kompilacji
• przykłady wypychania
• przykłady wypychania
• Przykłady pakietu Pack
• Publikowanie przykładów
• przykłady przywracania
• przykłady testów

Przykłady kompilacji

Kompilowanie projektu

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

Kompilowanie wielu projektów

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

Przykłady wypychania

Wypychanie pakietów NuGet do wewnętrznego źródła danych

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

Wypychanie pakietów NuGet do źródła danych zewnętrznych

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

Przykłady pakietów

Pakowanie pakietu NuGetPackage do określonego katalogu wyjściowego

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

Pakowanie pakietu symboli

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

Publikowanie przykładów

Publikowanie projektów w określonym folderze

# 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

Przykłady przywracania

#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

Przykłady testów

Uruchamianie testów w repozytorium

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.144.0 lub nowsza
Kategoria zadań	Budować