Szakaszok, függőségek és feltételek hozzáadása

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

A szakasz egy logikai határ egy Azure DevOps-folyamatban. A fázisok a szoftverfejlesztési folyamat műveleteinek csoportosítására használhatók (például az alkalmazás buildelésére, tesztek futtatására, üzembe helyezésre az előgyártásban). Minden szakasz egy vagy több feladatot tartalmaz.

Ha egy folyamat több szakaszát definiálja, alapértelmezés szerint egymás után futnak. A szakaszok egymástól is függhetnek. A kulcsszóval dependsOn függőségeket határozhat meg. A szakaszok az előző fázis eredményei alapján is futtathatók feltételekkel.

A párhuzamos feladatok és licencelés szakaszainak működéséről a Párhuzamos feladatok konfigurálása és fizetése című témakörben olvashat.

Ha szeretné megtudni, hogy a szakaszok hogyan kapcsolódnak a folyamat más részeihez, például a feladatokhoz, tekintse meg a főbb folyamatokra vonatkozó fogalmakat.

A YAML-sémaszakaszok cikkéből megtudhatja azt is, hogyan kapcsolódnak a szakaszok a folyamat egyes részeihez.

YAML

A folyamatfeladatokat fázisokba szervezheti. A fázisok a folyamatok fő osztásai: az alkalmazás létrehozása, a tesztek futtatása és az előkészítésre való üzembe helyezés jó példák a szakaszokra. Ezek logikai határok a folyamatban, ahol szüneteltetheti a folyamatot, és különböző ellenőrzéseket hajthat végre.

Minden folyamatnak van legalább egy fázisa, még akkor is, ha nem definiálja explicit módon. A fázisokat függőségi gráfba is rendezheti, így az egyik fázis a másik előtt fut. Egy szakaszra 256 feladat van korlátozva.

Klasszikus

A kiadási folyamat üzembehelyezési feladatait szakaszokba rendezheti. A fázisok a kiadási folyamat fő divíziói: a működési tesztek futtatása, az üzembe helyezés az előgyártásban és az éles üzembe helyezés jó példa a kiadási fázisokra.

A kiadási folyamat egy szakasza feladatokbólés feladatokból áll.

Jóváhagyások és kapuk, az üzembehelyezési feltételek és az eseményindítók, valamint a sorba állítási szabályzatok szabályozzák, hogy a kiadás mikor lesz üzembe helyezve egy fázisban.

Szakaszok megadása

YAML

A legegyszerűbb esetben nincs szükség logikai határokra a folyamatban. Ebben az esetben nem kell explicit módon használnia a kulcsszót stage . Közvetlenül megadhatja a feladatokat a YAML-fájlban.

# this has one implicit stage and one implicit job
pool:
  vmImage: 'ubuntu-latest'
steps:
- bash: echo "Hello world"

# this pipeline has one implicit stage
jobs:
- job: A
  steps:
  - bash: echo "A"

- job: B
  steps:
  - bash: echo "B"

Ha több fázisba rendezi a folyamatot, a kulcsszót stages használja.

stages:
- stage: A
  jobs:
  - job: A1
  - job: A2

- stage: B
  jobs:
  - job: B1
  - job: B2

Ha a szakasz szintjén ad meg egy pool értéket, akkor az adott szakaszban definiált összes feladat ezt a készletet használja, kivéve, ha a feladat szintjén van megadva.

stages:
- stage: A
  pool: StageAPool
  jobs:
  - job: A1 # will run on "StageAPool" pool based on the pool defined on the stage
  - job: A2 # will run on "JobPool" pool
    pool: JobPool

A szakasz megadásának teljes szintaxisa a következő:

stages:
- stage: string  # name of the stage, A-Z, a-z, 0-9, and underscore
  displayName: string  # friendly name to display in the UI
  dependsOn: string | [ string ]
  condition: string
  pool: string | pool
  variables: { string: string } | [ variable | variableReference ] 
  jobs: [ job | templateReference]

Klasszikus

Ha szakaszt szeretne hozzáadni a kiadási folyamathoz, jelölje ki a kiadási folyamatot a Kiadások lapon, válassza ki a szerkesztéshez szükséges műveletet, majd válassza a Folyamat lapot. Bár a fázisok meghatározásának legfontosabb része az automatizálási feladatok, a kiadási folyamat egy szakaszának számos tulajdonságát és beállítását is konfigurálhatja. A következőket teheti:

• Szükség esetén módosítsa a szakasz nevét.
• Jelöljön ki egy felhasználót vagy csoportot a szakasz tulajdonosának. A szakasztulajdonosok értesítést kapnak, ha az adott szakasz üzembe helyezése meghiúsul. Szakasztulajdonosnak lenni nem jár automatikusan engedélyekkel.
• Törölje a szakaszt a folyamatból.
• A szakaszok sorrendjének módosítása.
• Mentse a szakasz másolatát szakaszsablonként.
• A szakasz biztonsági beállításainak kezelése.

