Azure Pipelines için YAML şema başvurusu

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ını 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örevleri dizini.

Tanımlar

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

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

İşleri
Bir aşamanı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 stratejisini .

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

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

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

jobs.job
İş, bir aracı veya sunucuda çalıştırılan adım koleksiyonudur.

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

jobs.job.strategy
bu iş için Yürütme stratejisini .

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.

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

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

havuz
İşlem hattının bir işi için hangi havuzun kullanılacağını .

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

Pr
Çekme isteği tetikleyicisi .

kaynakları
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
Bir çalıştırmayı tetikleme için dahil etmek veya dışlamak üzere 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ını
web kancalarının listesini .

resources.webhooks.web kancası
Web kancası kaynağı, iş akışını otomatikleştirmek için işlem hattınızı bir dış hizmetle tümleştirmenizi sağlar.

resources.webhooks.webhook.filters
tetikleyici filtreleri listesini .

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

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

schedules.cron
Zamanlanmış tetikleyici, dalların oluşturulduğu zamanlamayı belirtir.

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

stage.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ımları
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 kodu nasıl kullanıma aldırmış olduğunu yapılandırın.

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

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

steps.getPackage
Azure Artifacts veya Azure DevOps Server'daki 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, 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
Görev çalıştırır.

steps.template
Bir dosyada bir dizi adım tanımlayın ve bunu 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
Hangi değişkenlerin ayarlanabileceğine ilişkin kısıtlamalar.

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

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

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

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

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

Destekleyici tanımlar

Uyarı

Destekleyici 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.

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

includeExcludeFilters
Eklenecek veya hariç tutulacak öğe listeleri.

includeExcludeStringFilters
Eklenecek veya dışlanan öğeleri .

mountReadOnly
Birimleri salt okunur olarak bağlamak 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 trafik sağlayan adımları çalıştırmak için kullanılır.

çalışma alanı
Aracıda Çalışma Alanı seçeneklerini .

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.

• : solunda işlem hattı tanımlarında kullanılan değişmez bir anahtar sözcük bulunur.
• :'ın sağında 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.
• [ veri türü] gösterimi, belirtilen tanım türünün bir dizisini gösterir. Örneğin, [ string ] bir dize dizisidir.
• { gösterimi, veri türü:veri türünü} veri türüne eşler. Örneğin, { string: string } dizeleri dizelere eşlemedir.
• sembol | 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 anlamına gelir.

Ayrıca bkz.

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