Aracı havuzu oluşturma ve yönetme

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Aracı havuzu bir aracı koleksiyonudur. Her aracıyı ayrı ayrı yönetmek yerine aracıları aracı havuzları halinde düzenlersiniz. Aracı yapılandırdığınızda, ajan tek bir havuza kaydedilir. İş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.

Yönetilen DevOps Havuzları aracı havuzları Azure portalında yönetilir. Yönetilen DevOps Havuzları kullanıyorsanız havuz oluşturma hızlı başlangıcına bakın.

Azure Pipelines'da havuzların kapsamı kuruluşun tamamına göre belirlenmiştir, böylece aracı makinelerini projeler arasında paylaşabilirsiniz.

Aracı havuzu işleri tek bir aracıda bir iş çalıştırır. Tüm aracılarda, örneğin klasik yayın işlem hatları için bir dağıtım grubunda bir iş çalıştırmanız gerekiyorsa Dağıtım grupları 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.

   

3. Ajan Havuzları'nı seçin.

   

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

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

Varsayılan aracı havuzları

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

• Varsayılan havuz: Ayarladığınız kendi kendine barındırılan aracıları kaydetmek için bunu kullanın.

• Azure Pipelines: Bu barındırılan havuz çeşitli Windows, Linux ve macOS görüntüleriyle birlikte gelir. 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.

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

İşlem hattınızda havuz belirleme

YAML

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 tablodakiYAML 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.

Klasik

Klasik düzenleyicide bir havuz ve aracı seçmek için işlem hattı ayarlarına gidin. Aracı Belirtimi açılan menüsünden istenen Aracı havuzu değerini ve istenen görüntüyü seçin. Varsayılan Aracı Belirtimi seçimi windows-2019'dur. Microsoft tarafından barındırılan görüntülerde yüklü olan yazılım hakkında daha fazla bilgi için bu tablonunKlasik Düzenleyici Havuzu sütunundaki ilgili girişe bakın.

Havuzları ve kuyrukları yönetme

Azure Pipelines Kullanıcı Arabirimi

Kuruluş yöneticileri, yönetici ayarlarındaki Aracı havuzları sekmesinden aracı havuzları oluşturur ve yönetir.

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

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

   

3. Ajan Havuzları'nı seçin.

   

Proje ekibi üyeleri, proje ayarlarındaki Aracı havuzları sekmesinden aracı havuzları oluşturur ve yönetir.

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

Havuzu silmek için Aracı havuzları listesine gidin ve Diğer seçenekler>Sil'i seçin.

Azure DevOps CLI

Aracı havuzlarını listele | Aracı havuzu ayrıntılarını göster | Aracı kuyruklarını listele | Aracı kuyruğu ayrıntılarını göster

Not

Kullanıcılar Azure CLI kullanarak aracı havuzları ve kuyrukları hakkındaki bilgileri görüntüleyebilir ancak düzenleyemez.

Komutları ilk kez kullanıyorsanız az devops pipelines bkz. Azure DevOps CLI'yı kullanmaya başlama.

Aracı havuzlarını listele

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parametreler

• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler , manageve nonedeğerleridiruse.
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler false ve true'dir.
• org veya organization: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir. Örneğin: https://dev.azure.com/MyOrganizationName/.
• pool-name: Listeyi eşleşen bir havuz adıyla filtreleyin.
• pool-type: Listeyi havuz türüyle filtreleyin. Kabul edilen değerler automation ve deployment'dir.

Örnek

Aşağıdaki örnek, tüm havuzları tablo biçiminde listeler. Bu örnekte aşağıdaki varsayılan yapılandırma kullanılır: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool list --output table

ID    Name                             Is hosted    Pool type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Aracı havuzu ayrıntılarını göster

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parametreler

• id veya pool-id: (Gerekli) Ayrıntıları listelemek için havuzun kimliği.
• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler , manageve nonedeğerleridiruse.
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler false ve true'dir.
• org veya organization: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir. Örneğin: https://dev.azure.com/MyOrganizationName/.

Örnek

Aşağıdaki örnek VS2019'lu Barındırılan Windows 2019 havuzu için havuz ayrıntılarını görüntüler. Bu örnekte aşağıdaki varsayılan yapılandırma kullanılır: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Aynı bilgileri döndüren --output table komutunu da list komutuyla birlikte kullanabilirsiniz.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Aracı kuyruklarını listeleme

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parametreler

• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler , manageve nonedeğerleridiruse.
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler false ve true'dir.
• org veya organization: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir. Örneğin: https://dev.azure.com/MyOrganizationName/.
• project veya p: Projenin adı veya kimliği. az devops configure -d project=NAME_OR_IDkullanarak varsayılan projeyi yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir.
• queue-name: Listeyi eşleşen bir kuyruk adı regex ile filtreleyin (örneğin, Barındırılan Ubuntu 1604 adlı bir kuyruk için ubuntu).

Örnek

Aşağıdaki örnekte tüm kuyruklar tablo biçiminde listelemektedir. Bu örnekte aşağıdaki varsayılan yapılandırma kullanılır: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue list --output table
This command group is in preview. It might be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Temsilci kuyruğu ayrıntılarını göster

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parametreler

• id veya queue-id: Bilgi edinmek için aracı kuyruğunun kimliği.
• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler , manageve nonedeğerleridiruse.
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler false ve true'dir.
• org veya organization: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir. Örneğin: https://dev.azure.com/MyOrganizationName/.
• project veya p: Projenin adı veya kimliği. az devops configure -d project=NAME_OR_IDkullanarak varsayılan projeyi yapılandırabilirsiniz. Bu işlem, varsayılan olarak yapılandırılmadıysa veya Git yapılandırması aracılığıyla alınmadıysa gereklidir.

Örnek

Aşağıdaki örnek, VS2019 ile Barındırılmış Windows 2019 kuyruğuna dair ayrıntıları görüntüler. Aşağıdaki varsayılan yapılandırmayı kullanır: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

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

Farklı ekipler veya amaçlar için tasarlanmış birçok kendi barındırdığınız aracınız varsa, daha fazla havuz oluşturmak isteyebilirsiniz. Aşağıdaki yönergeleri kullanın.

Ajan havuzları oluşturun

Şirket içinde barındırılan aracı havuzları oluşturmak isteyebileceğiniz bazı tipik durumlar aşağıda verilmiştir.

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:

1. Projenizde havuz oluşturma izinlerinizin olduğundan emin olun. Proje ayarlarındaAracı havuzları bölmesine gidin ve Güvenlik'i seçin. Yeni havuzlar oluşturmak için Yönetici rolüne sahip olmanız gerekir.
2. Havuz ekle'yi seçin ve ardından yeni havuz oluşturma seçeneğini belirleyin.
3. Aracıları yeni aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

Altyapı ekibinin bir üyesisiniz ve tüm projelerde kullanılacak bir aracı havuzu ayarlamak istiyorsunuz:

1. Projenizde havuz oluşturma izinlerinizin olduğundan emin olun. Kuruluş ayarları'ndaAracı havuzları bölmesine gidin ve Güvenlik'i seçin.
2. Yeni aracı havuzu oluşturun ve havuzu oluştururken bu aracı havuzunu tüm projelerde otomatik olarak sağla seçeneğini belirleyin. Bu ayar, tüm projelerin bu aracı havuzuna erişmesini sağlar.
3. Aracıları yeni aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

Bir dizi aracı makineyi bazı projelerinizle paylaşmak istiyorsunuz ancak hepsini paylaşmak istemiyorsunuz.

1. Projelerden biri için Ayarlar'a gidin. Bir aracı havuzu ekleyin ve kuruluş düzeyinde yeni bir havuz oluşturma seçeneğini belirleyin.
2. Diğer projelere gidin ve her birinde bir havuz oluşturun. Kuruluştan mevcut bir aracı havuzunu kullan'ı seçin.
3. Aracıları paylaşılan aracı havuzunun parçası olacak şekilde yükleyin ve yapılandırın.

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

Aracı havuzları için güvenliğin nasıl çalıştığını anladığınızda, aracıların paylaşımını ve kullanımını daha iyi denetleyebilirsiniz.

Roller her bir aracı havuzunda tanımlanır. Bu rollerdeki üyelik, aracı havuzunda gerçekleştirebileceğiniz işlemleri yönetir.

Kuruluş düzeyinde güvenlik ayarları

