Yayın işlem hatları ve Yapıt kaynakları

  • Makale

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

Azure Pipelines ile çok çeşitli yapıt kaynaklarından yapıtlarınızı dağıtabilir ve iş akışınızı farklı yapıt depoları türleriyle tümleştirebilirsiniz. Yayınlar birden çok yapıt kaynağına bağlanabilir ve burada birincil kaynak olarak atanabilir.

Yapıt kaynakları

Azure Pipelines çok çeşitli depoları, kaynak denetim araçlarını ve sürekli tümleştirme sistemlerini destekler.

Yayın oluştururken yapıt kaynağınızın sürümünü belirtebilirsiniz. Varsayılan olarak, sürümler kaynak yapıtın en son sürümünü kullanır. Ayrıca etiketleri, belirli bir sürümü belirterek belirli bir daldan en son derlemeyi kullanmayı seçebilir veya yayın oluşturma sırasında kullanıcının sürümü belirtmesine izin vekleyebilirsiniz.

Klasik yayın işlem hattına yapıt eklemeyi gösteren ekran görüntüsü.

Birden fazla yapıtı bağlarsanız, hangisinin birincil kaynak (varsayılan) olduğunu belirtebilirsiniz. Birincil yapıt kaynağı, önceden tanımlanmış bir dizi değişken ayarlamak için kullanılır. Ayrıca, sürümleri adlandırmak için de kullanılabilir.

Birincil kaynak yapıtın nasıl ayarlandığını gösteren ekran görüntüsü.

Not

Default version Açılan öğeler, bağlı derleme tanımının kaynak türüne bağlıdır.

  • Aşağıdaki seçenekler tüm depo türleri tarafından desteklenir: Specify at the time of release creation, Specific versionve Latest.

  • Latest from a specific branch with tags ve Latest from the build pipeline default branch with tags seçenekleri aşağıdaki depo türleri tarafından desteklenir: TfsGit, GitHub, Bitbucketve GitHubEnterprise.

  • Latest from the build pipeline default branch with tags derleme tanımları tarafından XAML desteklenmez.

Aşağıdaki bölümlerde, farklı yapıt kaynakları türleriyle nasıl çalışıldığı açıklanmaktadır.

Yapıt kaynakları - Azure Pipelines

Yayın işlem hattını herhangi bir Azure Pipelines derlemesine bağlayabilirsiniz. Ayrıca birden çok derleme işlem hattını bağlayabilir ve bunların varsayılan değerlerini belirtebilir ve birden çok derleme kaynağında dağıtım tetikleyicileri ayarlayabilirsiniz. Derlemelerden herhangi biri tamamlandığında bir yayın oluşturulması tetiklenir.

Yapıt kaynağı olarak Azure Pipelines kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.
Dağıtım aşamaları Derleme özeti, yapıtın dağıtıldığı tüm dağıtım aşamalarını listeler.

Not

Derleme işlem hattınıza Yapıtları Yayımla görevi eklemeniz gerekir. YAML derleme işlem hatları için, ad bırakmasına sahip bir yapıt örtük olarak yayımlanır.

Varsayılan olarak, yayınlar koleksiyon düzeyinde bir iş yetkilendirme kapsamıyla çalışır. Bu, yayınların kuruluştaki tüm projelerdeki (veya Azure DevOps Server koleksiyonundaki) kaynaklara erişebileceği anlamına gelir. Bu, diğer projelerden derleme yapıtlarını bağlarken kullanışlıdır. Projenin yapıtına erişimi kısıtlamak için proje ayarlarında Yayın işlem hatları için İş yetkilendirme kapsamını geçerli projeyle sınırla seçeneğini etkinleştirebilirsiniz.

Kuruluş için iş yetkilendirme kapsamını ayarlamak için:

  • Kuruluş ayarlarınıza gidin.
  • İşlem hatları'nın altında Ayarlar'ı seçin.
  • Kapsamı geçerli projeyle sınırlamak için Yayın işlem hatları için İş yetkilendirme kapsamını geçerli projeyle sınırla iki durumlu düğmesini açın. Bu, iyi bir güvenlik önlemleri için önerilen ayardır.

Belirli bir projenin iş yetkilendirme kapsamını ayarlamak için:

  • Proje ayarlarınıza gidin.
  • İşlem hatları'nın altında Ayarlar'ı seçin.
  • Kapsamı geçerli projeyle sınırlamak için Yayın işlem hatları için İş yetkilendirme kapsamını geçerli projeyle sınırla iki durumlu düğmesini açın. bu, işlem hatlarınızın güvenliğini artırdıkça önerilen ayardır.

Not

Kapsam kuruluş düzeyinde proje olarak ayarlandıysa, her projede kapsamı değiştiremezsiniz.

