A folyamat kezelése az Azure CLI-vel
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
A szervezet folyamatait az alábbi az pipelines
parancsokkal kezelheti:
- az pipelines run: Run an existing pipeline
- az pipelines update: Update an existing pipeline
- az pipelines show: Egy meglévő folyamat részleteinek megjelenítése
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őtgit 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őtgit 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őtgit 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őtgit 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 debug
a , help
, only-show-errors
, query
output
és verbose
.
Tipp.
Vannak olyan globális paraméterek is, mint például --output
a .
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őtgit 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őtgit 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.