Share via

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:

Ezekhez a parancsokhoz a kezelni kívánt folyamat neve vagy azonosítója szükséges. A folyamat azonosítóját az az pipelines list paranccsal szerezheti be.

Az első lépésekért lásd: Ismerkedés az Azure DevOps CLI-vel.

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 folyamat fut, várólistára helyezendő, például hivs/heads/main.
  • commit-id: Az a véglegesítési azonosító, amelyen a folyamat fut, várólistára kerül.
  • folder-path: A folyamat mappaútvonala. Az alapértelmezett érték a gyökérszintű mappa.
  • id: Kötelező megadni, ha a név nincs megadva. A várólistára helyezett folyamat azonosítója.
  • name: Kötelező, ha nem adja meg az azonosítót , de az azonosító megadásakor figyelmen kívül hagyja. Az üzenetsorba helyezendő folyamat neve.
  • megnyitás: Nyissa meg a folyamat eredményeinek lapját a webböngészőben.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet a paranccsal az devops configure -d organization=ORG_URLkonfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet git config. Példa: --org https://dev.azure.com/MyOrganizationName/.
  • project: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a paranccsal az devops configure -d project=NAME_OR_ID. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet 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

A következő parancs a myGithubname.pipelines-java nevű folyamatot futtatja az ágfolyamatban , és táblaformátumban jeleníti meg az eredményt.

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. Az első lépésekért lásd: Ismerkedés az Azure DevOps CLI-vel.

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 hivs/heads/main.
  • description: A folyamat új leírása.
  • id: Kötelező megadni, ha a név nincs megadva. A frissíteni kívánt folyamat azonosítója.
  • név: Kötelező, ha nincs megadva azonosító . A frissíteni kívánt folyamat neve.
  • new-folder-path: Annak a mappának az új teljes elérési útja, amelyre a folyamatot áthelyezték, például user1/production_pipelines.
  • new-name: A folyamat új frissített neve.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet a paranccsal az devops configure -d organization=ORG_URLkonfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet git config. Példa: --org https://dev.azure.com/MyOrganizationName/.
  • project: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a paranccsal az devops configure -d project=NAME_OR_ID. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet git config.
  • queue-id: Annak az ügynökkészletnek az üzenetsor-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é tartoznak a következők: debug, help, only-show-errors, query, outputé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 felhasználóbarát formátumban jeleníti meg a kimenetet. További információ: Kimeneti formátumok az Azure CLI-parancsokhoz.

Példa

A következő parancs frissíti a folyamatot a 12-s azonosítóval egy új névvel és leírással, é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. Az első lépésekért lásd: Ismerkedés az Azure DevOps CLI-vel.

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

Paraméterek

  • folder-path: A folyamat mappaútvonala. Az alapértelmezett érték a gyökérszintű mappa.
  • id: Kötelező megadni, ha a név nincs megadva. A folyamat azonosítója a részletek megjelenítéséhez.
  • name: Kötelező, ha a név nem szerepel a mezőben, de az azonosító megadásakor figyelmen kívül hagyja. A részletek megjelenítéséhez szükséges folyamat neve.
  • megnyitás: Nyissa meg a folyamat összefoglaló oldalát a webböngészőben.
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet a paranccsal az devops configure -d organization=ORG_URLkonfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet git config. Példa: --org https://dev.azure.com/MyOrganizationName/.
  • project: A projekt neve vagy azonosítója. Az alapértelmezett projektet konfigurálhatja a paranccsal az devops configure -d project=NAME_OR_ID. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy a használatával veszi fel a elemet 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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

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

Testreszabhatja 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 hozzon létre egy buildfolyamatot?

REST API-referencia: Buildfolyamat létrehozása

Megjegyzés

A buildeket és a folyamatokat a parancssorból vagy szkriptekből is kezelheti az Azure Pipelines CLI használatával.

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 parancs úgy van kialakítva, hogy független folyamatok független futtatásához működjön, és egyedi azonosító kéréseket igényel, 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.