Azure Pipelines aracıları

Makale
11/16/2021
Okumak için 21 dakika

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015

Not

Microsoft Team Foundation Server (TFS) 2018 ve önceki sürümlerde derleme ve yayın işlem hatları tanımlar, çalıştırmalar derlemeler, hizmet bağlantıları hizmet uç noktaları,aşamalar ortamlar ve işler olarak adlandırılan aşamalar olarak adlandırılanlardır.

Kodunuzu derlemek veya yazılımınızı Azure Pipelines dağıtmak için en az bir aracıya ihtiyacınız vardır. Daha fazla kod ve kişi eklerken, sonunda daha fazla koda ihtiyacınız olacak.

İşlem hattınız çalıştır geldiğinde sistem bir veya daha fazla iş başlar. Aracı, aynı anda bir iş çalıştıran yüklü aracı yazılımına sahip bilgi işlem altyapısıdır.

İşler doğrudan aracının konak makinesi üzerinde veya bir kapsayıcıda çalıştırabilirsiniz.

Microsoft tarafından barındırılan aracılar

İşlem hatlarınız Azure Pipelines microsoft tarafından barındırılan bir aracı kullanarak işlerinizi çalıştırmak için uygun bir seçeneğiniz vardır. Microsoft tarafından barındırılan aracılarla bakım ve yükseltmeler sizin için uzer. İşlem hattını her çalıştıracak olurken, işlem hattında her iş için yeni bir sanal makine elde olur. Sanal makine bir iş sonrasında atılır. Microsoft tarafından barındırılan aracılar, işleri doğrudan VM'de veya bir kapsayıcıda çalıştırabilirsiniz.

Azure Pipelines, Microsoft tarafından barındırılan aracılarla Azure Pipelines adlı önceden tanımlanmış bir aracı havuzu sağlar.

Birçok ekip için bu, işlerinizi çalıştırmanın en kolay yolu. Önce bunu deneyebilir ve derlemeniz veya dağıtımınız için çalışsa bile bunu denemeniz gerekir. Yoksa, kendinden konak aracı kullanabilirsiniz.

İpucu

Microsoft tarafından barındırılan aracıyı ücretsiz sınabilirsiniz.

Microsoft tarafından barındırılan aracılar hakkında daha fazla bilgi.

Şirket içinde barındırılan aracılar

İşleri çalıştırmak için kendi başına ayarlayacak ve yönetecek bir aracı, kendi içinde barındırılan bir aracıdır. Kendi kendine barındırılan aracıları Azure Pipelines veya Team Foundation Server (TFS) kullanabilirsiniz. Kendi içinde barındırılan aracılar, derleme ve dağıtımlar için gereken bağımlı yazılımları yüklemek için daha fazla denetim sağlar. Ayrıca makine düzeyinde önbellekler ve yapılandırmalar çalıştırmadan çalıştırmaya kadar devam eder ve bu da hızı artırıyor olabilir.

Not

Makine başına birden çok aracı yüklense de, makine başına yalnızca bir aracı yüklemenizi kesinlikle öneririz. İki veya daha fazla aracıyı yüklemek performansı ve işlem hatlarının sonucunda olumsuz etkileyebilir.

İpucu

Kendinden konak aracı yüklemeden önce, Microsoft tarafından barındırılan bir aracı havuzunun size uygun olup olamayacaklarını görmek istiyor olabilir. Çoğu durumda bu, en basit şekilde devam etmektir. Deneyin.

Aracıyı Linux, macOS veya Windows yükleyebilirsiniz. Docker kapsayıcısı üzerine de aracı yükleyebilirsiniz. Kendinden konak aracı yükleme hakkında daha fazla bilgi için bkz:

macOS aracısı
Linux aracısı (x64, ARM, ARM64, RHEL6)
Windows aracısı (x64, x86)
Docker aracısı

Aracıyı Linux, macOS veya Windows yükleyebilirsiniz. Kendinden konak aracı yükleme hakkında daha fazla bilgi için bkz:

Not

macOS'ta, çalıştırıldıklarında tar dosyasındaki her derleme için Gatekeeper korumasının görüntülemesini önlemek için indirme arşivinde özel özniteliği ./config.sh temizlemeniz gerekir. Aşağıdaki komut, dosyada genişletilmiş özniteliğini temizler:

xattr -c vsts-agent-osx-x64-V.v.v.tar.gz  ## replace V.v.v with the version in the filename downloaded.

# then unpack the gzip tar file normally:

tar xvfz vsts-agent-osx-x64-V.v.v.tar.gz

Aracıyı bir makineye yükledikten sonra, bu makineye işleriniz için gereken diğer yazılımları yükleyebilirsiniz.

Not

Aracılar geniş ölçüde geriye dönük uyumludur. Aracının herhangi bir sürümü, aracının daha yüksek bir Azure DevOps talep Azure DevOps herhangi bir sürümle uyumlu olmalıdır.

Tüm güncel düzeltme eklerini ve hata düzeltmelerini garanti eden tek sürüm bu olduğu için yalnızca aracının en son sürümünü destekliyoruz.

Azure sanal makine ölçek kümesi aracıları

Azure sanal makine ölçek kümesi aracıları, taleplerinizi karşılamak için otomatik olarak ölçeklendirilen, kendi içinde barındırılan bir aracı biçimidir. Bu esneklik, her zaman ayrılmış aracılar çalıştırmanızı azaltır. Microsoft tarafından barındırılan aracılardan farklı olarak, aracıların üzerinde çalıştırıldık makinelerin boyutuna ve görüntüsüne göre esnekliğe sahip oluruz.

Bir sanal makine ölçek kümesi, beklemede tutulan aracı sayısı, ölçek kümesinde en fazla sanal makine sayısı ve Azure Pipelines için aracılarınızı ölçeklendirmeyi yönetirsiniz.

Daha fazla bilgi için bkz. Azure sanal makine ölçek kümesi aracıları.

Paralel işler

Paralel işler, kuruluşta aynı anda çalıştırabilirsiniz iş sayısını temsil eder. Kuruluşta tek bir paralel iş varsa, ilk iş tamamlayana kadar ek eş zamanlı işler kuyruğa alınana kadar tek bir işi aynı anda çalıştırabilirsiniz. İki işi aynı anda çalıştırmak için iki paralel iş gerekir. Bu Azure Pipelines, Microsoft tarafından barındırılan altyapıda veya kendi (kendi içinde barındırılan) altyapınız üzerinde paralel işler çalıştırarak.

Microsoft, en az bir paralel iş içeren her kuruluşta varsayılan olarak ücretsiz bir hizmet katmanı sağlar. Çalıştırmanız gereken eşzamanlı işlem hatları sayısına bağlı olarak, aynı anda birden çok Microsoft tarafından barındırılan veya kendi içinde barındırılan aracıları kullanmak için daha fazla paralel iş gerekebilir. Paralel işler ve farklı ücretsiz hizmet katmanları hakkında daha fazla bilgi için bkz.Azure Pipelines.

Aynı anda birden çok aracı kullanmak için daha fazla paralel iş gerekiyor olabilir:

TFS'de paralel işler

Önemli

2019'Azure DevOps Server başlayarak, sürümlerde otomatik olarak barındırılan eş zamanlı işler için ödeme yapmak zorunda değildir. Yalnızca sahip olduğunuz aracı sayısıyla sınırlıdır.

Özellikler

Kendi içinde barındırılan her aracı, neler yapalarını belirten bir dizi özele sahip olur. Özellikler, aracı yazılımı tarafından otomatik olarak bulunan ad-değer çiftleridir. Bu durumda bunlar sistem özellikleri veya sizin tanımladığınız ad-değer çiftleridir ve bu durumda bunlar kullanıcı özellikleri olarak anılır.

Aracı yazılımı makinenin adı, işletim sistemi türü ve makinede yüklü olan belirli yazılımların sürümleri gibi çeşitli sistem özelliklerini otomatik olarak belirler. Ayrıca, makinede tanımlanan ortam değişkenleri otomatik olarak sistem özellikleri listesinde görünür.

Not

Ortam değişkenlerini özellikler olarak depolamak, bir aracı çalıştır geldiğinde, depolanan yetenek değerlerinin ortam değişkenlerini ayarlamak için kullan anlamına gelir. Ayrıca, aracı çalışırken ortam değişkenlerde yapılan tüm değişiklikler hiçbir görev tarafından toplanmayacak ve kullanılmaz. Değişen hassas ortam değişkenleriniz varsa ve bu değişkenlerin özellik olarak depolanmış olmasını istemiyorsanız, yoksayılacak virgülle ayrılmış bir değişken listesiyle ortam değişkenlerini ayarerek bunları VSO_AGENT_IGNORE yoksayabilirsiniz. Örneğin, PATH yazılım yüklüyorsanız yoksaymak istediğiniz kritik bir değişkendir.

İşlem hattı yazarken, aracının belirli taleplerini belirtirsiniz. Sistem, işi yalnızca işlem hattında belirtilen taleplere uyan özelliklere sahip aracılara gönderir. Sonuç olarak, aracı özellikleri işleri belirli aracılara yönlendiren olanak sağlar.

Not

Talepler ve yetenekler, işlerin işin gereksinimlerini karşılayacak bir aracıyla eşleştirilene kadar, kendinden konak aracılarla kullanım için tasarlanmıştır. Microsoft tarafından barındırılan aracıları kullanırken, aracı için işin gereksinimleriyle eşleşen bir görüntü seçersiniz, bu nedenle Microsoft tarafından barındırılan bir aracıya özellik eklemek mümkün olsa da, Microsoft tarafından barındırılan aracılarla özellikleri kullanmanıza gerek yok.

Aracı havuzlarına giderek ve istenen aracı için Özellikler sekmesini seçerek, bir aracının sürüm ve sistem özellikleri dahil olmak üzere ayrıntılarını görüntüleyebilirsiniz ve kullanıcı özelliklerini yönetebilirsiniz.

Web tarayıcınızda Aracı havuzlarına gidin:
1. , Azure DevOpsayarlarını seçin.
2. Aracı havuzları'ı seçin.
1. , Azure DevOpsayarlarını seçin.
2. Aracı havuzları'ı seçin.
1. , Azure DevOpsayarlarını seçin.
2. Aracı havuzları'ı seçin.
1. Projenize gidin ve Aracı Ayarlar (dişli simgesi) seçin.
2. Havuzları yönet'i seçin.
1. Projenize gidin ve Aracı Ayarlar (dişli simgesi) seçin.
2. Havuzları yönet'i seçin.
1. Projenize gidin ve Projeyi yönet 'i (dişli simgesi) seçin.
2. Denetim masası'nı seçin.
3. Aracı havuzları'ı seçin.
Özellikler sekmesine gidin:
1. Aracı havuzları sekmesinden istediğiniz aracı havuzunu seçin.
2. Aracılar'ı seçin ve istediğiniz aracıyı seçin.
3. Özellikler sekmesini seçin.
  
  Not
  
  Microsoft tarafından barındırılan aracılar sistem özelliklerini görüntülemez. Microsoft tarafından barındırılan aracılara yüklenmiş yazılımların listesi için bkz. Microsoft tarafından barındırılan aracı kullanma.
