Udostępnij za pośrednictwem

Dokumentacja schematu YAML dla usługi Azure Pipelines

  • Artykuł

Dokumentacja schematu YAML dla usługi Azure Pipelines to szczegółowa dokumentacja potoków YAML, która zawiera listę wszystkich obsługiwanych składni YAML i ich dostępnych opcji.

Aby utworzyć potok YAML, zacznij od definicji potoku . Aby uzyskać więcej informacji na temat tworzenia potoków YAML, zobacz Dostosowywanie potoku.

Dokumentacja schematu YAML nie obejmuje zadań. Aby uzyskać więcej informacji na temat zadań, zobacz indeks zadań usługi Azure Pipelines.

Definicje

Rurociągu
Potok to co najmniej jeden etap opisujący proces ciągłej integracji/ciągłego wdrażania. Definicja potoku zawiera dokumentację właściwości poziomu głównego, takich jak name.

Rurociągu
Potok to jedno lub więcej zadań opisujących proces ciągłej integracji/ciągłego wdrażania.

Rozszerza
Rozszerza potok przy użyciu szablonu.

Zadania
Określa zadania, które składają się na pracę etapu.

Zadania
Określa zadania, które składają się na pracę potoku.

jobs.deployment
Zadanie wdrożenia jest specjalnym typem zadania. Jest to zbiór kroków, które należy uruchamiać sekwencyjnie względem środowiska.

jobs.deployment.environment
Nazwa środowiska docelowego i opcjonalnie nazwa zasobu do rejestrowania historii wdrożenia; format: environment-name.resource-name.

jobs.deployment.strategy
Strategia wykonywania dla tego wdrożenia.

jobs.deployment.strategy.canary
Strategia wdrażania kanarowego.

jobs.deployment.strategy.rolling
Strategia wdrażania operacyjnego.

jobs.deployment.strategy.runOnce
Strategia wdrażania RunOnce.

jobs.job
Zadanie to zbiór kroków uruchamianych przez agenta lub na serwerze.

jobs.job.container
Nazwa zasobu kontenera.

jobs.job.strategy
Strategia wykonywania dla tego zadania.

jobs.job.uses
Wszystkie zasoby wymagane przez to zadanie, do których jeszcze nie odwołuje się odwołanie.

jobs.template
Zestaw zadań zdefiniowanych w szablonie.

Parametry
Określa parametry środowiska uruchomieniowego przekazywane do potoku.

parameters.parameter
Parametry szablonu potoku.

Basen
Która pula ma być używana dla zadania potoku.

pool.demands
Wymagania (w przypadku puli prywatnej).

Pr
Wyzwalacz żądania ściągnięcia.

Zasobów
Zasoby określają kompilacje, repozytoria, potoki i inne zasoby używane przez potok.

resources.builds
Lista zasobów kompilacji, do których odwołuje się potok.

resources.builds.build
Zasób kompilacji używany do odwoływanie się do artefaktów z przebiegu.

resources.containers
Lista obrazów kontenerów.

resources.containers.container
Zasób kontenera używany do odwoływanie się do obrazu kontenera.

resources.containers.container.trigger
Określ brak do wyłączenia, wartość true do wyzwolenia we wszystkich tagach obrazów lub użyj pełnej składni, jak opisano w poniższych przykładach.

resources.packages
Lista zasobów pakietu.

resources.packages.package
Zasób pakietu używany do odwoływanie się do pakietu NuGet lub npm GitHub.

resources.pipelines
Lista zasobów potoku.

resources.pipelines.pipeline.trigger
Określ brak do wyłączenia, wartość true, aby uwzględnić wszystkie gałęzie, lub użyć pełnej składni, jak opisano w poniższych przykładach.

resources.pipelines.pipeline.trigger.branches
Gałęzie do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

resources.repositories
Lista zasobów repozytorium.

resources.repositoryies.repository
Zasób repozytorium służy do odwoływanie się do dodatkowego repozytorium w potoku.

resources.webhooks
Lista elementów webhook.

resources.webhooks.webhook
Zasób elementu webhook umożliwia integrację potoku z usługą zewnętrzną w celu zautomatyzowania przepływu pracy.

resources.webhooks.webhook.filters
Lista filtrów wyzwalacza.

resources.webhooks.webhook.filters.filters
Filtr wyzwalacza zasobów elementu webhook.

Harmonogramy
Lista harmonogramów określa zaplanowane wyzwalacze dla potoku.

schedules.cron
Zaplanowany wyzwalacz określa harmonogram, w którym są tworzone gałęzie.

Etapach
Etapy to kolekcja powiązanych zadań.

stages.stage
Etap to kolekcja powiązanych zadań.

stages.template
Można zdefiniować zestaw etapów w jednym pliku i używać go wiele razy w innych plikach.

Kroki
Kroki to liniowa sekwencja operacji tworzących zadanie.

steps.bash
Uruchamia skrypt w programie Bash w systemach Windows, macOS i Linux.

steps.checkout
Skonfiguruj sposób sprawdzania kodu źródłowego potoku.