Bir yayındaki tüm işler, iş yetkilendirme kapsamı koleksiyon olarak ayarlanmış şekilde çalışır. Başka bir deyişle, bu işler proje koleksiyonunuzdaki tüm projelerdeki kaynaklara erişebilir.

Yapıt kaynakları - sürüm denetimi

Farklı kaynak denetimlerindeki yapıtları derleme işlem hattından geçirmeden doğrudan kullanmak isteyebileceğiniz bazı senaryolar vardır. Örneğin:

  • Açık derleme işlem hattı gerektirmeyen bir PHP veya JavaScript uygulaması geliştirme.

  • Farklı sürüm denetimi depolarındaki çeşitli aşamalar için yapılandırmaları yönetirsiniz ve dağıtım işlem hattının bir parçası olarak bu yapılandırma dosyalarını doğrudan sürüm denetiminden kullanmak istiyorsunuz.

  • Altyapınızı ve yapılandırmanızı kod olarak yönetirsiniz ve bu dosyaları bir sürüm denetimi deposunda yönetmek istersiniz.

Tek bir yayın işlem hattında birden çok yapıt kaynağı yapılandırabileceğinizden, hem uygulamanızın ikili dosyalarını üreten bir derleme işlem hattını hem de yapılandırma dosyalarını aynı işlem hattında depolayan bir sürüm denetimi deposunu bağlayabilir ve dağıtım sırasında iki yapıt kümesini birlikte kullanabilirsiniz.

Azure Pipelines Team Foundation Sürüm Denetimi (TFVC) depolarını, Git depolarını ve GitHub depolarını destekler.

Yayın işlem hattını koleksiyonunuzdaki herhangi bir projedeki Git veya TFVC depolarına bağlayabilirsiniz (bu depolara okuma erişiminiz olmalıdır). Aynı koleksiyon içinde sürüm denetimi yapıtları dağıtılırken ek kurulum gerekmez.

GitHub deposunu bağlayıp bir dal seçtiğinizde, yapıt kaydedildikten sonra yapıt türlerinin varsayılan özelliklerini düzenleyebilirsiniz. Bu özellikle yapıtın kararlı sürümü için dalın değiştiği ve sürekli teslim sürümlerinin yapıtın daha yeni sürümlerini elde etmek için bu dalı kullanması gereken senaryolarda kullanışlıdır. Ayrıca, kullanıma alma alt modüllerinin ve LFS tarafından izlenen dosyaların ve sığ getirme derinliğinin olup olmadığı gibi kullanıma alma işleminin ayrıntılarını belirtebilirsiniz.

Bir TFVC dalını bağladığınızda, yayın oluştururken dağıtılacak değişiklik kümesini belirtebilirsiniz.

Yapıt kaynağı olarak TFVC, Git ve GitHub kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini, sürüm ayrıntılarında görüntülenecek şekilde bağlayabilirsiniz. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Varsayılan olarak, yayınlar koleksiyon düzeyinde bir iş yetkilendirme kapsamıyla çalışır. Bu, yayınların kuruluştaki tüm projelerdeki (veya Azure DevOps Server koleksiyonundaki) kaynaklara erişebileceği anlamına gelir. Bu, diğer projelerden derleme yapıtlarını bağlarken kullanışlıdır. Projenin yapıtına erişimi kısıtlamak için proje ayarlarında Yayın işlem hatları için İş yetkilendirme kapsamını geçerli projeyle sınırla seçeneğini etkinleştirebilirsiniz.

Yapıt kaynakları - Jenkins

Jenkins yapıtlarını kullanmak için Jenkins sunucunuzla kimlik doğrulaması yapmak için bir hizmet bağlantısı oluşturmanız gerekir. Daha fazla bilgi için bkz . Hizmet bağlantılarını ve Jenkins hizmet bağlantısını yönetme. Jenkins projesi, yapıtlarınızı yayımlamak için derleme sonrası eylemiyle yapılandırılmalıdır.

Jenkins bir yapıt kaynağı olarak kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Jenkins derlemeleri tarafından oluşturulan yapıtlar genellikle arşivleme ve paylaşım için depolama depolarına yayılır. Azure blob depolama, azure depolamada yapıt kaynakları olarak yayımlayan Jenkins projelerini bir yayın işlem hattında kullanmanıza olanak sağlayan desteklenen depolardan biridir. Azure Pipelines yapıtları Azure'dan işlem hattını çalıştıran aracıya otomatik olarak indirir. Bu senaryoda, aracı ile Jenkins sunucusu arasında bağlantı gerekli değildir. Microsoft tarafından barındırılan aracılar, sunucuyu İnternet'e göstermeden kullanılabilir.

Not