Függőségek megadása

YAML

Ha egy folyamat több fázisát definiálja, alapértelmezés szerint egymás után futnak abban a sorrendben, amelyben a YAML-fájlban definiálja őket. Ez alól kivételt képeznek a függőségek hozzáadásakor. Függőségek esetén a szakaszok a követelmények sorrendjében futnak dependsOn .

A folyamatoknak legalább egy fázist tartalmazniuk kell függőségek nélkül.

Több szakasz és függőségük meghatározásának szintaxisa a következő:

stages:
- stage: string
  dependsOn: string
  condition: string

Egymást követő példaszakaszok:

# if you do not use a dependsOn keyword, stages run in the order they are defined
stages:
- stage: QA
  jobs:
  - job:
    ...

- stage: Prod
  jobs:
  - job:
    ...

Párhuzamosan futó példaszakaszok:

stages:
- stage: FunctionalTest
  jobs:
  - job:
    ...

- stage: AcceptanceTest
  dependsOn: []    # this removes the implicit dependency on previous stage and causes this to run in parallel
  jobs:
  - job:
    ...

Példa a ki- és befúvatásra:

stages:
- stage: Test

- stage: DeployUS1
  dependsOn: Test    # this stage runs after Test

- stage: DeployUS2
  dependsOn: Test    # this stage runs in parallel with DeployUS1, after Test

- stage: DeployEurope
  dependsOn:         # this stage runs after DeployUS1 and DeployUS2
  - DeployUS1
  - DeployUS2

Klasszikus

A függőségeket úgy szabályozhatja, hogy beállítja az eseményindítókat a kiadási folyamat minden szakaszában:

• A szakaszok eseményindítóval vagy manuális indítással futnak.
• A kiadás utáni eseményindítóval a kiadás kezdetekor egy fázis indul el, párhuzamosan a kiadást követő eseményindítóval rendelkező többi fázissal.
• Az After stage eseményindítóval a függő fázisok befejeződése után elindul egy szakasz. Ezzel modellezheti a ventilátorok és a ventilátorok viselkedését a szakaszokhoz.

Feltételek meghatározása

Megadhatja azokat a feltételeket, amelyek mellett az egyes szakaszok kifejezésekkel futnak. Alapértelmezés szerint egy szakasz akkor fut, ha nem függ semmilyen más fázistól, vagy ha az összes fázis, amelytől függ, befejeződött és sikeres volt. Ezt a viselkedést úgy szabhatja testre, hogy egy szakaszt arra kényszerít, hogy futtasson még akkor is, ha egy előző szakasz meghibásodik, vagy egyéni feltételt ad meg.

Ha testre szabja az előző lépések alapértelmezett feltételét egy szakaszhoz, akkor eltávolítja a befejezés és a sikeresség feltételeit. Ha tehát egyéni feltételt használ, gyakran használatos and(succeeded(),custom_condition) annak ellenőrzésére, hogy az előző szakasz sikeresen lefutott-e. Ellenkező esetben a szakasz az előző szakasz eredményétől függetlenül fut.

Feljegyzés

A sikertelen ('JOBNAME/STAGENAME') és a sikeres ('JOBNAME/STAGENAME') feltételek a következő példában látható módon csak YAML-folyamatok esetében működnek.

YAML

Példa egy szakasz futtatására az előző szakasz futtatásának állapota alapján:

stages:
- stage: A

# stage B runs if A fails
- stage: B
  condition: failed()

# stage C runs if B succeeds
- stage: C
  dependsOn:
  - A
  - B
  condition: succeeded('B')

Példa egyéni feltétel használatára:

stages:
- stage: A

- stage: B
  condition: and(succeeded(), eq(variables['build.sourceBranch'], 'refs/heads/main'))

Klasszikus

Ha a kiadás után vagy az After stage triggereket adja meg, megadhatja a kiadásban felhasznált összetevők ágszűrőit is. A kiadások csak akkor lesznek üzembe helyezve egy fázisban, ha az ágszűrők teljesülnek.

Sorbanállási szabályzatok megadása

YAML

A YAML-folyamatok nem támogatják a sorba állítási szabályzatokat. A folyamat minden egyes futtatása független a többi futtatástól, és nem tud a többi futtatásról. Más szóval a két egymást követő véglegesítés két folyamatot indíthat el, és mindkettő ugyanazt a fázissorozatot hajtja végre anélkül, hogy egymásra vár. Bár a YAML-folyamatokra sorba állítási szabályzatokat hozunk létre, javasoljuk, hogy manuális jóváhagyásokkal manuálisan rendezze és vezérelje a végrehajtás sorrendjét, ha ez fontos.

Klasszikus

