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

  • Makale
  • Okumak için 4 dakika

Şu komutları kullanarak, kuruluşta işlem hatlarını az pipelines 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 eldeebilirsiniz.

Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

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

az pipelines run komutuyla var olan bir işlem hattını kuyruğa alabilirsiniz (çalıştırabilirsiniz).

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

Parametreler

  • branch:İşlem hattı çalıştırması kuyruğa alınan dalın adı, örneğin refs/heads/main.
  • commit-id:İşlem hattı çalıştırması kuyruğa alınan commit-id.
  • folder-path:İşlem hattının klasör yolu. Varsayılan, kök düzey klasörüdür.
  • id:Ad sağlanmadı ise gereklidir. Kuyruğa alınan işlem hattının kimliği.
  • name:Kimlik sağlanmadı ise gereklidir, ancak kimlik sağlanırsa yoksayılır. Kuyruğa alınan işlem hattının adı.
  • open:İşlem hattı sonuçları sayfasını web tarayıcınızda açın.
  • org:Azure DevOps URL'si. Varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config 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_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • variables: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 işlem hattını az pipelines update komutuyla güncelleştirebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

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ı yapılandırılan dalın adı, örneğin refs/heads/main.
  • description:İşlem hattı için yeni açıklama.
  • id:Ad sağlanmadı ise gereklidir. Güncelleştirilen işlem hattının kimliği.
  • name:Kimlik sağlanmadı ise gereklidir. Güncelleştirilen işlem hattının adı.
  • new-folder-path:İşlem hattının taşındığı klasörün yeni tam yolu, örneğin, user1/production_pipelines.
  • new-name:İşlem hattının yeni güncelleştirilmiş adı.
  • org:Azure DevOps URL'si. Varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config 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_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • queue-id:İşlem hattının çalışması gereken aracı havuzunun kuyruk kimliği.
  • yaml-path:Depoda işlem hattının yaml dosyasının yolu.

Genel parametreler , debug , , , ve helponly-show-errorsqueryoutputverbose parametreleridir.

İpucu

Ayrıca gibi genel parametreler de --output kullanabilirsiniz. parametresi --output 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üebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

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üzey klasörüdür.
  • id:Ad sağlanmadı ise gereklidir. Ayrıntıları göstermek için işlem hattının kimliği.
  • name:Ad sağlanmadı ise gereklidir, ancak kimlik sağlanırsa yoksayılır. Ayrıntıları göstermek için işlem hattının adı.
  • open:İşlem hattı özet sayfasını web tarayıcınızda açın.
  • org:Azure DevOps URL'si. Varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config 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_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • sorgu örnekleri:Sizin için bir JMESPath dizesi önerin.
  • subscription:Aboneliğin adı veya kimliği. Varsayılan aboneliği kullanarak az account set -s NAME_OR_ID 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ştirebilirsiniz veya işlem hatlarını istediğiniz dilde yapılandırma hakkında daha fazla bilgi edinmek için:

SSS

Nasıl yaparım? işlem hattı mı oluşturabilirsiniz?

REST API Başvurusu: Derleme işlem hattı oluşturma

Not

Derlemeleri ve derleme işlem hatlarını komut satırı veya betiklerden yönetmek için Azure Pipelines CLI'Azure Pipelines.

Tek bir komut kullanarak birden çok Azure DevOps Services işlem hattı çalıştırabilirsiniz?

Şu anda Azure CLI ve Azure API'leri, komut satırlarından birden çok işlem hattı çalıştıran komutlar sunmaz. Tüm işlem hatlarını ve tanımları listelenin ve parametre olarak tek bir yayın veya derleme kimliği sağlamak için Azure CLI komutlarını kullanabilirsiniz. Tüm komutlar bağımsız işlem hatlarından bağımsız olarak ç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. işlem hatlarını tetikleyen olayları belirtme.