Share via

Azure CLI ile işlem hattınızı yönetme

  • Makale

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

Kuruluşunuzdaki işlem hatlarını şu az pipelines komutları kullanarak yönetebilirsiniz:

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ğı commit-id.
  • 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ı.
  • aç: web tarayıcınızda işlem hattı sonuçları sayfasını açın.
  • org: Azure DevOps kuruluş URL'si. kullanarak varsayılan kuruluşu az devops configure -d organization=ORG_URLyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalınmadıysa gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_IDyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalınmadıysa gereklidir.
  • variables: Ayarlamak istediğiniz değişkenler için "name=value" çiftlerini ayırarak boşluk bırakın.

Ö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ıldığı 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ı.
  • org: Azure DevOps kuruluş URL'si. kullanarak varsayılan kuruluşu az devops configure -d organization=ORG_URLyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalınmadıysa gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_IDyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalı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 arasında debug, , helponly-show-errors, query, outputve verbosebulunur.

İpucu

Gibi kullanabileceğiniz --outputgenel 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.
  • org: Azure DevOps kuruluş URL'si. kullanarak varsayılan kuruluşu az devops configure -d organization=ORG_URLyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalınmadıysa gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_IDyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya kullanılarak git configalınmadıysa gereklidir.
  • sorgu örnekleri: Sizin için bir JMESPath dizesi önerin.
  • subscription: Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak az account set -s NAME_OR_IDyapı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'yi kullanarak komut satırından veya betiklerden derlemeleri ve derleme işlem hatlarını da yönetebilirsiniz.

Tek bir komut kullanarak Azure DevOps Services'de 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.