Azure Pipelines, örneğin kurumsal ağınızdaysa Jenkins sunucunuzla iletişim kuramayabilir. Böyle bir durumda, Jenkins sunucusuna erişebilen bir şirket içi aracı ayarlayarak Azure Pipelines'ı Jenkins ile tümleştirebilirsiniz. Bir derlemeye bağlanırken Jenkins projelerinizin adını göremezsiniz, ancak adı URL metin alanına girebilirsiniz.

Yapıt kaynakları - kapsayıcılar

Kapsayıcılı uygulamaları dağıtırken, kapsayıcı görüntüsü önce kapsayıcı kayıt defterine gönderilir. Ardından kapsayıcı görüntünüzü Kapsayıcılar için Azure Web App'e veya Docker/Kubernetes kümesine dağıtabilirsiniz. Azure'da kimlik doğrulaması yapmak için bir hizmet bağlantısı oluşturmanız gerekir. Diğer ayrıntılar için bkz . hizmet bağlantılarını yönetme.

Yapıt kaynağı olarak Azure Container kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Not

Birden çok yapıt kaynağı kullanılırken, bir yapıt kaynağının belirli bir aşamayı tetiklemesi için eşlenmesi desteklenmez. Yapıt kaynaklarından herhangi birine gönderim olduğunda bir yayın oluşturulur. Bunu yapmak isterseniz Azure Pipelines yayın işlem hattınızı birden çok sürüme bölmenizi önerir.

Yapıt kaynakları - Azure Artifacts

Azure Artifacts'i yapıt kaynağı olarak kullanabileceğiniz senaryolardan bazıları aşağıdadır:

  1. Uygulama ikili dosyanız Azure Artifacts'te yayımlanır ve paketi bir yayın işlem hattında kullanmak istiyorsunuz.
  2. Dağıtım iş akışınızın bir parçası olarak Azure Artifacts'te depolanan ek paketlere ihtiyacınız vardır.

Yayın işlem hattınızda Azure Artifacts'i kullanarak paketiniz için Akış, Paket ve Varsayılan sürümü seçmeniz gerekir. Paketin en son sürümünü almayı, belirli bir sürümü kullanmayı veya sürüm oluşturma sırasında sürümü seçmeyi seçebilirsiniz. Dağıtım sırasında paket, işlem hattınızı çalıştıran aracıya indirilir/ayıklanır.

Yapıt kaynağı olarak Azure Artifacts kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Maven anlık görüntülerini işleme

Maven anlık görüntülerini kullanırken, aynı anda birden çok sürüm indirilebilir (örneğinmyApplication-2.1.0.BUILD-20190920.220048-3.jar, , myApplication-2.1.0.BUILD-20190820.221046-2.jarmyApplication-2.1.0.BUILD-20190820.220331-1.jar). Eski sürümü kaldırmanız ve dağıtımdan önce yalnızca en son Yapıtı tutmanız gerekebilir. Yükseltilmiş bir komut isteminde aşağıdaki PowerShell komutunu çalıştırarak en yüksek sözcük temelli değere sahip kopya dışındaki tüm kopyaları kaldırın:

Get-Item "myApplication*.jar" | Sort-Object -Descending Name | Select-Object -SkipIndex 0 | Remove-Item

Not

Akışınızda en fazla 30 Maven anlık görüntüsü depolayabilirsiniz. Maksimum sınıra ulaştığınızda Azure Artifacts, 25'e kadar olan anlık görüntüleri otomatik olarak siler. Akışınızda 30'undan fazla anlık görüntü yayımlandığında bu işlem otomatik olarak tetiklenir.

Yapıt kaynakları - TFS sunucusu

Şirket içi otomasyon aracısı ayarlayarak sunucunuzu İnternet'te bulunabilir hale getirmek zorunda kalmadan TFS sunucularından yapıt dağıtmak için Azure Pipelines'ı kullanabilirsiniz. Yapıtlar şirket içi aracıya indirilir ve ardından kurumsal ağınızdan çıkmadan belirtilen hedef sunuculara dağıtılır. Bu, müşterilerin Azure Pipelines sürümlerinden yararlanırken şirket içi altyapı yatırımlarından yararlanmaları için idealdir.

TFS sunucularını yapıt kaynağı olarak kullanmak için Visual Studio Market'ten Azure Pipelines uzantısı için TFS yapıtlarını yüklemeniz ve ardından Azure Pipelines ile kimlik doğrulaması yapmak için bir hizmet bağlantısı oluşturmanız gerekir. Kimlik doğrulamasından sonra bir TFS derleme işlem hattını yayın işlem hattınıza bağlayabilir ve Tür açılan menüsünden Dış TFS Derlemesi'ni seçebilirsiniz.

