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

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:

steps:
  - bash: echo This script could use $SYSTEM_ACCESSTOKEN
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
  - powershell: | 
      Write-Host "This is a script that could use $env:SYSTEM_ACCESSTOKEN"
      Write-Host "$env:SYSTEM_ACCESSTOKEN = $(System.AccessToken)"
    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.
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, aracı yazılımını içerir. Örneğin: c:\agent.
Agent.Id	Aracının kimliği.
Agent.JobName	Çalışan işin adı. Bu genellikle "İş" olacaktır; veya "__default", ancak çoklu yapılandırma senaryolarında yapılandırma olacaktır.
Agent.JobStatus	Derlemenin durumu. Canceled Failed Succeeded SucceededWithIssues (kısmen başarılı) 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, bu ad sizin tarafınızdan belirtilir. Bkz. aracılar.
Agent.OS	Aracı ana bilgisayarının işletim sistemi. Geçerli değerler: Windows_NT Darwin Linux Kapsayıcıda çalışıyorsanız aracı ana bilgisayarı ve kapsayıcısı farklı işletim sistemleri çalıştırıyor olabilir.
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 tarafından yazılabilir olması garanti edilmez (örneğin, bir kapsayıcıya eşlendiğinde)

Agent.ContainerMapping örneği:

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

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

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. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının 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, ancak derleme numarasının 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, ancak derleme numarasının 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. Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamıştır. Derlemenizi Depo sekmesinde temizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının 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 işlem hattı çalıştırması bir YAML zamanlanmış tetikleyicisi tarafından tetiklendiğinde 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 TFVC iade işlemi 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, derleme gerektiren bir Git dal ilkesi tarafından tetiklendi. BuildCompletion: Derleme başka bir derleme tarafından tetiklendi ResourceTrigger: Derleme bir kaynak tetikleyicisi tarafından tetiklendi veya başka bir derleme tarafından tetiklendi. Bkz . İşlem hattı tetikleyicileri oluşturma, Dal ilkeleriyle kod kalitesini geliştirme.	Yes
Build.Repository.Clean	Kaynak depo ayarlarında Temizleiç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, ancak derleme numarasının 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. Varsayılan olarak, yeni derleme işlem hatları 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 tanımlı özel bir kullanıma alma yolu varsa (ve çoklu kullanıma alma varsayılan yolu değilse), 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, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.ID	Deponun benzersiz tanımlayıcısı. Bu, deponun adı değişse bile değişmez. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Name	Tetikleyen deponun adı. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
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:Subversion Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının 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, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Uri	Tetikleyen deponun URL'si. Örneğin: Git: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: 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, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
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 İşlem hattınız bir etiket tarafından tetiklendiğ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. Bu refs/heads/feature/tools değerde değeridir tools. Bu refs/tags/your-tag-name değerde değeridir your-tag-name. 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. Varsayılan olarak, yeni derleme işlem hatları yalnızca değiştirilen dosyaları güncelleştirir. Ö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/<RepoName> farklı bir özel yola kullanıma alınmış olsa bile varsayılan değerine $(Pipeline.Workspace)/sgeri 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, ancak derleme numarasının 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, ancak derleme numarasının 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, ancak derleme numarasının 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 (yani, iş başlatılana ve kod kullanıma alınana kadar ileti ayıklanmaz). Not: Bu değişken TFS 2015.4'te kullanılabilir. Not: Derleme devam ederken Batch değiştiğinde Bitbucket depolarındaki klasik derleme işlem hatlarıyla Build.SourceVersionMessage değişkeni çalışmaz.	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. 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, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır
Build.Repository.Git.SubmoduleCheckout	Depo sekmesinde kullanı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, ancak derleme numarasının 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. Geçitli bir derleme veya raf kümesi derlemesi çalıştırıyorsanız, bu, oluşturduğ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	Derleme başka bir derleme tarafından tetiklendiyse , bu değişken tetiklenen derlemenin BuildID'sine ayarlanır. Klasik işlem hatlarında bu değişken bir derleme tamamlama tetikleyicisi tarafından 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, ancak derleme numarasının 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	Derleme başka bir derleme tarafından tetiklendiyse , bu değişken tetiklenen derlemenin DefinitionID değerine ayarlanır. Klasik işlem hatlarında bu değişken bir derleme tamamlama tetikleyicisi tarafından 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, ancak derleme numarasının 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	Derleme başka bir derleme tarafından tetiklendiyse, bu değişken tetiklenen derleme işlem hattının adına ayarlanır. Klasik işlem hatlarında bu değişken bir derleme tamamlama tetikleyicisi tarafından 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, ancak derleme numarasının 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	Derleme başka bir derleme tarafından tetiklendiyse, bu değişken tetiklenen derlemenin sayısına ayarlanır. Klasik işlem hatlarında bu değişken bir derleme tamamlama tetikleyicisi tarafından 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, ancak derleme numarasının 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	Derleme başka bir derleme tarafından tetiklendiyse , bu değişken tetiklenen derlemeyi içeren projenin kimliği olarak ayarlanır. Klasik işlem hatlarında bu değişken bir derleme tamamlama tetikleyicisi tarafından 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, ancak derleme numarasının 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. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinde parametre olarak kullanılabilir, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Hayır

İşlem hattı değişkenleri (DevOps Services)

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.

İ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 (DevOps Services)

Bu değişkenlerin kapsamı belirli bir Dağıtım işi kapsamındadır 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 eklenmiş 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 , Iterationveya PostIterationşeklindedirPreIteration.

Sistem değişkenleri (DevOps Services)

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, ancak derleme numarasının parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz.	Yes
System.CollectionId	TFS koleksiyonunun veya Azure DevOps kuruluşunun GUID'i.	Yes
System.CollectionUri	TFS koleksiyonunun veya Azure DevOps kuruluşunun 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 Varsayılan olarak, yeni derleme işlem hatları 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, ancak 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, gates geçitlerin değerlendirilmesi sırasında ve release diğer (Aracısız) işler için kullanılırdeployment.	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.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). Azure Pipelines'dan çoğunlukla "aşama" kavramını kaldırdık. Matris ve çoklu yapılandırma işleri, "aşama"nın hala "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 çekme isteği bir dal ilkesinden etkileniyorsa 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 çekme isteği bir dal ilkesinden etkileniyorsa 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 çekme isteği bir dal ilkesinden etkileniyorsa 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 çekme isteği bir dal ilkesinden etkileniyorsa YAML işlem hattında kullanılabilir.	Hayır
System.StageAttempt	Bu aşama ilk kez denendiği zaman 1 olarak ayarlanır ve iş 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	TFS koleksiyonunun veya Azure DevOps kuruluşunun 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, ancak derleme numarasının 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	True Betiğin bir derleme görevi tarafından çalıştırılıp çalıştırılmadığını 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, ancak derleme numarasının 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 API çağrısı denetiminde kullanabilirsiniz$(Checks.StageAttempt).

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