Aracılığıyla paylaş


Aracı havuzu oluşturma ve yönetme

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

Aracı havuzu bir aracı koleksiyonudur. Her aracıyı ayrı ayrı yönetmek yerine aracıları aracı havuzları halinde düzenlersiniz. Aracıyı yapılandırdığınızda, aracı tek bir havuza kaydedilir ve işlem hattı oluşturduğunuzda işlem hattının çalıştırıldığı havuzu belirtirsiniz. İşlem hattını çalıştırdığınızda, bu havuzdan işlem hattının taleplerini karşılayan bir aracı üzerinde çalışır.

Not

Yönetilen DevOps Havuzları aracı havuzları Azure Portal'da yönetilir. Yönetilen DevOps Havuzları kullanıyorsanız İlk Yönetilen DevOps Havuzunuzu oluşturma'ya bakınız.

Azure Pipelines'da havuzlar, kuruluşun tamamını kapsayacak şekilde belirlenmiştir; bu nedenle ajan makineleri projeler arasında paylaşabilirsiniz.

Azure DevOps Server'da aracı havuzlarının kapsamı sunucunun tamamına göre belirlenmiştir; aracı makinelerini projeler ve koleksiyonlar arasında paylaşabilirsiniz.

Not

Aracı havuzu işleri tek bir aracıda bir iş çalıştırır. Klasik yayın işlem hatları için bir dağıtım grubu gibi tüm aracılarda bir iş çalıştırmanız gerekiyorsa, Dağıtım gruplarını sağlama bölümüne bakın.

