Azure Pipelines için YAML şema başvurusu

  • Makale

Azure Pipelines için YAML şema başvurusu, desteklenen tüm YAML söz dizimini ve bunların kullanılabilir seçeneklerini listeleyen YAML işlem hatları için ayrıntılı bir başvurudur.

YAML işlem hattı oluşturmak için işlem hattı tanımıyla başlayın. YAML işlem hatları oluşturma hakkında daha fazla bilgi için bkz. İşlem hattınızı özelleştirme.

YAML şema başvurusu görevleri kapsamaz. Görevler hakkında daha fazla bilgi için bkz. Azure Pipelines görevler dizini.

Tanımlar

Boru hattı
İşlem hattı, CI/CD işlemini açıklayan bir veya daha fazla aşamadır. İşlem hattı tanımı, gibi namekök düzeyi özelliklerine yönelik belgeleri içerir.

Boru hattı
İşlem hattı, CI/CD işlemini açıklayan bir veya daha fazla iştir.

Genişletir
Şablon kullanarak işlem hattını genişletir.

Işleri
Bir aşamanın çalışmasını oluşturan işleri belirtir.

Işleri
İşlem hattının çalışmasını oluşturan işleri belirtir.

jobs.deployment
Dağıtım işi özel bir iş türüdür. Bu, ortama karşı sıralı olarak çalıştırılacak adımlardan oluşan bir koleksiyondur.

jobs.deployment.environment
Hedef ortam adı ve isteğe bağlı olarak dağıtım geçmişini kaydetmek için bir kaynak adı; format: environment-name.resource-name.

jobs.deployment.strategy
Bu dağıtım için yürütme stratejisi.

jobs.deployment.strategy.canary
Kanarya Dağıtım stratejisi.

jobs.deployment.strategy.rolling
Sıralı Dağıtım stratejisi.

jobs.deployment.strategy.runOnce
RunOnce Dağıtım stratejisi.

jobs.job
İş, bir aracı veya sunucuda çalıştırılan adımlardan oluşan bir koleksiyondur.

jobs.job.container
Kapsayıcı kaynak adı.

jobs.job.strategy
Bu iş için yürütme stratejisi.

jobs.job.uses
Bu işin gerektirdiği ve henüz başvurulmayan tüm kaynaklar.

jobs.template
Şablonda tanımlanan bir iş kümesi.

Parametre
İşlem hattına geçirilen çalışma zamanı parametrelerini belirtir.

parameters.parameter
İşlem hattı şablonu parametreleri.

Havuzu
İşlem hattının işi için kullanılacak havuz.

pool.demands
Talepler (özel havuz için).

pr
Çekme isteği tetikleyicisi.

Kaynak
Kaynaklar derlemeleri, depoları, işlem hatlarını ve işlem hattı tarafından kullanılan diğer kaynakları belirtir.

resources.builds
İşlem hattı tarafından başvuruda bulunan derleme kaynaklarının listesi.

resources.builds.build
Bir çalıştırmadan yapıtlara başvurmak için kullanılan derleme kaynağı.

resources.containers
Kapsayıcı görüntülerinin listesi.

resources.containers.container
Kapsayıcı görüntüsüne başvurmak için kullanılan kapsayıcı kaynağı.

resources.containers.container.trigger
Devre dışı bırakılacak yok, tüm görüntü etiketlerinde tetiklenen true değerini belirtin veya aşağıdaki örneklerde açıklandığı gibi tam söz dizimini kullanın.

resources.packages
Paket kaynaklarının listesi.

resources.packages.package
NuGet veya npm GitHub paketine başvurmak için kullanılan paket kaynağı.

resources.pipelines
İşlem hattı kaynaklarının listesi.

resources.pipelines.pipeline
İşlem hattı kaynağı.

resources.pipelines.pipeline.trigger
Devre dışı bırakılacak yok, tüm dalları eklemek için true belirtin veya aşağıdaki örneklerde açıklandığı gibi tam söz dizimini kullanın.

resources.pipelines.pipeline.trigger.branches
Çalıştırmayı tetikleme amacıyla dahil etmek veya dışlamak için dallar.

resources.repositories
Depo kaynaklarının listesi.

resources.repositories.repository
İşlem hattınızdaki ek bir depoya başvurmak için bir depo kaynağı kullanılır.

resources.web kancaları
Web kancalarının listesi.

resources.webhooks.web kancası
Web kancası kaynağı, iş akışını otomatikleştirmek için işlem hattınızı bir dış hizmetle tümleştirmenize olanak tanır.

resources.webhooks.webhook.filters
Tetikleyici filtreleri listesi.

resources.webhooks.webhook.filters.filter
Web kancası kaynak tetikleyici filtresi.

Zamanlama
Zamanlamalar listesi, işlem hattı için zamanlanmış tetikleyicileri belirtir.

schedules.cron
Zamanlanmış tetikleyici, dalların derlendiği bir zamanlamayı belirtir.

Aşama
Aşamalar, ilgili işlerden oluşan bir koleksiyon.

stages.stage
Aşama, ilgili işlerden oluşan bir koleksiyondur.

stages.template
Bir dosyada bir dizi aşama tanımlayabilir ve bunu diğer dosyalarda birden çok kez kullanabilirsiniz.

Adım -ları
Adımlar, işi oluşturan doğrusal bir işlem dizisidir.