steps.download
Pobiera artefakty skojarzone z bieżącym uruchomieniem lub z innego potoku platformy Azure skojarzonego jako zasób potoku.

steps.downloadBuild
Pobiera artefakty kompilacji.

steps.getPackage
Pobiera pakiet ze źródła danych zarządzania pakietami w usłudze Azure Artifacts lub Azure DevOps Server.

steps.powershell
Uruchamia skrypt przy użyciu Windows PowerShell (w systemie Windows) lub pwsh (Linux i macOS).

steps.publish
Publikuje (przekazuje) plik lub folder jako artefakt potoku, z którego mogą korzystać inne zadania i potoki.

steps.pwsh
Uruchamia skrypt w programie PowerShell Core w systemach Windows, macOS i Linux.

steps.reviewApp
Pobieranie tworzy zasób dynamicznie w ramach dostawcy fazy wdrażania.

steps.script
Uruchamia skrypt przy użyciu cmd.exe w systemach Windows i Bash na innych platformach.

steps.task
Uruchamia zadanie.

steps.template
Zdefiniuj zestaw kroków w jednym pliku i użyj go wiele razy w innym pliku.

Docelowego
Zadania są uruchamiane w kontekście wykonywania, który jest hostem agenta lub kontenerem.

target.settableVariables
Ograniczenia dotyczące zmiennych, które można ustawić.

Wyzwalacz
Wyzwalacz ciągłej integracji (wypychania).

Zmiennych
Zdefiniuj zmienne przy użyciu par nazwa/wartość.

variables.group
Odwołuje się do zmiennych z grupy zmiennych.

variables.name
Zdefiniuj zmienne przy użyciu nazwy i pełnej składni.

variables.template
Zdefiniuj zmienne w szablonie.

Definicje pomocnicze

Uwaga

Definicje pomocnicze nie są przeznaczone do użytku bezpośrednio w potoku. Definicje pomocnicze są używane tylko w ramach innych definicji i są dołączone tutaj do celów referencyjnych.

deployHook
Służy do uruchamiania kroków wdrażania aplikacji.

includeExcludeFilters
Listy elementów do uwzględnienia lub wykluczenia.

includeExcludeStringFilters
Elementy do uwzględnienia lub wykluczenia.

mountReadOnly
Woluminy do zainstalowania tylko do odczytu, wartość domyślna to wszystkie wartości false.

onFailureHook
Służy do uruchamiania kroków wycofywania akcji lub czyszczenia.

onSuccessHook
Służy do uruchamiania kroków wycofywania akcji lub czyszczenia.

onSuccessOrFailureHook
Służy do uruchamiania kroków wycofywania akcji lub czyszczenia.

postRouteTrafficHook
Służy do uruchamiania kroków po kierowaniu ruchu. Zazwyczaj te zadania monitorują kondycję zaktualizowanej wersji dla zdefiniowanego interwału.

preDeployHook
Służy do uruchamiania kroków, które inicjują zasoby przed rozpoczęciem wdrażania aplikacji.

routeTrafficHook
Służy do uruchamiania kroków obsługujących ruch do zaktualizowanej wersji.

Obszaru roboczego
Opcje obszaru roboczego w agencie.

Konwencje dokumentacji schematu YAML

Dokumentacja schematu YAML to szczegółowy przewodnik referencyjny dotyczący potoków YAML usługi Azure Pipelines. Zawiera wykaz wszystkich obsługiwanych funkcji YAML i dostępnych opcji.

Poniżej przedstawiono konwencje składni używane w dokumentacji schematu YAML.

  • Po lewej : stronie znajduje się słowo kluczowe literału używane w definicjach potoku.
  • Po prawej stronie : znajduje się typ danych. Typ danych może być typem pierwotnym, takim jak ciąg lub odwołanie do rozbudowanej struktury zdefiniowanej w innym miejscu w tym odwołaniu.
  • Typ danych] notacji [ wskazuje tablicę wymienionego typu definicji. Na przykład [ string ] jest tablicą ciągów.
  • Typ danych:} notacji { wskazuje mapowanie jednego typu danych na inny. Na przykład { string: string } jest mapowaniem ciągów na ciągi.
  • Symbol | wskazuje, że dla słowa kluczowego jest dostępnych wiele typów danych. Na przykład oznacza, job | template że jest dozwolona definicja zadania lub odwołanie do szablonu.

Zobacz też

Ta dokumentacja obejmuje schemat pliku YAML usługi Azure Pipelines. Aby poznać podstawy języka YAML, zobacz Learn YAML in Y Minutes (Uczenie yaML w minutach Y). Usługa Azure Pipelines nie obsługuje wszystkich funkcji YAML. Nieobsługiwane funkcje obejmują kotwice, złożone klucze i zestawy. Ponadto, w przeciwieństwie do standardowego kodu YAML, usługa Azure Pipelines zależy od wyświetlania stageskrótu zadań , job, tasklub, takiego jak script pierwszy klucz w mapowaniu.