TFS sunucuları yapıt kaynağı olarak kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Azure Pipelines, kurumsal ağınızda olması durumunda şirket içi TFS sunucusuyla iletişim kuramayabilir. Bu durumda, TFS sunucusuna erişebilen bir şirket içi aracı ayarlayarak Azure Pipelines'u TFS ile tümleştirebilirsiniz. Derlemeye bağlanırken TFS projelerinizin veya derleme işlem hatlarınızın adını göremezsiniz, ancak bu değişkenleri URL metin alanlarına ekleyebilirsiniz. Ayrıca, bir yayın oluşturduğunuzda, Azure Pipelines derleme numaraları için TFS sunucusunu sorgulayamayabilir. Bunun yerine, istenen derlemenin Derleme Kimliğini (derleme numarasını değil) uygun alana girin veya En son derlemeyi seçin.

Yapıt kaynakları - TeamCity

TeamCity'yi Yapıt kaynağı olarak kullanmak için önce Visual Studio Market'ten Azure Pipelines için TeamCity yapıtlarını yüklemeniz gerekir.

İşlem tamamlandıktan sonra TeamCity sunucunuzla kimlik doğrulaması yapmak için bir hizmet bağlantısı oluşturun. Ardından derleme yapıtınızı bir yayın işlem hattına bağlayabilirsiniz. TeamCity derleme yapılandırması, yapıtları yayımlamak için bir eylemle ayarlanmalıdır.

TeamCity yapıt kaynağı olarak kullanılırken aşağıdaki özellikler kullanılabilir:

Özellik Açıklama
Yayınları otomatik tetikleme Yeni bir derleme yapıtı kullanılabilir olduğunda (XAML derlemeleri dahil) yeni sürümler otomatik olarak oluşturulabilir. Daha fazla ayrıntı için bkz . Yayın tetikleyicileri .
Yapıt değişkenleri Azure Pipelines kaynakları için bir dizi yapıt değişkeni desteklenir.
İş öğeleri ve işlemeler Azure Pipelines iş öğelerini bağlayabilirsiniz ve bunlar sürüm ayrıntılarında görüntülenir. Git veya TFVC kaynak denetimlerini kullandığınızda işlemeler görüntülenir.
Yapıt indirme Varsayılan olarak, derleme yapıtları işlem hattını çalıştıran aracıya indirilir. Yapıtınızın indirilmesini atlamak için aşamanızda bir adım da yapılandırabilirsiniz.

Azure Pipelines, örneğin kurumsal ağınızdaysa TeamCity sunucunuzla iletişim kuramayabilir. Bu durumda, TeamCity sunucusuna erişebilen bir şirket içi aracı ayarlayarak Azure Pipelines'i TeamCity ile tümleştirebilirsiniz. Derlemeye bağlanırken TeamCity projelerinizin adını göremezsiniz, ancak bunu URL metin alanına yazabilirsiniz.

Yapıt kaynağı diğer adı

Her yapıt indirmesinin benzersiz olmasını sağlamak için, yayın işlem hattına bağlı her yapıt kaynağı otomatik olarak kaynak diğer adı olarak bilinen belirli bir indirme konumuyla sağlanır. Bu konuma şu değişken kullanılarak erişilebilir: $(System.DefaultWorkingDirectory)\[source alias]

Kaynak diğer adlarının kullanılması, bağlı yapıt kaynağını yeniden adlandırmanın görev özelliklerinin düzenlenmesini gerektirmemesini sağlar çünkü aracıda tanımlanan indirme konumu değişmez.

Varsayılan olarak, kaynak diğer adı bir alt çizgi ile ön ekli yapıt kaynağının adıdır. Yapıt kaynağının türüne bağlı olarak, bu derleme işlem hattının adı, iş adı, proje adı veya depo adı olacaktır. Yayın işlem hattınızın yapıtlar sekmesinden kaynak diğer adını düzenleyebilirsiniz.

Yapıt indirme

Bir aşamaya dağıtım tamamlandığında, her bir kaynaktan sürümlenmiş yapıtlar işlem hattı aracısına indirilir, böylece bu aşamada çalışan görevler bu yapıtlara erişebilir. İndirilen yapıtlar bir yayın tamamlandığında silinmez. Ancak, bir sonraki sürümü başlattığınızda, indirilen yapıtlar silinir ve yeni yapıt kümesiyle değiştirilir.

Bir yayın başlatıldığında her yayın işlem hattı için aracıda yeni bir benzersiz klasör oluşturulur ve yapıtlar aşağıdaki klasöre indirilir:$(System.DefaultWorkingDirectory).

Azure Pipelines, aynı sürüm yeniden dağıtılırsa değişmemiş yapıtların indirilmesini önlemek için herhangi bir iyileştirme gerçekleştirmez. Ayrıca, yeni bir sürüm başlattığınızda önceden indirilen içerikler her zaman silindiğinden Azure Pipelines aracıya artımlı indirme gerçekleştiremez.

Ancak, işlem hattınızı belirli bir iş veya aşama için otomatik indirmeyi atlamak üzere ayarlayabilirsiniz.