Dokumentacja zadania usługi Azure Pipelines

Zadanie wykonuje akcję w potoku. Na przykład zadanie może utworzyć 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 mają 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 steps.task..

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 dokumentacji usługi Azure Pipelines.

Ważny

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 usługą Azure DevOps Services, czy lokalną wersją usługi Azure DevOps Server.
Aby dowiedzieć się, której wersji lokalnej używasz, zobacz Wyszukaj platformę i wersję 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 tworzą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 Wykonaj analizę codeQL AdvancedSecurity-Codeql-Analyze@1	Finalizuje bazę danych CodeQL i uruchamia zapytania analizy.
wyniki publikowania zabezpieczeń zaawansowanych AdvancedSecurity-Publish@1	Łączy pliki SARIF generowane przez narzędzia do skanowania kodu, rozszerza połączony plik SARIF i publikuje rozszerzony plik SARIF w usłudze Advanced Security.
kompilacji systemu Android AndroidBuild@1	AndroidBuild@1 jest przestarzała. Użyj narzędzia Gradle.
podpisywania systemu Android AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Podpisywanie i wyrównywanie plików APK systemu Android.
Ant Ant@1	Kompiluj przy użyciu platformy Apache Ant.
azure IoT Edge AzureIoTEdge@2	Kompilowanie i wdrażanie obrazu usługi Azure IoT Edge.
narzędzia CMake CMake@1	Kompiluj za pomocą wieloplatformowego systemu kompilacji narzędzia CMake.
Container Build 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@1 DockerCompose@0	Kompilowanie, wypychanie lub uruchamianie aplikacji platformy Docker z wieloma kontenerami. Zadania można używać z usługą Docker lub Azure Container Registry.
pobierz pakiety NuGet usługi GitHub DownloadGitHubNugetPackage@1	Przywróć pakiety nuget przy użyciu interfejsu wiersza polecenia dotnet.
Go Go@0	Pobierz, skompiluj lub przetestuj aplikację języka Go lub uruchom niestandardowe polecenie języka Go.
Gradle Gradle@3 Gradle@2 Gradle@1	Skompiluj przy użyciu skryptu otoki Gradle.
Grunt Grunt@0	Uruchom moduł uruchamiający zadania Grunt JavaScript.
gulp gulp@1 gulp@0	Uruchom system kompilacji oparty na zadaniach przesyłania strumieniowego Node.js gulp.
Źródła indeksu i publikowanie symboli PublishSymbols@2 PublishSymbols@1	Zaindeksuj kod źródłowy i opublikuj symbole w udziale plików lub serwerze symboli usługi Azure Artifacts.
zadania kolejki usługi Jenkins JenkinsQueueJob@2	Kolejki zadania na serwerze Jenkins.
zadania kolejki serwera Jenkins JenkinsQueueJob@1	Kolejki 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.
przygotowanie konfiguracji analizy SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	Przygotuj konfigurację analizy SonarQube.
wynik bramy jakości publikowania SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	Opublikuj wynik bramy jakości sonarQube w wyniku kompilacji usługi Azure DevOps, który będzie używany po rzeczywistej analizie.
uruchamianie analizy kodu SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	Uruchom skaner i przekaż wyniki do serwera SonarQube.
kompilacji programu Visual Studio VSBuild@1	Skompiluj przy użyciu programu MSBuild i ustaw właściwość wersji programu Visual Studio.
Xamarin.Android XamarinAndroid@1	Tworzenie aplikacji dla systemu Android przy użyciu platformy Xamarin.
Xamarin.iOS XamariniOS@2 XamariniOS@1	Tworzenie aplikacji systemu iOS przy użyciu platformy Xamarin w systemie macOS.
Xcode Xcode@5 Xcode@4	Kompilowanie, testowanie lub archiwizowanie obszaru roboczego programu Xcode w systemie macOS. Opcjonalnie spakuj aplikację.
kompilacji Xcode Xcode@3 Xcode@2	Tworzenie obszaru roboczego programu 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
App Center dystrybuować 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żania szablonu usługi ARM AzureResourceManagerTemplateDeployment@3	Wdróż szablon usługi Azure Resource Manager (ARM) we wszystkich zakresach wdrażania.
Eksportowanie usługi Azure App Configuration AzureAppConfigurationExport@10	Pobierz wartości klucza do zmiennych zadań z usługi Azure App Configuration.
klasycznej usługi Azure App Service (przestarzałe) AzureWebPowerShellDeployment@1	Tworzenie lub aktualizowanie usługi Azure App Service przy użyciu programu Azure PowerShell.
wdrażanie w usłudze Azure App Service AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Wdróż w usłudze Azure App Service aplikację internetową, mobilną lub interfejs API przy użyciu platformy Docker, Java, .NET, .NET Core, Node.js, PHP, Python lub Ruby.
zarządzanie usługą Azure App Service AzureAppServiceManage@0	Uruchamianie, zatrzymywanie, ponowne uruchamianie, zamiana miejsca, usuwanie miejsca, instalowanie rozszerzeń lokacji lub włączanie ciągłego monitorowania dla usługi Azure App Service.
ustawień usługi Azure App Service AzureAppServiceSettings@1	Aktualizowanie/dodawanie ustawień aplikacji dla aplikacji internetowej platformy Azure dla systemu Linux lub Windows.
interfejsu 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/powłoki podczas uruchamiania w agencie systemu Linux lub w skrypcie programu PowerShell/PowerShell Core/Batch podczas uruchamiania w agencie systemu Windows.
interfejsu wiersza polecenia platformy Azure w wersji zapoznawczej AzureCLI@0	Uruchamianie skryptu powłoki lub usługi Batch przy użyciu poleceń interfejsu wiersza polecenia platformy Azure w ramach subskrypcji platformy Azure.
wdrażania usługi w chmurze platformy Azure AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Wdrażanie usługi w chmurze platformy Azure.
Azure Container Apps Deploy AzureContainerApps@1 AzureContainerApps@0	Zadanie usługi Azure DevOps do kompilowania i wdrażania usługi Azure Container Apps.
wdrażania usługi Azure Database for MySQL AzureMysqlDeployment@1	Uruchom skrypty i wprowadź zmiany w usłudze Azure Database for MySQL.
kopiowania plików platformy Azure AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Kopiowanie plików do usługi Azure Blob Storage lub maszyn wirtualnych.
funkcji platformy Azure na platformie Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Wdrażanie funkcji platformy Azure w klastrze Kubernetes.
Azure Functions Deploy AzureFunctionApp@2 AzureFunctionApp@1	Aktualizowanie aplikacji funkcji przy użyciu aplikacji internetowych opartych na języku .NET, Python, JavaScript, PowerShell i Java.
usługi Azure Functions dla kontenerów AzureFunctionAppContainer@1	Aktualizowanie aplikacji funkcji za pomocą kontenera platformy Docker.
usługi Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Pobierz wpisy tajne usługi Azure Key Vault.
alerty usługi Azure Monitor (przestarzałe) AzureMonitorAlerts@0	Konfigurowanie alertów dotyczących dostępnych metryk dla zasobu platformy Azure (przestarzałe).
azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Uruchamianie skryptu programu PowerShell w środowisku platformy Azure.
wdrażania 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żania grupy zasobów platformy Azure AzureResourceGroupDeployment@1	Wdrażanie, uruchamianie, zatrzymywanie i 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żania usługi Azure SQL Database SqlAzureDacpacDeployment@1	Wdróż usługę Azure SQL Database przy użyciu pakietu DACPAC lub uruchom skrypty przy użyciu narzędzia SQLCMD.
wdrażania zestawu skalowania maszyn wirtualnych platformy Azure AzureVmssDeployment@0	Wdrażanie obrazu zestawu skalowania maszyn wirtualnych.
azure Web App 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 usłudze 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 usługi Azure Policy AzurePolicyCheckGate@0	Ocena zabezpieczeń i zgodności dla usługi Azure Policy.
Chef Chef@1	Wdróż w środowiskach Chef, edytując atrybuty środowiska.
Chef Knife ChefKnife@1	Uruchamianie skryptów za pomocą poleceń Knife na stacji roboczej Chef.
kopiowanie plików za pośrednictwem SSH CopyFilesOverSSH@0	Kopiowanie plików lub tworzenie artefaktów 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.
aplikacja internetowa usług IIS zarządza 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.
interwencji ręcznej ManualIntervention@8	Wstrzymaj wdrażanie i poczekaj na interwencję ręczną.
ręcznej weryfikacji ManualValidation@1 ManualValidation@0	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.
pakiet i wdrażanie pakietów Helm HelmDeploy@1 HelmDeploy@0	Wdróż, skonfiguruj, zaktualizuj klaster Kubernetes w usłudze Azure Container Service, uruchamiając polecenia helm.
programu 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.
programu PowerShell na maszynach docelowych PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	Wykonywanie skryptów programu PowerShell na komputerach zdalnych.
wdrażania aplikacji usługi Service Fabric ServiceFabricDeploy@1	Wdrażanie aplikacji usługi Azure Service Fabric w klastrze.
wdrażania w usłudze Service Fabric ServiceFabricComposeDeploy@0	Wdrażanie aplikacji Docker Compose w klastrze usługi Azure Service Fabric.
wdrażanie bazy danych programu SQL Server SqlDacpacDeploymentOnMachineGroup@0	Wdrażanie bazy danych programu SQL Server przy użyciu skryptów DACPAC lub SQL.
wdrażanie bazy danych programu SQL Server (przestarzałe) SqlServerDacpacDeployment@1	Wdrażanie bazy danych programu SQL Server przy użyciu pakietu DACPAC.
SSH SSH@0	Uruchom polecenia powłoki lub skrypt na maszynie zdalnej przy użyciu protokołu SSH.
kopiowania plików 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 uruchamiaczy zadań) 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.
środowiska Conda CondaEnvironment@1 CondaEnvironment@0	To zadanie jest przestarzałe. Użyj conda bezpośrednio w skrypcie, aby pracować ze środowiskami Anaconda.
pobierz pakietu Npm usługi Github DownloadGithubNpmPackage@1	Zainstaluj pakiety npm z usługi GitHub.
uwierzytelniania narzędzia Maven MavenAuthenticate@0	Dostarcza 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 npmjs.com i uwierzytelnione rejestry, takie jak 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 NuGet.exe i współpracuje z aplikacjami .NET Framework. W przypadku aplikacji .NET Core i .NET Standard użyj zadania .NET Core.
uwierzytelniania nuGet NuGetAuthenticate@1 NuGetAuthenticate@0	Skonfiguruj narzędzia NuGet do uwierzytelniania za pomocą usługi Azure Artifacts i innych repozytoriów NuGet. Wymaga >NuGet = 4.8.5385, dotnet >= 6 lub MSBuild >= 15.8.166.59604.
polecenia NuGet NuGet@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współdziała ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji pakietu NuGet bez oczekiwania na aktualizację zadania, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa pakietu NuGet 4.
Instalator NuGet NuGetInstaller@0	Instaluje lub przywraca brakujące pakiety NuGet. Użyj zadania NuGetAuthenticate@0, aby uzyskać najnowsze możliwości.
pakietów NuGet NuGetPackager@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współdziała ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji pakietu NuGet bez oczekiwania na aktualizację zadania, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa pakietu NuGet 4.
wydawcy NuGet NuGetPublisher@0	Przestarzałe: zamiast tego użyj zadania "NuGet". Współdziała ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo używać nowych wersji pakietu NuGet bez oczekiwania na aktualizację zadania, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa pakietu NuGet 4.
przywracania nuGet NuGetRestore@1	Przywraca pakiety NuGet w ramach przygotowania do kroku kompilacji programu Visual Studio.
wydawcy PyPI PyPIPublisher@0	Utwórz i przekaż sdist lub wheel do indeksu zgodnego z interfejsem PyPI przy użyciu usługi Twine.
uwierzytelnianie języka Python PipAuthenticate@1 PipAuthenticate@0	Zadanie uwierzytelniania klienta używanego do instalowania dystrybucji języka Python.
przekazywanie bliźniaczych reprezentacji języka Python TwineAuthenticate@1 TwineAuthenticate@0	Uwierzytelnianie w celu przekazywania dystrybucji języka Python przy użyciu bliźniaczych 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 z usługą.
pakiety uniwersalne UniversalPackages@0	Pobierz lub opublikuj pakiety uniwersalne.
przywracanie składnika Xamarin XamarinComponentRestore@0	To zadanie jest przestarzałe. Zamiast tego użyj polecenia "NuGet".

