Önceden tanımlanmış değişkenleri kullan
Aracı değişkenleri (DevOps Services)
Not
Aracı değişkenlerini, betiklerinizde ortam değişkenleri olarak ve derleme görevlerinizde parametre olarak kullanabilirsiniz. Yapı 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 |
Aracıdaki, belirli bir yapı işlem hattı için tüm klasörlerin oluşturulduğu yerel yol. Bu değişken ile aynı değere sahip Örnek: |
| Agent. ContainerMapping |
YAML içindeki kapsayıcı kaynak adlarından çalışma zamanında Docker kimliklerine eşleme. Örnek: |
| 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 "Iş" veya "__default" olacaktır, ancak çoklu yapılandırma senaryolarında yapılandırma olacaktır. |
| Agent. JobStatus | Derleme durumu.
Ortam değişkenine olarak başvurulmalıdır |
| Agent. MachineName | Aracının yüklü olduğu makinenin adı. |
| Agent.Name |
Havuza kayıtlı aracının adı. Kendi kendine 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:
|
| Agent. OSArchitecture |
Aracı ana bilgisayarının işletim sistemi işlemci mimarisi. Geçerli değerler:
|
| Agent. TempDirectory |
Her bir ardışık düzen 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: |
| Agent. araçları dizini |
Düğüm aracı yükleyicisi gibi görevler tarafından kullanılan dizin ve bir aracın birden çok sürümü arasında geçiş yapmak Için Python sürümünü kullanma .
Bu görevler, PATH sonraki derleme adımlarının bunları kullanabilmesi için bu dizinden araç ekler.
Bu dizini kendi kendine barındırılan bir aracıda yönetmehakkı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 olmadığı garanti edilmez (örn. bir kapsayıcıya eşlendiğinde) |
Derleme değişkenleri (DevOps Services)
| Değişken | Açıklama | Şablonlardakullanılabilir mi? |
|---|---|---|
| Build. ArtifactStagingDirectory |
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
No |
| Build. BuildId | Tamamlanan derleme için kayıt KIMLIĞI. | No |
| Build. BuildNumber | Çalışma numarası olarak da bilinen tamamlanmış derleme adı. Bu değere nelerin ekleneceğini belirtebilirsiniz. Bu değişkenin tipik kullanımı, Depo sekmesindebelirttiğiniz etiket biçiminin bir parçası haline gelir. Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur.
|
No |
| Build. BuildUri | Yapı için URI. Örneğin: vstfs:///Build/Build/1430.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. BinariesDirectory | Aracıdaki yerel yol, derlenmiş ikili dosyalar için bir çıkış klasörü olarak kullanabilirsiniz.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamış. Derlemeyi Depo sekmesindetemizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. Containerıd | Yapıcınıza ait kapsayıcının KIMLIĞI. İşlem hattınıza bir yapıt yüklediğinizde, bu, söz konusu yapıya özgü bir kapsayıcıya eklenir. | No |
| Build. DefinitionName | Derleme işlem hattının adı.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
Yes |
| Build. DefinitionVersion | Derleme işlem hattının sürümü. | Yes |
| Build. QueuedBy | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
Yes |
| Build. Queuedbyıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. | Yes |
| Derleme. nedeni | Yapıya çalışmasına neden olan olay.
|
Yes |
| Build. Repository. Clean | Kaynak depo ayarlarındaTemizleme için seçtiğiniz değer.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. Repository. LocalPath |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Önemli Note: yalnızca bir git deposuna göz atın, bu yol kodun tam yolu olacaktır. Birden çok havuza göz atın, davranış aşağıdaki gibidir (ve Build. SourcesDirectory değişkeninin değerinden farklı olabilecek):
|
No |
| Build.Repository.ID | Deponunbenzersiz tanımlayıcısı.
Bu, deponun adı olsa bile değişmez. Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.Repository.Name | Tetikleyici deponunadı.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. Repository. Provider | Tetikleyici deponuntürü.
|
No |
| Build. Repository. TFVC. Workspace | deponuz Team Foundation Sürüm Denetimi tanımlı. Yapı Aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent. BuildDirectory ise c:\agent_work\12 ve Agent.ID ise 8 , çalışma alanı adı şu olabilir: ws_12_8
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. Repository. Uri | Tetikleme deposunun URL 'SI. Örnek: Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. | No |
| Build. RequestedFor | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
Yes |
| Derleme. RequestedForEmail | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. | Yes |
| Build. Requestedforıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. | Yes |
| Build. SourceBranch | Derlemeyi tetikleyen tetikleme dalı, için kuyruğa alındı. Bazı örnekler:
/ ) alt çizgi karakterleriyle değiştirilmiştir _ ).
Note: TFVC 'de, geçişli iade yapısı çalıştırıyorsanız veya bir raf kümesini el ile oluşturuyorsanız, bu değişkeni yapı numarası biçiminde kullanamazsınız. |
Yes |
| Build. SourceBranchName | Yapı için, derleme kuyruğa alındı.
|
Yes |
| Build. SourcesDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Önemli Note: yalnızca bir git deposuna göz atın, bu yol kodun tam yolu olacaktır. Birden çok depoyu kullanıma alırsanız, kendi varsayılan değerine döndürülür, |
No |
| Build. SourceVersion | Bu derlemede bulunan tetikleme deposunun en son sürüm denetim değişikliği.
|
Yes |
| Build. SourceVersionMessage | Tetikleme deposu için işleme veya değişiklik kümesinin açıklaması. İletiyi ilk satıra veya 200 karaktere kısaldık, hangisi daha kısadır.
, Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre 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ş ya da aşama düzeylerinde kullanılamaz (yani, iş başlatılana ve kodu kullanıma alana kadar ileti ayıklanmaz). Note: Bu değişken TFS 2015,4 ' de mevcuttur. |
No |
| Build. StagingDirectory |
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
No |
| 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ı seçeneğiyle, bu değer tetikleme deposunun ayarını izler.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. SourceTfvcShelveset | deponuz Team Foundation Sürüm Denetimi tanımlı.
Geçitli bir derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesinin adına ayarlanır. Note: Bu değişken yapı numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
No |
| Build. TriggeredBy. BuildId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin BuildId olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Kullanarak bir YAML işlem hattı tetiklerken resources , bunun yerine resources kullanmanız gerekir.
|
No |
| Build. TriggeredBy. definitionId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin definitionId değerine ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Kullanarak bir YAML işlem hattı tetiklerken resources , bunun yerine resources kullanmanız gerekir.
|
No |
| Build. TriggeredBy. DefinitionName | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derleme işlem hattının adına ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Kullanarak bir YAML işlem hattı tetiklerken resources , bunun yerine resources kullanmanız gerekir.
|
No |
| Build. TriggeredBy. BuildNumber | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin numarası olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Kullanarak bir YAML işlem hattı tetiklerken resources , bunun yerine resources kullanmanız gerekir.
|
No |
| Build. TriggeredBy. ProjectId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesini IÇEREN projenin kimliği olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Kullanarak bir YAML işlem hattı tetiklerken resources , bunun yerine resources kullanmanız gerekir.
|
No |
| Common. TestResultsDirectory | Aracıdaki test sonuçlarının oluşturulduğu yerel yol. Örnek: c:\agent_work\1\TestResults
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
İşlem hattı değişkenleri (DevOps Services)
| Değişken | Açıklama |
|---|---|
| İşlem hattı. çalışma alanı | Belirli bir işlem hattı için çalışma alanı dizini. Bu değişken ile aynı değere sahip Agent.BuildDirectory .Örneğin, /home/vsts/work/1. |
Dağıtım işi değişkenleri (DevOps Services)
Bu değişkenler, belirli bir dağıtım işinin kapsamına alınır ve yalnızca iş yürütme sırası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şine hedeflenmiş ortamın adı. Örneğin, smarthotel-dev. |
| Environment.Id | Dağıtım işine hedeflenmiş 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şine hedeflenmiş ortamda belirli bir kaynağın adı. Örneğin, bookings ortama kaynak olarak eklenmiş bir Kubernetes ad alanı olan smarthotel-dev . |
| Environment. ResourceID | Dağıtım adımlarını çalıştırmak için dağıtım işine hedeflenmiş ortamdaki belirli bir kaynağın KIMLIĞI. Örneğin, 4. |
| Strategy.Name | Dağıtım stratejisinin adı: canary , runOnce , veya rolling . |
| Strateji. CycleName | Bir dağıtımda geçerli geçiş adı. Seçenekler PreIteration , Iteration , veya PostIteration . |
Sistem değişkenleri (DevOps Services)
| Değişken | Açıklama | Şablonlardakullanılabilir mi? |
|---|---|---|
| System. AccessToken | REST API erişmek Için OAuth belirtecini kullanın.
YAML betiklerinden System. AccessToken kullanın. Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Yes |
| System. CollectionId | TFS koleksiyonunun veya Azure DevOps kuruluşun guıd 'si. | Yes |
| System. CollectionUri | TFS koleksiyonunun urı 'si veya Azure DevOps kuruluşu. Örneğin: https://dev.azure.com/fabrikamfiber/. |
Yes |
| System. DefaultWorkingDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: |
No |
| System. definitionId | Derleme işlem hattının KIMLIĞI. | Yes |
| System. Hosttürü | buildİşlem hattı bir yapı ise olarak ayarlayın. Bir sürüm için, değerler deployment dağıtım grubu işi için, gates kapıların değerlendirmesi sırasında ve release diğer (aracı ve aracısız) işler için kullanılır. |
Yes |
| System. JobAttempt | Bu iş denendiğinde 1 olarak ayarlayın ve işin her yeniden denenişinde artar. | No |
| System. JobDisplayName | Bir işe verilen insan tarafından okunabilen ad. | No |
| System. JobId | Tek bir işin tek denemesi için benzersiz bir tanımlayıcı. Değer, geçerli işlem hattının benzersizdir. | No |
| System. JobName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan iş adı. | No |
| System. Phasegirişim | Bu aşama denendiğinde 1 olarak ayarlayın ve iş her yeniden denendiğinde artar. Note: "Aşama" bir işin tasarım zamanını temsil eden (iş çalışma zamanının bir aşamanın çalışma zamanı sürümü olduğu), çoğunlukla yedekli bir kavramdır. Genellikle Azure Pipelines "aşama" kavramını kaldırdık. Matris ve çoklu yapılandırma işleri, "aşamanın" hala "iş" öğesinden farklı olduğu tek yerdir. Bir aşama yalnızca girişlerinde farklı olan birden çok işi oluşturabilir. |
No |
| System. PhaseDisplayName | Bir aşamaya verilen insan tarafından okunabilen ad. | No |
| System. PhaseName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan, bir iş için dize tabanlı tanımlayıcı. | No |
| System. Stagegirişimi | Bu aşama denendiğinde 1 olarak ayarlayın ve iş her yeniden denendiğinde artar. | No |
| System. StageDisplayName | Bir aşamaya verilen insan tarafından okunabilen ad. | No |
| System. StageName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan, bir aşama için dize tabanlı tanımlayıcı. | Yes |
| System. PullRequest. ısfork | Çekme isteği deponun çatalından ise, bu değişken olarak ayarlanır True .
Aksi takdirde, olarak ayarlanır False . |
Yes |
| System. PullRequest. Pullrequestıd | Bu yapıya neden olan çekme isteğinin Kımlığı. Örneğin: 17. (Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır). |
No |
| System. PullRequest. PullRequestNumber | Bu yapıya neden olan çekme isteği sayısı. bu değişken, farklı bir çekme isteği kimliği ve çekme isteği numarası olan GitHub gelen çekme istekleri için doldurulur. Bu değişken yalnızca, çekme isteği bir dal ilkesinden etkileniyorsa YAML ardışık düzeninde kullanılabilir. | No |
| 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 derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır). Bu değişken yalnızca, çekme isteği bir dal ilkesinden etkileniyorsa YAML ardışık düzeninde kullanılabilir. |
No |
| System. PullRequest. SourceRepositoryURI | Çekme isteğini içeren deponun URL 'SI. Örneğin: https://dev.azure.com/ouraccount/_git/OurProject. |
No |
| System. PullRequest. TargetBranch | Çekme isteğinin hedefi olan dal. örneğin: refs/heads/master deponuz Azure Repos ve master deponuzun GitHub olduğunda. Bu değişken yalnızca derleme, dal ilkesi tarafından etkilenen bir Git PR'i nedeniyle çalışsa başlatılır. Bu değişken yalnızca BIR YAML işlem hattında, PR bir dal ilkesi tarafından etkileniyorsa kullanılabilir. |
No |
| System.TeamFoundationCollectionUri | TFS koleksiyonunun URI'si veya Azure DevOps. Ö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örevinin bir parametresi olarak kullanılabilir, ancak 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 |
| TF_BUILD | Betik True bir derleme görevi tarafından çalıştır ediliyorsa olarak ayarlayın.
Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
Değişkenleri denetler (DevOps Services)
| Değişken | Açıklama |
|---|---|
| Checks.StageAttempt | Bu aşama ilk kez denenirken 1 olarak ayarlanır ve aşama her yeniden denenirken artırılır.
Bu değişken yalnızca bir onay veya ortam denetimi içinde kullanılabilir. Örneğin, bir Invoke REST API $(Checks.StageAttempt)$(Checks.StageAttempt) |
Aracı değişkenleri (DevOps Server 2020)
Not
Aracı değişkenlerini betiklerinize ortam değişkenleri olarak ve derleme görevlerinize parametre olarak kullanabilirsiniz. Bunları derleme numarasını özelleştirmek veya sürüm denetimi etiketi ya da etiketi uygulamak için kullanılamaz.
| Değişken | Açıklama |
|---|---|
| Agent.BuildDirectory |
Aracıda, bir derleme işlem hattı için tüm klasörlerin oluşturulacak yerel yolu. Bu değişken ile aynı değere Örnek: |
| Agent.HomeDirectory | Aracının yüklü olduğu dizin. Bu, aracı yazılımını içerir. Örneğin: c:\agent. |
| Agent.Id | Aracı kimliği. |
| Agent.JobName | Çalışan işin adı. Bu genellikle "İş" veya "__default" olur, ancak çoklu yapılandırma senaryolarında yapılandırma olur. |
| Agent.JobStatus | Derlemenin durumu.
Ortam değişkenine olarak |
| Agent.MachineName | Aracının yüklü olduğu makinenin adı. |
| Agent.Name |
Havuza kayıtlı aracının adı. Kendi içinde barındırılan bir aracı kullanıyorsanız, bu ad sizin adınızla belirtilir. Bkz. aracılar. |
| Agent.OS |
Aracı ana bilgisayarının işletim sistemi. Geçerli değerler:
|
| Agent.OSArchitecture |
Aracı ana bilgisayarının işletim sistemi işlemci mimarisi. Geçerli değerler:
|
| Agent.TempDirectory |
Her işlem hattı işinin ardından temizlenen geçici bir klasör. Bu dizin, test sonuçları .NET Core CLI geçici öğeleri tutmak için görev gibi görevler tarafından kullanılır. Örneğin: |
| Agent.ToolsDirectory |
Node Tool Installer ve Python Sürümünü Kullanma gibi görevler tarafından bir aracın birden çok sürümü arasında geçiş yapmak için kullanılan dizin.
Bu görevler, sonraki derleme adımlarını kullanmak PATH için bu dizinden araçları ekler.
Bu dizini, kendi içinde barındırılan bir aracıda yönetme hakkında bilgi öğrenin. |
| 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 edilemez (örneğin, bir kapsayıcıyla eşlenmiş olduğunda) |
Derleme değişkenleri (DevOps Server 2020)
| Değişken | Açıklama | Şablonlarda kullanılabilir mi? |
|---|---|---|
| Build.ArtifactStagingDirectory |
Aracıda, herhangi bir yapıt hedeflerine gitmeden önce kopyalanan yerel yol. Örnek: |
No |
| Build.BuildId | Tamamlanan derleme için kaydın kimliği. | No |
| Build.BuildNumber | Tamamlanan derlemenin adı ( çalıştırma numarası olarak da bilinir). Bu değere nelerin dahil olduğunu belirtsiniz. 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. Bu durumlarda etiket biçimi başarısız olur.
|
No |
| Build.BuildUri | Derlemenin URI'si. Ö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örevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| 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 ayarlanmaz. 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örevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.ContainerId | Yapıt için kapsayıcının kimliği. İşlem hattınıza bir yapıtı karşıya yüklerken, yapıt bu yapıya özgü bir kapsayıcıya eklenir. | No |
| Build.DefinitionName | Derleme işlem hattının adı.
Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu 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. Bu 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.
|
Yes |
| Build.Repository.Clean | Kaynak depo ayarlarında Temizleme içinseçtiğiniz değer.
Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.Repository.LocalPath |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: Önemli not: Yalnızca bir Git deposunu kontrol ediyorsanız, bu yol kodun tam yolu olur. Birden çok depoyu kontrol edersanız davranış aşağıdaki gibidir (ve Build.SourcesDirectory değişkeninin değerinden farklı olabilir):
|
No |
| Build.Repository.ID | Deponun benzersiz tanımlayıcısı.
Deponun adı değişse bile bu değişmez. Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.Repository.Name | Tetiklenen deponun adı.
Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.Repository.Provider | Tetiklenen deponun türü.
|
No |
| Build.Repository.Tfvc.Workspace | Deponun kullanılabilir olup Team Foundation Sürüm Denetimi. Derleme aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent.BuildDirectory ve Agent.Id c:\agent_work\12 ise çalışma 8 alanı adı şöyle olabilir: ws_12_8
Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build.Repository.Uri | Tetiklenen deponun URL'si. Örnek: Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. | No |
| 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. Bu durumlarda etiket biçimi başarısız olur. |
Yes |
| Build.RequestedForEmail | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. | Yes |
| Build. Requestedforıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. | Yes |
| Build. SourceBranch | Derlemeyi tetikleyen tetikleme dalı, için kuyruğa alındı. Bazı örnekler:
/ ) alt çizgi karakterleriyle değiştirilmiştir _ ).
Note: TFVC 'de, geçişli iade yapısı çalıştırıyorsanız veya bir raf kümesini el ile oluşturuyorsanız, bu değişkeni yapı numarası biçiminde kullanamazsınız. |
Yes |
| Build. SourceBranchName | Yapı için, derleme kuyruğa alındı.
|
Yes |
| Build. SourcesDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Önemli Note: yalnızca bir git deposuna göz atın, bu yol kodun tam yolu olacaktır. Birden çok depoyu kullanıma alırsanız, kendi varsayılan değerine döndürülür, |
No |
| Build. SourceVersion | Bu derlemede bulunan tetikleme deposunun en son sürüm denetim değişikliği.
|
Yes |
| Build. SourceVersionMessage | Tetikleme deposu için işleme veya değişiklik kümesinin açıklaması. İletiyi ilk satıra veya 200 karaktere kısaldık, hangisi daha kısadır.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre 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ş ya da aşama düzeylerinde kullanılamaz (yani, iş başlatılana ve kodu kullanıma alana kadar ileti ayıklanmaz). Note: Bu değişken TFS 2015,4 ' de mevcuttur. |
No |
| Build. StagingDirectory |
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
No |
| 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ı seçeneğiyle, bu değer tetikleme deposunun ayarını izler.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. SourceTfvcShelveset | deponuz Team Foundation Sürüm Denetimi tanımlı.
Geçitli bir derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesinin adına ayarlanır. Note: Bu değişken yapı numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
No |
| Build. TriggeredBy. BuildId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin BuildId olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. TriggeredBy. definitionId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin definitionId değerine ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. TriggeredBy. DefinitionName | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derleme işlem hattının adına ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. TriggeredBy. BuildNumber | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin numarası olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Build. TriggeredBy. ProjectId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesini IÇEREN projenin kimliği olarak ayarlanır. Klasik işlem hatlarında, bu değişken bir yapı tamamlama tetikleyicisi tarafından tetiklenir.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
| Common. TestResultsDirectory | Aracıdaki test sonuçlarının oluşturulduğu yerel yol. Örnek: c:\agent_work\1\TestResults
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
işlem hattı değişkenleri (DevOps Server 2020)
| Değişken | Açıklama |
|---|---|
| İşlem hattı. çalışma alanı | Belirli bir işlem hattı için çalışma alanı dizini. Bu değişken ile aynı değere Agent.BuildDirectory sahip.Örneğin, /home/vsts/work/1. |
Dağıtım işi değişkenleri (DevOps Server 2020)
Bu değişkenlerin kapsamı belirli bir Dağıtım işidir 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şini hedef alan ortamın adı. Örneğin, smarthotel-dev. |
| Environment.Id | Dağıtım işini hedef alan 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şini hedef alan ortamdaki belirli kaynağın adı. Örneğin, bookings ortamına kaynak olarak eklenmiş bir Kubernetes ad smarthotel-dev alanıdır. |
| Environment.ResourceId | Dağıtım adımlarını çalıştırmak için dağıtım işi hedeflenen ortamdaki belirli kaynağın kimliği. Örneğin, 4. |
Sistem değişkenleri (DevOps Server 2020)
| Değişken | Açıklama | Şablonlarda kullanılabilir mi? |
|---|---|---|
| System.AccessToken | OAuth belirteci kullanarak REST API.
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örevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Yes |
| System.CollectionId | TFS koleksiyonunun veya Azure DevOps GUID'si | Yes |
| System.CollectionUri | Bir dize Team Foundation Server URI'sini içerir. | Yes |
| System.DefaultWorkingDirectory |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: |
No |
| System.DefinitionId | Derleme işlem hattının kimliği. | Yes |
| System.HostType | İşlem hattı build bir derleme ise olarak ayarlayın. Bir yayın için değerler dağıtım grubu işi, geçitlerin değerlendirilmesi sırasında ve diğer (Aracı ve deploymentgatesrelease Aracısız) işler için değerlerdir. |
Yes |
| System.JobAttempt | Bu iş ilk kez denenirken 1 olarak ayarlanır ve iş her yeniden denenirken artırılır. | No |
| System.JobDisplayName | Bir işe verilen okunabilir ad. | No |
| System.JobId | Tek bir işin tek bir denemesi için benzersiz tanımlayıcı. Değer, geçerli işlem hattı için benzersizdir. | No |
| System.JobName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan işin adı. | No |
| System.PhaseAttempt | Bu aşama ilk kez denenirken 1 olarak ayarlanır ve iş her yeniden denenirken artırılır. Not: "Aşama", bir işin tasarım zamanını temsil eden çoğunlukla yedekli bir kavramdır (iş ise bir aşamanın çalışma zamanı sürümüdür). "Aşama" kavramını büyük ölçüde bu kavramlardan Azure Pipelines. Matris ve çoklu yapılandırma işleri, "aşama"nın "iş" aşamasından ayrı olduğu tek yerdir. Bir aşama, yalnızca girişlerinde farklı olan birden çok iş örneği oluşturabilir. |
No |
| System.PhaseDisplayName | Aşamaya verilen okunabilir ad. | No |
| System.PhaseName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan bir işin dize tabanlı tanımlayıcısı. | No |
| System.StageAttempt | Bu aşama ilk kez denenirken 1 olarak ayarlanır ve iş her yeniden denenirken artırılır. | No |
| System.StageDisplayName | Aşamaya verilen okunabilir ad. | No |
| System.StageName | Genellikle bağımlılıkları ifade etmek ve çıkış değişkenlerine erişmek için kullanılan bir aşama için dize tabanlı tanımlayıcı. | Yes |
| System.PullRequest.IsFork | Çekme isteği deponun bir mürekkeptense, bu değişken olarak True ayarlanır.
Aksi takdirde, olarak False ayarlanır. |
Yes |
| System.PullRequest.PullRequestId | Bu derlemeye neden olan çekme isteğinin kimliği. Örneğin: 17. (Bu değişken yalnızca, derleme dal ilkesi tarafından etkilenen bir Git PR'i nedeniyle çalışıldı ise başlatılır). |
No |
| System.PullRequest.PullRequestNumber | Bu derlemeye neden olan çekme isteğinin sayısı. Bu değişken, farklı bir çekme GitHub numarasına ve çekme isteği numarasına sahip olan çekme istekleri için doldurulur. Bu değişken yalnızca, PR bir dal ilkesi tarafından etkileniyorsa YAML işlem hattında kullanılabilir. | No |
| System.PullRequest.SourceBranch | Çekme isteğinde gözden geçirilan dal. Örneğin: refs/heads/users/raisa/new-feature. (Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır). Bu değişken yalnızca, çekme isteği bir dal ilkesinden etkileniyorsa YAML ardışık düzeninde kullanılabilir. |
No |
| System. PullRequest. SourceRepositoryURI | Çekme isteğini içeren deponun URL 'SI. Örneğin: https://dev.azure.com/ouraccount/_git/OurProject. |
No |
| System. PullRequest. TargetBranch | Çekme isteğinin hedefi olan dal. örneğin: refs/heads/master deponuz Azure Repos ve master deponuzun GitHub olduğunda. Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır. Bu değişken yalnızca, çekme isteği bir dal ilkesinden etkileniyorsa YAML ardışık düzeninde kullanılabilir. |
No |
| System. TeamFoundationCollectionUri | Team Foundation koleksiyonunun URI 'SI. Örnek: https://dev.azure.com/fabrikamfiber/
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Yes |
| System. TeamProject | Bu derlemeyi içeren projenin adı. | Yes |
| System. Teamprojectıd | Bu derleme ait olduğu projenin KIMLIĞI. | Yes |
| TF_BUILD | TrueBetik bir yapı görevi tarafından çalıştırılmakta ise olarak ayarlayın.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
No |
aracı değişkenleri (DevOps Server 2019)
Not
Aracı değişkenlerini, betiklerinizde ortam değişkenleri olarak ve derleme görevlerinizde parametre olarak kullanabilirsiniz. Yapı 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 |
Aracıdaki, belirli bir yapı işlem hattı için tüm klasörlerin oluşturulduğu yerel yol. Örnek: |
| 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 "Iş" veya "__default" olacaktır, ancak çoklu yapılandırma senaryolarında yapılandırma olacaktır. |
| Agent. JobStatus | Derleme durumu.
Ortam değişkenine olarak başvurulmalıdır |
| Agent. MachineName | Aracının yüklü olduğu makinenin adı. |
| Agent.Name |
Havuza kayıtlı aracının adı. Kendi kendine 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:
|
| Agent. OSArchitecture |
Aracı ana bilgisayarının işletim sistemi işlemci mimarisi. Geçerli değerler:
|
| Agent. TempDirectory | Her bir ardışık düzen 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. |
| Agent. araçları dizini |
Düğüm aracı yükleyicisi gibi görevler tarafından kullanılan dizin ve bir aracın birden çok sürümü arasında geçiş yapmak Için Python sürümünü kullanma .
Bu görevler, PATH sonraki derleme adımlarının bunları kullanabilmesi için bu dizinden araç ekler.
Bu dizini kendi kendine barındırılan bir aracıda yönetmehakkında bilgi edinin. |
| Agent. WorkFolder |
Bu aracı için çalışma dizini.
Örneğin: c:\agent_work.
Bu dizinin, işlem hattı görevleri tarafından yazılabilir olmadığı garanti edilmez (örn. bir kapsayıcıya eşlendiğinde) |
derleme değişkenleri (DevOps Server 2019)
| Değişken | Açıklama |
|---|---|
| Build. ArtifactStagingDirectory |
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
| Build. BuildId | Tamamlanan derleme için kayıt KIMLIĞI. |
| Build. BuildNumber | Tamamlanan derleme adı. İşlem hattı seçeneklerindebu değeri üreten yapı numarası biçimini belirtebilirsiniz.
Bu değişkenin tipik kullanımı, Depo sekmesindebelirttiğiniz etiket biçiminin bir parçası haline gelir. Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur.
|
| Build. BuildUri | Yapı için URI. Örneğin: vstfs:///Build/Build/1430.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. BinariesDirectory | Aracıdaki yerel yol, derlenmiş ikili dosyalar için bir çıkış klasörü olarak kullanabilirsiniz.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamış. Derlemeyi Depo sekmesindetemizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. DefinitionName | Derleme işlem hattının adı.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. DefinitionVersion | Derleme işlem hattının sürümü. |
| Build. QueuedBy | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. Queuedbyıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Derleme. nedeni | Yapıya çalışmasına neden olan olay.
|
| Build. Repository. Clean | Kaynak depo ayarlarındaTemizleme için seçtiğiniz değer.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. LocalPath |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken, Build. SourcesDirectory ile eşanlamlıdır. |
| Build.Repository.Name | Deponunadı.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Provider | Seçtiğiniz deponuntürü.
|
| Build. Repository. TFVC. Workspace | deponuz Team Foundation Sürüm Denetimi tanımlı. Yapı Aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent. BuildDirectory ise c:\agent_work\12 ve Agent.ID ise 8 , çalışma alanı adı şu olabilir: ws_12_8
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Uri | Deponun URL 'SI. Örnek: Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. RequestedFor | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Derleme. RequestedForEmail | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Build. Requestedforıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Build. SourceBranch | Yapılandırmanın sıraya alındığı dal. Bazı örnekler:
/ ) alt çizgi karakterleriyle değiştirilmiştir _ ).
Note: TFVC 'de, geçişli iade yapısı çalıştırıyorsanız veya bir raf kümesini el ile oluşturuyorsanız, bu değişkeni yapı numarası biçiminde kullanamazsınız. |
| Build. SourceBranchName | Yapılandırmanın sıraya alındığı dalın adı.
|
| Build. SourcesDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken Build. Repository. LocalPath ile eşanlamlıdır. |
| Build. SourceVersion | Bu derlemede bulunan en son sürüm denetimi değişikliği.
|
| Build. SourceVersionMessage | Tamamlama veya değişiklik kümesinin yorumu. İletiyi ilk satıra veya 200 karaktere kısaldık, hangisi daha kısadır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Note: Bu değişken TFS 2015,4 ' de mevcuttur. |
| Build. StagingDirectory |
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
| Build. Repository. git. SubmoduleCheckout | Depo sekmesindekullanıma alma alt modülleri için seçtiğiniz değer. Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. SourceTfvcShelveset | deponuz Team Foundation Sürüm Denetimi tanımlı.
Geçitli bir derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesinin adına ayarlanır. Note: Bu değişken yapı numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
| Build. TriggeredBy. BuildId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin BuildId olarak ayarlanır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. TriggeredBy. definitionId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin definitionId değerine ayarlanır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. TriggeredBy. DefinitionName | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derleme işlem hattının adına ayarlanır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. TriggeredBy. BuildNumber | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesinin numarası olarak ayarlanır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. TriggeredBy. ProjectId | Derleme başka bir derleme tarafından tetikleniyorsa, bu değişken tetikleme derlemesini IÇEREN projenin kimliği olarak ayarlanır.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Common. TestResultsDirectory | Aracıdaki test sonuçlarının oluşturulduğu yerel yol. Örnek: c:\agent_work\1\TestResults
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
sistem değişkenleri (DevOps Server 2019)
| Değişken | Açıklama |
|---|---|
| System. AccessToken | REST API erişmek Için OAuth belirtecini kullanın.
YAML betiklerinden System. AccessToken kullanın. Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System. CollectionId | TFS koleksiyonunun veya Azure DevOps kuruluşun guıd 'si |
| System. DefaultWorkingDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: |
| System. definitionId | Derleme işlem hattının KIMLIĞI. |
| System. Hosttürü | buildİşlem hattı bir yapı ise olarak ayarlayın. Bir sürüm için, değerler bir deployment dağıtım grubu işi ve bir release Aracı işi içindir.
|
| System. PullRequest. ısfork | Çekme isteği deponun çatalından ise, bu değişken olarak ayarlanır True .
Aksi takdirde, olarak ayarlanır False . |
| System. PullRequest. Pullrequestıd | Bu yapıya neden olan çekme isteğinin Kımlığı. Örneğin: 17. (Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır.) |
| System. PullRequest. PullRequestNumber | Bu yapıya neden olan çekme isteği sayısı. bu değişken, farklı bir çekme isteği kimliği ve çekme isteği numarası olan GitHub gelen çekme istekleri için doldurulur. |
| System. PullRequest. SourceBranch | Çekme isteğinde gözden geçirilmekte olan dal. Örneğin: refs/heads/users/raisa/new-feature. (Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır.) |
| System. PullRequest. SourceRepositoryURI | Çekme isteğini içeren deponun URL 'SI. Örneğin: https://dev.azure.com/ouraccount/_git/OurProject. (bu değişken yalnızca derleme bir dal ilkesinden etkilenen bir Azure Repos Git PRnedeniyle çalıştırıldığında başlatılır. GitHub pr 'ler için başlatılmaz.) |
| System. PullRequest. TargetBranch | Çekme isteğinin hedefi olan dal. Örneğin: refs/heads/master. Bu değişken yalnızca derleme bir dal ilkesinden etkilenen GIT PRnedeniyle çalıştırıldığında başlatılır. |
| System. TeamFoundationCollectionUri | Team Foundation koleksiyonunun URI 'SI. Örneğin: https://dev.azure.com/fabrikamfiber/.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System. TeamProject | Bu derlemeyi içeren projenin adı. |
| System. Teamprojectıd | Bu derleme ait olduğu projenin KIMLIĞI. |
| TF_BUILD | TrueBetik bir yapı görevi tarafından çalıştırılmakta ise olarak ayarlayın.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Aracı değişkenleri (TFS 2018)
Not
Aracı değişkenlerini, betiklerinizde ortam değişkenleri olarak ve derleme görevlerinizde parametre olarak kullanabilirsiniz. Yapı 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 |
Aracıdaki, belirli bir yapı işlem hattı için tüm klasörlerin oluşturulduğu yerel yol. Örnek: |
| 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. JobStatus | Derleme durumu.
Ortam değişkenine olarak başvurulmalıdır |
| Agent. MachineName | Aracının yüklü olduğu makinenin adı. |
| Agent.Name |
Havuza kayıtlı aracının adı. Bu ad sizin tarafınızdan belirtilir. Bkz. aracılar. |
| Agent. TempDirectory | Her bir ardışık düzen 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. |
| Agent. araçları dizini |
Düğüm aracı yükleyicisi gibi görevler tarafından kullanılan dizin ve bir aracın birden çok sürümü arasında geçiş yapmak Için Python sürümünü kullanma .
Bu görevler, PATH sonraki derleme adımlarının bunları kullanabilmesi için bu dizinden araç ekler.
Bu dizini kendi kendine barındırılan bir aracıda yönetmehakkında bilgi edinin. |
| Agent. WorkFolder |
Bu aracı için çalışma dizini.
Örneğin: c:\agent_work.
|
Derleme değişkenleri (TFS 2018)
| Değişken | Açıklama |
|---|---|
| Build. ArtifactStagingDirectory | Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol.
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
| Build. BuildId | Tamamlanan derleme için kayıt KIMLIĞI. |
| Build. BuildNumber | Tamamlanan derleme adı. İşlem hattı seçeneklerindebu değeri üreten yapı numarası biçimini belirtebilirsiniz.
Bu değişkenin tipik kullanımı, Depo sekmesindebelirttiğiniz etiket biçiminin bir parçası haline gelir. Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur.
|
| Build. BuildUri | Yapı için URI. Örneğin: vstfs:///Build/Build/1430.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. BinariesDirectory | Aracıdaki yerel yol, derlenmiş ikili dosyalar için bir çıkış klasörü olarak kullanabilirsiniz.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamış. Derlemeyi Depo sekmesindetemizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. DefinitionName | Derleme işlem hattının adı.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. DefinitionVersion | Derleme işlem hattının sürümü. |
| Build. QueuedBy | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. Queuedbyıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Derleme. nedeni | Yapıya çalışmasına neden olan olay.
|
| Build. Repository. Clean | Kaynak depo ayarlarındaTemizleme için seçtiğiniz değer.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. LocalPath |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken, Build. SourcesDirectory ile eşanlamlıdır. |
| Build.Repository.Name | Deponunadı.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Provider | Seçtiğiniz deponuntürü.
|
| Build. Repository. TFVC. Workspace | deponuz Team Foundation Sürüm Denetimi tanımlı. Yapı Aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent. BuildDirectory ise c:\agent_work\12 ve Agent.ID ise 8 , çalışma alanı adı şu olabilir: ws_12_8
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Uri | Deponun URL 'SI. Örnek:
|
| Build. RequestedFor | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Derleme. RequestedForEmail | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Build. Requestedforıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Build. SourceBranch | Yapılandırmanın sıraya alındığı dal. Bazı örnekler:
/ ) alt çizgi karakterleriyle değiştirilmiştir _ ).
Note: TFVC 'de, geçişli iade yapısı çalıştırıyorsanız veya bir raf kümesini el ile oluşturuyorsanız, bu değişkeni yapı numarası biçiminde kullanamazsınız. |
| Build. SourceBranchName | Yapılandırmanın sıraya alındığı dalın adı.
|
| Build. SourcesDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken Build. Repository. LocalPath ile eşanlamlıdır. |
| Build. SourceVersion | Bu derlemede bulunan en son sürüm denetimi değişikliği.
|
| Build. SourceVersionMessage | Tamamlama veya değişiklik kümesinin yorumu. İletiyi ilk satıra veya 200 karaktere kısaldık, hangisi daha kısadır.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Note: Bu değişken TFS 2015,4 ' de mevcuttur. |
| Build.StagingDirectory |
Aracıda, herhangi bir yapıt hedeflerine gitmeden önce kopyalanan yerel yol. Örnek: |
| Build.Repository.Git.SubmoduleCheckout | Depo sekmesindeki Checkout altmodules için seçtiğiniz değer. Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.SourceTfvcSh veri kümesi | Deponun kullanılabilir olup Team Foundation Sürüm Denetimi.
Geçitli derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesi adına ayarlanır. Not: Bu değişken, derleme numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
| Common.TestResultsDirectory | Test sonuçlarının oluşturularak aracıda yerel yol. Örnek: c:\agent_work\1\TestResults
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Sistem değişkenleri (TFS 2018)
| Değişken | Açıklama |
|---|---|
| System.AccessToken | OAuth belirteci kullanarak REST API.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System.CollectionId | TFS koleksiyonunun veya Azure DevOps GUID'si |
| System.DefaultWorkingDirectory |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: |
| System.DefinitionId | Derleme işlem hattının kimliği. |
| System.HostType | İşlem hattı build bir derleme ise veya işlem hattı bir release yayınsa olarak ayarlayın. |
| System.PullRequest.IsFork | Çekme isteği deponun bir mürekkeptense, bu değişken olarak True ayarlanır.
Aksi takdirde, olarak False ayarlanır. TFS 2018.2'de kullanılabilir. |
| System.PullRequest.PullRequestId | Bu derlemeye neden olan çekme isteğinin kimliği. Örneğin: 17. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceBranch | Çekme isteğinde gözden geçirilan dal. Örneğin: refs/heads/users/raisa/new-feature. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceRepositoryURI | Çekme isteğini içeren repo URL'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git Azure Repos nedeniyle çalışsa başlatılır.) |
| System.PullRequest.TargetBranch | Çekme isteğinin hedefi olan dal. Örneğin: refs/heads/master. Bu değişken yalnızca derleme, dal ilkesi tarafından etkilenen bir Git PR'i nedeniyle çalışsa başlatılır. |
| System.TeamFoundationCollectionUri | Team Foundation koleksiyonunun URI'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System.TeamProject | Bu derlemeyi içeren projenin adı. |
| System.TeamProjectId | Bu derlemenin ait olduğu projenin kimliği. |
| TF_BUILD | Betik True bir derleme görevi tarafından çalıştır ediliyorsa olarak ayarlayın.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Aracı değişkenleri (TFS 2017)
Not
Aracı değişkenlerini betiklerinize ortam değişkenleri olarak ve derleme görevlerinize parametre olarak kullanabilirsiniz. Bunları derleme numarasını özelleştirmek veya sürüm denetimi etiketi ya da etiketi uygulamak için kullanılamaz.
| Değişken | Açıklama |
|---|---|
| Agent.BuildDirectory |
Aracıda, bir derleme işlem hattı için tüm klasörlerin oluşturulacak yerel yolu. Örnek: |
| Agent.ComputerName | Aracının yüklü olduğu makinenin adı. |
| Agent.HomeDirectory | Aracının yüklü olduğu dizin. Bu, aracı yazılımını içerir. Örneğin: c:\agent. |
| Agent.Id | Aracı kimliği. |
| Agent.JobStatus | Derlemenin durumu.
Ortam değişkenine olarak |
| Agent.Name |
Havuza kayıtlı aracının adı. Bu ad sizin belirttiğiniz addır. Bkz. aracılar. |
| Agent. WorkFolder |
Bu aracı için çalışma dizini.
Örneğin: c:\agent_work.
|
Derleme değişkenleri (TFS 2017)
| Değişken | Açıklama |
|---|---|
| Build. ArtifactStagingDirectory | Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol.
Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: |
| Build. BuildId | Tamamlanan derleme için kayıt KIMLIĞI. |
| Build. BuildNumber | Tamamlanan derleme adı. İşlem hattı seçeneklerindebu değeri üreten yapı numarası biçimini belirtebilirsiniz.
Bu değişkenin tipik kullanımı, Depo sekmesindebelirttiğiniz etiket biçiminin bir parçası haline gelir. Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur.
|
| Build. BuildUri | Yapı için URI. Örneğin: vstfs:///Build/Build/1430.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. BinariesDirectory | Aracıdaki yerel yol, derlenmiş ikili dosyalar için bir çıkış klasörü olarak kullanabilirsiniz.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamış. Derlemeyi Depo sekmesindetemizlemek için tanımlayabilirsiniz. Örneğin: c:\agent_work\1\b.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. DefinitionName | Derleme işlem hattının adı.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. DefinitionVersion | Derleme işlem hattının sürümü. |
| Build. QueuedBy | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. Queuedbyıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Derleme. nedeni | Yapıya çalışmasına neden olan olay. TFS 2017,3' de kullanılabilir.
|
| Build. Repository. Clean | Kaynak depo ayarlarındaTemizleme için seçtiğiniz değer.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. LocalPath |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken, Build. SourcesDirectory ile eşanlamlıdır. |
| Build.Repository.Name | Deponunadı.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Provider | Seçtiğiniz deponuntürü.
|
| Build. Repository. TFVC. Workspace | deponuz Team Foundation Sürüm Denetimi tanımlı. Yapı Aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent. BuildDirectory ise c:\agent_work\12 ve Agent.ID ise 8 , çalışma alanı adı şu olabilir: ws_12_8
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Uri | Deponun URL 'SI. Örnek:
|
| 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. Bu durumlarda etiket biçimi başarısız olur. |
| Build.RequestedForEmail | Bkz." Kimlik değişkenleri nasıl ayarlanır?". |
| Build.RequestedForId | Bkz." Kimlik değişkenleri nasıl ayarlanır?". |
| Build.SourceBranch | Derlemenin kuyruğa alınan dalı. Bazı örnekler:
/ ) alt çizgi karakterleriyle _ değiştirilir.
Not: TFVC'de, geçitli iade derlemesi çalıştırıyorsanız veya el ile raf kümesi derlemeniz varsa, bu değişkeni derleme numarası biçiminde kullanılamaz. |
| Build.SourceBranchName | Derlemenin kuyruğa alınan dal adı.
|
| Build.SourcesDirectory |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: Bu değişken Build.Repository.LocalPath ile eş anlamlıdır. |
| Build.SourceVersion | Bu derlemeye dahil edilen en son sürüm denetimi değişikliği.
|
| Build.SourceVersionMessage | Commit veya changeset'in açıklaması. İletiyi ilk satıra veya 200 karaktere (hangisi daha kısa olursa) keseriz.
Bu değişken aracı kapsamlıdır ve bir betikte ortam değişkeni olarak ve derleme görevinin bir parametresi olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. Not: Bu değişken TFS 2015.4'te kullanılabilir. |
| Build.StagingDirectory |
Aracıda, herhangi bir yapıt hedeflerine gitmeden önce kopyalanan yerel yol. Örnek: |
| Build.Repository.Git.SubmoduleCheckout | Depo sekmesindeki Checkout altmodules için seçtiğiniz değer. Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.SourceTfvcSh veri kümesi | Deponun kullanılabilir olup Team Foundation Sürüm Denetimi.
Geçitli derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesi adına ayarlanır. Not: Bu değişken, derleme numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
| Common.TestResultsDirectory | Test sonuçlarının oluşturularak aracıda yerel yol. Örnek: c:\agent_work\1\TestResults
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Sistem değişkenleri (TFS 2017)
| Değişken | Açıklama |
|---|---|
| System.AccessToken | OAuth belirteci kullanarak REST API. |
| System.CollectionId | TFS koleksiyonunun veya Azure DevOps GUID'si |
| System.DefaultWorkingDirectory |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: |
| System.DefinitionId | Derleme işlem hattının kimliği. |
| System.HostType | İşlem hattı build bir derleme ise veya işlem hattı bir release yayınsa olarak ayarlayın. |
| System.PullRequest.PullRequestId | Bu derlemeye neden olan çekme isteğinin kimliği. Örneğin: 17. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceBranch | Çekme isteğinde gözden geçirilan dal. Örneğin: refs/heads/users/raisa/new-feature. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceRepositoryURI | Çekme isteğini içeren repo URL'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git Azure Repos nedeniyle çalışsa başlatılır.) |
| System.PullRequest.TargetBranch | Çekme isteğinin hedefi olan dal. Örneğin: refs/heads/master. Bu değişken yalnızca derleme, dal ilkesi tarafından etkilenen bir Git PR'i nedeniyle çalışsa başlatılır. |
| System.TeamFoundationCollectionUri | Team Foundation koleksiyonunun URI'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System.TeamProject | Bu derlemeyi içeren projenin adı. |
| System.TeamProjectId | Bu derlemenin ait olduğu projenin kimliği. |
| TF_BUILD | Betik True bir derleme görevi tarafından çalıştır ediliyorsa olarak ayarlayın.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Aracı değişkenleri (TFS 2015)
Not
Aracı değişkenlerini betiklerinize ortam değişkenleri olarak ve derleme görevlerinize parametre olarak kullanabilirsiniz. Bunları derleme numarasını özelleştirmek veya sürüm denetimi etiketi ya da etiketi uygulamak için kullanılamaz.
| Değişken | Açıklama |
|---|---|
| Agent.BuildDirectory |
Aracıda, bir derleme işlem hattı için tüm klasörlerin oluşturulacak yerel yolu. Örnek:
|
| Agent.HomeDirectory |
Aracının yüklü olduğu dizin. Bu, aracı yazılımını içerir. Örnek:
|
| Agent.Id | Aracı kimliği. |
| Agent.JobStatus | Derlemenin durumu.
Not: Ortam değişkenine yalnızca olarak başvurulmalıdır. |
| Agent.MachineName | Aracının yüklü olduğu makinenin adı. Bu değişken TFS 2015.4'tekullanılabilir, TFS 2015 RTM'de kullanılamaz. |
| Agent.Name |
Havuza kayıtlı aracının adı. Bu ad sizin belirttiğiniz addır. Bkz. aracılar. |
| Agent.WorkFolder |
Bu aracı için çalışma dizini.
Örneğin: c:\agent_work.
|
Derleme değişkenleri (TFS 2015)
| Değişken | Açıklama |
|---|---|
| Build.ArtifactStagingDirectory | Aracıda, herhangi bir yapıt hedeflerine gitmeden önce kopyalanan yerel yol.
Bu klasörü kullanmanın tipik bir yolu, Derleme yapıtlarınızı Dosyaları kopyala ve Derleme yapıtlarını yayımla görevleriyle yayımlamaktır. bkz. Artifacts içinde Azure Pipelines. Örnek:
TFS 2015.4'teBuild.ArtifactStagingDirectory ve Build.StagingDirectory birbirinin yerine kullanılabilir. Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.BuildId | Tamamlanan derleme için kaydın kimliği. |
| Build.BuildNumber | Tamamlanan derlemenin adı. İşlem hattı seçeneklerinde bu değeri oluşturan derleme numarası biçimini 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. Bu durumlarda etiket biçimi başarısız olur.
|
| Build.BuildUri | Derlemenin URI'si. Örneğin: vstfs:///Build/Build/1430.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.BinariesDirectory |
Aracıda derlenmiş ikili dosyalar için çıkış klasörü olarak kullanabileceğiniz yerel yol. TFS 2015.4'te kullanılabilir.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmaz. Derlemenizi depo sekmesinde temizlemek için tanımlayabilirsiniz. Örnek: C:\TfsData\Agents\Agent-MACHINENAME_work\1\b
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.DefinitionName | Derleme işlem hattının adı.
Not: Bu değer boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda etiket biçimi başarısız olur. |
| Build.DefinitionVersion | Derleme işlem hattının sürümü. |
| 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. Bu durumlarda etiket biçimi başarısız olur. |
| Build.QueuedById | Bkz." Kimlik değişkenleri nasıl ayarlanır?". |
| Build. Repository. Clean | Kaynak depo ayarlarındaTemizleme için seçtiğiniz değer.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. LocalPath |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken, Build. SourcesDirectory ile eşanlamlıdır. |
| Build.Repository.Name | Deponunadı.
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Provider | Seçtiğiniz deponuntürü.
|
| Build. Repository. TFVC. Workspace | deponuz Team Foundation Sürüm Denetimi tanımlı. Yapı Aracısı tarafından kullanılan TFVC çalışma alanının adı.
Örneğin, Agent. BuildDirectory ise c:\agent_work\12 ve Agent.ID ise 8 , çalışma alanı adı şu olabilir: ws_12_8
Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. Uri | Deponun URL 'SI. Örnek:
|
| Build. RequestedFor | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın.
Note: Bu değer, boşluk veya diğer geçersiz etiket karakterlerini içerebilir. Bu durumlarda, etiket biçimi başarısız olur. |
| Build. Requestedforıd | "Kimlik değişkenleri nasıl ayarlanır?" başlığına bakın. |
| Build. SourceBranch | Yapılandırmanın sıraya alındığı dal. Bazı örnekler:
/ ) alt çizgi karakterleriyle değiştirilmiştir _ ).
Note: TFVC 'de, geçişli iade yapısı çalıştırıyorsanız veya bir raf kümesini el ile oluşturuyorsanız, bu değişkeni yapı numarası biçiminde kullanamazsınız. |
| Build. SourceBranchName | Yapılandırmanın sıraya alındığı dalın adı.
|
| Build. SourcesDirectory |
Aracıdaki kaynak kodu dosyalarınızın indirileceği yerel yol. Örnek: Bu değişken Build. Repository. LocalPath ile eşanlamlıdır. |
| Build. SourcesDirectoryHash | Not: Bu değişken TFS 2015 RTM 'de kullanılabilir, ancak TFS 2015,4 ' de kullanılamaz. |
| Build. SourceVersion | Bu derlemede bulunan en son sürüm denetimi değişikliği.
|
| Build. SourceVersionMessage | Tamamlama veya değişiklik kümesinin yorumu. İletiyi ilk satıra veya 200 karaktere kısaldık, hangisi daha kısadır.
Bu değişken, aracı kapsamıdır ve bir betik içinde bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. Note: Bu değişken TFS 2015,4 ' de mevcuttur. |
| Build. StagingDirectory |
TFS 2015 RTM
Aracıdaki yerel yol, derlenmiş ikili dosyalar için bir çıkış klasörü olarak kullanabilirsiniz. Örneğin: C:\TfsData\Build_work\6c3842c6\staging.
Varsayılan olarak, yeni derleme işlem hatları bu dizini temizlemek için ayarlanmamış. Derlemeyi Depo sekmesindetemizlemek için tanımlayabilirsiniz. TFS 2015,4 Aracıdaki herhangi bir yapıtların hedefine gönderilmeden önce kopyalandığı yerel yol. Örnek: C:\TfsData\Agents\Agent-MACHINENAME_work\1\a
Bu dizin her yeni derlemeden önce temizlenir, bu nedenle kendiniz temizlemeniz gerekmez. Bu klasörü kullanmanın tipik bir yolu, derleme yapıtlarınızı dosyaları kopyalama ve derleme yapıtları yayımlama görevleri ile yayımlamaktır. Azure Pipelines Artifactsbakın. TFS 2015,4' de Build. ArtifactStagingDirectory ve Build. stagingdirectory ile değiştirilebilir. Tüm TFS 2015 sürümleri Bu değişken, aracıda kapsama sahip. Bir betikte bir ortam değişkeni olarak ve derleme görevindeki bir parametre olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build. Repository. git. SubmoduleCheckout | Depo sekmesindeki Checkout altmodules için seçtiğiniz değer. Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| Build.SourceTfvcSh veri kümesi | Deponun kullanılabilir olup Team Foundation Sürüm Denetimi.
Geçitli derleme veya raf kümesi derlemesiçalıştırıyorsanız, bu, oluşturmakta olduğunuz raf kümesi adına ayarlanır. Not: Bu değişken, derleme numarası biçiminde derleme kullanımı için geçersiz bir değer verir. |
| Common.TestResultsDirectory | Test sonuçlarının oluşturularak aracıda yerel yol. Örneğin: c:\agent_work\1\TestResults. TFS 2015.4'te kullanılabilir.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Sistem değişkenleri (TFS 2015)
| Değişken | Açıklama |
|---|---|
| System.AccessToken | TFS 2015.4'te kullanılabilir. OAuth belirteci kullanarak REST API.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System.CollectionId | TFS koleksiyonunun veya Azure DevOps GUID'si |
| System.DefaultWorkingDirectory |
Aracıda kaynak kod dosyalarınızın indiril olduğu yerel yol. Örnek: |
| System.DefinitionId | Derleme işlem hattının kimliği. |
| System.HostType | İşlem hattı build bir derleme ise veya işlem hattı bir release yayınsa olarak ayarlayın. |
| System.PullRequest.PullRequestId | Bu derlemeye neden olan çekme isteğinin kimliği. Örneğin: 17. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceBranch | Çekme isteğinde gözden geçirilan dal. Örneğin: refs/heads/users/raisa/new-feature. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git pr nedeniyle çalışıldı ise başlatılır.) |
| System.PullRequest.SourceRepositoryURI | Çekme isteğini içeren repo URL'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (Bu değişken yalnızca derleme bir dal ilkesi tarafından etkilenen git Azure Repos nedeniyle çalışsa başlatılır.) |
| System.PullRequest.TargetBranch | Çekme isteğinin hedefi olan dal. Örneğin: refs/heads/master. Bu değişken yalnızca derleme, dal ilkesi tarafından etkilenen bir Git PR'i nedeniyle çalışsa başlatılır. |
| System.TeamFoundationCollectionUri | Team Foundation koleksiyonunun URI'si. Örneğin: http://our-server:8080/tfs/DefaultCollection/.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
| System.TeamProject | Bu derlemeyi içeren projenin adı. |
| System.TeamProjectId | Bu derlemenin ait olduğu projenin kimliği. |
| TF_BUILD | Betik True bir derleme görevi tarafından çalıştır ediliyorsa olarak ayarlayın.
Bu değişken aracı kapsamlıdır. Bir betikte ortam değişkeni olarak ve derleme görevsinde parametre olarak kullanılabilir, ancak derleme numarasının bir parçası olarak veya sürüm denetimi etiketi olarak kullanılamaz. |
Kimlik değişkenleri nasıl ayarlanır?
Değer, derlemenin neden olduğu değere bağlıdır ve depolara Azure Repos bağlıdır.
| Derleme tetiklenirse... | Ardından Build.QueuedBy ve Build.QueuedById değerleri... | Ardından Build.RequestedFor ve Build.RequestedForId değerleri... |
|---|---|---|
| Git veya TFVC'de Sürekli tümleştirme (CI) tetikleyicileri | Sistem kimliği, örneğin: [DefaultCollection]\Project Collection Service Accounts |
Değişiklikleri teslim eden veya iade eden kişi. |
| Git'te veya dal ilkesiyle derleme. | 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 |
| Derlemeyi kuyruğa ekle düğmesine tıkladınız | Siz | Siz |
Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015
Not
Microsoft Team Foundation Server (TFS) 2018 ve önceki sürümlerinde derleme ve yayın işlem hatları tanımlar,çalıştırmalar derlemeler, hizmet bağlantıları hizmet uç noktaları,aşamalar ortamlar ve işler olarak adlandırılan aşamalar olarak adlandırılan bir uygulamadır.
Değişkenler, önemli veri parçalarını işlem hattınızı çeşitli bölümlerine almak için kullanışlı bir yol sağlar. Bu liste, kullanımınıza uygun önceden tanımlanmış değişkenlerin listesidir. Önceden tanımlanmış birkaç değişken daha olabilir, ancak bunlar çoğunlukla dahili kullanım için kullanılır.
Bu değişkenler sistem tarafından otomatik olarak ayarlanır ve salt okunur. (Özel durumlar Build.Clean ve System.Debug'dı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_ARTIFACTSTAGINGDIRECTORY olur.
Klasik işlem hatları için dağıtım görevlerinizin yayın değişkenlerini kullanarak ortak bilgileri paylaşabilirsiniz (örneğin, Ortam Adı, Kaynak Grubu vb.).
Değişkenlerle çalışma hakkında daha fazla bilgi.
Build.Clean
Bu, derleme aracı tarafından kaynağı temizlemeyi değiştiren kullanım dışı bir değişkendir. Kaynağı temizlemeyi öğrenmek için bkz. Aracıda yerel repo temizleme.
Bu değişken, derleme aracının kaynağı temizlemesi için değişiklik gösterir. Daha fazla bilgi edinmek için bkz. Aracıda yerel repo temizleme.
System. AccessToken
System.AccessToken , çalışan derleme tarafından kullanılan güvenlik belirtecini taşıyan özel bir değişkendir.
YAML 'de, bir değişken kullanarak işlem hattına açıkça eşleme yapmanız gerekir System.AccessToken . 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)
System.AccessTokenSystem.AccessTokenkullanmak için varsayılan kapsamı yapılandırabilirsiniz.
System. Debug
İşlem hattı sorunlarını ayıklamak için daha ayrıntılı Günlükler için, tanımlayın System.Debug ve olarak ayarlayın true .
İşlem hattınızı düzenleyin.
Değişkenler' i seçin.
Ad ve değere sahip yeni bir değişken ekleyin
System.Debugtrue.
Yeni değişkeni kaydedin.