Kuruluş Ayarlarında ajan havuzunda rol	Purpose
Reader	Bu rolün üyeleri aracı havuzunu ve aracıları görüntüleyebilir. Bu rolü genellikle aracıları ve bunların sağlığını izlemekle sorumlu olan işleçleri eklemek amacıyla kullanırsınız.
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 önceki yönergeleri izlerseniz, genellikle buraya ü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. Ayrıca organizasyonun/şirketin aracısı havuzundaki tüm roller için üyeliği yönetebilirler. Kuruluş aracısı havuzu oluşturan kullanıcıya otomatik olarak bu havuz için Yönetici rolü atanır.

Aracı Havuzları sekmesindeki Tüm aracı havuzları düğümü, tüm kuruluş aracı havuzlarının güvenliğini denetler. Tek tek kuruluş aracı havuzları için rol üyelikleri otomatik olarak Tüm aracı havuzları düğümünden devralınır. Varsayılan olarak Azure DevOps Server yöneticileri, Azure DevOps Server kullanırken Tüm aracı havuzları düğümünün de yöneticisidir.

Proje düzeyinde güvenlik ayarları

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

Proje Ayarları'nda ajan havuzundaki rol	Purpose
Reader	Bu rolün üyeleri proje aracısı havuzunu görüntüleyebilir. Bu rolü genellikle bu proje aracı havuzundaki derleme ve dağıtım işlerini izleyen operatörleri eklemek için kullanırsınız.
User	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. Kuruluş aracısı havuzu oluşturan kullanıcıya otomatik olarak bu havuz için Yönetici rolü atanır.

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 işlemlerden birini seçin:

• Aracı havuzunun güvenlik sekmesindeki İşlem hattı izinleri bölümünün sağ üst köşesindeki diğer seçeneklerden aracı havuzunu kullanmak için tüm işlem hatları için erişimi açın.
• Aracı havuzunu kilitleyin ve yalnızca seçili YAML işlem hatlarının kullanmasına izin verin. Aracı havuzuna başka bir YAML işlem hattı başvuruyorsa, bir aracı havuzu Yöneticisinin onaylaması gereken bir yetkilendirme isteği oluşturulur. Bu işlem klasik işlem hatlarından erişimi sınırlamaz.

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

Aracı havuzları sekmesindeki Güvenlik eylemi, bir projedeki tüm proje aracısı havuzlarının güvenliğini denetler. 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ınYönetici rolüne aşağıdaki gruplar eklenir: Derleme Yöneticileri, Yayın Yöneticileri ve Proje Yöneticileri.

SSS

Bakım penceresi zamanlaması yapmazsam, aracılar bakımı ne zaman gerçekleştirir?

Eğer bir pencere programlamazsanız, bu havuzdaki aracılar bakım işini çalışmaz.

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 işlem, aracıların disk alanının yetersiz olması olasılığını azaltı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ırma:

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

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

   

3. Ajan Havuzları'nı seçin.

   

İstediğiniz havuzu seçin ve ardından Ayarlar'ı seçerek aracı havuzu için bakım işi 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 veya Bakım Geçmişi sekmelerini görmüyorsanız, Yönetici rolünün varsayılan olarak sahip olduğu bu izne sahip değilsinizdir. Daha fazla bilgi için bkz. Aracı havuzlarının güvenliği.

İ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, makine başına değil aracı havuzu başına yapılır. Tek bir makinede birden çok aracı havuzu 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 bir bakım işi, artık aracı havuzunda olmayan bir aracıda çalıştırılacak şekilde beklerken takılır. Örneğin, bir aracı kasıtlı olarak çevrimdışına alındı veya onunla iletişimde sorunlar yaşanıyor.

Çalışmak üzere kuyruğa alınan bakım işleri yedi gün boyunca çalışır. Bu süre boyunca çalıştırılamazlarsa, otomatik olarak başarısız durumda olur. Bu zaman sınırını değiştiremezsiniz.

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 kullanarak bir proje aracısı havuzu oluşturmaya çalışıyorum, ancak kontroller mevcut değil. Neden?

Proje aracısı havuzu oluşturma iletişim kutusunda, başka bir proje aracısı havuzu zaten buna referans veriyorsa mevcut bir kuruluş aracısı havuzunu kullanamazsınız. Her kuruluş aracısı havuzuna bir proje koleksiyonu içinde 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. Bu sorunu nasıl düzeltebilirim?

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?

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 şunları yapabilirsiniz:

• Yönettiğiniz altyapıda kendi aracılarınızı barındırma
• Daha fazla paralel iş satın alın