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.

Azure Pipelines'da havuzların kapsamı kuruluşun tamamına göre belirlenmiştir; aracı makinelerini projeler 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 dağıtım grubu gibi tüm aracılarda bir iş çalıştırmanız gerekiyorsa bkz . Dağıtım grupları sağlama.

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

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

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

   

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

Varsayılan aracı havuzları

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

• Varsayılan havuz: Ayarladığınız şirket içinde barındırılan aracıları kaydetmek için bu aracıyı kullanın.

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

  Not

  Azure Pipelines barındırılan havuzu, ilgili görüntülere eşlenen adları olan önceki barındırılan havuzların yerini alır. Önceki barındırılan havuzlarda sahip olduğunuz tüm işler, yeni Azure Pipelines barındırılan havuzunda otomatik olarak doğru görüntüye yönlendirilir. Bazı durumlarda, eski havuz adlarını görmeye devam edebilirsiniz, ancak arka planda barındırılan işler Azure Pipelines havuzu kullanılarak çalıştırılır. Daha fazla bilgi için 1 Temmuz 2019 - Sprint 154 sürüm notlarının Tek barındırılan havuz sürüm notlarına 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

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

Klasik

Klasik düzenleyicide bir havuz ve aracı seçmek için işlem hattı ayarlarına gidin, istediğiniz Aracı havuzunu seçin ve ardından Aracı Belirtimi açılan listesinden istediğiniz görüntüyü seçin. Varsayılan Aracı Belirtimi windows-2019'dur. Microsoft tarafından barındırılan görüntülere yüklenen yazılım hakkında daha fazla bilgi için, bu tablonun Klasik Düzenleyici Havuzu sütunundaki ilgili girişe bakın.

Havuzları ve kuyrukları yönetme

Tarayıcı

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

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

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

   

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

Azure DevOps CLI

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

Not

Şu anda Azure CLI kullanarak aracı havuzları ve kuyrukları hakkındaki bilgileri görüntüleyebilir, ancak düzenleyemezsiniz.

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

Aracı havuzlarını listeleme

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: yönet, yok, kullan
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true
• kuruluş veya kuruluş: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/.
• pool-name: Listeyi eşleşen havuz adıyla filtreleyin.
• pool-type: Listeyi havuz türüyle filtreleyin. Kabul edilen değerler: otomasyon, dağıtım

Ö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

• kimlik veya havuz kimliği: (Gerekli) Ayrıntıları listelemek için havuzun kimliği.
• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler: yönet, yok, kullan
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true
• kuruluş veya kuruluş: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/.

Örnek

Aşağıdaki örnek, VS2019 ile 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
}

Komutuyla aynı bilgileri döndüren de list kullanabilirsiniz--output table.

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: yönet, yok, kullan
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true
• kuruluş veya kuruluş: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/.
• project veya p: Projenin adı veya kimliği. kullanarak varsayılan projeyi az devops configure -d project=NAME_OR_IDyapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir.
• kuyruk-adı: Listeyi eşleşen kuyruk adı kayıt defteriyle filtreleyin; örneğin, 'Barındırılan Ubuntu 1604' adlı 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 may 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

Aracı 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: Hakkında bilgi almak için aracı kuyruğunun kimliği.
• action: Listeyi kullanıcı eylemine izin verilen şekilde filtreleyin. Kabul edilen değerler: yönet, yok, kullan
• detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true
• kuruluş veya kuruluş: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/.
• project veya p: Projenin adı veya kimliği. kullanarak varsayılan projeyi az devops configure -d project=NAME_OR_IDyapılandırabilirsiniz. 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ılan Windows 2019 kuyruğunun kuyruk 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 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 çalıştırmak için kullanılır. İşler için havuz belirtme hakkında bilgi edinin.

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

Aracı havuzları oluşturma

Şirket içinde 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 havuzlar oluşturabilmek için Yönetici istrator 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 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 aracı havuzunda tanımlanır ve bu rollerdeki üyelik , aracı havuzunda gerçekleştirebileceğiniz işlemleri yönetir.

Kuruluş düzeyinde güvenlik ayarları

Kuruluş ayarlarında aracı havuzundaki rol	Purpose
Okuyucu	Bu rolün üyeleri aracı havuzunu ve aracıları görüntüleyebilir. Bunu genellikle aracıları ve bunların sistem durumunu izlemekle sorumlu olan işleçler eklemek için kullanırsınız.
Servis Firması	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ı, bu havuzun Yönetici istrator rolüne otomatik olarak 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. Tek tek kuruluş aracısı havuzları için rol üyelikleri otomatik olarak 'Tüm aracı havuzları' düğümünden devralı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	Purpose
Okuyucu	Bu rolün üyeleri proje aracısı havuzunu görüntüleyebilir. Bunu genellikle bu proje aracısı havuzundaki derleme ve dağıtım işlerini izlemekle sorumlu olan işleçler 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. Havuzu oluşturan kullanıcı, bu havuzun Yönetici istrator rolüne otomatik olarak eklenir.

İşlem hattı 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 aracı havuzunu kullanmak üzere 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, aracı havuzu Yönetici istrator tarafından onaylanması gereken bir yetkilendirme isteği oluşturulur. Bu, Klasik işlem hatlarından erişimi sınırlamaz.

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 istrator rolüne aşağıdaki gruplar eklenir: Derleme Yönetici istrator'lar, Yayın Yönetici istrator'lar, Project Yönetici istrators.

SSS

Bir bakım penceresi zamanlamıyorsam aracılar ne zaman bakım çalıştıracak?

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 (https://dev.azure.com/{yourorganization}) oturum açın.

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

   

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

   

İstediğiniz havuzu seçin ve aracı havuzu için bakım işi ayarlarını yapılandırmak üzere Ayarlar seçin.

Önemli

Bakım işi ayarlarını yapılandırmak için Derleme kuyruklarını yönet iznine sahip olmanız gerekir. Ayarlar sekmesini veya Bakım Geçmişi sekmesini görmüyorsanız, varsayılan olarak Yönetici istrator rolüne verilen 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; 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ışı olduğunda veya aracıyla iletişim kurarken sorun olduğunda gerçekleşir.

Ç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. İkinci seçenek, bir aracının bakım yaparken harcayabileceği en fazla dakika değerini denetler. Zamanlayıcı, iş, bir aracıda kuyruğa alınırken değil, iş başlatıldığında başlar.

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

'Proje aracısı havuzu oluştur' iletişim kutusunda, başka bir proje aracısı havuzu tarafından zaten başvurulmuşsa, var olan bir kuruluş aracısı 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 barındırılan derleme 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:

• Yönettiğiniz altyapıda kendi aracılarınızı barındırma
• Ek paralel işler satın alma