Dokumentacja zadań usługi Azure Pipelines

Zadanie wykonuje akcję w potoku. Na przykład zadanie może skompilować aplikację, wchodzić w interakcje z zasobami platformy Azure, instalować narzędzie lub uruchamiać test. Zadania to bloki konstrukcyjne służące do definiowania automatyzacji w potoku.

W artykułach w tej sekcji opisano wbudowane zadania dla usługi Azure Pipelines i określ semantyka atrybutów, które przechowują specjalne znaczenie dla każdego zadania.

Aby uzyskać szczegółowe informacje na temat atrybutów ogólnych obsługiwanych przez zadania, zapoznaj się z dokumentacją YAML.

Aby uzyskać instrukcje i samouczki dotyczące tworzenia potoków przy użyciu zadań, w tym tworzenia niestandardowych zadań, rozszerzeń niestandardowych i znajdowania zadań w witrynie Visual Studio Marketplace, zobacz Pojęcia dotyczące zadań i dokumentacja usługi Azure Pipelines.

Ważne

Aby wyświetlić dokumentację zadań dla zadań dostępnych dla danej platformy, upewnij się, że wybrano poprawną wersję usługi Azure DevOps z selektora wersji znajdującego się nad spisem treści. Obsługa funkcji różni się w zależności od tego, czy pracujesz z Azure DevOps Services, czy lokalną wersją Azure DevOps Server.
Aby dowiedzieć się, której wersji lokalnej używasz, zobacz Wyszukiwanie platformy i wersji usługi Azure DevOps.

Zadania kompilacji

Zadanie	Opis
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Skompiluj, przetestuj, spakuj lub opublikuj aplikację dotnet albo uruchom niestandardowe polecenie dotnet.
AutoBuild zabezpieczeń zaawansowanych AdvancedSecurity-Codeql-Autobuild@1	Próbuje skompilować repozytorium, wyszukując i kompilując pliki projektu w folderze źródłowym.
Advanced Security Initialize CodeQL AdvancedSecurity-Codeql-Init@1	Inicjuje bazę danych CodeQL w ramach przygotowań do utworzenia.
Advanced Security Perform CodeQL analysis (Zaawansowane zabezpieczenia— wykonywanie analizy koduQL) AdvancedSecurity-Codeql-Analyze@1	Finalizuje bazę danych CodeQL i uruchamia zapytania analizy.
Kompilacja systemu Android AndroidBuild@1	AndroidBuild@1 jest przestarzałe. Użyj narzędzia Gradle.
Podpisywanie systemu Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Podpisywanie i dopasowywanie plików APK systemu Android.
Ant Ant@1	Kompilowanie przy użyciu platformy Apache Ant.
Azure IoT Edge AzureIoTEdge@2	Kompilowanie i wdrażanie obrazu usługi Azure IoT Edge.
Cmake CMake@1	Kompiluj za pomocą wieloplatformowego systemu kompilacji narzędzia CMake.
Kompilacja kontenera ContainerBuild@0	Zadanie kompilacji kontenera.
Docker Docker@2 Docker@1 Docker@0	Skompiluj lub wypchnij obrazy platformy Docker, zaloguj się lub wyloguj, uruchom lub zatrzymaj kontenery albo uruchom polecenie platformy Docker.
Docker Compose DockerCompose@0	Kompilowanie, wypychanie lub uruchamianie aplikacji platformy Docker z wieloma kontenerami. Zadanie może być używane z usługą Docker lub Azure Container Registry.
Pobieranie pakietów NuGet w usłudze GitHub DownloadGitHubNugetPackage@1	Przywróć pakiety nuget przy użyciu interfejsu wiersza polecenia dotnet.
Przejdź Go@0	Pobierz, skompiluj lub przetestuj aplikację języka Go lub uruchom niestandardowe polecenie Języka Go.
Gradle Gradle@3 Gradle@2 Gradle@1	Kompiluj przy użyciu skryptu otoki Gradle.
Grunt Grunt@0	Uruchom moduł uruchamiający zadania Grunt JavaScript.
Łyk gulp@1 gulp@0	Uruchom system kompilacji oparty na zadaniach Node.js przesyłania strumieniowego.
Indeksowanie źródeł i symboli publikowania PublishSymbols@2 PublishSymbols@1	Zaindeksuj kod źródłowy i opublikuj symbole w udziale plików lub serwerze symboli usługi Azure Artifacts.
Zadanie kolejki serwera Jenkins JenkinsQueueJob@2	Kolejka zadania na serwerze Jenkins.
Zadanie kolejki serwera Jenkins JenkinsQueueJob@1	Kolejka zadania na serwerze Jenkins.
Maven Maven@4 Maven@3 Maven@2 Maven@1	Kompilowanie, testowanie i wdrażanie za pomocą narzędzia Apache Maven.
MSBuild MSBuild@1	Kompilowanie za pomocą programu MSBuild.
Przygotowywanie konfiguracji analizy SonarQubePrepare@5 SonarQubePrepare@4	Przygotuj konfigurację analizy SonarQube.
Wynik bramy jakości publikowania SonarQubePublish@5 SonarQubePublish@4	Opublikuj wynik bramy jakości SonarQube w wyniku kompilacji usługi Azure DevOps, który ma być używany po rzeczywistej analizie.
Uruchamianie analizy kodu SonarQubeAnalyze@5 SonarQubeAnalyze@4	Uruchom skaner i przekaż wyniki na serwer SonarQube.
Kompilacja programu Visual Studio VSBuild@1	Kompiluj za pomocą programu MSBuild i ustaw właściwość wersji programu Visual Studio.
Xamarin.Android XamarinAndroid@1	Tworzenie aplikacji dla systemu Android za pomocą platformy Xamarin.
Xamarin.iOS XamariniOS@2 XamariniOS@1	Tworzenie aplikacji dla systemu iOS przy użyciu platformy Xamarin w systemie macOS.
Xcode Xcode@5 Xcode@4	Kompilowanie, testowanie lub archiwizowanie obszaru roboczego Xcode w systemie macOS. Opcjonalnie spakuj aplikację.
Kompilacja Xcode Xcode@3 Xcode@2	Tworzenie obszaru roboczego Xcode w systemie macOS.
Pakiet Xcode dla systemu iOS XcodePackageiOS@0	Wygeneruj plik ipa z danych wyjściowych kompilacji Xcode przy użyciu narzędzia xcrun (Xcode 7 lub nowszego).

Wdrażanie zadań

Zadanie	Opis
Dystrybucja centrum aplikacji AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Dystrybuowanie kompilacji aplikacji do testerów i użytkowników za pośrednictwem programu Visual Studio App Center.
Wdrażanie szablonu usługi ARM AzureResourceManagerTemplateDeployment@3	Wdróż szablon usługi Azure Resource Manager (ARM) we wszystkich zakresach wdrażania.
Azure App Service Classic (przestarzałe) AzureWebPowerShellDeployment@1	Tworzenie lub aktualizowanie Azure App Service przy użyciu Azure PowerShell.
Azure App Service wdrażanie AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Wdrażanie w Azure App Service aplikacji internetowej, mobilnej lub interfejsu API przy użyciu platformy Docker, Java, .NET, .NET Core, Node.js, PHP, Python lub Ruby.
zarządzanie Azure App Service AzureAppServiceManage@0	Uruchamianie, zatrzymywanie, ponowne uruchamianie, zamiana miejsca, usuwanie miejsca, instalowanie rozszerzeń lokacji lub włączanie ciągłego monitorowania dla Azure App Service.
ustawienia Azure App Service AzureAppServiceSettings@1	Aktualizowanie/dodawanie ustawień aplikacji w aplikacji internetowej platformy Azure dla systemu Linux lub Windows.
Interfejs wiersza polecenia platformy Azure AzureCLI@2 AzureCLI@1	Uruchom polecenia interfejsu wiersza polecenia platformy Azure względem subskrypcji platformy Azure w skrypcie programu PowerShell Core/Shell podczas uruchamiania w agencie systemu Linux lub w skrypcie programu PowerShell/programu PowerShell Core/Batch podczas uruchamiania w agencie systemu Windows.
Interfejs wiersza polecenia platformy Azure w wersji zapoznawczej AzureCLI@0	Uruchom skrypt powłoki lub usługi Batch za pomocą poleceń interfejsu wiersza polecenia platformy Azure w ramach subskrypcji platformy Azure.
Wdrażanie usługi w chmurze platformy Azure AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Wdrażanie usługi w chmurze platformy Azure.
Wdrażanie usługi Azure Container Apps AzureContainerApps@1 AzureContainerApps@0	Zadanie usługi Azure DevOps do kompilowania i wdrażania usługi Azure Container Apps.
wdrażanie Azure Database for MySQL AzureMysqlDeployment@1	Uruchom skrypty i wprowadź zmiany w Azure Database for MySQL.
Kopiowanie plików platformy Azure AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Skopiuj pliki do Azure Blob Storage lub maszyn wirtualnych.
Funkcja platformy Azure na platformie Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Wdrażanie funkcji platformy Azure w klastrze Kubernetes.
wdrażanie Azure Functions AzureFunctionApp@2 AzureFunctionApp@1	Zaktualizuj aplikację funkcji przy użyciu platformy .NET, Python, JavaScript, programu PowerShell, aplikacji internetowych opartych na języku Java.
Azure Functions dla kontenera AzureFunctionAppContainer@1	Aktualizowanie aplikacji funkcji przy użyciu kontenera platformy Docker.
Usługa Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Pobierz wpisy tajne usługi Azure Key Vault.
Alerty usługi Azure Monitor (przestarzałe) AzureMonitorAlerts@0	Skonfiguruj alerty dotyczące dostępnych metryk dla zasobu platformy Azure (przestarzałe).
Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Uruchom skrypt programu PowerShell w środowisku platformy Azure.
Wdrażanie grupy zasobów platformy Azure AzureResourceGroupDeployment@2	Wdrażanie szablonu usługi Azure Resource Manager (ARM) w grupie zasobów i zarządzanie maszynami wirtualnymi.
Wdrażanie grupy zasobów platformy Azure AzureResourceGroupDeployment@1	Wdrażanie, uruchamianie, zatrzymywanie, usuwanie grup zasobów platformy Azure.
Azure Spring Apps AzureSpringCloud@0	Wdrażanie aplikacji w usłudze Azure Spring Apps i zarządzanie wdrożeniami.
Wdrażanie usługi Azure SQL Database SqlAzureDacpacDeployment@1	Wdróż bazę danych Azure SQL przy użyciu narzędzia DACPAC lub uruchom skrypty przy użyciu narzędzia SQLCMD.
Wdrażanie zestawu skalowania maszyn wirtualnych platformy Azure AzureVmssDeployment@0	Wdrażanie obrazu zestawu skalowania maszyn wirtualnych.
Aplikacja internetowa platformy Azure AzureWebApp@1	Wdrażanie aplikacji internetowej platformy Azure dla systemu Linux lub Windows.
Azure Web App for Containers AzureWebAppContainer@1	Wdrażanie kontenerów w Azure App Service.
Tworzenie obrazu maszyny PackerBuild@1 PackerBuild@0	Skompiluj obraz maszyny przy użyciu narzędzia Packer, który może być używany do wdrożenia zestawu skalowania maszyn wirtualnych platformy Azure.
Sprawdzanie zgodności Azure Policy AzurePolicyCheckGate@0	Ocena zabezpieczeń i zgodności dla Azure Policy.
Chef Chef@1	Wdróż w środowiskach chef, edytując atrybuty środowiska.
Nóż chef ChefKnife@1	Uruchamianie skryptów za pomocą poleceń nóż na stacji roboczej Chef.
Kopiowanie plików za pośrednictwem protokołu SSH CopyFilesOverSSH@0	Skopiuj pliki lub artefakty kompilacji do maszyny zdalnej za pośrednictwem protokołu SSH.
Wdrażanie na platformie Kubernetes KubernetesManifest@1 KubernetesManifest@0	Użyj plików manifestu platformy Kubernetes, aby wdrożyć je w klastrach, a nawet przygotować pliki manifestu do użycia na potrzeby wdrożeń przy użyciu wykresów programu Helm.
Wdrażanie aplikacji internetowej usług IIS IISWebAppDeploymentOnMachineGroup@0	Wdróż witrynę internetową lub aplikację internetową przy użyciu narzędzia Web Deploy.
Wdrażanie aplikacji internetowej usług IIS (przestarzałe) IISWebAppDeployment@1	Wdróż przy użyciu narzędzia MSDeploy, a następnie utwórz/zaktualizuj witryny internetowe i pule aplikacji.
Zarządzanie aplikacją internetową usług IIS IISWebAppManagementOnMachineGroup@0	Tworzenie lub aktualizowanie witryn internetowych, aplikacji internetowych, katalogów wirtualnych lub pul aplikacji.
Wywoływanie interfejsu API REST InvokeRESTAPI@1 InvokeRESTAPI@0	Wywołaj interfejs API REST jako część potoku.
Kubectl Kubernetes@1 Kubernetes@0	Wdróż, skonfiguruj, zaktualizuj klaster Kubernetes w usłudze Azure Container Service, uruchamiając polecenia kubectl.
Interwencja ręczna ManualIntervention@8	Wstrzymaj wdrażanie i poczekaj na ręczną interwencję.
Walidacja ręczna ManualValidation@0	[WERSJA ZAPOZNAWCZA] Wstrzymaj przebieg potoku, aby poczekać na interakcję ręczną. Działa tylko z potokami YAML.
Wdrażanie bazy danych MySQL MysqlDeploymentOnMachineGroup@1	Uruchamianie skryptów i wprowadzanie zmian w bazie danych MySQL.
Pakowanie i wdrażanie wykresów programu Helm HelmDeploy@0	Wdróż, skonfiguruj i zaktualizuj klaster Kubernetes w usłudze Azure Container Service, uruchamiając polecenia helm.
Program PowerShell na maszynach docelowych PowerShellOnTargetMachines@3	Wykonaj skrypty programu PowerShell na maszynach zdalnych przy użyciu programu PSSession i Invoke-Command na potrzeby komunikacji zdalnej.
Program PowerShell na maszynach docelowych PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	Wykonywanie skryptów programu PowerShell na komputerach zdalnych.
Wdrażanie aplikacji usługi Service Fabric ServiceFabricDeploy@1	Wdrażanie aplikacji usługi Azure Service Fabric w klastrze.
Wdrażanie narzędzia Service Fabric Compose ServiceFabricComposeDeploy@0	Wdrażanie aplikacji Docker Compose w klastrze usługi Azure Service Fabric.
wdrażanie bazy danych SQL Server SqlDacpacDeploymentOnMachineGroup@0	Wdróż bazę danych SQL Server przy użyciu skryptów DACPAC lub SQL.
wdrażanie bazy danych SQL Server (przestarzałe) SqlServerDacpacDeployment@1	Wdróż bazę danych SQL Server przy użyciu pakietu DACPAC.
Protokół SSH SSH@0	Uruchom polecenia powłoki lub skrypt na maszynie zdalnej przy użyciu protokołu SSH.
Kopia pliku maszyny z systemem Windows WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Kopiowanie plików na zdalne maszyny z systemem Windows.