Kuruluş yöneticisiyseniz, yönetici ayarlarındaki aracı havuzları sekmesinden aracı havuzları oluşturup yönetirsiniz.

  1. Kuruluşunuzda oturum açın (https://dev.azure.com/{yourorganization}).

  2. Azure DevOps, Kuruluş ayarları'nı seçin.

    Kuruluş ayarları'nı seçin.

  3. Aracı havuzlarını seçin.

    Aracı havuzları sekmesini seçin.

  1. Proje koleksiyonunuzda (http://your-server/DefaultCollection) oturum açın.

  2. Azure DevOps, Koleksiyon ayarları'nı seçin.

    Koleksiyon ayarları'nı seçin.

  3. Aracı havuzları'nı seçin.

    Aracı havuzları'nı seçin.

Proje ekip üyesiyseniz, proje ayarlarındaki aracı havuzları sekmesinden aracı havuzları oluşturup yönetirsiniz.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları (2020) öğesini seçin.

Varsayılan aracı havuzları

Varsayılan olarak aşağıdaki aracı havuzları sağlanır:

  • Azure Pipelines tarafından barındırılan çeşitli Windows, Linux ve macOS görüntüleriyle havuz. Kullanılabilir görüntülerin ve yüklü yazılımların tam listesi için bkz Microsoft tarafından barındırılan aracılar.

    Not

    Azure Pipelines'in barındırılan havuzu, adları ilgili görüntülere eşlenen önceki barındırılan havuzların yerini alır. Önceki barındırılan havuzlardaki tüm işleriniz, yeni Azure Pipelines barındırılan havuzunda otomatik olarak doğru görüntüye yönlendirilir. Bazı durumlarda, hâlâ eski havuz isimlerini görebilirsiniz, ancak arka planda işler Azure Pipelines havuzunu kullanarak çalıştırılır. Daha fazla bilgi için Tek barındırılan havuz sürüm notlarına, 1 Temmuz 2019 - Sprint 154 sürüm notları kısmından bakın.

Varsayılan olarak, bir projedeki tüm katkıda bulunanlar barındırılan havuzlardaki Kullanıcı rolünün üyeleridir. Bu, bir projedeki tüm katkıda bulunanların Microsoft tarafından barındırılan aracıları kullanarak işlem hatları yazmasına ve çalıştırmasına olanak tanır.

İşlem hattınızda havuz belirleme

Azure DevOps Services YAML işlem hattınızdaki Azure Pipelines havuzundan Microsoft tarafından barındırılan bir aracı seçmek için, bu tablodaki YAML VM Görüntü Etiketi'ni kullanarak görüntünün adını belirtin.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Talepte bulunmadan özel havuz kullanmak için:

pool: MyPool

Daha fazla bilgi için havuzlar için YAML şemasına bakın.

Havuzları ve kuyrukları yönetme

Kuruluş yöneticisiyseniz, yönetici ayarlarındaki aracı havuzları sekmesinden aracı havuzları oluşturup yönetirsiniz.

  1. Kuruluşunuzda oturum açın (https://dev.azure.com/{yourorganization}).

  2. Azure DevOps, Kuruluş ayarları'nı seçin.

    Kuruluş ayarları'nı seçin.

  3. Aracı havuzları'nı seçin.

    Aracı havuzları sekmesini seçin.

  1. Proje koleksiyonunuzda (http://your-server/DefaultCollection) oturum açın.

  2. Azure DevOps, Koleksiyon ayarları'nı seçin.

    Koleksiyon ayarları'nı seçin.

  3. Aracı havuzlarını seçin.

    Aracı havuzları'nı seçin.

Proje ekip üyesiyseniz, proje ayarlarındaki aracı havuzları sekmesinden aracı havuzları oluşturup yönetirsiniz.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları'nı seçin.

Projenize gidin ve Proje ayarları, Aracı havuzları (2020) öğesini seçin.

Havuzu silmek için Aracı havuzları listesine gidin, Diğer seçenekler ve Sil öğelerini seçin.

Aracı havuzunu silme ekran görüntüsü.

Havuzlar işleri yürütmek için kullanılır. İşler için havuz belirtme hakkında bilgi edinin.

Farklı ekiplere veya amaçlara yönelik çok sayıda yerel barındırılan ajanınız varsa, aşağıda açıklandığı gibi ek havuzlar oluşturmak isteyebilirsiniz.

Ajan havuzları oluşturun

Kendine barındırılan aracı havuzları oluşturmak isteyebileceğiniz bazı tipik durumlar şunlardır:

  • Bir projenin üyesisiniz ve derleme ve dağıtım işlerini çalıştırmak için ekibinizin sahip olduğu bir makine kümesini kullanmak istiyorsunuz. İlk olarak, Proje ayarlarınızdaki aracı havuzları sayfasında Güvenlik'i seçerek projenizde havuz oluşturma izinlerine sahip olduğunuzdan emin olun. Yeni havuz oluşturabilmek için Yönetici rolüne sahip olmanız gerekir. Ardından Havuz ekle'yi seçin ve yeni havuz oluşturma seçeneğini belirleyin. Son olarak aracıları bu aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

  • Altyapı ekibinin bir üyesisiniz ve tüm projelerde kullanmak üzere bir aracı havuzu ayarlamak istiyorsunuz. İlk olarak, Kuruluş ayarlarınızdaki aracı havuzları sayfasında Güvenlik'i seçerek projenizde havuz oluşturma izinlerine sahip olduğunuzdan emin olun. Ardından bir Yeni aracı havuzu oluşturun ve havuzu oluştururken bu aracı havuzunu tüm projelerde otomatik olarak sağlama seçeneğini belirleyin. Bu ayar, tüm projelerin bu aracı havuzuna erişmesini sağlar. Son olarak, ajanları bu ajan havuzunun bir parçası olacak şekilde kurun ve yapılandırın.

  • Bir dizi ajan makinesini birden çok projeyle paylaşmak istiyorsunuz, ancak bunların tümünü paylaşmak istemiyorsunuz. İlk olarak projelerden birinin ayarlarına gidin, bir aracı havuzu ekleyin ve kuruluş düzeyinde yeni bir havuz oluşturma seçeneğini belirleyin. Ardından, diğer projelerin her birine gidin ve kuruluştaki mevcut aracı havuzunu kullan seçeneğini belirleyerek bunların her birinde bir havuz oluşturun. Son olarak aracıları yükleyin ve paylaşılan aracı havuzunun parçası olacak şekilde yapılandırın.

  • Bir projenin üyesisiniz ve derleme ve dağıtım işlerini çalıştırmak için ekibinizin sahip olduğu bir makine kümesini kullanmak istiyorsunuz. İlk olarak, Proje ayarlarınızdaki aracı havuzları sayfasında Güvenlik'i seçerek projenizde havuz oluşturma izinlerine sahip olduğunuzdan emin olun. Yeni havuz oluşturabilmek için Yönetici rolüne sahip olmanız gerekir. Ardından Havuz ekle'yi seçin ve yeni havuz oluşturma seçeneğini belirleyin. Son olarak aracıları bu aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

  • Altyapı ekibinin bir üyesisiniz ve tüm projelerde kullanmak üzere bir aracı havuzu ayarlamak istiyorsunuz. İlk olarak, Proje koleksiyonu ayarlarınızdaki aracı havuzları sayfasında Güvenlik'i seçerek projenizde havuz oluşturma izinlerine sahip olduğunuzdan emin olun. Ardından bir Yeni aracı havuzu oluşturun ve havuzu oluştururken bu aracı havuzunu tüm projelerde otomatik olarak sağlama seçeneğini belirleyin. Bu ayar, tüm projelerin bu aracı havuzuna erişmesini sağlar. Son olarak aracıları bu aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

  • Bir dizi aracı makineyi birden çok projeyle paylaşmak istiyorsunuz, ancak bunların tümünü paylaşmak istemiyorsunuz. İlk olarak projelerden birinin ayarlarına gidin, bir aracı havuzu ekleyin ve kuruluş düzeyinde yeni bir havuz oluşturma seçeneğini belirleyin. Ardından, diğer projelerin her birine gidin ve kuruluştaki mevcut aracı havuzunu kullan seçeneğini belirleyerek bunların her birinde bir havuz oluşturun. Son olarak aracıları yükleyin ve paylaşılan aracı havuzunun parçası olacak şekilde yapılandırın.

Aracı havuzlarının güvenliği

Aracı havuzları için güvenliğin nasıl çalıştığını anlamak, aracıların paylaşımını ve kullanımını denetlemenize yardımcı olur.

Roller her bir aracı havuzunda tanımlanır ve bu rollerdeki üyelik, aracı havuzları üzerinde gerçekleştirebileceğiniz işlemleri belirler.

Kuruluş düzeyinde güvenlik ayarları

Kuruluş ayarlarında aracı havuzundaki rol Purpose
Okuyucu Bu rollerdeki üyeler, aracı havuzunu ve aracıları görüntüleyebilir. Bu genellikle, aracıları ve sağlık durumlarını izlemekten sorumlu işleçleri eklemek için kullanılır.
Hizmet Hesabı Bu rolün üyeleri, bir projede proje aracısı havuzu oluşturmak için kuruluş aracı havuzunu kullanabilir. Yeni proje aracısı havuzları oluşturmak için yukarıdaki yönergeleri izlerseniz, genellikle buraya herhangi bir üye eklemeniz gerekmez.
Yönetici Yukarıdaki tüm izinlere ek olarak, bu rolün üyeleri kuruluş aracı havuzundan aracıları kaydedebilir veya kaydını kaldırabilir. Ayrıca, bir projede proje aracısı havuzu oluştururken kuruluş aracısı havuzuna da başvurabilir. Son olarak, kuruluş aracısı havuzunun tüm rolleri için üyeliği de yönetebilirler. Kuruluş aracısı havuzunu oluşturan kullanıcı otomatik olarak bu havuzun Yönetici rolüne eklenir.

Aracı Havuzları sekmesindeki Tüm aracı havuzları düğümü, tüm kuruluş aracı havuzlarının güvenliğini denetlemek için kullanılır. Bireysel organizasyon ajan havuzları için rol üyelikleri, otomatik olarak 'Tüm ajan havuzları' düğümünden miras alınır. Varsayılan olarak, TFS ve Azure DevOps Server yöneticileri de TFS veya Azure DevOps Server kullanırken 'Tüm aracı havuzları' düğümünün yöneticileridir.

Proje düzeyinde güvenlik ayarları

Roller her proje aracısı havuzunda da tanımlanır ve bu rollerdeki üyelikler, bir aracı havuzunda proje düzeyinde gerçekleştirebileceğiniz işlemleri yönetir.

Proje ayarlarında aracı havuzundaki rol Amaç
Okuyucu Bu rolün üyeleri proje aracısı havuzunu görüntüleyebilir. Bunu, proje aracı havuzuna derleme ve dağıtım işlerini izlemekle görevli operatörler eklemek için genellikle kullanırsınız.
Kullanıcı Bu rolün üyeleri işlem hatları yazarken proje aracısı havuzunu kullanabilir.
Yönetici Yukarıdaki tüm işlemlere ek olarak, bu rolün üyeleri proje aracısı havuzunun tüm rolleri için üyeliği yönetebilir. Havuzu oluşturan kullanıcı otomatik olarak bu havuzun Yönetici rolüne eklenir.

Pipeline izinleri

İşlem hattı izinleri, hangi YAML işlem hatlarının aracı havuzu kullanma yetkisine sahip olduğunu denetler. İşlem hattı izinleri Klasik işlem hatlarından erişimi kısıtlamaz.

Aşağıdaki seçeneklerden birini seçebilirsiniz:

  • Aracı havuzunun güvenlik sekmesindeki İşlem hattı izinleri bölümünün sağ üst köşesindeki diğer seçeneklerden, tüm işlem hatlarının aracı havuzunu kullanması için erişimi açın.

  • Ajan havuzunu kısıtlayın ve yalnızca seçili YAML işlem hatlarının kullanmasına izin verin. Başka bir YAML işlem hattı aracı havuzuna başvuruyorsa, aracı havuzu Yöneticisi tarafından onaylanması gereken bir yetkilendirme isteği oluşturulur. Bu, Klasik işlem hatlarından erişimi sınırlamaz.

Aracı havuzu için işlem hattı izinleri kullanıcı deneyiminin ekran görüntüsü.

Azure Pipelines aracı havuzu için işlem hattı izinleri, havuz varsayılan olarak tüm işlem hatlarına erişilebilir olduğundan yapılandırılamaz.

Aracı havuzları sekmesindeki Güvenlik eylemi, bir projedeki tüm proje aracısı havuzlarının güvenliğini denetlemek için kullanılır. Tek tek proje aracısı havuzları için rol üyelikleri, burada tanımladığınız kaynaktan otomatik olarak devralınır. Varsayılan olarak, 'Tüm aracı havuzları'nın Yönetici rolüne aşağıdaki gruplar eklenir: Derleme Yöneticileri, Yayın Yöneticileri, Proje Yöneticileri.

SSS

Bir bakım penceresi zamanlamazsam ajanlar ne zaman bakım yapacak?

Zamanlanmış bir pencere yoksa, bu havuzdaki aracılar bakım işini çalıştırmaz.

Bakım işi nedir?

Eski çalışma dizinlerini ve depolarını düzenli aralıklarla temizlemek için aracı havuzlarını yapılandırabilirsiniz. Bu, aracıların disk alanı yetersiz olma olasılığını azaltmalıdır. Bakım işleri aracı havuzu ayarlarında kuruluş düzeyinde yapılandırılır.

Bakım işi ayarlarını yapılandırmak için:

  1. Kuruluşunuzda oturum açın (https://dev.azure.com/{yourorganization}).

  2. Azure DevOps, Kuruluş ayarları'nı seçin.

    Kuruluş ayarları'nı seçin.

  3. 'Aracı havuzları'nı seçin.

    Aracı havuzları sekmesini seçin.

  1. Proje koleksiyonunuzda (http://your-server/DefaultCollection) oturum açın.

  2. Azure DevOps, Koleksiyon ayarları'nı seçin.

    Koleksiyon ayarları'nı seçin.

  3. Aracı havuzları'nı seçin.

    Aracı Havuzları Seçin.

İstediğiniz havuzu seçin ve Ayarlar'ı seçerek o aracıl havuzu için bakım görev ayarlarını yapılandırın.

Önemli

Bakım işi ayarlarını yapılandırmak için Derleme kuyruklarını yönetme iznine sahip olmanız gerekir. Ayarlar sekmesini veya Bakım Geçmişi sekmesini görmüyorsanız, varsayılan olarak Yönetici rolüne verilen bu izne sahip değilsinizdir. Daha fazla bilgi için bkz. Aracı havuzlarının güvenliği.

Bakım işi ayarları

İstediğiniz ayarları yapılandırın ve Kaydet'i seçin.

Geçerli aracı havuzunun bakım işi geçmişini görmek için Bakım Geçmişi'ni seçin. Temizleme adımlarını ve gerçekleştirilir eylemleri görmek için günlükleri indirebilir ve gözden geçirebilirsiniz.

Bakım işi geçmişi

Bakım, makine başına değil aracı havuzu başına yapılır; bu nedenle, tek bir makinede birden çok aracı havuzunuz varsa disk alanı sorunlarıyla karşılaşabilirsiniz.

Şirket içinde barındırılan aracı havuzumun bakım işi takılmış görünüyor. Neden?

Genellikle, bakım işi artık aracı havuzunda olmayan bir aracıda çalıştırılmasını beklediğinde "takılır". Bu durum, örneğin, aracı kasıtlı olarak çevrimdışına alındığında veya aracıyla iletişim sorunları olduğunda ortaya çıkar.

Çalıştırılacak şekilde kuyruğa alınan bakım işlerinin çalıştırılması yedi gün sürer. Daha sonra, çalıştırılmadıysa otomatik olarak başarısız duruma ayarlanır. Bu süre sınırı değiştirilemez.

Yedi günlük sınır, bakım işi zaman aşımı ayarından farklıdır. Sonuncusu, bir temsilcinin bakım yapma süresi için harcayabileceği maksimum dakika sayısını denetler. Zamanlayıcı, iş bir aracıya kuyruğa alındığında değil, başlatıldığında çalışmaya başlar.

Mevcut bir kuruluş aracısı havuzunu kullanan bir proje aracısı havuzu oluşturmaya çalışıyorum, ancak denetimler gri renkte görünüyor. Neden?

'Proje temsilci havuzu oluştur' iletişim kutusunda, başka bir proje temsilci havuzu tarafından zaten kullanılıyorsa var olan bir organizasyon temsilci havuzunu kullanamazsınız. Her kuruluş aracısı havuzuna, belirli bir proje koleksiyonu içindeki yalnızca bir proje aracısı havuzu tarafından başvurulabilir.

Microsoft tarafından barındırılan bir havuz seçemiyorum ve derlememi kuyruğa alamıyorum. Bunu nasıl düzeltirim?

Azure DevOps kuruluşunuzun sahibinden size havuzu kullanma izni vermesini isteyin. Bkz. Aracı havuzlarının güvenliği.

Daha fazla hosted build kaynağına ihtiyacım var. Ne yapabilirim?

Y: Azure Pipelines havuzu, tüm Azure DevOps kuruluşlarına her ay bulutta barındırılan derleme aracıları ve ücretsiz derleme dakikaları sağlar. Microsoft tarafından barındırılan daha fazla derleme kaynağına ihtiyacınız varsa veya paralel olarak daha fazla iş çalıştırmanız gerekiyorsa şunlardan birini yapabilirsiniz: