Definice kanálu

Kanál je jedna nebo více fází, které popisují proces CI/CD.

Implementace

Implementace	Popis
kanál: fáze	Kanál s fázemi.
kanál: rozšiřuje	Kanál, který rozšiřuje šablonu.
kanál: úlohy	Kanál s úlohami a jednou implicitní fází
kanál: kroky	Kanál s kroky a jednou implicitní úlohou

Poznámky

Kanál je jedna nebo více fází, které popisují proces CI/CD. Fáze jsou hlavní divize v kanálu. Dobrým příkladem jsou fáze Sestavení této aplikace, Spuštění těchto testů a Nasazení do předprodukční fáze.

Fáze je jedna nebo více úloh, což jsou jednotky práce, které lze přiřadit stejnému počítači. Fáze i úlohy můžete uspořádat do grafů závislostí. Mezi příklady patří "Spustit tuto fázi před touto fází" a "Tato úloha závisí na výstupu této úlohy".

Úloha je lineární řada kroků. Kroky můžou být úkoly, skripty nebo odkazy na externí šablony.

Tato hierarchie se odráží ve struktuře souboru YAML, například:

- Pipeline
  - Stage A
    - Job 1
      - Step 1.1
      - Step 1.2
      - ...
    - Job 2
      - Step 2.1
      - Step 2.2
      - ...
  - Stage B
    - ...

Jednoduché kanály nevyžadují všechny tyto úrovně. Například v sestavení s jednou úlohou můžete vynechat kontejnery pro fáze a úlohy, protože existují pouze kroky. A protože mnoho možností uvedených v tomto článku není povinných a mají dobré výchozí hodnoty, je nepravděpodobné, že by definice YAML obsahovaly všechny.

Pokud máte jednu fázi, můžete klíčové slovo vynechat stages a zadat přímo klíčové slovo jobs :

# ... other pipeline-level keywords
jobs: [ job | template ]

Pokud máte jednu fázi a jednu úlohu, můžete vynechat stages klíčová slova a jobs a zadat přímo klíčové slovo steps :

# ... other pipeline-level keywords
steps: [ script | bash | pwsh | powershell | checkout | task | template | ... ]

name Ke konfiguraci čísla spuštění kanálu použijte vlastnost . Další informace najdete v tématu Konfigurace čísel spuštění nebo sestavení.

kanál: fáze

Kanál s fázemi.

stages: [ stage | template ] # Required. Stages are groups of jobs that can run without human intervention.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Vlastnosti

stagesjednotlivých fází. Povinná hodnota.
Fáze jsou skupiny úloh, které můžou běžet bez zásahu člověka.

poolbazénu.
Fond, ve kterém se budou úlohy v tomto kanálu spouštět, pokud není uvedeno jinak.

name Řetězec.
Číslo spuštění kanálu

appendCommitMessageToRunNamelogická hodnota.
Připojte zprávu potvrzení k číslu sestavení. Výchozí hodnota je true.

triggeraktivační událost.
Triggery kontinuální integrace.

parametersparametry.
Parametry šablony kanálu.

prPr.
Triggery žádostí o přijetí změn

schedulesplány.
Naplánované triggery.

resourcesprostředků.
Kontejnery a úložiště použitá v sestavení.

variablesproměnné.
Proměnné pro tento kanál

lockBehavior Řetězec.
Požadavky na uzamčení chování z této fáze by se měly projevit ve vztahu k ostatním žádostem o výhradní uzamčení. sekvenční | runLatest.

Příklady

trigger:
- main

pool: 
  vmImage: ubuntu-latest

stages:
- stage: CI
  jobs:
  - job: CIWork
    steps:
    - script: "Do CI work"

- stage: Test
  jobs:
  - job: TestWork
    steps:
    - script: "Do test work"

kanál: rozšiřuje

Kanál, který rozšiřuje šablonu.

extends: # Required. Extends a template.
  template: string # The template referenced by the pipeline to extend.
  parameters: # Parameters used in the extend.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Vlastnosti

extendsprodlužuje. Povinná hodnota.
Rozšíří šablonu.

poolbazénu.
Fond, ve kterém se budou úlohy v tomto kanálu spouštět, pokud není uvedeno jinak.

