Azure CLI ile işlem hattınızı yönetme
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
Kuruluşunuzdaki işlem hatlarını şu az pipelines
komutları kullanarak yönetebilirsiniz:
- az pipelines run: Mevcut bir işlem hattını çalıştırma
- az pipelines update: Mevcut işlem hattını güncelleştirme
- az pipelines show: Mevcut işlem hattının ayrıntılarını gösterme
Bu komutlar, yönetmek istediğiniz işlem hattının adını veya kimliğini gerektirir. az pipelines list komutunu kullanarak işlem hattının kimliğini alabilirsiniz.
Başlamak için bkz . Azure DevOps CLI ile çalışmaya başlama.
İşlem hattı çalıştırma
az pipelines run komutuyla mevcut bir işlem hattını kuyruğa alabilir (çalıştırabilirsiniz ).
az pipelines run [--branch]
[--commit-id]
[--folder-path]
[--id]
[--name]
[--open]
[--org]
[--project]
[--variables]
Parametreler
- branch: İşlem hattı çalıştırmasının kuyruğa alınacağı dalın adı(örneğin, refs/heads/main).
- commit-id: İşlem hattı çalıştırmasının kuyruğa alınacağı işleme kimliği.
- folder-path: İşlem hattının klasör yolu. Varsayılan, kök düzeyi klasörüdür.
- id: Ad sağlanmazsa gereklidir. Kuyruğa alınacak işlem hattının kimliği.
- name: Kimlik sağlanmazsa gereklidir, ancak kimlik sağlandığında yoksayılır. Kuyruğa alınacak işlem hattının adı.
- open: İşlem hattı sonuçları sayfasını web tarayıcınızda açın.
- kuruluş: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URL
varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/
. - project: Projenin adı veya kimliği. kullanarak varsayılan projeyi
az devops configure -d project=NAME_OR_ID
yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. - değişkenler: Ayarlamak istediğiniz değişkenler için boşlukla ayrılmış "name=value" çiftleri.
Örnek
Aşağıdaki komut, dal işlem hattında myGithubname.pipelines-java adlı işlem hattını çalıştırır ve sonucu tablo biçiminde gösterir.
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
İşlem hattını güncelleştirme
Mevcut bir işlem hattını az pipelines update komutuyla güncelleştirebilirsiniz . Başlamak için bkz . Azure DevOps CLI ile çalışmaya başlama.
az pipelines update [--branch]
[--description]
[--id]
[--name]
[--new-folder-path]
[--new-name]
[--org]
[--project]
[--queue-id]
[--yaml-path]
Parametreler
- branch: İşlem hattı çalıştırmasının yapılandırılacağı dalın adı(örneğin, refs/heads/main).
- description: İşlem hattı için yeni açıklama.
- id: Ad sağlanmazsa gereklidir. Güncelleştirilecek işlem hattının kimliği.
- name: Kimlik sağlanmazsa gereklidir. Güncelleştirilecek işlem hattının adı.
- new-folder-path: İşlem hattının taşındığı klasörün yeni tam yolu, örneğin, kullanıcı1/production_pipelines.
- new-name: İşlem hattının yeni güncelleştirilmiş adı.
- kuruluş: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URL
varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/
. - project: Projenin adı veya kimliği. kullanarak varsayılan projeyi
az devops configure -d project=NAME_OR_ID
yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. - queue-id: İşlem hattının çalıştırılması gereken aracı havuzunun kuyruk kimliği.
- yaml-path: depodaki işlem hattının yaml dosyasının yolu.
Genel parametreler , , help
, only-show-errors
, query
, output
ve verbose
parametrelerini içerirdebug
.
İpucu
Gibi kullanabileceğiniz --output
genel parametreler de vardır.
--output
parametresi tüm komutlar için kullanılabilir. Tablo değeri, çıkışı kolay bir biçimde sunar. Daha fazla bilgi için bkz . Azure CLI komutları için çıkış biçimleri.
Örnek
Aşağıdaki komut işlem hattını 12 kimliğiyle yeni bir ad ve açıklamayla güncelleştirir ve sonucu tablo biçiminde gösterir.
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
İşlem hattını göster
az pipelines show komutuyla mevcut işlem hattının ayrıntılarını görüntüleyebilirsiniz. Başlamak için bkz . Azure DevOps CLI ile çalışmaya başlama.
az pipelines show [--folder-path]
[--id]
[--name]
[--open]
[--org]
[--project]
[--query-examples]
[--subscription]
Parametreler
- folder-path: İşlem hattının klasör yolu. Varsayılan, kök düzeyi klasörüdür.
- id: Ad sağlanmazsa gereklidir. Ayrıntıları göstermek için işlem hattının kimliği.
- name: Ad sağlanmazsa gereklidir, ancak kimlik sağlandığında yoksayılır. Ayrıntıları göstermek için işlem hattının adı.
- open: web tarayıcınızda işlem hattı özet sayfasını açın.
- kuruluş: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URL
varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/
. - project: Projenin adı veya kimliği. kullanarak varsayılan projeyi
az devops configure -d project=NAME_OR_ID
yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit config
alınmadıysa gereklidir. - sorgu örnekleri: Sizin için bir JMESPath dizesi önerin.
- subscription: Aboneliğin adı veya kimliği. kullanarak
az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Örnek
Aşağıdaki komut, 12 kimliğine sahip işlem hattının ayrıntılarını gösterir ve sonucu tablo biçiminde döndürür.
az pipelines show --id 12 --output table
ID Name Status Default Queue
---- -------------------------- -------- ------------------
12 updatedname.pipelines-java enabled Hosted Ubuntu 1604
Sonraki adımlar
İşlem hattınızı özelleştirebilir veya işlem hatlarını istediğiniz dilde yapılandırma hakkında daha fazla bilgi edinebilirsiniz:
SSS
Program aracılığıyla derleme işlem hattı Nasıl yaparım??
REST API Başvurusu: Derleme işlem hattı oluşturma
Not
Azure Pipelines CLI kullanarak komut satırından veya betiklerden derlemeleri ve derleme işlem hatlarını da yönetebilirsiniz.
Azure DevOps Services'da tek bir komut kullanarak birden çok işlem hattı çalıştırabilir miyim?
Şu anda Azure CLI ve Azure API'leri komut satırından birden çok işlem hattı çalıştıran komutlar sunmamaktadır. Tüm işlem hatlarını ve tanımları listelemek ve parametre olarak tek bir sürüm veya derleme kimliği sağlamak için Azure CLI komutlarını kullanabilirsiniz. Tüm komutlar bağımsız işlem hatlarının bağımsız çalıştırmaları için çalışacak şekilde tasarlanmıştır ve yalnızca bir benzersiz değere izin veren benzersiz kimlik istekleri gerektirir. İşlem hattı tetikleyicileri hakkında bilgi edinmek için bkz . İşlem hatlarını tetikleyen olayları belirtme.
İşlem hattı çalıştırmasında bir aşamayı atlamak Nasıl yaparım??
komutunu kullanarak az rest
Azure DevOps REST API'sini run pipeline
kullanarak parametresini kullanarak işlem hattı çalıştırmasındaki bir aşamayı stagesToSkip
atlayabilirsiniz.
Ö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 DevOps Services REST API Başvurusu.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin