Aracılığıyla paylaş

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

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 , debug, , help, only-show-errorsquery, ve outputgibi verbosegenel Azure CLI parametrelerini de kullanabilirsiniz. Küresel table parametrenin --output değeri, çıkışı kullanıcı dostu bir formatta 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 tespit edemezseniz, varsayılan bir kuruluş veya proje yapılandırmazsanız ya da git config aracılığıyla kuruluşu ve projeyi almazsanız, her komutta org ve project parametrelerini belirtmeniz gerekir.

Mevcut işlem hatlarını listele

run, show, update ve delete işlem hattı komutları, yönetmek istediğiniz işlem hattının ya name ya da id değerini gerektirir. Eğer id kullanırsanız, name parametresi yoksayılır. Proje işlem hatlarının kimlikleri ile birlikte 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 az pipelines list bölümüne bakın.

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

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, ID içindeki 12 işlem hattının ayrıntılarını gösterir ve işlem hattının ö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ını çalıştır

Mevcut bir işlem hattını kuyruğa almak ve çalıştırmak için az pipelines run komutunu kullanın. parameters ve variables çalıştırma esnasında kullanılacak şekilde ayarlayabilirsiniz.

Örneğin, aşağıdaki komut, pipeline dalında name ve myGithubname.pipelines-java kullanarak hattı çalıştırır, çalıştırma için değişken var1'ün değerini 100 olarak ayarlar ve sonuçları table formatında 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 referansı için bkz. az pipelines run.

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

Mevcut bir işlem hattını güncellemek için az pipelines update komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut, id ve 12'yi yeni bir ad ve açıklama ekleyerek günceller 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 referansı için bkz az pipelines update.

Bir işlem hattını sil

İş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

Komutların tam listesi için bkz az pipelines delete.

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

Azure DevOps CLI kullanarak bir YAML işlem hattı oluşturmak için az pipelines create komutuna bakın. 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ırma sırasında bir aşamayı atla

parametresini kullanarak işlem hattı çalıştırmasındaki bir aşamayı atlamak için az rest komutunu, İşlem Hattı Çalıştır REST API ile 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