Yapılandırma Aracıları Oluşturma ve Onlarla Çalışma

Team Foundation Yapısı'ni kullanmak için, en az bir yapı aracınızın olması gerekir. Yapı aracısı, yapınızın, sürüm denetiminden dosyaları alma, iş alanını destekleme, kodu derleme, testler çalıştırma ve sürüm kontrolüne geri döndüren dosyaları birleştirme gibi yoğun işlem içeren işlerini yapar. Her yapı aracısı tek bir yapı denetleyicisine verilir ve onun tarafından denetlenir.

Başlamadan Önce

• Yapı aracılarını kullanmanın farklı yollarına ek olarak onların bir yapı sistemindeki rolünü de öğrenmelisiniz. Daha fazla bilgi için bkz. Team Foundation Yapı Sistemini Anlama.

• Yapı aracısı bir yapı makinesinde barındırılır. Bundan dolayı, bir yapı makinesini, yapı aracısıyla oluşturmadan ve çalışmadan önce yapılandırmalısınız. Her yapı makinesi bir veya daha fazla yapı aracısı barındırabilir. Daha fazla bilgi için bkz. Bir Yapı Makinesini Yapılandırma.

Bu konuda

• Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)

• Yapı Aracısı Oluşturma

• Yapı Aracısını Değiştirme

• Yapı Aracısı Özellikleri İletişim Kutusu

  • Çalışma Dizini Özelliği Hakkında Daha Fazla Bilgi

• Ek yazılım yükleme

  • Kod Derlemesi için Gerekli Yazılımı Yükleme

  • Diğer Görevleri Gerçekleştirmek için Gerekli Yazılımı Yükleme

  • Yapılandırma Aracısı ile Testleri Çalıştırma

• Yapı Aracısı'na Etiketler Atayın

• Yapı Aracısını Kaldırma

Gerekli İzinler (bu sayfa İngilizce içeriğe sahip olabilir)

Bu yordamı gerçekleştirmek için, yapı makinesindeki Yöneticiler grubunun üyesi olmalısınız ve Yapı kaynaklarını yönet izninizin İzin Ver'e ayarlanmış olması gerekir. Daha fazla bilgi için bkz. Takım Kuruluş Sunucusu İzinleri.

Yapı Aracısı Oluşturma

Yapı aracısı oluşturma

1. Yapı aracısı oluşturmak istediğiniz yapı makinesinde oturum açın.

2. Başlat'ı tıklatın, Tüm Programlar'ı tıklatın, Microsoft Team Foundation Server 2010'ı tıklatın ve sonra Team Foundation Yönetim Uçbirimi'ni tıklatın.

   Team Foundation Yönetim Uçbirimi görünür.

3. Ağaç bölmesinde, sunucu adını genişletin ve sonra Team Foundation Yapısı devresini tıklatın.

   Yapı makinesi hakkındaki bilgi içerik bölmesinde görünür.

   Yapı Hizmeti şunun için yapılandırıldı… mesajı belirmezse, bkz. Bir Yapı Makinesini Yapılandırma.

4. Yeni Aracı seçeneğini tıklatın.

   Yapı Aracı Özellikleri iletişim kutusu görüntülenir. Daha fazla bilgi için bkz. Yapılandırma Aracısı Özellikleri. Bu konuda daha sonra.

5. Aracının özelliklerini değiştirmeyi bitirdiğinizde, OK öğesine tıklayın.

6. Başlat bağlantısı yapı aracısı adının hemen altında görünürse tıklatın.

Yapı Aracısını Değiştirme

Bir yapı aracısını bir istemci makineden veya doğrudan yapı aracısını barındıran yapı makinesinde değiştirebilirsiniz.

İstemci bir makineden yapı aracısını değiştirme

1. Visual Studio'da, Yapı menüsünü açın ve sonra Yapı Denetleyicilerini Yönet'i tıklatın.

   Yapı Denetleyicilerini Yönet iletişim kutusu görüntülenir.

2. Değiştirmek istediğiniz yapı aracısını ve sonra Özellikler'i tıklatın.

   Yapı Aracı Özellikleri iletişim kutusu görüntülenir.

Yapı makinesinde bir yapı aracısını değiştirme

1. Yapı aracısı oluşturmak istediğiniz yapı makinesinde oturum açın.

2. Başlat'ı tıklatın, Tüm Programlar'ı tıklatın, Microsoft Team Foundation Server 2010'ı tıklatın ve sonra Team Foundation Yönetim Uçbirimi'ni tıklatın.

   Team Foundation Yönetim Uçbirimi görünür.

3. Ağaç bölmesinde, sunucu adını genişletin ve sonra Team Foundation Yapısı devresini tıklatın.