1. Aracı havuzları sekmesinden istediğiniz havuzu seçin.
2. Aracılar'ı seçin ve istediğiniz aracıyı seçin.
3. Özellikler sekmesini seçin.
1. Aracı havuzları sekmesinden istediğiniz havuzu seçin.
2. Aracılar'ı seçin ve istediğiniz aracıyı seçin.
3. Özellikler sekmesini seçin.
İstediğiniz aracıyı seçin ve Özellikler sekmesini seçin.

İstediğiniz aracıyı seçin ve Özellikler sekmesini seçin.

Aracı havuzları sekmesinden istediğiniz aracıyı seçin ve Özellikler sekmesini seçin.
Aracıya yeni bir özellik kaydetmek için Yeni yetenek ekle'yi seçin.

Aşağıdaki az pipelines agent Azure CLI yöntemlerini kullanarak bir aracının sürümü ve sistem ve kullanıcı özellikleri dahil olmak üzere ayrıntılarını görüntüebilirsiniz.

Aracıları listele Aracı ayrıntılarını gösterme

Not

az pipelines komutlarını ilk kez kullanıyorsanız bkz. Kullanmaya başlayın CLI ile Azure DevOps.

Aracıları listele

az pipelines agent list komutunu kullanarak aracılarınızı listeebilirsiniz.

az pipelines agent list --pool-id
                        [--agent-name]
                        [--demands]
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]
                        [--subscription]

Parametreler

pool-id:(Gerekli) Aracıları içeren aracı havuzu.
aracı-adı:Aracı adına göre filtrele.
talepler:Aracıların karşılay taleplerini göre filtrele. Virgülle ayrılmış liste.
detect:Kuruluşu otomatik olarak algıla. Kabul edilen değerler: false, true
include-assigned-request:Aracıların geçerli çalışmasıyla ilgili ayrıntıların dahil olup olmadığı. Kabul edilen değerler: false, true
include-capabilities:Aracıların yeteneklerinin yanıta dahil olup olmadığı. Kabul edilen değerler: false, true
include-last-completed-request:Aracıların en son tamamlanan çalışmasıyla ilgili ayrıntıların dahil olup olmadığı. Kabul edilen değerler: false, true
kuruluş veya kuruluş:Azure DevOps URL'sini seçin. Az devops configure -d organization=ORG_URL. Varsayılan olarak yapılandırılmamışsa veya git yapılandırması aracılığıyla toplanmazsa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/ .
subscription:Aboneliğin adı veya kimliği. Varsayılan aboneliği yapılandırmak için az account set -s NAME_OR_ID komutunu kullanabilirsiniz.

Örnek

Aşağıdaki örnekte havuzdaki tüm aracılar ID: 4 tablo biçiminde listelemektedir. Havuzların kimliğini almak için az pipelines pool list kullanın. 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 agent list --pool-id 4 --output table

ID    Name          Is Enabled    Status    Version
----  ------------  ------------  --------  ---------
3     Hosted Agent  True          offline   2.155.1

Aracı ayrıntılarını gösterme

az pipelines agent show komutunu kullanarak aracı ayrıntılarını alın.

az pipelines agent show --agent-id
                        --pool-id
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]
                        [--subscription]

Parametreler

agent-id veya id:(Gerekli) Hakkında bilgi almak için aracı kimliği.
pool-id:(Gerekli) Aracıları içeren aracı havuzu.
detect:Kuruluşu otomatik olarak algıla. Kabul edilen değerler: false, true
include-assigned-request:Aracıların geçerli çalışmasıyla ilgili ayrıntıların dahil olup olmadığı. Kabul edilen değerler: false, true
include-capabilities:Aracıların yeteneklerinin yanıta dahil olup olmadığı. Kabul edilen değerler: false, true
include-last-completed-request:Aracıların en son tamamlanan çalışmasıyla ilgili ayrıntıların dahil olup olmadığı. Kabul edilen değerler: false, true
kuruluş veya kuruluş:Azure DevOps URL'sini seçin. Az devops configure -d organization=ORG_URL. Varsayılan olarak yapılandırılmamışsa veya git yapılandırması aracılığıyla toplanmazsa gereklidir. Örnek: https://dev.azure.com/MyOrganizationName/ .
subscription:Aboneliğin adı veya kimliği. Varsayılan aboneliği yapılandırmak için az account set -s NAME_OR_ID komutunu kullanabilirsiniz.

Örnek

Aşağıdaki örnek, kimliğine sahip aracı için aracı ayrıntılarını 3 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 agent show --agent-id 3 --pool-id 4 --include-capabilities true
This command group is in preview. It may be changed/removed in a future release.
{
  "accessPoint": null,
  "assignedAgentCloudRequest": null,

  <Some properties omitted for space>

  "status": "offline",
  "statusChangedOn": null,
  "systemCapabilities": {
    "ANDROID_HOME": "",
    "ANDROID_NDK_HOME": "",
    "Agent.Name": "Hosted Agent",
    "Agent.Version": "2.160.1",

    <Some capabilities omitted for space>

    "sh": "",
    "subversion": "",
    "svn": "",
    "xcode": ""
  },
  "userCapabilities": null,
  "version": "2.160.1"
}
}

Aynı bilgilerin --output table kısaltılmış bir sürümünü döndüren de kullanabilirsiniz.

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

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

Azure DevOps CLI komutları, Azure DevOps Server 2019 ve önceki sürümlerde desteklenmiyor.

İpucu

Kendi içinde barındırılan bir aracıya yeni yazılım yükledikten sonra, yeni özelliğin gösterilesi için aracıyı yeniden başlatmanız gerekir. Daha fazla bilgi için bkz. Windows aracıyı yeniden başlatma,Linux aracıyı yeniden başlatmave Mac aracıyı yeniden başlatma.

İletişim

Azure Pipelines ile İletişim

TFS ile iletişim

Aracı, hangi işin Azure Pipelines gerektiğini belirlemek ve günlükleri ve iş durumunu rapor etmek için Azure Pipelines veya TFS ile iletişim kurar. Bu iletişim her zaman aracı tarafından başlatılır. Aracıdan Azure Pipelines veya TFS'ye gönderilen tüm iletiler, aracıyı yapılandırmanıza bağlı olarak HTTP veya HTTPS üzerinden dolar. Bu çekme modeli, aracının aşağıda gösterildiği gibi farklı topolojilerde yapılandırılmalarına olanak sağlar.

Şirket içi yüklemelerde aracı topolojileri.

Azure DevOps Services'da aracı topolojileri.

Aracı ile TFS arasında yaygın olarak kullanılan bir iletişim Azure Pipelines burada ve açık bir şekilde açık bir şekilde açık ve açık bir şekilde açık bir şekilde açık ve açık bir şekilde ifade Azure Pipelines.

Kullanıcı aracıyı bir aracı havuzuna Azure Pipelines veya TFS'ye kaydettirmektedir. Bir aracıyı bu aracı havuzuna kaydetmek için aracı havuzu yöneticisi olmak gerekir. Aracı havuzu yöneticisinin kimliği yalnızca kayıt sırasında gereklidir ve aracıda kalıcı olmaz ve aracı ile aracı veya TFS arasında daha fazla iletişimde Azure Pipelines kullanılmaz. Kayıt tamamlandıktan sonra, aracı bir dinleyici OAuth belirteci indirir ve iş kuyruğuna dinlemek için bu belirteci kullanır.
Aracı, uzun BIR HTTP yoklaması kullanarak Azure Pipelines/TFS'de iş kuyruğunda bunun için yeni bir iş isteği olup olmadığını dinler. Bir iş kullanılabilir olduğunda, aracı işi ve işe özgü bir OAuth belirteci indirir. Bu belirteç, işlem hattında Azure Pipelines kapsamlı kimlik için Azure Pipelines/TFS tarafından oluşturulur. Bu belirteç kısa sürelidir ve aracı tarafından bu iş içindeki Azure Pipelines veya TFS'de kaynaklara erişmek (örneğin, kaynak kodu) veya kaynakları değiştirmek (örneğin, test sonuçlarını karşıya yükleme) için kullanılır.
İş tamamlandıktan sonra, aracı işe özgü OAuth belirteci atar ve dinleyici OAuth belirteci kullanan yeni bir iş isteği olup oauth belirteci olup denetlemeye geri döner.

Aracı ile Azure Pipelines/TFS arasında ileti alışverişi yapılan iletilerin yükü asimetrik şifreleme kullanılarak güvenli hale getirildi. Her aracıda bir ortak-özel anahtar çifti vardır ve ortak anahtar kayıt sırasında sunucuyla paylaştırıldı. Sunucu, aracıya göndermeden önce işin yükünü şifrelemek için ortak anahtarı kullanır. Aracı, özel anahtarını kullanarak iş içeriğinin şifresini çözebilir. İşlem hatlarında veya değişken gruplarında depolanan gizli diziler aracıyla alışverişte bulunarak bu gizli dizilerin güvenliği bu şekilde sağlanıyor.

Aracı ile TFS arasında yaygın bir iletişim deseni aşağıdaki gibidir.

Aracı havuzu yöneticisi aracıyı bir aracı havuzuna katıyor ve TFS ile iletişim başlatmak için hizmet hesabının (Windows için) veya kayıtlı kullanıcı adı ve parolası (Linux ve macOS için) kimlik bilgileri kullanılır. Aracı, iş kuyruğuna dinlemek için bu kimlik bilgilerini kullanır.
Aracı, sunucuyla iletişim kurarken asimetrik anahtar şifrelemesi kullanmaz. Ancak, aracı ile TFS arasındaki iletişimin güvenliğini sağlamak için HTTPS kullanabilirsiniz.

Hedef sunuculara dağıtım için iletişim

Yapıtları bir dizi sunucuya dağıtmak için aracıyı kullanırken, bu sunuculara "görüş hattı" bağlantısı olması gerekir. Microsoft tarafından barındırılan aracı havuzları varsayılan olarak Azure'da çalışan Azure web sitelerine ve sunucularına bağlanır.

Not

Azure kaynaklarınız bir Azure Sanal Ağına çalışıyorsa, Aracı tarafından erişime izin verecek şekilde Azure sanal ağınız için güvenlik duvarı kurallarını yapılandırarak Microsoft tarafından barındırılan aracıların dağıtılacağı Aracı IP aralıklarını edinebilirsiniz.

Şirket içi ortamlarının Microsoft tarafından barındırılan bir aracı havuzuna bağlantısı yoksa (bu genellikle ara güvenlik duvarlarında olduğu gibi), şirket içi bilgisayarlarında şirket içinde barındırılan bir aracıyı el ile yapılandırmanız gerekir. Aracıların hedef şirket içi ortamlara bağlantısı ve aşağıdaki şemada gösterildiği gibi Azure Pipelines veya Team Foundation Server için İnternet erişimi olmalıdır.

Şirket içi ortamlar için aracı bağlantısı

