Git depoları için işlem hattı seçenekleri

Dal

TFS 2017 RTM ve TFS 2015:Bu alan Varsayılan dal olarak adlandırılan bir alandır.

Bu, bu derlemeyi el ile kuyruğa almak için varsayılan olarak istediğiniz daldır. Derleme için zamanlanmış bir tetikleyici ayarsanız, bu, derlemenizin en son kaynakları hangi daldan edinecekleridir. Derlemenin sürekli tümleştirme (CI) ile tetiklendiğinde varsayılan dalın hiçbir ilgisi yoktur. Genellikle bunu deponun varsayılan dalı ile aynı olacak şekilde ayarlarsınız (örneğin, "ana").

Aracıda yerel repo temizleme

Derleme çalışmadan önce, kendi içinde barındırılan aracının çalışma dizinini temizlemenin farklı biçimlerini gerçekleştirebilirsiniz.

Genel olarak, kendi içinde barındırılan aracılarınızı daha hızlı performans için, repo temizlemeyin. Bu durumda, en iyi performansı elde etmek için, derlemek için kullanmakta olan görev veya aracın herhangi bir Temiz seçeneğini devre dışı bırakarak artımlı olarak da derlemeye devam edin.

Bir önceki derlemede yer alan artık dosyalardan kaynaklanan sorunları önlemek için, (örneğin,)po temizlemeniz gerekirse seçenekleriniz aşağıda verilmiştir.

TFS 2017 RTM

True'yi seçmeniz, derleme işlem hattında yapılan değişikliklerin geri alınarak gerçekleştirdiği bir işlem hattıdır. Hata oluşursa içeriğini $(Build.SourcesDirectory) siler.

Yukarıda açıklanan Clean anahtarının farklı şekilde çalışması için Değişkenler sekmesinde değişkeni tanımlayın ve değerini şu şekilde ayarlayın:

• all sources klasörünü, ikili dosyalar klasörünü, yapıt klasörünü ve diğer tüm çalışma klasörünü içeren 'i $(Agent.BuildDirectory) silmek için.

• source silmek istediğiniz $(Build.SourcesDirectory) .

• binarysilmek için . $(Build.BinariesDirectory)

TFS 2015.4

True'yi seçmeniz, derleme işlem hattında yapılan değişikliklerin geri alınarak gerçekleştirdiği bir işlem hattıdır. Hata oluşursa içeriğini $(Build.SourcesDirectory) siler.

Yukarıda açıklanan Clean anahtarının farklı şekilde çalışması için Değişkenler sekmesinde değişkeni tanımlayın ve değerini şu şekilde ayarlayın:

• all sources klasörünü, ikili dosyalar klasörünü, yapıt klasörünü ve diğer tüm çalışma klasörünü içeren 'i $(Agent.BuildDirectory) silmek için.

• source silmek istediğiniz $(Build.SourcesDirectory) .

• binarysilmek için . $(Build.BinariesDirectory)

TFS 2015 RTM

Depo klasörünü silmek için true'yi seçin.

Yukarıda açıklanan Clean anahtarının farklı şekilde çalışması için Değişkenler sekmesinde değişkeni tanımlayın ve değerini şu şekilde ayarlayın:

• all sources klasörünü, ikili dosyalar klasörünü, yapıt klasörünü ve diğer tüm çalışma klasörünü içeren 'i $(Agent.BuildDirectory) silmek için.

• source silmek istediğiniz $(Build.SourcesDirectory) .

• binarysilmek için . $(Build.BinariesDirectory)

Etiket kaynakları

Takımınıza, tamamlanan derlemede her bir dosyanın hangi sürümünün dahil olduğunu kolayca tanımlaması için kaynak kod dosyalarınızı etiketlemek istiyor olabilirsiniz. Ayrıca kaynak kodun tüm derlemeler için mi yoksa yalnızca başarılı derlemeler için mi etiketlenmiş olacağını belirtme seçeneğiniz de vardır.

Etiket biçiminde, "All" kapsamına sahip kullanıcı tanımlı ve önceden tanımlanmış değişkenleri kullanabilirsiniz. Örneğin:

$(Build.DefinitionName)_$(Build.DefinitionVersion)_$(Build.BuildId)_$(Build.BuildNumber)_$(My.Variable)

İlk dört değişken önceden tanımlanmıştır. My.Variable, değişkenler sekmesinde sizin tarafından My.Variable

Derleme işlem hattı, kaynaklarınızı Git etiketiyle etiketler.

Bazı derleme değişkenleri, geçerli bir etiket değil bir değer verir. Örneğin, ve gibi değişkenler $(Build.RequestedFor)$(Build.DefinitionName) boşluk içerebilir. Değer boşluk içeriyorsa etiket oluşturulmaz.