steps.bash
Windows, macOS ve Linux üzerinde Bash'te bir betik çalıştırır.

steps.checkout
İşlem hattının kaynak kodunu nasıl kullanıma aldırıp aldırıp aldırmaygını yapılandırın.

steps.download
Geçerli çalıştırmayla veya işlem hattı kaynağıyla ilişkili başka bir Azure İşlem Hattı'ndan ilişkili yapıtları indirir.

steps.downloadBuild
derleme yapıtlarını indirir.

steps.getPackage
Azure Artifacts veya Azure DevOps Server paket yönetimi akışından paket indirir.

steps.powershell
Windows PowerShell (Windows üzerinde) veya pwsh (Linux ve macOS) kullanarak bir betik çalıştırır.

steps.publish
Bir dosya veya klasörü diğer işlerin ve işlem hatlarının kullanabileceği bir işlem hattı yapıtı olarak yayımlar (karşıya yükler).

steps.pwsh
Windows, macOS ve Linux üzerinde PowerShell Core'da bir betik çalıştırır.

steps.reviewApp
İndirmeler, bir dağıtım aşaması sağlayıcısı altında dinamik olarak bir kaynak oluşturur.

steps.script
Windows'da cmd.exe ve diğer platformlarda Bash kullanarak bir betik çalıştırır.

steps.task
Bir görev çalıştırır.

steps.template
Bir dosyada bir dizi adımı tanımlayın ve başka bir dosyada birden çok kez kullanın.

Hedef
Görevler, aracı konağı veya kapsayıcı olan bir yürütme bağlamında çalışır.

target.settableVariables
Ayarlanabilecek değişkenlerle ilgili kısıtlamalar.

Tetikleyici
Sürekli tümleştirme (gönderme) tetikleyicisi.

Değişken
Ad/değer çiftlerini kullanarak değişkenleri tanımlayın.

variables.group
Değişken grubundan değişkenlere başvuru.

variables.name
Ad ve tam söz dizimini kullanarak değişkenleri tanımlayın.

variables.template
Şablonda değişkenleri tanımlama.

Destekleyici tanımlar

Not

Destek tanımları doğrudan bir işlem hattında kullanılmak üzere tasarlanmamıştır. Destekleyici tanımlar yalnızca diğer tanımların bir parçası olarak kullanılır ve başvuru için buraya eklenir.

deployHook
Uygulamanızı dağıtan adımları çalıştırmak için kullanılır.

includeExcludeFilters
Dahil etmek veya dışlamak için öğelerin listesi.

includeExcludeStringFilters
Dahil etmek veya dışlamak için öğeler.

mountReadOnly
Salt okunur olarak bağlanacak birimler için varsayılan değer false'tur.

onFailureHook
Geri alma eylemleri veya temizleme adımlarını çalıştırmak için kullanılır.

onSuccessHook
Geri alma eylemleri veya temizleme adımlarını çalıştırmak için kullanılır.

onSuccessOrFailureHook
Geri alma eylemleri veya temizleme adımlarını çalıştırmak için kullanılır.

postRouteTrafficHook
Trafik yönlendirildikten sonra adımları çalıştırmak için kullanılır. Bu görevler genellikle tanımlı aralık için güncelleştirilmiş sürümün durumunu izler.

preDeployHook
Uygulama dağıtımı başlamadan önce kaynakları başlatan adımları çalıştırmak için kullanılır.

routeTrafficHook
Güncelleştirilmiş sürüme gelen trafiğe hizmet eden adımları çalıştırmak için kullanılır.

Çalışma alanı
Aracıdaki çalışma alanı seçenekleri.

YAML şema belgeleri kuralları

YAML şema başvurusu, Azure Pipelines YAML işlem hatlarına yönelik ayrıntılı bir başvuru kılavuzudur. Desteklenen tüm YAML özelliklerinin ve kullanılabilir seçeneklerin bir kataloğunu içerir.

YAML şema başvurusunda kullanılan söz dizimi kuralları aşağıdadır.

  • sol : tarafta işlem hattı tanımlarında kullanılan bir değişmez anahtar sözcüktür.
  • Sağ : tarafta bir veri türü bulunur. Veri türü dize gibi ilkel bir tür veya bu başvurunun başka bir yerinde tanımlanan zengin bir yapıya başvuru olabilir.
  • Gösterimi [veri türü] , belirtilen tanım türünde bir diziyi gösterir. Örneğin, [ string ] bir dize dizisidir.
  • Gösterimi {veri türü:veri türü} , bir veri türünün başka bir veri türüyle eşlediğini gösterir. Örneğin, { string: string } dizelerin dizelerle eşlemini gösterir.
  • simgesi | , anahtar sözcük için birden çok veri türü olduğunu gösterir. Örneğin, job | template bir iş tanımına veya şablon başvurusuna izin verilir.

Ayrıca bkz.

Bu başvuru, Azure Pipelines YAML dosyasının şemasını kapsar. YAML'nin temellerini öğrenmek için bkz. Y Dakika içinde YAML'yi Öğrenme. Azure Pipelines tüm YAML özelliklerini desteklemez. Desteklenmeyen özellikler arasında yer işaretleri, karmaşık tuşlar ve kümeler bulunur. Ayrıca Azure Pipelines, standart YAML'nin aksine , job, taskveya gibi bir görev kısayolunu script eşlemedeki ilk anahtar olarak görmeye stagebağlıdır.