Zadania pakietu

Zadanie	Opis
Uwierzytelnianie ładunku (dla modułów uruchamiającego zadania) CargoAuthenticate@0	Zadanie uwierzytelniania klienta ładunku używanego do instalowania dystrybucji skrzynek towarowych.
CocoaPods CocoaPods@0	Zainstaluj zależności CocoaPods dla projektów Swift i Objective-C Cocoa.
Środowisko Conda CondaEnvironment@1 CondaEnvironment@0	To zadanie jest przestarzałe. Użyj conda bezpośrednio w skrypcie, aby pracować ze środowiskami Anaconda.
Pobieranie pakietu Npm usługi Github DownloadGithubNpmPackage@1	Zainstaluj pakiety npm z usługi GitHub.
Uwierzytelnianie narzędzia Maven MavenAuthenticate@0	Udostępnia poświadczenia dla źródeł danych usługi Azure Artifacts i zewnętrznych repozytoriów maven.
npm Npm@1 Npm@0	Zainstaluj i opublikuj pakiety npm lub uruchom polecenie npm. Obsługuje narzędzie npmjs.com i uwierzytelnione rejestry, takie jak usługa Azure Artifacts.
Uwierzytelnianie npm (dla modułów uruchamiający zadania) npmAuthenticate@0	Nie używaj tego zadania, jeśli używasz również zadania npm. Udostępnia poświadczenia npm do pliku npmrc w repozytorium dla zakresu kompilacji. Umożliwia to modułom uruchamiającym zadania npm, takim jak gulp i Grunt, uwierzytelnianie za pomocą prywatnych rejestrów.
NuGet NuGetCommand@2	Przywracanie, pakowanie lub wypychanie pakietów NuGet lub uruchamianie polecenia NuGet. Obsługuje NuGet.org i uwierzytelnione źródła danych, takie jak Azure Artifacts i MyGet. Używa pliku NuGet.exe i współpracuje z aplikacjami .NET Framework. W przypadku aplikacji .NET Core i .NET Standard użyj zadania .NET Core.
Uwierzytelnianie narzędzia NuGet NuGetAuthenticate@1 NuGetAuthenticate@0	Skonfiguruj narzędzia NuGet do uwierzytelniania za pomocą usługi Azure Artifacts i innych repozytoriów NuGet. Wymaga narzędzia NuGet >= 4.8.5385, dotnet >= 6 lub MSBuild >= 15.8.166.59604.
Polecenie NuGet NuGet@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współpracuje ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji narzędzia NuGet bez oczekiwania na aktualizację zadań, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa narzędzia NuGet 4.
Instalator NuGet NuGetInstaller@0	Instaluje lub przywraca brakujące pakiety NuGet. Użyj zadania NuGetAuthenticate@0 w celu uzyskania najnowszych możliwości.
Pakiet NuGet NuGetPackager@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współpracuje ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji narzędzia NuGet bez oczekiwania na aktualizację zadań, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa narzędzia NuGet 4.
Wydawca NuGet NuGetPublisher@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współpracuje ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji narzędzia NuGet bez oczekiwania na aktualizację zadań, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa narzędzia NuGet 4.
Przywracanie nuGet NuGetRestore@1	Przywraca pakiety NuGet w ramach przygotowań do kroku kompilacji programu Visual Studio.
Wydawca PyPI PyPIPublisher@0	Tworzenie i przekazywanie sdist lub wheel do indeksu zgodnego z interfejsem PyPI przy użyciu usługi Twine.
Uwierzytelnianie potoku języka Python PipAuthenticate@1 PipAuthenticate@0	Zadanie uwierzytelniania klienta pip używanego do instalowania dystrybucji języka Python.
Uwierzytelnianie przekazywania bliźniaczych reprezentacji języka Python TwineAuthenticate@1 TwineAuthenticate@0	Uwierzytelnianie na potrzeby przekazywania dystrybucji języka Python przy użyciu bliźniaczej reprezentacji. Dodaj element "-r FeedName/EndpointName --config-file $(PYPIRC_PATH)" do polecenia przekazywania bliźniaczej reprezentacji. W przypadku kanałów informacyjnych znajdujących się w tej organizacji użyj nazwy źródła danych jako repozytorium (-r). W przeciwnym razie użyj nazwy punktu końcowego zdefiniowanego w połączeniu usługi.
Pakiety uniwersalne UniversalPackages@0	Pobierz lub opublikuj pakiety uniwersalne.
Przywracanie składnika platformy Xamarin XamarinComponentRestore@0	To zadanie jest przestarzałe. Zamiast tego użyj polecenia "NuGet".