Kaynaklar derleme işlem hattınız tarafından etiketlendikten sonra, tamamlanmış derlemeye otomatik olarak Git refs/tags/{tag} ref'lü bir yapıt eklenir. Bu, takımınıza ek izlenebilirlik ve derlemeden, yerleşik koda gitmek için daha kolay bir yol sağlar. Etiket, derleme tarafından üretilen bir yapıt olarak kabul edilir. Derleme el ile veya bir saklama ilkesi aracılığıyla silindiğinde, etiket de silinir.

Rapor derleme durumu (Azure Pipelines, TFS 2017 ve daha yenisi)

Takımınıza uzak kaynak depodan derleme durumunu görüntüleme seçeneğine sahipsiniz.

Kaynaklarınız projenizin git deposunda Azure Repos, bu seçenek Derlemenin geçip geçe olmadığını belirtmek için Kod sayfasında bir rozet görüntüler. Derleme durumu aşağıdaki sekmelerde görüntülenir:

• Dosyalar:Seçilen dal için en son derlemenin durumunu gösterir.
• Commits:Her işlemenin derleme durumunu gösterir (bu, derlemeleriniz için sürekli tümleştirme (CI) tetikleyicinin etkinleştirilmesi gerekir).
• Dallar:Her dal için en son derlemenin durumunu gösterir.

Projeniz içinde aynı depo için birden çok derleme işlem hattı kullanıyorsanız, bir veya daha fazla işlem hattı için bu seçeneği etkinleştirmeyi seçebilirsiniz. Bu seçeneğin birden çok işlem hattında etkinleştirilmesi durumunda, Kod sayfasındaki rozet tüm işlem hatlarında en son derlemenin durumunu gösterir. Takım üyeleriniz derleme durumu rozetine tıklar ve derleme işlem hatlarının her biri için en son derleme durumunu görüntülemelerini sağlar.

GitHub

Kaynaklarınız GitHub durumunda ise, bu seçenek GitHub Veya Durum API'lerini kullanarak derlemenizin durumunu GitHub yayımlamak için yayımlar. Derlemeniz bir çekme isteğinden GitHub tetiklenirse, çekme istekleri sayfasında GitHub görüntüleyebilirsiniz. Bu ayrıca, uygulama içinde durum ilkeleri ayarlama GitHub birleştirmeleri otomatikleştirmenize olanak sağlar. Derlemeniz sürekli tümleştirme (CI) tarafından tetiklenirse, derleme durumunu işleme veya dalda sürekli tümleştirme GitHub.

Diğer Git uzak depo türleri

Kaynağınız başka bir uzak depo türünde ise derleme durumunu otomatik olarak bu depoda yayımlamak için Azure Pipelines veya TFS'yi kullanılamaz. Bununla birlikte, sürüm denetimi deneyimleriniz içinde derleme durumunu tümleştirin ve göstermenin bir yolu olarak derleme rozetini kullanabilirsiniz.

Çıkış yolu

Tek bir depoyu kullanıma alırsanız, kaynak kodunuz varsayılan olarak adlı bir dizine iade s edilir. YAML işlem hatları için, ile belirterek bunu checkoutpath değiştirebilirsiniz. Belirtilen yol ile $(Agent.BuildDirectory) görelidir. Örneğin, kullanıma alma yolu değeri ve ise mycustompath$(Agent.BuildDirectory) kaynak kodu içine C:\agent\_work\1C:\agent\_work\1\mycustompath denetlenir.

Birden çok adım kullanıyorsanız ve birden çok depoyu kontrol ediyorsanız ve kullanarak klasörü açıkça belirtmezseniz, her depo, depodan sonra adlı bir alt checkoutpaths klasöre yerleştirilir. Örneğin, ve adlı iki depoyu kullanıma toolscode aldıysanız, kaynak kodu ve içine C:\agent\_work\1\s\toolsC:\agent\_work\1\s\code denetlenir.

Lütfen ödeme yolu değerinin üzerinde herhangi bir dizin düzeyine gitmek için ayarlanamaysa da geçerli bir ödeme yolu (örneğin) ile sonuçlansa da gibi bir değer (örneğin , ) $(Agent.BuildDirectory)path\..\anotherpathC:\agent\_work\1\anotherpath..\invalidpathC:\agent\_work\invalidpath olmayacaktır.

Altmodülleri denetleme

Altmodüllerden dosya indirmek için seçeneğini seçin. Hemen altmodülleri veya tüm altmodülleri herhangi bir derinliğe iç içe yerleştirmeyi seçebilirsiniz. LFS'yi altmodüllerle kullanmak için LFS'yi altmodüllerle kullanma ile ilgili nota bakın.

Derleme işlem hattı, Git altmodüllerinizi şu şekilde olduğu sürece kontrol edin:

• Kimliği_doğrulanmamış: Kopyalama veya getirme için kimlik bilgilerine gerek olmayan ortak, kimliği doğrulanmamış bir depo.

• Kimlik doğrulaması:

  • Yukarıda belirtilen Git depos GitHub aynı projede, kuruluşta veya Bitbucket Cloud hesabında yer alan.

  • Ana depoya göre bir URL kullanılarak eklenir. Örneğin, bu kullanıma alınmış olabilir: git submodule add /../../submodule.git mymodule Bu, kullanıma alınmış olmaz: git submodule add https://dev.azure.com/fabrikamfiber/_git/ConsoleApp mymodule

Kimliği doğrulanmış altmodüller

Aracı tarafından ana depodan kaynakları almak için kullanılan kimlik bilgileri, altmodüllerin kaynaklarını almak için de kullanılır.

Ana depo ve altmodüller Azure Repos git Azure DevOps kullanılıyorsa, kaynaklara erişmek için kullanılan hesabı seçebilirsiniz. Seçenekler sekmesindeki Derleme işi yetkilendirme kapsamı menüsünde şunlardan birini seçin:

• Project Koleksiyonu Derleme hizmet hesabını Project için koleksiyon oluşturma

• Project Build Service hesabını kullanmak için geçerli proje.

Hangi hesabı kullanırsanız kullanın, hem ana depoya hem de altmodüllere erişime sahip olduğundan emin olun.

Ana depo ve altmodüller aynı GitHub ise, kaynaklara erişmek için GitHub hizmet bağlantısında depolanan belirteç kullanılır.

Satın alma altmodülleri seçeneğini kullanmanın alternatifi

Bazı durumlarda Satın alma altmodülleri seçeneğini kullanaabilirsiniz. Altmodüllere erişmek için farklı bir kimlik bilgileri kümesine ihtiyaç duyulan bir senaryo olabilir. Örneğin ana depo ve altmodül depoları aynı kuruluşta veya Git hizmetiyle Azure DevOps olabilir.

Satın alma altmodülleri seçeneğini kullanasanız, bunun yerine altmodülleri getirmek için özel bir betik adımı kullanabilirsiniz. İlk olarak, bir kişisel erişim belirteci (PAT) alın ve ön ek olarak pat: yazın. Ardından, temel bir kimlik doğrulama belirteci oluşturmak için bu ön ekli dizeyi base64 ile kodla. Son olarak, bu betiği işlem hattınıza ekleyin:

git -c http.https://<url of submodule repository>.extraheader="AUTHORIZATION: basic <BASE64_ENCODED_TOKEN_DESCRIBED_ABOVE>" submodule update --init --recursive

" < BASIC_AUTH_TOKEN " yerine > Base64 ile kodlanmış belirtecinizi değiştir

Proje veya derleme işlem hattında bir gizli değişken kullanarak, oluşturulan temel kimlik doğrulama belirteci depolar. Yukarıdaki Git komutunda gizli kodu doldurmak için bu değişkeni kullanın.

LFS'den dosyaları alma

Büyük dosya depolamadan (LFS) dosya indirmek istiyorsanız seçin.

Klasik düzenleyicide bu seçeneği etkinleştirmek için onay kutusunu işaretleyin.

YAML derlemesinde, olarak ayarlanmış bir onay lfs adımı true ekleyin:

steps:
- checkout: self
  lfs: true

• TFS 2017 RTM ve TFS 2015 (yalnızca macOS ve Linux): Değişkenler sekmesinde olarak ayarlayın.

TFS kullanıyorsanız veya kendi Azure Pipelines aracı kullanıyorsanız, bu seçeneğin çalışması için aracıya git-lfs yüklemeniz gerekir. Barındırılan aracılar Windows kullanıyorsa, işlem hatlarının makinede yüklü git ve git-lfs sürümlerini kullanmalarını sağlamak için System.PreferGitFromPath değişkenini kullanmayı göz önünde bulundurun.

Altmodüllerle Git LFS kullanma

Bir altmodül LFS dosyaları içeriyorsa, altmodülleri denetlemeden önce Git LFS'nin yapılandırılması gerekir. Microsoft tarafından barındırılan macOS ve Linux aracıları bu şekilde önceden yapılandırılmış olarak gelir. Windows aracıları ve kendi kendine barındırılan macOS /Linux aracıları bunu doğrulayamayabilirsiniz.

Geçici bir çözüm olarak, YAML kullanıyorsanız, önce aşağıdaki adımı checkout ekleyin:

steps:
- script: |
    git config --global --add filter.lfs.required true
    git config --global --add filter.lfs.smudge "git-lfs smudge -- %f"
    git config --global --add filter.lfs.process "git-lfs filter-process"
    git config --global --add filter.lfs.clean "git-lfs clean -- %f"
  displayName: Configure LFS for use with submodules
- checkout: self
  lfs: true
  submodules: true
# ... rest of steps ...

İkinci bir repo kopyalama

Varsayılan olarak, işlem hattınız bir depodan veya Azure Repos depoyla ilişkilendirildi. Bu, işlemeler ve çekme istekleri üzerinde derlemeleri tetikleyen bir repotur.

İşlem hattınıza ikinci bir depodan kaynakları dahil etmek istiyor olabilirsiniz. Bunu bir betik yazarak da yapabiliriz.

git clone https://github.com/Microsoft/TypeScript.git

Depo genel yoksa, Git komutuna kimlik doğrulamasını geçmelisiniz.

Azure Repos

İşlem hattınız projesinde diğer depolara zaten erişime sahip olur ve bunları aşağıdaki örnekte gösterildiği gibi bir betik komutu kullanarak işlem hattınıza kopyaabilirsiniz.

- script: | 
    git clone -c http.extraheader="AUTHORIZATION: bearer $(System.AccessToken)" https://organization@dev.azure.com/project/FabrikamFiber/_git/reponame

Birden çok depoyu alma kullanarak işlem hattınız ile aynı projede birden çok depo kopya bulabilirsiniz.

Kaynakları eşitleme (yalnızca TFS 2017 ve daha yeni sürümler)

Dağıtım dışı işler otomatik olarak kaynakları getirir. Bu davranışı atlamak için bu seçeneği kullanın. Bu seçenek, şunları yapmak istediğiniz durumlarda yararlı olabilir:

• Git init, config ve kendi özel seçeneklerinizi kullanarak getirme.

• Sürüm denetiminde koda bağımlı olan otomasyonu (örneğin bazı betikler) çalıştırmak için derleme işlem hattı kullanın.

Kaynakları indirmeyi devre dışı bırakmak için:

• Azure Pipelines, TFS 2017.2 ve daha yeni sürümler: Gelişmiş ayarlar'a tıklayın ve kaynakları eşitleme'yi seçin.

• TFS 2017 RTM:Değişkenler'de tanımlayın ve değerini false olarak ayarlayın.

Basit getirme

Geçmişin ne kadar geri indirile bir sınıra varmalarını istediğinize tıklayın. Bu, ile sonuç git fetch --depth=n verir. Depon büyükse, bu seçenek derleme işlem hattınızı daha verimli hale getirir. Depo, uzun süredir kullanıyorsa ve büyük bir geçmişi varsa büyük olabilir. Ayrıca, büyük dosyaları eklediy ve daha sonra sildikten sonra sildikten sonra büyük olabilir.

Böyle durumlarda bu seçenek ağ ve depolama kaynaklarını korumanıza yardımcı olabilir. Ayrıca zaman tasarrufu da olabilir. Her zaman tasarruf etmese de, bazı durumlarda sunucunun belirttiğiniz derinlik için indirilmesi gereken işlemeleri hesaplamak için zaman harcaması gerektir.

Azure Pipelines, TFS 2018, TFS 2017.2

Bu seçeneği etkinleştirmek için onay kutusunu işaretledikten sonra Derinlik kutusunda işleme sayısını belirtin.

TFS 2017 RTM, TFS 2015 (yalnızca macOS ve Linux)

Değişkenler sekmesinde değerini tanımlayın ve tarihte indirmek istediğiniz işleme sayısına ayarlayın. Sınır ayarlamak için 0'a ayarlayın.

Yoldan Git'i tercih

Windows aracı kendi Git kopyasıyla birlikte gelir. Dahil edilen kopyayı kullanmak yerine kendi Git'inizi sağlamak isterseniz olarak System.PreferGitFromPathtrue ayarlayın. Bu ayar, varsayılan olmayan aracılarda Windows olur.

Diğer Git için Tetikleyici Seçenekleri

Diğer/dış Git deposu kullanırken CI derlemeleri, deponun İnternet'te erişilebilir olmasını gerektirir. Depo bir güvenlik duvarı veya ara sunucu arkasında ise yalnızca zamanlanmış ve el ile yapılan derlemeler çalışır.

SSS

Derleme aracısı Git ile hangi protokolleri kullanabilir?

Aracı HTTPS'yi destekler.

Aracı henüz SSH'i desteklemez. Bkz. Git altmodüllerini kontrol ederken derlemenin SSH kimlik doğrulaması kullanmasına izin ver.

Şirket içi TFS'yi kullanıyor ve bu özelliklerden bazılarını göremiyorum. Neden olmasın?

Bu özelliklerden bazıları yalnızca şirket Azure Pipelines şirket içinde kullanılamaz. TFS'nin en son sürümüne yükseltme yaptıysanız bazı özellikler şirket içinde kullanılabilir.