Share via

Uw pijplijn beheren met Azure CLI

  • Artikel

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

U kunt de pijplijnen in uw organisatie beheren met behulp van deze az pipelines opdrachten:

Voor deze opdrachten is de naam of id vereist van de pijplijn die u wilt beheren. U kunt de id van een pijplijn ophalen met behulp van de opdracht az pipelines list .

Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

Een pijplijn uitvoeren

U kunt een bestaande pijplijn in de wachtrij plaatsen (uitvoeren) met de opdracht az pipelines run .

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

Parameters

  • branch: naam van de vertakking waarop de pijplijn moet worden uitgevoerd, bijvoorbeeld refs/heads/main.
  • commit-id: Commit-id waarop de pijplijnuitvoering in de wachtrij moet worden geplaatst.
  • folder-path: mappad van pijplijn. De standaardwaarde is map op hoofdniveau.
  • id: vereist als de naam niet is opgegeven. Id van de pijplijn die in de wachtrij moet worden geplaatst.
  • name: vereist als id niet is opgegeven, maar wordt genegeerd als id wordt opgegeven. Naam van de pijplijn die in de wachtrij moet worden geplaatst.
  • open: open de pagina met pijplijnresultaten in uw webbrowser.
  • org: Azure DevOps-organisatie-URL. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config. Bijvoorbeeld: --org https://dev.azure.com/MyOrganizationName/.
  • project: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config.
  • variabelen: spaties gescheiden 'name=value'-paren voor de variabelen die u wilt instellen.

Voorbeeld

Met de volgende opdracht wordt de pijplijn met de naam myGithubname.pipelines-java uitgevoerd in de vertakkingspijplijn en wordt het resultaat weergegeven in tabelindeling.

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

Een pijplijn bijwerken

U kunt een bestaande pijplijn bijwerken met de opdracht az pipelines update . Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

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

Parameters

  • branch: naam van de vertakking waarop de pijplijn moet worden geconfigureerd, bijvoorbeeld refs/heads/main.
  • beschrijving: nieuwe beschrijving voor de pijplijn.
  • id: vereist als de naam niet is opgegeven. Id van de pijplijn die moet worden bijgewerkt.
  • name: vereist als id niet is opgegeven. Naam van de pijplijn die moet worden bijgewerkt.
  • new-folder-path: nieuw volledig pad van de map waarnaar de pijplijn wordt verplaatst, bijvoorbeeld gebruiker1/production_pipelines.
  • new-name: nieuwe bijgewerkte naam van de pijplijn.
  • org: Azure DevOps-organisatie-URL. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config. Bijvoorbeeld: --org https://dev.azure.com/MyOrganizationName/.
  • project: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config.
  • queue-id: wachtrij-id van de agentgroep waarin de pijplijn moet worden uitgevoerd.
  • yaml-path: pad van het yaml-bestand van de pijplijn in de opslagplaats.

Globale parameters zijn , debughelp, only-show-errors, query, outputen verbose.

Tip

Er zijn ook globale parameters die u kunt gebruiken, zoals --output. De --output parameter is beschikbaar voor alle opdrachten. De tabelwaarde geeft de uitvoer weer in een beschrijvende indeling. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor meer informatie.

Voorbeeld

Met de volgende opdracht wordt de pijplijn bijgewerkt met de id van 12 met een nieuwe naam en beschrijving en wordt het resultaat weergegeven in tabelindeling.

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

Pijplijn weergeven

U kunt de details van een bestaande pijplijn weergeven met de opdracht az pipelines show . Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

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

Parameters

  • folder-path: mappad van pijplijn. De standaardwaarde is map op hoofdniveau.
  • id: vereist als de naam niet is opgegeven. Id van de pijplijn om details weer te geven.
  • name: vereist als de naam niet is opgegeven, maar wordt genegeerd als id wordt opgegeven. Naam van de pijplijn om details weer te geven.
  • open: Open de overzichtspagina van de pijplijn in uw webbrowser.
  • org: Azure DevOps-organisatie-URL. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config. Bijvoorbeeld: --org https://dev.azure.com/MyOrganizationName/.
  • project: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist als deze niet als standaard is geconfigureerd of wordt opgehaald met behulp van git config.
  • queryvoorbeelden: een JMESPath-tekenreeks voor u aanbevelen.
  • subscription: naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Voorbeeld

De volgende opdracht toont de details van de pijplijn met de id van 12 en retourneert het resultaat in tabelindeling.

az pipelines show --id 12 --output table

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

Volgende stappen

U kunt uw pijplijn aanpassen of meer informatie over het configureren van pijplijnen in de taal van uw keuze:

Veelgestelde vragen

Hoe kan ik programmatisch een build-pijplijn maken?

REST API-naslaginformatie: Een build-pijplijn maken

Notitie

U kunt ook builds en pijplijnen beheren vanaf de opdrachtregel of scripts met behulp van de Azure Pipelines CLI.

Kan ik meerdere pijplijnen uitvoeren in Azure DevOps Services met één opdracht?

Op dit moment bieden de Azure CLI en Azure-API's geen opdrachten waarmee meerdere pijplijnen vanaf de opdrachtregel worden uitgevoerd. U kunt Azure CLI-opdrachten gebruiken om alle pijplijnen en definities weer te geven en één release- of build-id als parameter op te geven. Alle opdrachten zijn ontworpen om te werken voor onafhankelijke uitvoeringen van onafhankelijke pijplijnen en ze vereisen unieke id-aanvragen die slechts één unieke waarde toestaan. Zie Gebeurtenissen opgeven die pijplijnen activeren voor meer informatie over pijplijntriggers.