Bizonyos esetekben gyorsabban hozhat létre buildeket, mint amennyi üzembe helyezhető. Másik lehetőségként több ügynököt is konfigurálhat, és például ugyanabból a kiadási folyamatból hozhat létre kiadásokat különböző összetevők üzembe helyezéséhez. Ilyen esetekben hasznos lehet szabályozni, hogy több kiadás hogyan legyen várólistára helyezve egy fázisban. A sorba állítási szabályzatok ezt a vezérlést biztosítják.

A sorkezelési szabályzathoz a következő lehetőségek közül választhat:

• Párhuzamos üzemelő példányok száma: Ezt a lehetőséget akkor használja, ha dinamikusan épít ki új erőforrásokat a fázisban, és fizikailag képes egyszerre több kiadás üzembe helyezését kezelni, de korlátozni szeretné a párhuzamos üzembe helyezések számát.

• Ha maximális számú üzembe helyezést ad meg, két további lehetőség jelenik meg:

  • Az összes üzembe helyezése sorrendben: Ezt a lehetőséget akkor használja, ha az összes kiadást egymás után szeretné üzembe helyezni ugyanabban a megosztott fizikai erőforrásban. A buildek egymás utáni üzembe helyezésével biztosíthatja, hogy két üzembe helyezési feladat ne célozza meg egyszerre ugyanazokat a fizikai erőforrásokat, még akkor sem, ha több build- és kiadási ügynök áll rendelkezésre. Emellett gondoskodnia kell arról, hogy a szakasz előzetes üzembe helyezési jóváhagyási kérelmei sorrendben legyenek elküldve.

  • Telepítse a legújabb verziót, és mondja le a többit: Ezt a lehetőséget akkor használja, ha a kiadásoknál gyorsabban készít buildeket, és csak a legújabb buildet szeretné üzembe helyezni.

A beállítások működésének megértéséhez fontolja meg azt a forgatókönyvet, amelyben az egyetlen kiadási folyamat R1, R2, ..., R5 kiadásai gyorsan egymás után jönnek létre. Tegyük fel, hogy a folyamat első szakasza QA néven van elnevezve, és előre üzembe helyezést és üzembe helyezés utáni jóváhagyókat is definiált.

• Ha nem határoz meg korlátot a párhuzamos üzemelő példányok számára, a rendszer a kiadások létrehozása után mind az öt jóváhagyási kérelmet elküldi. Ha a jóváhagyók jóváhagyják az összes kiadást, az összes kiadás párhuzamosan lesz üzembe helyezve a minőségbiztosítási szakaszban. (ha a A minőségbiztosítási fázisban nem definiáltak előre üzembe helyezési jóváhagyókat, az öt kiadás automatikusan üzembe lesz helyezve ezzel a fázissal párhuzamosan.

• Ha korlátot ad meg, és az üzembe helyezés sorrendben történik, és a korlát már el lett érve, az R1 kiadás előzetes üzembe helyezési jóváhagyása lesz először elküldve. A jóváhagyás befejezése után megkezdődik az R1 kiadás üzembe helyezése a minőségbiztosítási fázisban. Ezután a rendszer elküldi az üzembe helyezés utáni jóváhagyásra vonatkozó kérést az R1 kiadáshoz. Csak az üzembe helyezés utáni jóváhagyás befejezése után kezdődik meg az R2 kiadás végrehajtása, és a rendszer elküldi az előzetes üzembe helyezés jóváhagyását. A folyamat így folytatódik az összes kiadás esetében.

• Ha korlátot ad meg, és a legújabb üzembe helyezést alkalmazza, és visszavonja a többit, és a korlát már el lett érve, az R2, az R3 és az R4 kiadás ki lesz hagyva, és a QA fázisban lévő R5 előzetes üzembe helyezési jóváhagyása azonnal ki lesz küldve az R1 kiadás üzembe helyezés utáni jóváhagyása után.

Jóváhagyások megadása

YAML

Manuálisan szabályozhatja, hogy mikor fusson egy szakasz jóváhagyási ellenőrzésekkel. Ezt gyakran használják az éles környezetekben történő üzembe helyezés szabályozására. Az ellenőrzések egy olyan mechanizmus, amely az erőforrás tulajdonosának rendelkezésére áll annak szabályozására, hogy a folyamat egy szakasza mikor és mikor használhat fel erőforrást. Egy erőforrás, például egy környezet tulajdonosaként megadhatja azokat az ellenőrzéseket, amelyeket teljesítenie kell ahhoz, hogy megkezdődjön az erőforrás egy szakaszának felhasználása.

Jelenleg a manuális jóváhagyási ellenőrzések támogatottak a környezetekben. További információ: Jóváhagyások.

Klasszikus

A folyamat egyes szakaszainak elején vagy végén manuális jóváhagyásokat adhat hozzá. További információ: Kiadási jóváhagyások és kapuk áttekintése.