Megosztás a következőn keresztül:

A folyamat kezelése az Azure CLI-vel

  • Cikk

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

A szervezet folyamatait az alábbi az pipelines parancsokkal kezelheti:

Ezek a parancsok a kezelni kívánt folyamat nevét vagy azonosítóját igénylik. A folyamat azonosítóját az az pipelines list paranccsal szerezheti be.

Első lépésként tekintse meg az Azure DevOps parancssori felület használatának első lépéseit.

Folyamat futtatása

Az az pipelines run paranccsal várólistára helyezhet (futtathat) egy meglévő folyamatot.

az pipelines run [--branch]
                 [--commit-id]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--project]
                 [--variables]

Paraméterek

  • ág: Annak az ágnak a neve, amelyen a folyamatfuttatást várólistára kell tenni, például refs/heads/main.
  • commit-id: Véglegesítési azonosító, amelyen a folyamatfuttatás várólistára kerül.
  • mappa-elérési út: A folyamat mappaútvonala. Az alapértelmezett gyökérszintű mappa.
  • id: Kötelező, ha a név nincs megadva. Az üzenetsorba helyezett folyamat azonosítója.
  • név: Kötelező, ha nem adja meg az azonosítót, de az azonosító megadásakor figyelmen kívül hagyja. Az üzenetsorba helyezett folyamat neve.
  • megnyitás: Nyissa meg a folyamat eredményoldalát a webböngészőben.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet konfigurálhatja a következővel az devops configure -d organization=ORG_URL: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: . Példa: --org https://dev.azure.com/MyOrganizationName/
  • projekt: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a következővel az devops configure -d project=NAME_OR_ID: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: .
  • változók: A beállítani kívánt változók szóközzel elválasztott "name=value" párjai.

Példa

Az alábbi parancs a myGithubname.pipelines-java nevű folyamatot futtatja az ágfolyamatban, és az eredményt táblaformátumban jeleníti meg.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --output table

Run ID    Number      Status      Result    Pipeline ID    Pipeline Name                Source Branch    Queued Time               Reason
--------  ----------  ----------  --------  -------------  ---------------------------  ---------------  --------------------------  --------
123       20200123.2  notStarted            12             myGithubname.pipelines-java  pipeline           2020-01-23 11:55:56.633450  manual

Folyamat frissítése

Egy meglévő folyamatot az az pipelines update paranccsal frissíthet. Első lépésként tekintse meg az Azure DevOps parancssori felület használatának első lépéseit.

az pipelines update [--branch]
                    [--description]
                    [--id]
                    [--name]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Paraméterek

  • ág: Annak az ágnak a neve, amelyen a folyamatfuttatást konfigurálni kell, például refs/heads/main.
  • leírás: A folyamat új leírása.
  • id: Kötelező, ha a név nincs megadva. A frissíteni kívánt folyamat azonosítója.
  • név: Kötelező, ha nem adja meg az azonosítót . A frissíteni kívánt folyamat neve.
  • new-folder-path: Annak a mappának az új teljes elérési útja, amelybe a folyamat átkerül, például felhasználó1/production_pipelines.
  • új név: A folyamat új frissített neve.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet konfigurálhatja a következővel az devops configure -d organization=ORG_URL: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: . Példa: --org https://dev.azure.com/MyOrganizationName/
  • projekt: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a következővel az devops configure -d project=NAME_OR_ID: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: .
  • queue-id: Annak az ügynökkészletnek a várólista-azonosítója, ahol a folyamatot futtatni kell.
  • yaml-path: A folyamat yaml-fájljának elérési útja az adattárban.

A globális paraméterek közé tartozik debuga , help, only-show-errors, queryoutputés verbose.

Tipp.

Vannak olyan globális paraméterek is, mint például --outputa . A --output paraméter minden parancshoz elérhető. A tábla értéke a kimenetet felhasználóbarát formátumban jeleníti meg. További információkért tekintse meg az Azure CLI-parancsok kimeneti formátumait.

Példa

Az alábbi parancs új névvel és leírással frissíti a folyamatot a 12-s azonosítóval , és táblaformátumban jeleníti meg az eredményt.

az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Folyamat megjelenítése

Egy meglévő folyamat részleteit az az pipelines show paranccsal tekintheti meg . Első lépésként tekintse meg az Azure DevOps parancssori felület használatának első lépéseit.

az pipelines show [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]
                  [--query-examples]
                  [--subscription]

Paraméterek

  • mappa-elérési út: A folyamat mappaútvonala. Az alapértelmezett gyökérszintű mappa.
  • id: Kötelező, ha a név nincs megadva. A folyamat azonosítója a részletek megjelenítéséhez.
  • név: Kötelező, ha a név nincs megadva, de az azonosító megadásakor figyelmen kívül hagyja. A részleteket megjelenítő folyamat neve.
  • megnyitás: Nyissa meg a folyamat összegzési oldalát a webböngészőben.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet konfigurálhatja a következővel az devops configure -d organization=ORG_URL: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: . Példa: --org https://dev.azure.com/MyOrganizationName/
  • projekt: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a következővel az devops configure -d project=NAME_OR_ID: . Kötelező, ha nincs alapértelmezettként konfigurálva, vagy ha a rendszer felvette a következőt git config: .
  • lekérdezési példák: JMESPath-sztring ajánlása.
  • előfizetés: Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

Példa

Az alábbi parancs a folyamat részleteit mutatja be a 12 azonosítóval, és az eredményt táblaformátumban adja vissza.

az pipelines show --id 12 --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Következő lépések

Testre szabhatja a folyamatot , vagy többet is megtudhat a folyamatok tetszőleges nyelven történő konfigurálásáról:

GYIK

Hogyan programozott módon létrehozni egy buildfolyamatot?

REST API-referencia: Buildfolyamat létrehozása

Feljegyzés

A buildeket és a folyamatokat a parancssorból vagy szkriptekből is kezelheti az Azure Pipelines parancssori felületével.

Futtathatok több folyamatot az Azure DevOps Servicesben egyetlen paranccsal?

Az Azure CLI és az Azure API-k jelenleg nem kínálnak olyan parancsokat, amelyek több folyamatot futtatnak a parancssorból. Az Azure CLI-parancsokkal listázhatja az összes folyamatot és definíciót, és paraméterként egyetlen kiadási vagy buildazonosítót adhat meg. Minden parancsot úgy terveztek, hogy független folyamatok független futtatásához működjenek, és egyedi azonosító kéréseket igényelnek, amelyek csak egy egyedi értéket tesznek lehetővé. A folyamat-eseményindítókról további információt a folyamatok eseményindító eseményeinek megadása című témakörben talál.

Hogyan kihagyja a folyamatfuttatás egy szakaszát?

A parancs használatával az rest az run pipeline Azure DevOps REST API használatával kihagyhatja a folyamatfuttatás egy szakaszát a stagesToSkip paraméterrel.

Példa:

az rest --method post `
    --uri https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1-preview.1 `
    --body "{'stagesToSkip': [''], 'resources': {'repositories': {'self': {'refName': 'refs/heads/{branch}'}}}}" `
    --resource 499b84ac-1321-427f-aa17-267ca6975798

További információ: Azure DevOps Services REST API-referencia.