Aracılığıyla paylaş

Azure DevOps CLI ile işlem hatlarını yönetme

  • Makale

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

Bu makalede, aşağıdaki az pipelines komutlarını kullanarak Azure DevOps projenizdeki mevcut işlem hatlarını nasıl yönetebileceğiniz açıklanır:

Not

Azure DevOps CLI uzantısı yalnızca Azure DevOps Services için kullanılabilir ve Azure DevOps Server'ın herhangi bir sürümünü desteklemez.

Azure DevOps CLI uzantısı

az-pipelines Komut grubu, Azure CLI sürüm 2.30.0 veya üzerini gerektiren Azure CLI'nın DevOps uzantısının bir parçasıdır. Azure DevOps uzantısı, bir azure pipelines komutu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Kullanmaya başlama hakkında daha fazla bilgi için bkz . Azure DevOps CLI'yı kullanmaya başlama.

Azure DevOps CLI komutlarınızda , help, , only-show-errors, outputquery, ve verbosegibi debuggenel Azure CLI parametrelerini de kullanabilirsiniz. Genel table parametrenin --output değeri, çıkışı kolay bir biçimde sunar. Daha fazla bilgi için bkz . Azure CLI komutları için çıkış biçimleri.

kullanarak az devops configure --defaults organization=<YourOrganizationURL>Azure DevOps CLI komutları için varsayılan Azure DevOps kuruluşunu ayarlayabilir veya parametresini --detect true kullanarak kuruluşu otomatik olarak algılayabilirsiniz. kullanarak varsayılan Azure DevOps projesini az devops configure -d project=<Project Name or ID>yapılandırabilirsiniz.

Kuruluşu algılamazsanız veya varsayılan bir kuruluş veya proje yapılandırmazsanız ya da aracılığıyla git configkuruluşu ve projeyi almazsanız, her komutta org ve project parametrelerini belirtmeniz gerekir.

Mevcut işlem hatlarını listeleme

, , ve işlem hattı komutları, yönetmek istediğiniz veya id işlem hattını gerektirirname.delete updateshowrun kullanıyorsanız idname parametresi yoksayılır. Kimlikleri de dahil olmak üzere proje işlem hatlarının listesini almak için az pipelines list komutunu kullanın. Parametreleri kullanarak sonuç listesini filtreleyebilir veya biçimlendirebilirsiniz.

Örneğin, aşağıdaki komut, ile python*başlayan adları olan proje işlem hatlarını tablo biçiminde listeler.

az pipelines list --name python* --output table

Çıktı:

ID    Path    Name                        Status    Default Queue
----  ------  --------------------------  --------  ---------------
17    \       python-sample-vscode-flask  disabled  Azure Pipelines
24    \       python-sample-get-started   enabled   Azure Pipelines

Tam komut başvurusu için bkz . az pipelines list.

İşlem hattı ayrıntılarını gösterme

Mevcut işlem hattının ayrıntılarını görüntülemek için az pipelines show komutunu kullanın. Örneğin, aşağıdaki komut ile işlem ID 12hattının ayrıntılarını gösterir ve işlem hattı özet sayfasını web tarayıcınızda açar.

az pipelines show --id 12 --open

Tam komut başvurusu için bkz . az pipelines show.

İşlem hattı çalıştırma

Mevcut bir işlem hattını kuyruğa almak ve çalıştırmak için az pipelines run komutunu kullanın. ve öğesini çalıştırmada kullanacak şekilde ayarlayabilirsiniz parameters variables .

Örneğin, aşağıdaki komut dalda pipeline ile işlem myGithubname.pipelines-java name hattını çalıştırır, çalıştırma için değişkenin var1 100 değerini olarak ayarlar ve sonuçları table biçiminde verir.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --variables var1=100 --output table

Çıktı:

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

Tam komut başvurusu için bkz . az pipelines run.

İşlem hattını güncelleştirme

Mevcut bir işlem hattını güncelleştirmek için az pipelines update komutunu kullanın. Örneğin, aşağıdaki komut işlem hattını ile yeni bir ad ve açıklamayla id 12 güncelleştirir ve sonucu tablo biçiminde döndürür.

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

Çıktı:

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

Tam komut başvurusu için bkz . az pipelines update.

İşlem hattını silme

İşlem hattını silmek için az-pipelines-delete komutunu çalıştırın. Örneğin, aşağıdaki komut kimliğine 12sahip işlem hattını siler ve onay istemez. parametresini --yes eklemezseniz, komut varsayılan olarak onay ister.

az pipelines delete --id 12 --yes

Tam komut başvurusu için bkz . az pipelines delete.

İşlem hatlarını program aracılığıyla oluşturma ve yapılandırma

Azure DevOps CLI kullanarak YAML işlem hattı oluşturmak için bkz . az pipelines create. YAML işlem hatlarında Azure CLI komutlarını çalıştırmak için bkz . Azure Pipelines YAML'de Azure DevOps CLI.

Uygulamaları istediğiniz dilde derlemek, yapılandırmak, test etmek ve dağıtmak için YAML işlem hatları oluşturabilirsiniz. Daha fazla bilgi için aşağıdaki makaleleri inceleyin:

Azure DevOps Services REST API

Doğrudan HTTP çağrıları yapmak için REST API'lerini kullanarak Azure DevOps ile tümleşen özel uygulamalar veya hizmetler oluşturabilirsiniz. Daha fazla bilgi için bkz . Azure DevOps Services REST API Başvurusu. Bu API'ler için istemci kitaplıklarını da kullanabilirsiniz.

İşlem hattı çalıştırmasında aşamayı atlama

parametresini kullanarak işlem hattı çalıştırmasındaki bir aşamayı atlamak için İşlem Hattı REST API'sini stagesToSkip Çalıştır ile az rest komutunu kullanabilirsiniz.

Örneğin:

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

Daha fazla bilgi için bkz . Azure CLI ile Azure REST API'sini kullanma.

İlgili içerik