4. Değiştirmek istediğiniz yapı aracısının adının hemen altında, Özellikler'i tıklatın.

   Yapı Aracı Özellikleri iletişim kutusu görüntülenir.

Yapı Aracısı Özellikleri İletişim Kutusu

Yapı Aracısı Özellikleri iletişim kutusunda, yapı aracısının nasıl işlediğini etkileyen diğer özelliklere ek olarak, görünen adı ve açıklamayı görebilir ve değiştirebilirsiniz.

Görünen Ad, Açıklama

Takım üyelerinin kolayca yapı aracısını tanımasına ve onun hakkındaki önemli bilgileri kolayca edinmesine yardım edebilecek bir ad ve açıklama sağlayın.

Denetleyici

Bu yapı aracısını denetlemesini istediğiniz yapı denetleyicisini belirtin. Yapı denetleyicisi bu yapı aracısı ile aynı yapı makinesinde veya farklı bir yapı makinesinde çalışabilir.

Bilgisayar Adı

Bu kutu yapı aracısını barındıran yapı makinesinin adını görüntüler.

Çalışma Dizini

Çalışma dizinine yolu belirtmek için bu kutuyu kullanın. Daha fazla bilgi için bkz. Çalışma Dizini Özelliği Hakkında Daha Fazla Bilgi.

Yapı Aracısı hizmeti etkinleştirilir

Bu yapı aracısının işlemesi için bu onay kutusunu işaretleyin veya onu devre dışı bırakmak ve yapıların ona atanmasını engellemek için kutuyu temizleyin.

İpucu
Yapı makinesinde sürdürme işlemi gerçekleştirdiğinize, yapı aracısını devre dışı bırakmak iyi bir fikirdir.

Çalışma Dizini Özelliği Hakkında Daha Fazla Bilgi

Yapı aracı, aracının dosyalardan okuması veya dosyalara yazmasının gerektiği işlemler için çalışma dizinini kullanır. Örneğin, kaynak dosyaları bu klasör üzerindeki alt dizinlere kopyalanır ve ikili değerler bu klasör üzerindeki diğer alt dizinlerde oluşturulur ve depolanır.

Çalışma Dizini Belirteci

Her ne kadar, Çalışma Dizini özelliği (örneğin, c:\temp\build\) için değişmez bir yol belirtebilseniz de, yolu belirtmek açısından belirteçleri kullanmak daha esnek bir yaklaşımdır. İki tür belirteçleri kullanabilirsiniz:

• Ortam değişkenleri: Ortam değişkenleri sistem ortamı ve oturum açmış olan kullanıcı hakkında bilgiler içerir.

  Örneğin, Team Foundation Yapı Hizmeti'yi BuildSvcAcct adında bir hesap altında çalışacak şekilde yapılandırdınız. Windows Server 2008 çalıştıran bir derleme makinesindeki derleme aracısı için çalışma dizini olarak $(HomeDrive)\Builds dizinini belirtin. Bunun sonucunda, yapı aracı, kendi çalışma dizini gibi genellikle aşağıdaki konuma yakın olan fiziksel bir dizin kullanacaktır: C:\Builds.

  İpucu
  Yapı makineniz üzerindeki ortam değişkenlerini listelemek için bir komut istemi açın ve set yazın.

• Team Foundation Build variables: Yapı aracısı çalışma directory'deki aşağıdaki değişkenleri kullanabilirsiniz:

  • $(BuildAgentId): Bir ekip projesi koleksiyonundaki yapılandırma aracısını benzersiz olarak tanımlayan otomatik olarak oluşturulmuş bir tamsayı.

  • $(BuildAgentName): Yapılandırma aracısının Görünen Adı.

  • $(BuildDefinitionId): Bir ekip projesi koleksiyonundaki bir yapı tanımını benzersiz olarak tanımlayan otomatik olarak oluşturulmuş bir tamsayı.

  • $(BuildDefinitionPath): Ters eğik çizgi ile ayrılmış ekip projesi adı ve yapı tanımı adı.

Çalışma Dizini Örneği

Örneğin, BuildBot3 adında bir oluşturma aracınız var. CoolApp adı verilen bir ekip projesinde NightlyBuild ve WeeklyBuild adında iki yapı tanımladınız. Çalışma Dizini kutusunda, aşağıdaki değeri belirtin: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). Bunun sonucunda, BuildBot3 yapı aracısı aşağıdaki iki çalışma dizini oluşturur ve kullanır:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Çalışma Dizininin Çok Uzun Olmadığından Emin Olun