Kimlik Doğrulaması

Bir aracıyı kaydetmek için, aracı havuzunda yönetici rolünün bir üyesi olmak gerekir. Aracı havuzu yöneticisinin kimliği yalnızca kayıt sırasında gereklidir ve aracıda kalıcı değildir ve aracı ile aracı veya TFS arasındaki sonraki iletişimlerde Azure Pipelines kullanılmaz. Ayrıca, aracıyı yapılandırmak için sunucuda yerel yönetici olmak gerekir.

Aracınız aşağıdaki yöntemi Azure Pipelines kimlik doğrulaması gerçekleştirebilirsiniz:

Aracınız aşağıdaki yöntemlerden Azure DevOps Server veya TFS'de kimlik doğrulaması gerçekleştirebilirsiniz:

Kişisel Erişim Belirteci (PAT):

Bir aracıyı Azure Pipelines veya TFS 2017 ve daha yeni bir sürüme bağlamak için PAT oluşturma ve kullanma. PAT, yenileriyle çalışan tek Azure Pipelines. PAT'nin Aracı Havuzları (okuma, yönetme) kapsamı (dağıtım grubu aracısı için, PAT'nin Dağıtım grubu (okuma, yönetme) kapsamına sahip olması gerekir ve tek bir PAT birden çok aracıyı kaydetmek için kullanılabilirken PAT yalnızca aracıyı kaydettirirken kullanılır ve sonraki iletişim için kullanılamaz. Daha fazla bilgi için, Windows ,Linuxveya macOS şirket içinde barındırılan aracılar makalesinde Kişisel erişim belirteci (PAT) ile kimlik doğrulama bölümüne bakın.

TFS ile PAT kullanmak için sunucunuz HTTPS ile yapılandırıldı. Bkz. Web sitesi ayarları ve güvenliği.

Tümleşik

Bağlan oturum Windows NTLM veya Kerberos gibi bir Windows kimlik doğrulaması şeması aracılığıyla TFS'ye bir aracı ekleme.

Bu kimlik doğrulama yöntemini kullanmak için önce TFS sunucuyu yapılandırmanız gerekir.

TFS'yi çalıştırarak makinede oturum açma.
Internet Information Services (IIS) Yöneticisi'ni başlatma. TFS sitenizi seçin ve ntlm Windows Kerberos gibi geçerli bir sağlayıcı ile kimlik doğrulamasının etkinleştirildiğinden emin olun.

IIS TFS windows kimlik doğrulaması

ntlm sağlayıcısı ile IIS TFS Windows kimlik doğrulaması

Anlaşma

Bağlan TFS'ye, NTLM veya Kerberos gibi bir Windows kimlik doğrulama düzeni aracılığıyla oturum açma kullanıcıdan farklı bir kullanıcı olarak oturum açmasını sağlar.

Bu kimlik doğrulama yöntemini kullanmak için önce TFS sunucuyu yapılandırmanız gerekir.

TFS'yi çalıştırarak makinede oturum açma.
Internet Information Services (IIS) Yöneticisi'ni başlatma. TFS sitenizi seçin ve Anlaşma sağlayıcısı Windows NTLM veya Kerberos gibi başka bir yöntemle kimlik doğrulamasının etkinleştirildiğinden emin olun.

IIS TFS windows kimlik doğrulaması

negotiate ve ntlm sağlayıcısı ile IIS TFS Windows kimlik doğrulaması

Alternatif

Bağlan kimlik doğrulaması kullanarak TFS'ye oturum açma. Bu yöntemi kullanmak için önce TFS üzerinde HTTPS'yi yapılandırmalısiniz.

Bu kimlik doğrulama yöntemini kullanmak için TFS sunucuyu aşağıdaki gibi yapılandırmanız gerekir:

TFS'yi çalıştırarak makinede oturum açma.
Temel kimlik doğrulamasını yapılandırma. Bkz. Temel Kimlik Doğrulaması Team Foundation Server 2015'e karşı kullanma.

Etkileşimli ve hizmet karşılaştırması

Kendinden konak aracınızı hizmet veya etkileşimli bir işlem olarak çalıştırabilirsiniz. Aracıyı yapılandırdikten sonra, çalışır olduğundan emin olmak için önce etkileşimli modda denemenizi öneririz. Ardından, üretim kullanımı için, güvenilir bir şekilde çalışır durumda kalması için aracıyı aşağıdaki modlardan birini kullanarak çalıştırmayı öneririz. Bu modlar, makine yeniden başlatılırsa aracının otomatik olarak başlatılmasını da sağlar.

Hizmet olarak. Aracı yaşam döngüsünü yönetmek için işletim sisteminin hizmet yöneticisini kaldırabilirsiniz. Buna ek olarak, aracı bir hizmet olarak çalıştır olduğunda aracıyı otomatik yükseltme deneyimi daha iyidir.
Otomatik oturum açma etkin etkileşimli bir işlem olarak. Bazı durumlarda, ui testlerini çalıştırmak gibi üretim kullanımı için aracıyı etkileşimli olarak çalıştırması gerekir. Aracı bu modda çalıştırılacak şekilde yapılandırıldığında, ekran koruyucu da devre dışı bırakılır. Bazı etki alanı ilkeleri, otomatik oturum açmayı etkinleştirmeyi veya ekran koruyucusunu devre dışı bırakmayı önleyebilirsiniz. Böyle durumlarda, etki alanı ilkesinden bir muafiyet aramanız veya etki alanı ilkelerinin geçerli olmadığını bir çalışma grubu bilgisayarda aracıyı çalıştırmanız gerekir.

Not