Zadania testu

Zadanie	Opis
Test centrum aplikacji AppCenterTest@1	Testowanie pakietów aplikacji za pomocą programu Visual Studio App Center.
Azure Load Testing AzureLoadTest@1	Automatyzowanie testowania regresji wydajności za pomocą testowania obciążenia platformy Azure.
Test struktury kontenera ContainerStructureTest@0	Używa kontenera-structure-test (https://github.com/GoogleContainerTools/container-structure-test) do weryfikacji struktury obrazu na podstawie czterech kategorii testów — testów poleceń, testów istnienia plików, testów zawartości plików i testów metadanych.
Mobile Center Test VSMobileCenterTest@0	Testowanie pakietów aplikacji mobilnych za pomocą programu Visual Studio Mobile Center.
Publikowanie wyników pokrycia kodu PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	Opublikuj dowolne wyniki pokrycia kodu z kompilacji.
Publikowanie wyników testu PublishTestResults@1	Publikowanie wyników testów w usłudze Azure Pipelines.
Publikowanie wyników testu PublishTestResults@2	Publikowanie wyników testów w usłudze Azure Pipelines.
Uruchamianie testów funkcjonalnych RunVisualStudioTestsusingTestAgent@1	Przestarzałe: to zadanie i zadanie towarzyszące (wdrożenie agenta testowego programu Visual Studio) są przestarzałe. Zamiast tego użyj zadania "Visual Studio Test". Zadanie VSTest może uruchamiać jednostkę, a także testy funkcjonalne. Uruchamianie testów na co najmniej jednym agencie przy użyciu ustawienia zadania obejmującego wiele agentów. Użyj zadania "Platforma testowa programu Visual Studio", aby uruchamiać testy bez konieczności używania programu Visual Studio na agencie. Zadanie VSTest oferuje również nowe możliwości, takie jak automatyczne ponowne uruchamianie testów zakończone niepowodzeniem.
Visual Studio Test VSTest@3 VSTest@2 VSTest@1	Uruchamianie testów jednostkowych i funkcjonalnych (Selenium, Appium, Kodowany test interfejsu użytkownika itp.) przy użyciu modułu uruchamiającego testy programu Visual Studio (VsTest). Można uruchomić platformy testowe z adapterem testowym programu Visual Studio, takimi jak MsTest, xUnit, NUnit, Chutzpah (dla testów JavaScript przy użyciu narzędzi QUnit, Mocha i Jasmine). Testy można rozpowszechniać na wielu agentach przy użyciu tego zadania (wersja 2).
Wdrażanie agenta testowego programu Visual Studio DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2 jest przestarzała. Użyj zadania Test programu Visual Studio, aby uruchomić testy jednostkowe i funkcjonalne.
Wdrażanie agenta testowego programu Visual Studio DeployVisualStudioTestAgent@1	Wdrażanie i konfigurowanie agenta testowego w celu uruchamiania testów na zestawie maszyn.
Xamarin Test Cloud XamarinTestCloud@1	[Przestarzałe] Testowanie aplikacji mobilnych za pomocą platformy Xamarin Test Cloud przy użyciu platformy Xamarin.UITest. Zamiast tego użyj zadania "Test usługi App Center".

Zadania narzędzi

Zadanie	Opis
Instalator zestawu .NET Core SDK/środowiska uruchomieniowego DotNetCoreInstaller@1 DotNetCoreInstaller@0	Uzyskaj określoną wersję zestawu .NET Core SDK z Internetu lub lokalnej pamięci podręcznej i dodaj ją do ścieżki.
Instalator interfejsu wiersza polecenia platformy Docker DockerInstaller@0	Zainstaluj interfejs wiersza polecenia platformy Docker na maszynie agenta.
Instalator narzędzia Duffle DuffleInstaller@0	Zainstaluj określoną wersję narzędzia Duffle na potrzeby instalowania pakietów CNAB i zarządzania nimi.
Instalator narzędzi języka Go GoTool@0	Znajdź w pamięci podręcznej lub pobierz określoną wersję języka Go i dodaj ją do ścieżki .
Instalator narzędzia Helm HelmInstaller@1 HelmInstaller@0	Zainstaluj program Helm na maszynie agenta.
Instalowanie narzędzi Azure Func Core Tools FuncToolsInstaller@0	Zainstaluj narzędzia Azure Func Core Tools.
Instalator narzędzia Java JavaToolInstaller@0	Uzyskaj określoną wersję języka Java z dostarczonego przez użytkownika obiektu blob platformy Azure lub pamięci podręcznej narzędzi i ustawia JAVA_HOME.
Instalator narzędzia Kubectl KubectlInstaller@0	Zainstaluj narzędzie Kubectl na maszynie agenta.
Instalator narzędzia Kubelogin KubeloginInstaller@0	Pomaga zainstalować narzędzie kubelogin.
Instalator narzędzia NuGet NuGetToolInstaller@1 NuGetToolInstaller@0	Uzyskuje określoną wersję narzędzia NuGet z Internetu lub pamięci podręcznej narzędzi i dodaje ją do ścieżki. To zadanie służy do zmiany wersji narzędzia NuGet używanej w zadaniach NuGet.
Korzystanie z platformy .NET Core UseDotNet@2	Uzyskuje określoną wersję zestawu .NET Core SDK z Internetu lub lokalnej pamięci podręcznej i dodaje ją do ścieżki . To zadanie służy do zmiany wersji platformy .NET Core używanej w kolejnych zadaniach. Ponadto zapewnia obsługę serwera proxy.
Korzystanie z ekosystemu Node.js UseNode@1 NodeTool@0	Skonfiguruj środowisko Node.js i dodaj je do ścieżki, dodatkowo zapewniając obsługę serwera proxy.
Korzystanie z wersji języka Python UsePythonVersion@0	Użyj określonej wersji języka Python z pamięci podręcznej narzędzi, opcjonalnie dodając ją do ścieżki .
Korzystanie z wersji języka Ruby UseRubyVersion@0	Użyj określonej wersji języka Ruby z pamięci podręcznej narzędzi, opcjonalnie dodając ją do ścieżki .
Instalator platformy testowej programu Visual Studio VisualStudioTestPlatformInstaller@1	Uzyskaj platformę testowa z nuget.org lub pamięci podręcznej narzędzi. Spełnia żądanie "vstest" i może służyć do uruchamiania testów i zbierania danych diagnostycznych przy użyciu zadania testowego programu Visual Studio.

Zadania narzędziowe

Zadanie	Opis
Zaawansowane skanowanie zależności zabezpieczeń AdvancedSecurity-Dependency-Scanning@1	Skanuj pod kątem luk w zabezpieczeniach zależności open source w kodzie źródłowym.
Archiwizowanie plików ArchiveFiles@2	Kompresuj pliki do .7z, .tar.gz lub .zip.
Archiwizowanie plików ArchiveFiles@1	Archiwizowanie plików przy użyciu formatów kompresji, takich jak .7z, .rar, .tar.gz i .zip.
Azure Network Load Balancer AzureNLBManagement@1	Połącz lub rozłącz interfejs sieciowy maszyny wirtualnej platformy Azure z pulą adresów zaplecza Load Balancer.
Bash Bash@3	Uruchom skrypt powłoki Bash w systemach macOS, Linux lub Windows.
Skrypt usługi Batch BatchScript@1	Uruchom polecenie systemu Windows lub skrypt wsadowy i opcjonalnie zezwól na zmianę środowiska.
Cache Cache@2	Buforuj pliki między przebiegami.
Pamięć podręczna (wersja beta) CacheBeta@1 CacheBeta@0	Buforuj pliki między przebiegami.
Wiersz polecenia CmdLine@2 CmdLine@1	Uruchom skrypt wiersza polecenia przy użyciu powłoki Bash w systemach Linux i macOS i programu cmd.exe w systemie Windows.
Kopiowanie i publikowanie artefaktów kompilacji CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1 jest przestarzałe. Zamiast tego użyj zadania Kopiuj pliki i zadania Publikuj artefakty kompilacji.
Kopiowanie plików CopyFiles@2	Kopiowanie plików z folderu źródłowego do folderu docelowego przy użyciu wzorców pasujących do ścieżek plików (a nie ścieżek folderów).
Kopiowanie plików CopyFiles@1	Skopiuj pliki z folderu źródłowego do folderu docelowego przy użyciu wzorców minimatch (wzorce minimatch będą pasować tylko do ścieżek plików, a nie ścieżek folderów).
Pliki przekazywania biblioteki cURL cURLUploader@2 cURLUploader@1	Użyj obsługiwanych protokołów cURL do przekazywania plików.
Odszyfrowywanie pliku (OpenSSL) DecryptFile@1	Odszyfrowywanie pliku przy użyciu protokołu OpenSSL.
Opóźnienie Delay@1	Opóźnij dalsze wykonywanie przepływu pracy przez ustalony czas.
Usuwanie plików DeleteFiles@1	Usuń foldery lub pliki pasujące do wzorca.
Wdrażanie statycznej aplikacji internetowej platformy Azure AzureStaticWebApp@0	Kompilowanie i wdrażanie statycznej aplikacji internetowej platformy Azure.
Pobieranie artefaktów z udziału plików DownloadFileshareArtifacts@1	Pobierz artefakty z udziału plików, na przykład \share\drop.
Pobieranie artefaktów kompilacji DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	Pobierz pliki zapisane jako artefakty ukończonej kompilacji.
Pobierz wersję usługi GitHub DownloadGitHubRelease@0	Pobiera wersję usługi GitHub z repozytorium.
Pobieranie pakietu DownloadPackage@1 DownloadPackage@0	Pobierz pakiet ze źródła danych zarządzania pakietami w usłudze Azure Artifacts.
Pobieranie artefaktów potoku DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	Pobierz artefakty kompilacji i potoku.
Pobieranie bezpiecznego pliku DownloadSecureFile@1	Pobierz bezpieczny plik na maszynę agenta.
Wyodrębnianie plików ExtractFiles@1	Wyodrębnij różne pliki archiwum i kompresji, takie jak .7z, .rar, .tar.gz i .zip.
Przekształcanie plików FileTransform@2 FileTransform@1	Zastąp tokeny wartościami zmiennych w plikach konfiguracji XML lub JSON.
Przekazywanie FTP FtpUpload@2 FtpUpload@1	Przekazywanie plików przy użyciu protokołu FTP.
Komentarz usługi GitHub GitHubComment@0	Napisz komentarz do jednostki usługi GitHub, np. problem lub żądanie ściągnięcia (PR).
Wersja usługi GitHub GitHubRelease@1 GitHubRelease@0	Tworzenie, edytowanie lub usuwanie wydania usługi GitHub.
Instalowanie certyfikatu firmy Apple InstallAppleCertificate@2	Zainstaluj certyfikat firmy Apple wymagany do kompilacji na maszynie agenta systemu macOS.
Instalowanie certyfikatu firmy Apple InstallAppleCertificate@1 InstallAppleCertificate@0	Zainstaluj certyfikat firmy Apple wymagany do utworzenia agenta systemu macOS.
Instalowanie profilu aprowizacji firmy Apple InstallAppleProvisioningProfile@1	Zainstaluj profil aprowizacji firmy Apple wymagany do utworzenia na maszynie agenta systemu macOS.
Instalowanie profilu aprowizacji firmy Apple InstallAppleProvisioningProfile@0	Zainstaluj profil aprowizacji firmy Apple wymagany do utworzenia agenta systemu macOS.
Instalowanie klucza SSH InstallSSHKey@0	Zainstaluj klucz SSH przed kompilacją lub wdrożeniem.
Wywoływanie funkcji platformy Azure AzureFunction@1 AzureFunction@0	Wywoływanie funkcji platformy Azure.
Pobieranie artefaktów usługi Jenkins JenkinsDownloadArtifacts@1	Pobierz artefakty utworzone przez zadanie narzędzia Jenkins.
instalator modułu uruchamiającego zadaniaNode.js NodeTaskRunnerInstaller@0	Zainstaluj konkretną wersję Node.js, aby uruchamiać zadania węzłów.
Notacja Notation@0	Zadanie potoku platformy Azure służące do konfigurowania interfejsu wiersza polecenia notacji, podpisywania i weryfikowania przy użyciu notacji.
Program PowerShell PowerShell@2 PowerShell@1	Uruchom skrypt programu PowerShell w systemach Linux, macOS lub Windows.
Publikowanie artefaktów kompilacji PublishBuildArtifacts@1	Publikowanie artefaktów kompilacji w usłudze Azure Pipelines lub udziale plików systemu Windows.
Publikowanie artefaktów potoku PublishPipelineArtifact@1 PublishPipelineArtifact@0	Opublikuj (przekaż) plik lub katalog jako nazwany artefakt dla bieżącego przebiegu.
Publikowanie metadanych potoku PublishPipelineMetadata@0	Publikowanie metadanych potoku w magazynie dowodów.
Publikowanie w celu Azure Service Bus PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Wysyła komunikat do Azure Service Bus przy użyciu połączenia z usługą (nie jest wymagany żaden agent).
Skrypt języka Python PythonScript@0	Uruchom plik w języku Python lub wbudowany skrypt.
Wykonywanie zapytań dotyczących alertów usługi Azure Monitor AzureMonitor@1	Obserwuj skonfigurowane reguły usługi Azure Monitor dla aktywnych alertów.
Wykonywanie zapytań względem klasycznych alertów usługi Azure Monitor AzureMonitor@0	Obserwuj skonfigurowane klasyczne reguły usługi Azure Monitor dla aktywnych alertów.
Wykonywanie zapytań o elementy robocze queryWorkItems@0	Wykonaj zapytanie elementu roboczego i sprawdź liczbę zwróconych elementów.
Przeglądanie aplikacji ReviewApp@0	Użyj tego zadania w obszarze dostawca fazy wdrażania, aby dynamicznie utworzyć zasób.
Service Fabric PowerShell ServiceFabricPowerShell@1	Uruchom skrypt programu PowerShell w kontekście połączenia klastra usługi Azure Service Fabric.
Skrypt powłoki ShellScript@2	Uruchom skrypt powłoki przy użyciu powłoki Bash.
Aktualizowanie wersji aplikacji usługi Service Fabric ServiceFabricUpdateAppVersions@1	Automatycznie aktualizuje wersje spakowanej aplikacji usługi Service Fabric.
Aktualizowanie manifestów usługi Service Fabric ServiceFabricUpdateManifests@2	Automatycznie aktualizuj części manifestów aplikacji i usługi w spakowanej aplikacji usługi Azure Service Fabric.
Licencja platformy Xamarin XamarinLicense@1	[Przestarzałe] Uaktualnij do bezpłatnej wersji platformy Xamarin: https://store.xamarin.com.

Technologia open source

Te zadania są open source w usłudze GitHub. Opinie i wkłady są mile widziane. Zobacz Dziennik zmian zadań potoku , aby uzyskać listę zmian zadań, w tym historyczny rekord aktualizacji zadań.

Często zadawane pytania

Co to są aliasy wejściowe zadania?

Dane wejściowe zadania są identyfikowane przez element label, namei mogą zawierać co najmniej jeden opcjonalny aliaseselement . Poniższy przykład to fragment kodu źródłowego dla danych wejściowych Znanych hostów wejściowychInstallSSHKey@0 .

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Przed wprowadzeniem potoków YAML w 2019 r. potoki zostały utworzone i edytowane przy użyciu edytora potoków opartego na interfejsie użytkownika, a tylko label potoki były używane przez autorów potoków do odwoływanie się do danych wejściowych zadania.

Kiedy potoki YAML zostały wprowadzone w 2019 r., autorzy potoków korzystający z języka YAML zaczęli używać danych wejściowych name zadania w celu odwoływania się do danych wejściowych zadania. W niektórych przypadkach nazwy danych wejściowych zadania nie były opisowe, dlatego aliases zostały dodane w celu zapewnienia dodatkowych nazw opisowych danych wejściowych zadań.

Na przykład InstallSSHKey@0 zadanie ma wejście Znane hosty wpis o nazwie hostName , które oczekuje wpisu z pliku known_hosts . Etykieta Wpis znanych hostów w klasycznym projektancie potoku jasno pokazuje, ale nie jest tak jasna, gdy używasz hostName nazwy w potoku YAML. Wprowadzono aliasy danych wejściowych zadań, aby umożliwić autorom zadań podawanie nazw dekryptywnych dla poprzednio utworzonych zadań, a dla InstallSSHKey@0 zadania knownHostsEntrydodano alias przy zachowaniu oryginalnej hostName nazwy w celu zachowania zgodności z istniejącymi potokami przy użyciu tej nazwy.

Wszystkie elementy w danych wejściowych aliases zadania są zamienne z elementem name w potoku YAML. Poniższe dwa fragmenty kodu YAML są funkcjonalnie identyczne, przy użyciu pierwszego przykładu przy użyciu aliasu knownHostsEntry i drugiego przykładu przy użyciu metody hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

Począwszy od Azure DevOps Server 2019.1, wprowadzono edytor potoków YAML, który zapewnia funkcję typu intellisense.

Edytor potoku YAML używa interfejsu API REST Yamlschema — Pobierz interfejs API REST do pobrania schematu używanego do walidacji w edytorze. Jeśli dane wejściowe zadania mają alias, schemat promuje alias do podstawowej nazwy YAML dla danych wejściowych zadania, a alias jest sugerowany przez funkcję IntelliSense.

Poniższy przykład to dane wejściowe zadania Znane hosty Entry dla InstallSSHKey@0 zadania ze schematu YAML z knownHostsEntry listy w pozycji nazwy i hostName w kolekcji aliases .

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Ponieważ funkcja IntelliSense w edytorze potoku YAML wyświetla knownHostsEntrywartość , a kod YAML wygenerowany przez zadanie asystent jest używany knownHostsEntry w wygenerowanym pliku YAML, odwołanie do zadania wyświetla alias kod źródłowy zadania jako nazwę YAML dla danych wejściowych zadania. Jeśli zadanie ma więcej niż jeden alias (istnieje kilka, które mają dwa aliasy), pierwszy alias jest używany jako nazwa.

Dlaczego odwołanie do zadania uległo zmianie?

Dokumentacja referencyjna zadań usługi Azure Pipelines została przeniesiona do bieżącej lokalizacji, aby zapewnić obsługę następujących ulepszeń.

• Artykuły dotyczące zadań są generowane przy użyciu kodu źródłowego zadania z zadań usługi Azure Pipelines open source repozytorium.
• Nazwy danych wejściowych i aliasów zadań są generowane ze źródła zadań, dzięki czemu są zawsze aktualne.
• Bloki składni YAML są generowane ze źródła zadań, dzięki czemu są aktualne.
• Obsługuje współtworzenie społeczności z zintegrowaną zawartością użytkownika, taką jak rozszerzone opisy danych wejściowych zadań, uwagi i przykłady.
• Zapewnia pokrycie zadań dla wszystkich obsługiwanych wersji usługi Azure DevOps.
• Zaktualizowano każdy przebieg, aby uwzględnić najnowsze aktualizacje.

Aby współtworzyć zawartość, zobacz Współtworzenie zawartości zadań.

Gdzie mogę dowiedzieć się, jak utworzyć aplikację krok po kroku?

Kompilowanie aplikacji

Czy mogę dodać własne zadania kompilacji?

Tak: Dodawanie zadania kompilacji

Co to są zadania instalatora?

Aby dowiedzieć się więcej o zadaniach instalatora narzędzi, zobacz Instalatory narzędzi.