Belirlenen çalışma dizini, yapı aracısının 259 değerden fazla karakter içeren fiziksel yolları ortaya koymasına yol açmamalıdır. Aksi takdirde, yapılarınız başarısız olacak ve bu hatayı günlüğe gireceksiniz: TF10128: YolPhysicalPath izin verilen 259 karakterden fazlasını içerir. Daha kısa bir yol yazın veya seçin. Genelde yapı aracılarının oluşturduğu fiziksel yolları fark edemeyeceğiniz için bu hata sizi şaşırtabilir.

Bu sorunu çözmek için daha kısa bir fiziksel yolla sonuçlanan bir çalışma dizini belirleyebilirsiniz. Örneğin aşağıdaki dizini belirtebilirsiniz: $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), bu da aşağıdaki konuma yakın olan bir çalışma dizini üzerinde görülür: c:\bld\3\2\.

Çalışma Dizininde Oluşturulmuş Alt Dizinler

Yapı aracısı, bu yol altındaki sonraki alt dizinlerde oluşturur ve çalışır.

Ek yazılım yükleme

Yapı aracınızın belirli görevleri gerçekleştirmesi için, derleme makinesi üzerine ek yazılım yüklemeniz gerekebilir.

Kod Derlemesi için Gerekli Yazılımı Yükleme

bir yapı aracısının en tipik projelerin çoğunu oluşturması için, ilave bir yazılıma gerek yoktur. Örneğin, herhangi bir ek yazılım yüklü olmadan, bir yapı aracısı temel bir Visual C# WPF uygulaması derleyebilir.

Ancak, diğer proje türlerini derlemek için ek yazılım yüklemeniz gerekir. Örneğin, bir Kurulum Projesi derlemek için Visual Studio yüklemeniz gerekir.

Yapı aracısının projelerinizi derleyebilmesini sağlamak için

1. Takımınızın kullandığı Visual Studio öğesinin sürümünü yapı aracısının çalıştığı yapı makinesine yükleyin.

2. Geliştirici ortamınızda yüklü olan, uygulamanızı yapılandırmak için gerekli olan diğer yazılım ve bileşenleri yükleyin.

Diğer Görevleri Gerçekleştirmek için Gerekli Yazılımı Yükleme

Bir yapı aracısının çeşitli diğer görevleri gerçekleştirmesi için, yapı makinesine ilave yazılım yüklenmesi gerekli olabilir. Aşağıdaki tablo bazı ortak yapı aracısı görevlerini ve bu görevleri gerçekleştirmek için gerekli olan yazılımı tanımlar.

Yapılandırma Aracısı ile Testleri Çalıştırma

Bir yapı aracısının testleri çalıştırabilmesi için, yapı aracısını etkileşimli olarak çalışacak biçimde ayarlamanız ya da yapı aracısını çalıştırmayı istediğiniz testlerin türüne göre yüklemeniz gerekli olabilir. Daha fazla bilgi için bkz. Nasıl yapılır: Uygulamanızı Oluşturduktan Sonra Zamanlanmış Testleri Yapılandırma ve Çalıştırma.

Yapı Aracısı'na Etiketler Atayın

Yapı sisteminizin ölçeği büyüdükçe, muhtemelen özel yapı aracılarınız gerekecektir. Bir yapı ajanı özel yeteneklere sahip olduğunda veya belirli türden bir kullanım için tasarlandığında, ajana bir veya daha fazla etiket atamanız gerekir. Böylece bir takım üyesi belirli bir tür yapı aracısı gerektiren bir yapı tanımı oluşturduğunda, yapı tanımında etiketi belirtebilir.

Yapı aracısına birden çok etiket uygulayabilirsiniz. Örneğin, 32 bitlik bir uygulamanın Sürüm yapılandırmasını derlemek için ayarlanmış bir aracıyı belirtmek üzere x86 etiketleri ve Sürümü olan bir oluşturma aracısı oluşturabilirsiniz.

Aynı yapı makine üzerinde birden fazla yapı aracısı çalıştırıyorsanız, muhtemelen hepsi aynı yeteneklere sahip olacaktır. Bu yüzden, büyük olasılıkla bu yapı makinesi üzerindeki tüm yapı aracılarına aynı etiketleri uygulamak istersiniz.

Yapı aracısı yeteneklerini temsil etmek için etiketler kullanın.

Aşağıdaki tablo temsil edebileceğiniz etiket adları ve yapı aracısı yetenekleri örnekleri sunar.

Yapı işleminizin yükünü dengelemek için etiketler kullanın.