Zadania testowe

Zadanie	Opis
testowych usługi App Center AppCenterTest@1	Testowanie pakietów aplikacji za pomocą programu Visual Studio App Center.
testowania obciążenia platformy Azure AzureLoadTest@1	Automatyzowanie testowania regresji wydajności przy użyciu usługi Azure Load Testing.
test struktury kontenera ContainerStructureTest@0	Używa kontenera-structure-test (https://github.com/GoogleContainerTools/container-structure-test) do weryfikowania 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.
testowe Mobile Center 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 testów PublishTestResults@1	Publikowanie wyników testów w usłudze Azure Pipelines.
publikowanie wyników testów 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 "Test programu Visual Studio". 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 uruchomić testy bez konieczności korzystania z programu Visual Studio w agencie. Zadanie VSTest udostępnia również nowe funkcje, takie jak automatyczne ponowne uruchamianie testów, które zakończyły się niepowodzeniem.
testowych programu Visual Studio VSTest@3 VSTest@2 VSTest@1	Uruchamianie testów jednostkowych i funkcjonalnych (Selenium, Appium, Coded UI test itp.) przy użyciu modułu uruchamiającego testy programu Visual Studio (VsTest). Można uruchamiać struktury testowe z adapterem testowym programu Visual Studio, takim jak MsTest, xUnit, NUnit, Chutzpah (w przypadku testów JavaScript przy użyciu narzędzi QUnit, Mocha i Jasmine). Testy można dystrybuować na wielu agentach przy użyciu tego zadania (wersja 2 lub nowsza).
wdrażanie agenta testowego programu Visual Studio DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2 jest przestarzała. Użyj zadania testowego 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.
chmury testowej platformy Xamarin 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
instalatora 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ę programu Duffle na potrzeby instalowania pakietów CNAB i zarządzania nimi.
Instalatora 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 .
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.
narzędzia Java JavaToolInstaller@0	Uzyskaj określoną wersję języka Java z obiektu blob platformy Azure dostarczonego przez użytkownika 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.
instalatora narzędzi 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.
używanie .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 , co dodatkowo zapewnia obsługę serwera proxy.
używanie 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 .
używanie 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 typu open source w kodzie źródłowym.
pliki archiwum ArchiveFiles@2	Kompresuj pliki do .7z, .tar.gz lub .zip.
archiwum plików ArchiveFiles@1	Archiwizowanie plików przy użyciu formatów kompresji, takich jak .7z, .rar, .tar.gz i .zip.
importowania usługi Azure App Configuration AzureAppConfigurationImport@10	Wypychanie wartości kluczy do wystąpienia usługi Azure App Configuration.
migawki usługi Azure App Configuration AzureAppConfigurationSnapshot@1	Utwórz migawkę w wystąpieniu usługi Azure App Configuration.
usługi Azure Network Load Balancer AzureNLBManagement@1	Łączenie lub rozłączanie interfejsu sieciowego maszyny wirtualnej platformy Azure z pulą adresów zaplecza usługi Load Balancer.
powłoki Bash Bash@3	Uruchom skrypt powłoki Bash w systemach macOS, Linux lub Windows.
skryptu usługi Batch BatchScript@1	Uruchom polecenie systemu Windows lub skrypt wsadowy i opcjonalnie zezwól na zmianę środowiska.
pamięci podręcznej Cache@2	Buforuj pliki między przebiegami.
pamięci podręcznej (wersja beta) CacheBeta@1 CacheBeta@0	Buforuj pliki między przebiegami.
wiersza polecenia CmdLine@2 CmdLine@1	Uruchom skrypt wiersza polecenia przy użyciu powłoki Bash w systemach Linux i macOS i cmd.exe w systemie Windows.
kopiowanie i publikowanie artefaktów kompilacji CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1 jest przestarzały. Zamiast tego użyj zadania Copy Files (Kopiowanie plików) i zadania Publish Build Artifacts (Publikuj artefakty kompilacji).
kopiowanie plików CopyFiles@2	Skopiuj pliki 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).
kopiowania plików CopyFiles@1	Skopiuj pliki z folderu źródłowego do folderu docelowego przy użyciu wzorców minimatch (wzorce minimatch będą zgodne tylko ze ścieżkami plików, a nie ścieżkami folderów).
przekazywania plików cURL cURLUploader@2 cURLUploader@1	Użyj obsługiwanych protokołów cURL do przekazywania plików.
odszyfrowywania pliku (OpenSSL) DecryptFile@1	Odszyfrowywanie pliku przy użyciu biblioteki OpenSSL.
opóźnienie Delay@1	Opóźnij dalsze wykonywanie przepływu pracy o ustalony czas.
Usuń pliki DeleteFiles@1	Usuń foldery lub pliki pasujące do wzorca.
wdrażanie usługi Azure Static Web App AzureStaticWebApp@0	Skompiluj i wdróż statyczną aplikację internetową 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, które zostały zapisane jako artefakty ukończonej kompilacji.
pobierz wydania usługi GitHub DownloadGitHubRelease@0	Pobiera wydanie usługi GitHub z repozytorium.
Pobierz pakiet 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.
przekazywania FTP FtpUpload@2 FtpUpload@1	Przekazywanie plików przy użyciu protokołu FTP.
komentarza usługi GitHub GitHubComment@0	Napisz komentarz do jednostki Usługi GitHub, tj. problem lub żądanie ściągnięcia (PR).
wydania 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 kompilacji na agencie systemu macOS.
Instalowanie profilu aprowizacji firmy Apple InstallAppleProvisioningProfile@1	Zainstaluj profil aprowizacji firmy Apple wymagany do kompilacji na maszynie agenta systemu macOS.
Instalowanie profilu aprowizacji firmy Apple InstallAppleProvisioningProfile@0	Zainstaluj profil aprowizacji firmy Apple wymagany do kompilacji na agencie 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.
pobierania artefaktów usługi Jenkins JenkinsDownloadArtifacts@1	Pobieranie artefaktów utworzonych przez zadanie jenkins.
instalator modułu uruchamiającego zadania Node.js NodeTaskRunnerInstaller@0	Zainstaluj określoną wersję Node.js, aby uruchamiać zadania węzłów.
Notacja Notation@0	Zadanie pipepine platformy Azure służące do konfigurowania interfejsu wiersza polecenia notacji, podpisywania i weryfikowania przy użyciu notacji.
programu PowerShell PowerShell@2 PowerShell@1	Uruchom skrypt programu PowerShell w systemie 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 usłudze Azure Service Bus PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Wysyła komunikat do usługi Azure Service Bus przy użyciu połączenia usługi Azure Resource Manager (żaden agent nie jest wymagany).
skrypt języka Python PythonScript@0	Uruchom plik języka Python lub skrypt wbudowany.
wykonywanie zapytań dotyczących alertów usługi Azure Monitor AzureMonitor@1	Obserwuj skonfigurowane reguły usługi Azure Monitor dla aktywnych alertów.
Zapytania klasyczne alerty 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 dotyczące elementu roboczego i sprawdź liczbę zwracanych elementów.
Przeglądanie aplikacji ReviewApp@0	Użyj tego zadania w ramach dostawcy fazy wdrażania, aby dynamicznie utworzyć zasób.
programu PowerShell usługi Service Fabric ServiceFabricPowerShell@1	Uruchom skrypt programu PowerShell w kontekście połączenia klastra usługi Azure Service Fabric.
skryptu powłoki ShellScript@2	Uruchom skrypt powłoki przy użyciu powłoki Bash.
aktualizacji wersji aplikacji usługi Service Fabric ServiceFabricUpdateAppVersions@1	Automatycznie aktualizuje wersje spakowanej aplikacji usługi Service Fabric.
aktualizacji 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.
licencji platformy Xamarin XamarinLicense@1	[Przestarzałe] Przeprowadź uaktualnienie do bezpłatnej wersji platformy Xamarin: https://store.xamarin.com.

Open source

Te zadania to open source w witrynie GitHub. Opinie i współtworzenie są mile widziane. Zobacz Dziennik zmian zadań potoku listę zmian zadań, w tym historyczny rekord aktualizacji zadań.

FAQ

Co to są aliasy wejściowe zadania?

Dane wejściowe zadania są identyfikowane przez label, namei mogą zawierać co najmniej jeden opcjonalny aliases. Poniższy przykład to fragment kodu źródłowego dla danych wejściowych Znanych hostów danych wejściowych zadania InstallSSHKey@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 potoku opartego na interfejsie użytkownika, a tylko label były używane przez autorów potoków do odwołwania 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ć name wejściowych zadań 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 dla danych wejściowych zadań.

Na przykład zadanie InstallSSHKey@0 ma wejście Znane hosty wejściowe o nazwie hostName, które oczekuje wpisu z pliku known_hosts. Etykieta wpis znanych hostów w klasycznym projektancie potoku jest jasna, ale nie jest tak jasna, gdy używasz nazwy hostName w potoku YAML. Wprowadzono aliasy danych wejściowych zadań, aby umożliwić autorom zadań podawanie nazw dekrypcyjne dla poprzednio utworzonych zadań, a dla zadania InstallSSHKey@0 dodano alias knownHostsEntry, zachowując jednocześnie oryginalną nazwę hostName pod kątem zgodności z istniejącymi potokami przy użyciu tej nazwy.