name Řetězec.
Číslo spuštění kanálu

appendCommitMessageToRunNamelogická hodnota.
Připojte zprávu potvrzení k číslu sestavení. Výchozí hodnota je true.

triggeraktivační událost.
Triggery kontinuální integrace.

parametersparametry.
Parametry šablony kanálu.

prPr.
Triggery žádostí o přijetí změn

schedulesplány.
Naplánované triggery.

resourcesprostředků.
Kontejnery a úložiště použitá v sestavení.

variablesproměnné.
Proměnné pro tento kanál

lockBehavior Řetězec.
Požadavky na uzamčení chování z této fáze by se měly projevit ve vztahu k ostatním žádostem o výhradní uzamčení. sekvenční | runLatest.

kanál: úlohy

Kanál s úlohami a jednou implicitní fází

jobs: [ job | deployment | template ] # Required. Jobs represent units of work which can be assigned to a single agent or server.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Vlastnosti

jobspracovních míst. Povinná hodnota.
Úlohy představují jednotky práce, které lze přiřadit k jednomu agentovi nebo serveru.

poolbazénu.
Fond, ve kterém se budou úlohy v tomto kanálu spouštět, pokud není uvedeno jinak.

name Řetězec.
Číslo spuštění kanálu

appendCommitMessageToRunNamelogická hodnota.
Připojte zprávu potvrzení k číslu sestavení. Výchozí hodnota je true.

triggeraktivační událost.
Triggery kontinuální integrace.

parametersparametry.
Parametry šablony kanálu.

prPr.
Triggery žádostí o přijetí změn

schedulesplány.
Naplánované triggery.

resourcesprostředků.
Kontejnery a úložiště použitá v sestavení.

variablesproměnné.
Proměnné pro tento kanál

lockBehavior Řetězec.
Požadavky na uzamčení chování z této fáze by se měly projevit ve vztahu k ostatním žádostem o výhradní uzamčení. sekvenční | runLatest.

Příklady

trigger:
- main

pool: 
  vmImage: ubuntu-latest

jobs:
- job: PreWork
  steps:
  - script: "Do pre-work"

- job: PostWork
  pool: windows-latest
  steps:
  - script: "Do post-work using a different hosted image"

kanál: kroky

Kanál s kroky a jednou implicitní úlohou

steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # Required. A list of steps to run in this job.
strategy: strategy # Execution strategy for this job.
continueOnError: string # Continue running even on failure?
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
container: string | container # Container resource name.
services: # Container resources to run as a service container.
  string: string # Name/value pairs
workspace: # Workspace options on the agent.
  clean: string # Which parts of the workspace should be scorched before fetching.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Vlastnosti

stepskroky. Povinná hodnota.
Seznam kroků, které se mají v této úloze spustit.

strategyjobs.job.strategy.
Strategie provádění pro tuto úlohu

continueOnError Řetězec.
Chcete pokračovat v provozu i při selhání?

poolbazénu.
Fond, ve kterém se budou úlohy v tomto kanálu spouštět, pokud není uvedeno jinak.

containerjobs.job.container.
Název prostředku kontejneru.

services slovník řetězců.
Prostředky kontejneru, které se mají spustit jako kontejner služby.

workspacepracovní prostor.
Možnosti pracovního prostoru v agentu

name Řetězec.
Číslo spuštění kanálu

appendCommitMessageToRunNamelogická hodnota.
Připojte zprávu potvrzení k číslu sestavení. Výchozí hodnota je true.

triggeraktivační událost.
Triggery kontinuální integrace.

parametersparametry.
Parametry šablony kanálu.

prPr.
Triggery žádostí o přijetí změn

schedulesplány.
Naplánované triggery.

resourcesprostředků.
Kontejnery a úložiště použitá v sestavení.

variablesproměnné.
Proměnné pro tento kanál

lockBehavior Řetězec.
Požadavky na uzamčení chování z této fáze by se měly projevit ve vztahu k ostatním žádostem o výhradní uzamčení. sekvenční | runLatest.

Příklady

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Viz také

• Kanály s více úlohami
• Triggery
• Proměnné
• Formáty čísel sestavení