Takımınızın gerçekleştirmesi gereken yapı işleme işinin yükünü dengelemek için etiketleri kullanabilirsiniz. Örneğin, iadelerinizi doğrulayan İade Oluşumu adında bir oluşum tanımınız olabilir. (Daha fazla bilgi için bkz. Değişiklikleri doğrulamak üzere bir Gated iade yapı tanımlayın.) Bu yapı tanımı genellikle çalıştırılır ve bir seferde yalnızca bir örneği çalıştırılabilir. Bu yüzden, yüksek performanslı donanım içeren bir yapı makinesi (örneğin, hızlı bir çok çekirdekli işlemci ve hızlı bir sabit disk sürücüsü) kurabilirsiniz. O makinede bir yapı aracısı oluşturun ve etiket girişi atayın. Giriş etiketi olan bir yapı aracısında çalıştırmak için derleme tanımını kurun.

Bir ekibin üzerinde çalıştığı yüksek öncelikli bir projenin yapılarını işlemek için kullanacağınız Hızlı İzleme Yapısı adında başka bir yapı tanımınız vardır. Bu özel projenin gereksinimlerini karşılayan başka bir derleme aracısı kurun. Yalnızca söz konusu etikete sahip bir yapı aracısında çalıştırmak için FastTrack etiketini atarsınız ve ardından yapı tanımını ayarlarsınız.

Bir istemci makine üzerindeki yapı aracısına bir etiket uygulamak için

1. Yapı menüsünde, Yapı Denetleyicilerini Yönet'i tıklatın.

   Yapı Denetleyicilerini Yönet iletişim kutusu görüntülenir.

2. Etiket uygulamayı istediğiniz yapı aracısını tıklatın, ardından Özellikler seçeneğini tıklatın.

   Yapı Aracı Özellikleri iletişim kutusu görüntülenir.

3. Bir veya daha fazla etiket uygulamak için aşağıdaki yöntemlerden birini kullanın:

   • Listeden bir veya daha fazla etiketi seçin.

   • Yeni etiket ekle bağlantısını tıklatın. Yeni Etiket Ekle iletişim kutusuna, uygulamak istediğiniz etiketin adını yazın.

Bir yapı makinesi üzerindeki yapı aracısına bir etiket uygulamak için

1. Yapı aracısı oluşturmak istediğiniz yapı makinesinde oturum açın.

2. Başlat'ı tıklatın, Tüm Programlar'ı tıklatın, Microsoft Team Foundation Server 2010'ı tıklatın ve sonra Team Foundation Yönetim Uçbirimi'ni tıklatın.

   Team Foundation Yönetim Uçbirimi görünür.

3. Ağaç bölmesinde, sunucu adını genişletin ve sonra Team Foundation Yapısı devresini tıklatın.

4. Yapı aracısının adının hemen altındaki Özellikler'i tıklatın.

   Yapı Aracı Özellikleri iletişim kutusu görüntülenir.

5. Bir veya daha fazla etiket uygulamak için aşağıdaki yöntemlerden birini kullanın:

   • Listeden bir veya daha fazla etiketi seçin.

   • Yeni etiket ekle bağlantısını tıklatın. Yeni Etiket Ekle iletişim kutusuna, uygulamak istediğiniz etiketin adını yazın.

Yapı Aracısını Kaldırma

Bir istemci makinesi kullanarak veya doğrudan yapı aracısını barındıran bir yapı makinesinden bir yapı aracısını kaldırabilirsiniz.

Not   Yapı aracısını kaldırma yapı makinesinden Team Foundation Yapı Hizmeti yüklemeyi kaldırmaz.

İstemci bir makine kullanarak yapı aracısını kaldırma

1. Yapı menüsünde, Yapı Denetleyicilerini Yönet'i tıklatın.

   Yapı Denetleyicilerini Yönet iletişim kutusu görüntülenir.

2. Kaldırmak istediğiniz yapı denetleyicisini veya yapı aracısını tıklatın ve ardından Sil'i tıklatın.

Yapı makinesinden yapı aracısını kaldırma

1. Yapı aracısı oluşturmak istediğiniz yapı makinesinde oturum açın.

2. Başlat'ı tıklatın, Tüm Programlar'ı tıklatın, Microsoft Team Foundation Server 2010'ı tıklatın ve sonra Team Foundation Yönetim Uçbirimi'ni tıklatın.

   Team Foundation Yönetim Uçbirimi görünür.

3. Ağaç bölmesinde, sunucu adını genişletin ve sonra Team Foundation Yapısı devresini tıklatın.

4. Yapı aracısının adının hemen altındaki Sil'i tıklatın.

Ayrıca bkz.

Diğer Kaynaklar

Tanımları oluşturma ve birlikte çalışma yaparsınız?

Tanımları oluşturma ve birlikte çalışma yaparsınız?