Önceden tanımlanmış değişken kullanma

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Değişkenler, ardışık düzenin çeşitli bölümlerine anahtar bitleri almak için kullanışlı bir yol sunar. Bu, kullanımınıza sunulan önceden tanımlanmış değişkenlerin listesidir. Önceden tanımlanmış birkaç değişken daha olabilir, ancak bunlar çoğunlukla iç kullanım içindir.

Bu değişkenler sistem tarafından otomatik olarak ayarlanır ve salt okunur olarak ayarlanır. (Özel durumlar Build.Clean ve System.Debug'tır.)

YAML işlem hatlarında, önceden tanımlanmış değişkenlere ortam değişkenleri olarak başvurabilirsiniz. Örneğin, değişkeni Build.ArtifactStagingDirectory değişkeni BUILD_ARTIFACTSTAGINGDIRECTORYolur.

Klasik işlem hatlarında, yaygın bilgileri (örneğin, Ortam Adı, Kaynak Grubu vb.) paylaşmak için dağıtım görevlerinizde yayın değişkenlerini kullanabilirsiniz.

Değişkenlerle çalışma hakkında daha fazla bilgi edinin.

İpucu

Copilot'dan değişkenlerle ilgili yardım isteyebilirsiniz. Daha fazla bilgi edinmek için bkz. Copilot'adeğişken değerlerine dayalı bir koşula sahip bir aşama oluşturmasını isteyin.

Build.Clean

Bu, derleme aracısının kaynağı temizleme biçimini değiştiren kullanım dışı bir değişkendir. Kaynağı temizlemeyi öğrenmek için bkz . Aracıdaki yerel depoyu temizleme.

System.AccessToken

System.AccessToken , çalışan derleme tarafından kullanılan güvenlik belirtecini taşıyan özel bir değişkendir.

YAML

YAML'de, bir değişken kullanarak işlem hattına açıkça eşlemeniz System.AccessToken gerekir. Bunu adım veya görev düzeyinde yapabilirsiniz. Örneğin, kapsayıcı kayıt defteriyle kimlik doğrulaması yapmak için System.AccessToken kullanabilirsiniz.

steps:
- task: Docker@2
  inputs:
    command: login
    containerRegistry: '<docker connection>'
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Derleme işi yetkilendirme kapsamını kullanmak için System.AccessToken varsayılan kapsamı yapılandırabilirsiniz.

Klasik

Betiklerin ve görevlerin System.AccessToken'a iş düzeyinde erişmesine izin vekleyebilirsiniz.

1. İşe gitme

2. Ek seçenekler'in altında, Betiklerin OAuth belirtecine erişmesine izin ver kutusunu işaretleyin.

Bu kutu işaretlenirken, betiklerinizde gönderme ve çekme işlemleri çalıştırabilmeniz için Git'te kimlik bilgisi kümesi de kalır.

System.Debug

İşlem hattı sorunlarının hatalarını ayıklamak için daha ayrıntılı günlükler için öğesini tanımlayın System.Debug ve olarak trueayarlayın.

1. İşlem hattınızı düzenleyin.

2. Değişkenler'i seçin.

3. adı System.Debug ve değeriyle trueyeni bir değişken ekleyin.

   

4. Yeni değişkeni kaydedin.

ayarı System.Debugtrue , tüm çalıştırmalar için ayrıntılı günlükleri yapılandırıyor. Ayrıca, Sistem tanılamasını etkinleştir onay kutusuyla tek bir çalıştırma için ayrıntılı günlükleri yapılandırabilirsiniz.

İşlem hattında veya şablonda değişken olarak da ayarlayabilirsiniz System.Debugtrue .

variables:
  system.debug: 'true'

System.Debug olarak ayarlandığında trueadlı Agent.Diagnostic ek bir değişken olarak ayarlanırtrue. olduğunda Agent.Diagnostictruearacı, şirket içinde barındırılan aracıların ağ sorunlarını gidermek için kullanılabilecek daha fazla günlük toplar. Daha fazla bilgi için bkz. Şirket içi barındırılan aracılar için ağ tanılaması.

Not

Agent.Diagnostic değişkeni Agent v2.200.0 ve üzeri sürümlerde kullanılabilir.

Daha fazla bilgi için bkz . İşlem hattı sorunlarını tanılamak için günlükleri gözden geçirme.

Aracı değişkenleri (DevOps Services)

Not

Aracı değişkenlerini betiklerinizde ortam değişkenleri olarak ve derleme görevlerinizde parametre olarak kullanabilirsiniz. Derleme numarasını özelleştirmek veya bir sürüm denetimi etiketi veya etiketi uygulamak için bunları kullanamazsınız.

Değişken	Açıklama
Agent.BuildDirectory	Belirli bir derleme işlem hattı için tüm klasörlerin oluşturulduğu aracıdaki yerel yol. Bu değişken ile aynı değere Pipeline.Workspacesahiptir. Örneğin: /home/vsts/work/1. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı.
Agent.ContainerMapping	YAML'deki kapsayıcı kaynak adlarından çalışma zamanında Docker kimliklerine eşleme. Örnek, tabloyu izler.
Agent.HomeDirectory	Aracının yüklendiği dizin. Bu değişken aracı yazılımını içerir. Örneğin: c:\agent. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı.
Agent.Id	Aracının kimliği.
Agent.JobName	Çalışan işin adı. Bu ad genellikle Job; veya __defaultşeklindedir, ancak çok yapılandırmalı senaryolarda yapılandırmadır.
Agent.JobStatus	Derlemenin durumu. Canceled Failed Succeeded SucceededWithIssues (kısmen başarılı) Skipped (son iş) Ortam değişkenine olarak AGENT_JOBSTATUSbaşvurulmalıdır. Eski agent.jobstatus , geriye dönük uyumluluk için kullanılabilir.
Agent.MachineName	Aracının yüklü olduğu makinenin adı.
Agent.Name	Havuza kayıtlı aracının adı. Şirket içinde barındırılan bir aracı kullanıyorsanız, adı belirtirsiniz. Bkz. aracılar.
Agent.OS	Aracı ana bilgisayarının işletim sistemi. Geçerli değerler: Windows_NT Darwin Linux Bir kapsayıcıda çalıştırıyorsanız aracı ana bilgisayarı ve kapsayıcısı farklı işletim sistemleri çalıştırabilir.
Agent.OSArchitecture	Aracı konağın işletim sistemi işlemci mimarisi. Geçerli değerler: X86 X64 ARM
Agent.TempDirectory	Her işlem hattı işinden sonra temizlenen geçici bir klasör. Bu dizin, yayımlanmadan önce test sonuçları gibi geçici öğeleri tutmak için .NET Core CLI görevi gibi görevler tarafından kullanılır. Örneğin: /home/vsts/work/_temp Ubuntu için.
Agent.ToolsDirectory	Bir aracın birden çok sürümü arasında geçiş yapmak için Düğüm Aracı Yükleyicisi ve Python Sürümünü Kullanma gibi görevler tarafından kullanılan dizin. Bu görevler, sonraki derleme adımlarının kullanabilmesi için bu dizinden 'a PATH araçlar ekler. Şirket içinde barındırılan bir aracıda bu dizini yönetme hakkında bilgi edinin.
Agent.WorkFolder	Bu aracı için çalışma dizini. Örneğin: c:\agent_work. Not: Bu dizinin işlem hattı görevleri (örneğin, bir kapsayıcıya eşlendiğinde) tarafından yazılabilir olması garanti edilmez. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı.

Agent.ContainerMapping örneği:

{
  "one_container": {
    "id": "bdbb357d73a0bd3550a1a5b778b62a4c88ed2051c7802a0659f1ff6e76910190"
  },
  "another_container": {
    "id": "82652975109ec494876a8ccbb875459c945982952e0a72ad74c91216707162bb"
  }
}

Değişken oluşturma (DevOps Services)

Şablonlarda kullanılabilir olarak işaretlenmemiş bir şablonda değişken kullandığınızda, değişken işlenmez. Değişkenin değeri şablonun kapsamında erişilebilir olmadığından işlenmez.

Değişken	Açıklama	Şablonlarda kullanılabilir mi?
Build.ArtifactStagingDirectory	Herhangi bir yapıtın hedeflerine gönderilmeden önce kopyalandığı aracıdaki yerel yol. Örneğin: c:\agent_work\1\a. Bu klasörü kullanmanın tipik bir yolu, derleme yapıtlarınızı Dosyaları kopyalama ve Derleme yapıtlarını yayımlama görevleriyle yayımlamaktır. Not: Build.ArtifactStagingDirectory ve Build.StagingDirectory birbirinin yerine kullanılabilir. Bu dizin her yeni derlemeden önce temizlenir, bu nedenle kendi başınıza temizlemeniz gerekmez. Bkz. Azure Pipelines'da yapıtlar. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.BuildId	Tamamlanan derleme için kaydın kimliği.	Hayır
Build.BuildNumber	Tamamlanan derlemenin adı( çalıştırma numarası olarak da bilinir). Bu değere nelerin dahil olduğunu belirtebilirsiniz. Bu değişkenin tipik bir kullanımı, bunu depo sekmesinde belirttiğiniz etiket biçiminin bir parçası yapmaktır. Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Böyle durumlarda etiket biçimi başarısız olur. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.BuildUri	Derleme için URI. Örneğin: vstfs:///Build/Build/1430. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.BinariesDirectory	Aracıda derlenmiş ikili dosyalar için çıkış klasörü olarak kullanabileceğiniz yerel yol. Şirket içinde barındırılan aracılarda, yeni derleme işlem hatları varsayılan olarak bu dizini temizecek şekilde ayarlanmamıştır. Derlemenizi Depo sekmesinde temizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.ContainerId	Yapıtınızın kapsayıcı kimliği. İşlem hattınıza bir yapıt yüklediğinizde, bu yapıt belirli bir kapsayıcıya eklenir.	Hayır
Build.CronSchedule.DisplayName	İşlem displayName hattı çalıştırmasını tetikleyen cron zamanlaması. Bu değişken yalnızca yaml zamanlanmış tetikleyici işlem hattı çalıştırmasını tetiklerse ayarlanır. Daha fazla bilgi için bkz . schedules.cron tanımı - Build.CronSchedule.DisplayName değişkeni	Yes
Build.DefinitionName	Derleme işlem hattının adı. Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Böyle durumlarda etiket biçimi başarısız olur.	Yes
Build.DefinitionVersion	Derleme işlem hattının sürümü.	Yes
Build.QueuedBy	Bkz . Kimlik değişkenleri nasıl ayarlanır?. Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Böyle durumlarda etiket biçimi başarısız olur.	Yes
Build.QueuedById	Bkz . Kimlik değişkenleri nasıl ayarlanır?.	Yes
Build.Reason	Derlemenin çalışmasına neden olan olay. Manual: Kullanıcı derlemeyi el ile kuyruğa aldı. IndividualCI: Git gönderimi veya Team Foundation Sürüm Denetimi (TFVC) iadesi tarafından tetiklenen sürekli tümleştirme (CI ). BatchedCI: Git gönderimi veya TFVC iadesi tarafından tetiklenen sürekli tümleştirme (CI) ve Batch değişiklikleri seçildi. Schedule: Zamanlanmış tetikleyici. ValidateShelveset: Kullanıcı belirli bir TFVC raf kümesinin derlemesini el ile kuyruğa aldı. CheckInShelveset: Geçitli iade tetikleyicisi. PullRequest: Derleme gerektiren bir Git dal ilkesi, derlemeyi tetikler. BuildCompletion: Başka bir derleme, derlemeyi tetikler . ResourceTrigger: Bir kaynak tetikleyicisi veya başka bir derleme derlemeyi tetikler . Bkz . İşlem hattı tetikleyicileri oluşturma, Dal ilkeleriyle kod kalitesini geliştirme.	Yes
Build.Repository.Clean	Kaynak depo ayarlarındaTemizle için seçtiğiniz değer. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.LocalPath	Kaynak kod dosyalarınızın indirildiği aracıdaki yerel yol. Örneğin: c:\agent_work\1\s. Şirket içinde barındırılan aracılarda, yeni derleme işlem hatları varsayılan olarak yalnızca değiştirilen dosyaları güncelleştirir. Dosyaların indirilma şeklini Depo sekmesinde değiştirebilirsiniz. Önemli not: Yalnızca bir Git deposunu kullanıma alırsanız, bu yol kodun tam yoludur. Birden çok depoyu kullanıma alırsanız, davranış aşağıdaki gibidir (ve Build.SourcesDirectory değişkeninin değerinden farklı olabilir): Kendi kendine (birincil) deponun kullanıma alma adımında tanımlı özel bir kullanıma alma yolu yoksa veya kullanıma alma yolu kendi deposu için çoklu kullanıma alma varsayılan yoluysa $(Pipeline.Workspace)/s/&<RepoName> , bu değişkenin değeri varsayılan değerine (olan $(Pipeline.Workspace)/s) geri döner. Kendi kendine (birincil) deponun kullanıma alma adımında, çoklu kullanıma alma varsayılan yolu olmayan özel bir kullanıma alma yolu tanımlanmışsa, bu değişken kendi kendine deponun tam yolunu içerir. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.ID	Deponun benzersiz tanımlayıcısı. Deponun adı değişse bile bu değer değişmez.	Yes
Build.Repository.Name	Tetikleyen deponun adı.	Yes
Build.Repository.Provider	Tetikleyen deponun türü. TfsGit: TFS Git deposu TfsVersionControl: Team Foundation Sürüm Denetimi Git: Dış sunucuda barındırılan Git deposu GitHub Svn:Yıkılma Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Tfvc.Workspace	Deponuz Team Foundation Sürüm Denetimi ise tanımlanır. Derleme aracısı tarafından kullanılan TFVC çalışma alanının adı. Örneğin, Agent.BuildDirectory c:\agent_work\12 ve Agent.Id ise 8, çalışma alanı adı şu olabilir: ws_12_8 Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Uri	Tetikleyen deponun URL'si. Örneğin: Aptal: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Bu değişken, derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
Build.RequestedFor	Bkz . Kimlik değişkenleri nasıl ayarlanır?. Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Böyle durumlarda etiket biçimi başarısız olur.	Yes
Build.RequestedForEmail	Bkz . Kimlik değişkenleri nasıl ayarlanır?.	Yes
Build.RequestedForId	Bkz . Kimlik değişkenleri nasıl ayarlanır?.	Yes
Build.SourceBranch	Derlemenin kuyruğa alındığı tetikleyici deposunun dalı. Bazı örnekler: Git deposu dalı: refs/heads/main Git deposu çekme isteği: refs/pull/1/merge TFVC depo dalı: $/teamproject/main TFVC deposu geçitli iade: Gated_2016-06-06_05.20.51.4369;username@live.com TFVC depo raf kümesi derlemesi: myshelveset;username@live.com Bir etiket işlem hattınızı tetiklediğinde: refs/tags/your-tag-name Bu değişkeni derleme numarası biçiminizde kullandığınızda, eğik çizgi karakterleri (/) alt çizgi karakterleriyle (_) değiştirilir. Not: TFVC'de, geçitli bir iade derlemesi çalıştırıyorsanız veya raf kümesini el ile oluşturuyorsanız, bu değişkeni derleme numarası biçiminizde kullanamazsınız.	Yes
Build.SourceBranchName	Derlemenin kuyruğa alındığı tetikleyici deposundaki dalın adı. Git deposu dalı, çekme isteği veya etiket: Başvurudaki son yol kesimi. Örneğin, bu değerde refs/heads/main şeklindedir main. içinde refs/heads/feature/tools, bu değer şeklindedir tools. refs/tags/your-tag-nameiçinde, değer your_tag_name, yerine alt çizgi (-) kısa çizgi (_) eklenir. TFVC depo dalı: Çalışma alanının kök sunucu yolundaki son yol kesimi. Örneğin, bu değerde $/teamproject/main şeklindedir main. TFVC deposu kapılı iade veya raf kümesi derlemesi raf kümesinin adıdır. Örneğin, Gated_2016-06-06_05.20.51.4369;username@live.com veya myshelveset;username@live.com. Not: TFVC'de, geçitli bir iade derlemesi çalıştırıyorsanız veya raf kümesini el ile oluşturuyorsanız, bu değişkeni derleme numarası biçiminizde kullanamazsınız.	Yes
Build.SourcesDirectory	Kaynak kod dosyalarınızın indirildiği aracıdaki yerel yol. Örneğin: c:\agent_work\1\s. Şirket içinde barındırılan aracılarda, yeni derleme işlem hatları yalnızca değiştirilen dosyaları güncelleştirir. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı. Önemli not: Yalnızca bir Git deposunu kullanıma alırsanız, bu yol kodun tam yoludur. Birden çok depoyu kullanıma alırsanız, kendi (birincil) deposu çoklu kullanıma alma varsayılan yolundan $(Pipeline.Workspace)/s farklı bir özel yola kullanıma alınmış olsa bile varsayılan değerine $(Pipeline.Workspace)/s/<RepoName>geri döner (bu açıdan değişken Build.Repository.LocalPath değişkeninin davranışından farklıdır). Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.SourceVersion	Bu derlemeye dahil edilen tetikleyici deposunun en son sürüm denetimi değişikliği. Git: İşleme kimliği. TFVC: değişiklik kümesi. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
Build.SourceVersionMessage	Tetikleyici deposu için işleme veya değişiklik kümesinin açıklaması. İletiyi ilk satıra veya 200 karaktere (hangisi daha kısaysa) kesiyoruz. , Build.SourceVersionMessage işleme sırasında Build.SourceVersion iletiye karşılık gelir. Çekme Build.SourceVersion isteği derlemesinin işlemesi, birleştirme işlemesidir (kaynak daldaki işleme değildir). Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. Ayrıca bu değişken yalnızca adım düzeyinde kullanılabilir ve iş veya aşama düzeylerinde kullanılamaz. Başka bir ifadeyle, iş başlayana ve kod kullanıma alınana kadar ileti ayıklanmaz. Not: Derleme devam ederken Batch değiştiğinde, Build.SourceVersionMessage değişkeni Bitbucket depolarındaki klasik derleme işlem hatlarıyla çalışmaz.	Hayır
Build.StageRequestedBy	Aşama el ile çalıştırıldığında veya Microsoft.VisualStudio.Services.TFS başka bir şekilde çalıştırıldığında aşamayı tetikleyen kişi. Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir.	Hayır
Build.StageRequestedForId	Aşama el ile çalıştırıldığında veya 00000002-0000-8888-8000-000000000000 başka bir şekilde çalıştırıldığında aşamayı tetikleyen kişinin kimliğinin GUID'i.	Hayır
Build.StagingDirectory	Herhangi bir yapıtın hedeflerine gönderilmeden önce kopyalandığı aracıdaki yerel yol. Örneğin: c:\agent_work\1\a. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı. Bu klasörü kullanmanın tipik bir yolu, derleme yapıtlarınızı Dosyaları kopyalama ve Derleme yapıtlarını yayımlama görevleriyle yayımlamaktır. Not: Build.ArtifactStagingDirectory ve Build.StagingDirectory birbirinin yerine kullanılabilir. Bu dizin her yeni derlemeden önce temizlenir, bu nedenle kendi başınıza temizlemeniz gerekmez. Bkz. Azure Pipelines'da yapıtlar. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Git.SubmoduleCheckout	Depo sekmesindeKullanıma Alma alt modülleri için seçtiğiniz değer. Birden çok depo kullanıma alındığında, bu değer tetikleyici deponun ayarını izler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.SourceTfvcShelveset	Deponuz Team Foundation Sürüm Denetimi ise tanımlanır. Bir geçitli derleme veya raf kümesi derlemesi çalıştırıyorsanız, bu değişken oluşturmakta olduğunuz raf kümesinin adına ayarlanır. Not: Bu değişken, derleme numarası biçiminde derleme kullanımı için geçersiz bir değer verir.	Hayır
Build.TriggeredBy.BuildId	Başka bir derleme derlemeyi tetiklerse, bu değişken tetikleyen derlemenin BuildID'sine ayarlanır. Klasik işlem hatlarında derleme tamamlama tetikleyicisi bu değişkeni tetikler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. kullanarak resourcesbir YAML işlem hattı tetikliyorsanız bunun yerine kaynak değişkenlerini kullanmanız gerekir.	Hayır
Build.TriggeredBy.DefinitionId	Başka bir derleme derlemeyi tetiklerse, bu değişken tetikleyen derlemenin DefinitionID değerine ayarlanır. Klasik işlem hatlarında derleme tamamlama tetikleyicisi bu değişkeni tetikler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. kullanarak resourcesbir YAML işlem hattı tetikliyorsanız bunun yerine kaynak değişkenlerini kullanmanız gerekir.	Hayır
Build.TriggeredBy.DefinitionName	Başka bir derleme derlemeyi tetiklerse, bu değişken tetikleyen derleme işlem hattının adına ayarlanır. Klasik işlem hatlarında derleme tamamlama tetikleyicisi bu değişkeni tetikler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. kullanarak resourcesbir YAML işlem hattı tetikliyorsanız bunun yerine kaynak değişkenlerini kullanmanız gerekir.	Hayır
Build.TriggeredBy.BuildNumber	Başka bir derleme derlemeyi tetiklerse, bu değişken tetikleyen derlemenin sayısına ayarlanır. Klasik işlem hatlarında derleme tamamlama tetikleyicisi bu değişkeni tetikler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. kullanarak resourcesbir YAML işlem hattı tetikliyorsanız bunun yerine kaynak değişkenlerini kullanmanız gerekir.	Hayır
Build.TriggeredBy.ProjectID	Başka bir derleme derlemeyi tetiklerse, bu değişken tetikleyen derlemeyi içeren projenin kimliği olarak ayarlanır. Klasik işlem hatlarında derleme tamamlama tetikleyicisi bu değişkeni tetikler. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. kullanarak resourcesbir YAML işlem hattı tetikliyorsanız bunun yerine kaynak değişkenlerini kullanmanız gerekir.	Hayır
Common.TestResultsDirectory	Test sonuçlarının oluşturulduğu aracıdaki yerel yol. Örneğin: c:\agent_work\1\TestResults. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır

İşlem hattı değişkenleri

Değişken	Açıklama
Pipeline.Workspace	Belirli bir işlem hattı için çalışma alanı dizini. Bu değişken ile aynı değere Agent.BuildDirectorysahiptir. Örneğin, /home/vsts/work/1. Aracı dizin yapısı hakkında daha fazla bilgi için bkz . Aracı dizin yapısı.

İpucu

Klasik yayın işlem hatlarını kullanıyorsanız, işlem hattınızın tamamında verileri depolamak ve verilere erişmek için klasik yayınları ve yapıt değişkenlerini kullanabilirsiniz.

Dağıtım işi değişkenleri

Bu değişkenlerin kapsamı belirli bir Dağıtım işi olarak belirlenmiştir ve yalnızca iş yürütme zamanında çözümlenir.

Değişken	Açıklama
Environment.Name	Dağıtım adımlarını çalıştırmak ve dağıtım geçmişini kaydetmek için dağıtım işinde hedeflenen ortamın adı. Örneğin, smarthotel-dev.
Environment.Id	Dağıtım işinde hedeflenen ortamın kimliği. Örneğin, 10.
Environment.ResourceName	Dağıtım adımlarını çalıştırmak ve dağıtım geçmişini kaydetmek için dağıtım işinde hedeflenen ortamdaki belirli kaynağın adı. Örneğin, bookings ortamına smarthotel-devkaynak olarak eklenen bir Kubernetes ad alanıdır.
Environment.ResourceId	Dağıtım adımlarını çalıştırmak için dağıtım işinde hedeflenen ortamdaki belirli kaynağın kimliği. Örneğin, 4.
Strategy.Name	Dağıtım stratejisinin adı: canary, runOnceveya rolling.
Strategy.CycleName	Dağıtımdaki geçerli döngü adı. Seçenekler , PreIterationveya IterationşeklindedirPostIteration.

Sistem değişkenleri

Şablonlarda kullanılabilir olarak işaretlenmemiş bir şablonda değişken kullandığınızda, değişken işlenmez. Değişkenin değeri şablonun kapsamında erişilebilir olmadığından işlenmez.

Değişken	Açıklama	Şablonlarda kullanılabilir mi?
System.AccessToken	REST API'ye erişmek için OAuth belirtecini kullanın. YAML betiklerinden System.AccessToken kullanın. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
System.CollectionId	Azure DevOps kuruluşunun veya koleksiyonunun GUID'i.	Yes
System.CollectionUri	Azure DevOps kuruluşunun veya koleksiyonunun URI'sini. Örneğin: https://dev.azure.com/fabrikamfiber/.	Yes
System.DefaultWorkingDirectory	Kaynak kod dosyalarınızın indirildiği aracıdaki yerel yol. Örneğin: c:\agent_work\1\s Aracı dizin yapısı hakkında daha fazla bilgi için bkz. Aracı dizin yapısı. Şirket içinde barındırılan aracılarda, yeni derleme işlem hatları varsayılan olarak yalnızca değiştirilen dosyaları güncelleştirir. Dosyaların indirilma şeklini Depo sekmesinde değiştirebilirsiniz. Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
System.DefinitionId	Derleme işlem hattının kimliği.	Yes
System.HostType	build İşlem hattının bir derleme olup olmadığını olarak ayarlayın. Yayın için değerler dağıtım grubu işi, deployment geçitlerin değerlendirilmesi sırasında ve gates diğer (Aracısız) işler için kullanılırrelease.	Yes
System.JobAttempt	Bu iş ilk kez denendiği zaman 1 olarak ayarlanır ve iş her yeniden denenişinde artar.	Hayır
System.JobDisplayName	bir işe verilen, okunabilir ad.	Hayır
System.JobId	Tek bir işin tek bir girişimi için benzersiz tanımlayıcı. Değer geçerli işlem hattı için benzersizdir.	Hayır
System.JobName	Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan işin adı.	Hayır
System.OidcRequestUri	OpenID Connect (OIDC) kullanarak Entra ID ile kimlik doğrulaması için bir idToken oluşturun. Daha fazla bilgi edinin.	Yes
System.PhaseAttempt	Bu aşama ilk kez denenmeye çalışıldığında 1 olarak ayarlanır ve iş her yeniden denenişinde artar. Not: "Aşama", bir işin tasarım süresini temsil eden çoğunlukla yedekli bir kavramdır (ancak iş bir aşamanın çalışma zamanı sürümüdür). Aşama kavramı çoğunlukla Azure Pipelines'dan kaldırılır. Matris ve çoklu yapılandırma işleri, aşamanın hala bir işten ayrı olduğu tek yerdir. Bir aşama, yalnızca girişlerinde farklılık gösteren birden çok iş örneği oluşturabilir.	Hayır
System.PhaseDisplayName	Bir aşamaya verilen, insan tarafından okunabilen ad.	Hayır
System.PhaseName	Bir işin dize tabanlı tanımlayıcısı, genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılır.	Hayır
System.PlanId	Tek bir işlem hattı çalıştırması için dize tabanlı tanımlayıcı.	Hayır
System.PullRequest.IsFork	Çekme isteği deponun çatalından geliyorsa, bu değişken olarak Trueayarlanır. Aksi takdirde, olarak ayarlanır False.	Yes
System.PullRequest.PullRequestId	Bu derlemeye neden olan çekme isteğinin kimliği. Örneğin: 17. (Bu değişken yalnızca derlemenin bir Dal ilkesinden etkilenen Git PR).	Hayır
System.PullRequest.PullRequestNumber	Bu derlemeye neden olan çekme isteğinin sayısı. Bu değişken, GitHub'dan farklı bir çekme isteği kimliğine ve çekme isteği numarasına sahip çekme istekleri için doldurulur. Bu değişken yalnızca bir dal ilkesi çekme isteğini etkiliyorsa YAML işlem hattında kullanılabilir.	Hayır
System.PullRequest.targetBranchName	Çekme isteğinin hedef dalının adı. Bu değişken, çekme isteğinin hedef dalı temelinde görevleri veya adımları koşullu olarak yürütmek için işlem hattında kullanılabilir. Örneğin, değişikliklerin birleştirildiği dala bağlı olarak farklı bir test kümesini veya kod çözümleme araçlarını tetiklemeniz gerekebilir.	Hayır
System.PullRequest.SourceBranch	Çekme isteğinde gözden geçirilmekte olan dal. Örneğin: refs/heads/users/raisa/new-feature Azure Repos için. (Bu değişken yalnızca derlemenin bir Dal ilkesinden etkilenen Git PR). Bu değişken yalnızca bir dal ilkesi çekme isteğini etkiliyorsa YAML işlem hattında kullanılabilir.	Hayır
System.PullRequest.SourceCommitId	Çekme isteğinde gözden geçirilmekte olan işleme. (Bu değişken yalnızca derlemenin bir Dal ilkesinden etkilenen Git PR). Bu değişken yalnızca bir dal ilkesi çekme isteğini etkiliyorsa YAML işlem hattında kullanılabilir.
System.PullRequest.SourceRepositoryURI	Çekme isteğini içeren deponun URL'si. Örneğin: https://dev.azure.com/ouraccount/_git/OurProject.	Hayır
System.PullRequest.TargetBranch	Çekme isteğinin hedefi olan dal. Örneğin: refs/heads/main deponuz Azure Repos'tayken ve main deponuz GitHub'da olduğunda. Bu değişken yalnızca bir dal ilkesinden etkilenen git pr'i nedeniyle derleme çalıştırıldıysa başlatılır. Bu değişken yalnızca bir dal ilkesi çekme isteğini etkiliyorsa YAML işlem hattında kullanılabilir.	Hayır
System.StageAttempt	Bu aşama ilk kez denenmeye çalışıldığında 1 olarak ayarlanır ve aşama her yeniden denenişinde artar.	Hayır
System.StageDisplayName	Bir aşamaya verilen, insan tarafından okunabilen ad.	Hayır
System.StageName	Bir aşama için dize tabanlı tanımlayıcı, genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılır.	Hayır
System.TeamFoundationCollectionUri	Azure DevOps kuruluşunun veya koleksiyonunun URI'sini. Örneğin: https://dev.azure.com/fabrikamfiber/. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
System.TeamProject	Bu derlemeyi içeren projenin adı.	Yes
System.TeamProjectId	Bu derlemenin ait olduğu projenin kimliği.	Yes
System.TimelineId	Tek bir işlem hattı çalıştırmasının yürütme ayrıntıları ve günlükleri için dize tabanlı tanımlayıcı.	Hayır
TF_BUILD	Bir derleme görevinin True betiği çalıştırdığında olarak ayarlayın. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir. Derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır

Değişkenleri denetler (DevOps Services)

Değişken	Açıklama
Checks.StageAttempt	Bu aşama ilk kez denenmeye çalışıldığında 1 olarak ayarlanır ve aşama her yeniden denenişinde artar. Bu değişken yalnızca bir onay veya ortam denetimi içinde kullanılabilir. Örneğin, rest $(Checks.StageAttempt) kullanabilirsiniz.

Kimlik değişkenleri nasıl ayarlanır?

Bu değer, derlemeye neyin neden olduğuna bağlıdır ve Azure Repos depolarına özeldir.

Derleme tetikleniyorsa...	Ardından Build.QueuedBy ve Build.QueuedById değerleri...	Ardından Build.RequestedFor ve Build.RequestedForId değerleri...
Git'te veya Sürekli tümleştirme (CI) tetikleyicileri tarafından	Sistem kimliği, örneğin: [DefaultCollection]\Project Collection Service Accounts	Değişiklikleri gönderen veya iade eden kişi.
Git'te veya bir dal ilkesi derlemesi tarafından.	Sistem kimliği, örneğin: [DefaultCollection]\Project Collection Service Accounts	Değişiklikleri iade eden kişi.
TFVC'de geçitli iade tetikleyicisi	Değişiklikleri iade eden kişi.	Değişiklikleri iade eden kişi.
Zamanlanmış tetikleyiciler tarafından Git veya TFVC'de	Sistem kimliği, örneğin: [DefaultCollection]\Project Collection Service Accounts	Sistem kimliği, örneğin: [DefaultCollection]\Project Collection Service Accounts
Kuyruk derleme düğmesine tıkladığınızdan	Siz	Siz

Copilot'dan değişken değerleri temel alan bir koşula sahip bir aşama oluşturmasını isteyin

Copilot kullanarak bir değişkenin değeri tarafından belirlenen bir koşula sahip bir aşama oluşturun.

Bu örnek istem, Agent.JobStatus önceki aşamanın başarıyla çalıştırıldığını gösterdiğinde çalışan bir aşama tanımlar:

Yalnızca Agent.JobStatusSucceeded veya SucceededWithIssuesolduğunda çalışan yeni bir Azure DevOps aşaması oluşturun.

gereksinimlerinizi karşılayan değerleri kullanmak için istemleri özelleştirebilirsiniz. Örneğin, yalnızca işlem hattı başarısız olduğunda çalışan bir aşama oluşturma konusunda yardım isteyebilirsiniz.

Not

GitHub Copilot yapay zeka ile desteklendiğinden sürprizler ve hatalar mümkündür. Oluşturulan tüm kodları veya önerileri doğruladığından emin olun. GitHub Copilot'ın genel kullanımı, ürün etkisi, insan gözetimi ve gizlilik hakkında daha fazla bilgi için bkz. gitHub Copilot SSS.