Wszystkie elementy w aliases danych wejściowych zadania są wymienne z name w potoku YAML. Następujące dwa fragmenty kodu YAML są funkcjonalnie identyczne, a pierwszy przykład używa aliasu knownHostsEntry i drugiego przykładu przy użyciu 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 usługi Azure DevOps Server 2019.1, wprowadzono edytor potoków YAML , który zapewnia funkcję typu intellisense.

Edytor potoku YAML używa Yamlschema — Pobierz interfejs API REST w celu 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.

W poniższym przykładzie przedstawiono dane wejściowe zadania znane hosty zadania dla zadania InstallSSHKey@0 ze schematu YAML z knownHostsEntry wymienione 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 knownHostsEntry, a kod YAML wygenerowany przez asystenta zadań używa knownHostsEntry w wygenerowanym pliku YAML, dokumentacja zadania wyświetla alias z kodu źródłowego 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ę poniższych ulepszeń.

• Artykuły dotyczące zadań są generowane przy użyciu kodu źródłowego zadania z repozytorium open source zadań usługi Azure Pipelines.
• Nazwy danych wejściowych i aliasów zadań są generowane ze źródła zadania, więc są zawsze aktualne.
• Bloki składni YAML są generowane ze źródła zadania, dzięki czemu są aktualne.
• Obsługuje współtworzenie społeczności ze zintegrowaną zawartością użytkownika, taką jak ulepszone 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ć, zobacz Współtworzenie zawartości zadań.

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

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