Otomatik oturum açmayı etkinleştiren veya ekran koruyucusunu devre dışı bırakarak diğer kullanıcıların bilgisayara kadar ilerleyişlerini ve otomatik olarak oturum açtığı hesabı kullanmalarını etkinleştiren güvenlik riskleri vardır. Aracıyı bu şekilde çalıştıracak şekilde yapılandırıyorsanız, bilgisayarın fiziksel olarak korun olduğundan emin olun; örneğin, güvenli bir tesiste bulunur. Bir aracının otomatik oturum açma ile çalıştırılıyor olduğu bilgisayara erişmek için Uzak Masaüstü kullanıyorsanız, Uzak Masaüstü'nüz kapatarak bilgisayarın kilitlenmesi ve bu aracıda çalışan tüm UI testleri başarısız olabilir. Bunu önlemek için tscon komutunu kullanarak Uzak Masaüstü bağlantısını kesin. Örnek:

%windir%\System32\tscon.exe 1 /dest:console

Aracı hesabı

Bir aracıyı hizmet olarak veya etkileşimli olarak çalıştırmayı tercih etmeksizin, aracıyı çalıştırmak için kullandığınız bilgisayar hesabını seçebilirsiniz. (bu, aracıyı Azure Pipelines veya TFS 'ye kaydettiğinizde kullandığınız kimlik bilgilerinden farklı olduğunu unutmayın.) Aracı hesabı seçimi yalnızca derleme ve dağıtım işleriniz üzerinde çalışan görevlerin ihtiyaçlarına bağlıdır.

örneğin, bir dış hizmete erişmek için Windows kimlik doğrulaması kullanan görevleri çalıştırmak için, aracıyı bu hizmete erişimi olan bir hesap kullanarak çalıştırmanız gerekir. Ancak, bir tarayıcı gerektiren Selenium veya kodlanmış UI testleri gibi UI testleri çalıştırıyorsanız, tarayıcı aracı hesabı bağlamında başlatılır.

Windows, ağ hizmeti veya yerel hizmet gibi bir hizmet hesabı kullanmayı göz önünde bulundurmanız gerekir. Bu hesapların sınırlı izinleri vardır ve parolalarının süresi dolmaz, yani aracı zaman içinde daha az yönetim gerektirir.

Aracı sürümü ve yükseltmeleri

Aracı yazılımını Azure Pipelines her birkaç haftada güncelleştiririz. Aracı sürümünü biçiminde gösteririz {major}.{minor} . Örneğin, aracı sürümü ise, 2.1 ana sürüm 2 ve ikincil sürüm 1 ' dir.

Microsoft tarafından barındırılan aracılar her zaman güncel tutulur. aracının daha yeni sürümü yalnızca alt sürümde farklıysa , şirket içinde barındırılan aracılar genellikle otomatik olarak güncelleştirilebilirler ( aracı havuzlarındabu ayarı yapılandır, aracıyı Ayarlar , varsayılan olarak etkindir) Azure Pipelines. Bir platform özelliği veya işlem hattında kullanılan görevlerden biri aracının daha yeni bir sürümünü gerektirdiğinde, yükseltme istendi.

Şirket içinde barındırılan bir aracıyı etkileşimli olarak çalıştırırsanız veya aracının daha yeni bir ana sürümü varsa, aracıları el ile yükseltmeniz gerekebilir. Bunu, kuruluşunuzun altındaki Aracı havuzları sekmesinden kolayca yapabilirsiniz. İşlem hatlarınız, uyumlu bir aracıyı hedeflendirilene kadar çalışmaz.

Şirket içinde barındırılan aracıları güncelleştirmek için

Project ayarları, aracı havuzları' na gidin.
Aracı havuzunuzu seçin ve tüm aracıları güncelleştir' i seçin.

Aracıları ayrıca, ... menüsünden aracıyı Güncelleştir ' i seçerek tek tek güncelleştirebilirsiniz.
Güncelleştirmeyi onaylamak için Güncelleştir ' i seçin.
Havuzdaki her aracı için bir güncelleştirme isteği sıraya alındı, bu, çalışmakta olan herhangi bir iş tamamlandığında çalışır. Genellikle yükseltme, aracı yazılımının en son sürümünü (yaklaşık 200 MB) indirmek için yeterince uzun sürer, sıkıştırmayı açın ve aracıyı yeni sürümle yeniden başlatın. Aracılarınızın durumunu aracılar sekmesinden izleyebilirsiniz.

aracı yazılımını Azure DevOps Server ve TFS 'deki her güncelleştirme ile güncelleştiririz. Aracı sürümünü biçiminde gösteririz {major}.{minor} . Örneğin, aracı sürümü ise, 2.1 ana sürüm 2 ve ikincil sürüm 1 ' dir.

Azure DevOps Server veya TFS sunucunuzun aracısının daha yeni bir sürümü varsa ve bu yeni aracı yalnızca ikincil sürümde farklıysa, genellikle otomatik olarak yükseltilebilir. Bir platform özelliği veya işlem hattında kullanılan görevlerden biri aracının daha yeni bir sürümünü gerektirdiğinde, yükseltme istendi. Azure DevOps Server 2019 ' den başlayarak yeni bir sunucu sürümü beklemeniz gerekmez. Aracının yeni bir sürümünü uygulama katmanınıza yükleyebilirve bu sürüm yükseltme olarak sunulur.

Aracıyı etkileşimli olarak çalıştırırsanız veya aracısının daha yeni bir ana sürümü varsa, aracıları el ile yükseltmeniz gerekebilir. Bunu, proje koleksiyonunuz altındaki Aracı havuzları sekmesinden kolayca yapabilirsiniz. İşlem hatlarınız, uyumlu bir aracıyı hedeflendirilene kadar çalışmaz.

Aracı havuzlarını yapılandırmabölümünde açıklandığı gibi, aracı havuzlarına gidip istediğiniz aracının yetenekler sekmesini seçerek bir aracının sürümünü görüntüleyebilirsiniz.

Aracı güncelleştirmesini programlı bir şekilde tetikleyebilmeniz için, aracı güncelleştirme API 'sini bölüm bölümünde açıklandığı gibi kullanarak belirli aracı havuzu için aracı güncelleştirmelerini programlama yoluyla nasıl tetikleyebilirim?.

Not

İnternet erişimi olmayan sunucular için, aracı ZIP dosyasını C:\ProgramData\Microsoft\Azure DevOps\Agents\ yerel dosya olarak kullanılacak şekilde el ile kopyalayın.

SSS

En son v2 Aracısı sürümüne sahip olduğumu Nasıl yaparım? emin olun.

Aracı havuzları sekmesine gidin:
1. Azure DevOps, kuruluş ayarları' nı seçin.
2. Aracı havuzlarınıseçin.
1. Azure DevOps, koleksiyon ayarları' nı seçin.
2. Aracı havuzlarınıseçin.
1. Azure DevOps, koleksiyon ayarları' nı seçin.
2. Aracı havuzlarınıseçin.
1. projenize gidin ve Ayarlar (dişli simgesi) aracı kuyrukları' ni seçin.
2. Havuzları Yönet' i seçin.
1. projenize gidin ve Ayarlar (dişli simgesi) aracı kuyrukları' ni seçin.
2. Havuzları Yönet' i seçin.
1. Projenize gidin ve projeyi Yönet ' i (dişli simgesi) seçin.
2. Denetim Masası' nı seçin.
3. Aracı havuzlarınıseçin.
Aracıyı içeren havuza tıklayın.
Aracının etkinleştirildiğinden emin olun.
Yetenekler sekmesine gidin:
1. Aracı havuzları sekmesinden istenen aracı havuzunu seçin.
2. Aracılar ' ı seçin ve istediğiniz aracıyı seçin.
3. Yetenekler sekmesini seçin.
  
  Not
  
  Microsoft tarafından barındırılan aracılar sistem yeteneklerini göstermez. Microsoft tarafından barındırılan aracılarda yüklü yazılımların listesi için bkz. Microsoft tarafından barındırılan aracı kullanma.
1. Aracı havuzları sekmesinden istenen havuzu seçin.
2. Aracılar ' ı seçin ve istediğiniz aracıyı seçin.
3. Yetenekler sekmesini seçin.
1. Aracı havuzları sekmesinden istenen havuzu seçin.
2. Aracılar ' ı seçin ve istediğiniz aracıyı seçin.
3. Yetenekler sekmesini seçin.
İstediğiniz aracıyı seçin ve yetenekler sekmesini seçin.

İstediğiniz aracıyı seçin ve yetenekler sekmesini seçin.

Aracı havuzları sekmesinden istenen aracıyı seçin ve yetenekler sekmesini seçin.
Agent.VersionÖzelliği bulun. Bu değeri en son yayınlanan aracı sürümüne karşı kontrol edebilirsiniz. Azure Pipelines aracısı ' na bakın ve listelenen en yüksek sürüm numarası için sayfayı kontrol edin.
Her aracı, aracının daha yeni bir sürümünü gerektiren bir görev çalıştırdığında kendisini otomatik olarak güncelleştirir. Bazı aracıları el ile güncelleştirmek istiyorsanız, havuza sağ tıklayın ve tüm aracıları güncelleştir' i seçin.

Azure DevOps Server havuzunun parçası olan v2 aracılarımı güncelleştirebilir miyim?

Evet. Azure DevOps Server 2019 ' den başlayarak, sunucunuzu yerel bir diskte aracı paket dosyalarını aramak üzere yapılandırabilirsiniz. Bu yapılandırma, sürümü sırasında sunucu ile gelen varsayılan sürümü geçersiz kılar. Bu senaryo, sunucunun internet erişimi olmadığında da geçerlidir.

Internet erişimi olan bir bilgisayardan, aracı paket dosyalarının en son sürümünü (.zip veya. tar. gz biçiminde) Azure Pipelines aracısı GitHub yayınlar sayfasındanindirin.
seçtiğiniz bir yöntemi (USB sürücüsü, ağ aktarımı vb.) kullanarak indirilen paket dosyalarını her bir Azure DevOps Server uygulama katmanına aktarın. Aracı dosyalarını klasörün altına yerleştirin %ProgramData%\Microsoft\Azure DevOps\Agents .
Hazırsınız! Azure DevOps Server, aracıların her güncelleştirildiği anda yerel dosyaları kullanacaktır. Her aracı, aracının daha yeni bir sürümünü gerektiren bir görev çalıştırdığında kendisini otomatik olarak güncelleştirir. Ancak bazı aracıları el ile güncelleştirmek istiyorsanız, havuza sağ tıklayın ve ardından tüm aracıları güncelleştir' i seçin.

Şirket içinde barındırılan aracıların Microsoft tarafından barındırılan aracılardan herhangi bir performans avantajı var mı?

Birçok durumda, evet. Özellikle:

Kendi kendine barındırılan bir aracı kullanıyorsanız Artımlı derlemeler çalıştırabilirsiniz. Örneğin, depoyu temizleyen ve temiz bir yapı gerçekleştirmeyecek bir işlem hattı tanımlarsanız, yapılarınız genellikle daha hızlı çalışır. Microsoft tarafından barındırılan bir aracı kullandığınızda, derleme veya yayın ardışık düzeni tamamlandıktan sonra aracı yok edildiğinden bu avantajları elde etmeyin.
Microsoft tarafından barındırılan bir aracının, derlemenizi başlatması daha uzun sürebilir. İşinizin Microsoft tarafından barındırılan bir aracıya atanması genellikle birkaç saniye sürer, ancak sistemimizin yüküne bağlı olarak bir aracının ayrılması birkaç dakika sürebilir.

Aynı makineye birden çok şirket içinde barındırılan aracı yükleyebilir miyim?

Evet. Bu yaklaşım, birçok paylaşılan kaynağı kullanmayan işleri çalıştıran aracılar için iyi bir şekilde çalışabilir. Örneğin, bu hizmeti, genellikle dağıtımları düzenleyen ve aracının kendisi üzerinde çok fazla iş yapmayan yayınlar çalıştıran aracılar için deneyebilirsiniz.

Diğer durumlarda, aynı makinede birden fazla aracı çalıştırarak çok daha fazla verimlilik elde edemediğiniz fark edebilirsiniz. Örneğin, çok fazla disk ve g/ç kaynağı kullanan yapılar çalıştıran aracılar için bu durum oldukça olabilir.

Ayrıca, paralel derleme işleri NPM paketleri gibi aynı Singleton araç dağıtımını kullanıyorsa sorunlarla karşılaşabilirsiniz. Örneğin, bir yapı, başka bir derleme bunu kullanmanın ortasında olduğunda bir bağımlılığı güncelleştirebilir, bu da güvenilmez sonuçlara ve hatalara neden olabilir.

İşlem hattı işleri iptal edildiğinde aracıların davranışı nedir?

Microsoft tarafından barındırılan aracılar için aracı kaldırılır ve Azure Pipelines havuza döndürülür.

Şirket içinde barındırılan aracılar için:

İşlem hattı iptal edildiğinde, aracı geçerli adımı yürüten işleme bir komut dizisi gönderir. İlk komut 7,5 saniyelik bir zaman aşımı ile gönderilir. İşlem sonlandırılmışsa, 2,5 saniyelik bir zaman aşımı ile ikinci bir komut gönderilir. İşlem sonlandırılmışsa, Aracı işlemi sonlandırmak için bir komut yayınlar. İşlem iki başlangıç sonlandırma isteğini kabul etmez, sonlandırılacak. İlk istekten sonlandırma için yaklaşık 10 saniye sürer.

İşleme verilen komutlar, aracı işletim sistemine göre farklılık fark edilir.

macOS ve Linux-gönderilen komutlar SIGINT, ardından SIGTERM ve SIGKıLL tarafından izlenir.
Windows-işleme gönderilen komutlar ctrl + C, ardından ctrl + Break ve ardından process. kıll tarafından izlenir.

Belirli bir aracı havuzu için aracı güncelleştirmelerini programlı bir şekilde tetikleyebilirim?

Sonraki API 'YI kullanarak havuz için aracı güncelleştirmelerini tetikleyebilirsiniz:

POST https://dev.azure.com/{organization}/_apis/distributedtask/pools/{poolId}/messages?agentId={agentId}&api-version=6.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
`agentId`	sorgu	False	string	Güncelleştirilecek aracı. Belirtilmemişse-güncelleştirme tüm aracılar için tetiklenecektir.
`organization`	path	True	string	Azure DevOps kuruluşun adı.
`poolId`	path	Doğru	tamsayı Int32	Kullanılacak aracı havuzu
`api-version`	sorgu	False	string	Kullanılacak API 'nin sürümü. Bu, API 'nin bu sürümünü kullanmak için ' 6,0 ' olarak ayarlanmalıdır.

Aracı güncelleştirmesini tetiklemek için-istek gövdesi boş olmalıdır.

Not

Azure Pipelines aracısı GitHubaçık kaynaktır.

Daha fazla bilgi edinin

aracılar hakkında daha fazla bilgi için Azure DevOps öğrenme yoluyla yapı uygulamalarından aşağıdaki modüllere bakın.

Azure Pipelines aracıları

Lütfen deneyiminizi değerlendirin

Microsoft tarafından barındırılan aracılar

Şirket içinde barındırılan aracılar

Azure sanal makine ölçek kümesi aracıları

Paralel işler

Özellikler

Aracı özelliklerini yapılandırma

İletişim

Azure Pipelines ile İletişim

TFS ile iletişim

Hedef sunuculara dağıtım için iletişim

Kimlik Doğrulaması

Kişisel Erişim Belirteci (PAT):

Tümleşik

Anlaşma

Alternatif

Etkileşimli ve hizmet karşılaştırması

Aracı hesabı

Aracı sürümü ve yükseltmeleri

Şirket içinde barındırılan aracıları güncelleştirmek için

SSS

En son v2 Aracısı sürümüne sahip olduğumu Nasıl yaparım? emin olun.

Azure DevOps Server havuzunun parçası olan v2 aracılarımı güncelleştirebilir miyim?

Şirket içinde barındırılan aracıların Microsoft tarafından barındırılan aracılardan herhangi bir performans avantajı var mı?

Aynı makineye birden çok şirket içinde barındırılan aracı yükleyebilir miyim?

İşlem hattı işleri iptal edildiğinde aracıların davranışı nedir?

Belirli bir aracı havuzu için aracı güncelleştirmelerini programlı bir şekilde tetikleyebilirim?

URI Parametreleri

Daha fazla bilgi edinin