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

Azure Pipelines | TFS 2018 | TFS 2017 | TFS 2015Önceki sürümler (XAML derlemeleri)

Azure, Azure Windows diğer Visual Studio çözümlerini derlemek ve dağıtmak için en az bir Windows gerekir. Windows aracıları Java ve Android uygulamaları da derlemek için kullanılabilir.

Başlamadan önce:

• Kodunuz Azure Pipelines Microsoft tarafından barındırılan bir aracı ihtiyaçlarına uygunsa, kendi kendine barındırılan bir aracı ayarlamayı Windows atlayabilirsiniz.
• Kodunuz şirket içi Team Foundation Server (TFS) 2015 sunucusunda ise, bkz. Şirket içi TFS 2015için Windows aracı dağıtma.
• Aksi takdirde, Windows'da aracı ayarlamak için doğru Windows. Sonraki bölüme devam edin.

Aracılar hakkında bilgi

Bir aracının ne olduğunu ve nasıl çalıştığını zaten biliyorsanız, hemen aşağıdaki bölümlere geçebilirsiniz. Ancak, ne yapacakları ve nasıl çalışacakları hakkında daha fazla bilgi için bkz. Azure Pipelines..

Önkoşulları denetleme

Makinenizin şu önkoşullara sahip olduğundan emin olun:

• Windows 7, 8.1 veya 10 (istemci işletim sistemi kullanıyorsanız)
• Windows 2008 R2 SP1 veya daha yenisi (sunucu işletim sistemi kullanıyorsanız)
• PowerShell 3.0 veya daha yenisi
• .NET Framework 4.6.2 veya daha yüksek

Önerilen:

• Visual Studio araçları (2015 veya daha yüksek)

Bir Subversion repo'dan binayaıyorsanız, makineye Subversion istemcisini yüklemeniz gerekir.

Aracı kurulumunu ilk kez el ile çalıştırmanız gerekir. Aracıların nasıl çalışmalarına yönelik bir his elde ettikten sonra veya birçok aracıyı ayarlamayı otomatikleştirmek için katılımsız yapılandırmayı kullanmayı göz önünde bulundurabilirsiniz.

Donanım özellikleri

Aracılar için donanım özellikleri gereksinimlerinize, takım boyutunıza vb. göre değişiklik gösterir. Herkes için geçerli olacak genel bir öneri yapmak mümkün değildir. Başvuru noktası olarak, Azure DevOps ekibi barındırılan aracıları kullanan işlem hatlarını kullanarak barındırılan aracılar kodunu derlemek için kullanılır. Öte yandan, ana bilgisayar kodunun Azure DevOps, 4 adet kendi kendine barındırılan aracıları çalıştıran 24 çekirdekli sunucu sınıfı makineler tarafından inşa edilmiştir.

İzinleri hazırlama

Kendinden konak aracılar için bilgi güvenliği

Aracıyı yapılandıran kullanıcının havuz yöneticisi izinlerine sahip olması gerekir, ancak aracıyı çalıştıran kullanıcının ihtiyacı olmaz.

Aracı tarafından denetlenen klasörler mümkün olduğunca az kullanıcıyla kısıtlanmış olmalı ve şifresi çözülebilecek veya sızması mümkün olan gizli diziler içeriyor olabilir.

ADO işlem hatları aracısı, dış kaynaklardan indirdiği kodu yürütmek için tasarlanmış bir yazılım ürünüdür. Doğal olarak Uzaktan Kod Yürütme (RCE) saldırılarının hedefi olabilir.

Bu nedenle, işi gerçekleştirmek için Pipelines Aracılarının her bir kullanımını çevreleyen tehdit modelini göz önünde bulundurarak, aracıyı çalıştıran kullanıcıya, aracının çalıştırlandığı makineye, İşlem hattı tanımına yazma erişimi olan kullanıcılara, yaml'nin depolandığı git depolarına hangi minimum izinlerin verilil olduğuna karar vermek önemlidir. veya yeni işlem hatları için havuza erişimi kontrol eden kullanıcı grubu.

Aracıyı çalıştıran kimliğin, aracıyı havuza bağlama izinlerine sahip kimlikten farklı olması en iyi uygulamadır. Kimlik bilgilerini (ve aracıyla ilgili diğer dosyaları) üreten kullanıcı, bunları okuması gereken kullanıcıdan farklıdır. Bu nedenle, aracı makinenin kendisine ve günlükler ve yapıtlar gibi hassas dosyaları içeren aracı klasörlerine verilen erişimi dikkatle göz önünde bulundurmalısınız.

Aracı klasörüne yalnızca aracı işlemini çalıştıran DevOps ve kullanıcı kimliği için erişim izni vermek mantıklıdır. Yöneticilerin derleme hatalarını anlamak veya günlük dosyalarını almak için dosya sistemini araştırması veya bu hataları Azure DevOps gerekir.

Hangi kullanıcıyı kullanabileceğinize karar verme

Tek bir adım olarak aracıyı kaydetmelisiniz. Aracı kuyruğu yönetme izni olan birinin bu adımları tamamlaması gerekir. Aracı günlük işlemde bu kişinin kimlik bilgilerini kullanmaz, ancak kaydı tamamlaması gerekir. Aracıların iletişim kurması hakkında daha fazla bilgi.

Kullanıcının izni olduğunu onaylayın

Kullanmakta olacağınız kullanıcı hesabının aracıyı kaydetme izni olduğundan emin olun.

Kullanıcı kuruluş sahibi Azure DevOps TFS mi yoksa yönetici Azure DevOps Server mi? Burada dur,izniniz var.

Aksi durumda:.

1. Bir tarayıcı açın ve Azure Pipelines veya Azure DevOps Server TFS sunucunuz için Aracı havuzları sekmesine gidin:

   1. , Azure DevOpsayarlarını seçin.

      

   2. Aracı havuzları'ı seçin.

      

   1. Azure DevOps,Koleksiyon ayarları'ı seçin.

      

   2. Aracı havuzları'ı seçin.

      

   1. Azure DevOps,Koleksiyon ayarları'ı 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.

      

2. Sayfanın sağ tarafındaki havuzu seçin ve ardından Güvenlik'e tıklayın.

3. Kullanmak istediğiniz kullanıcı hesabı gösterilmezse, eklemesi için bir yöneticiye danışın. Yönetici bir aracı havuzu yöneticisi, kuruluş sahibi Azure DevOpsbir TFSveya Azure DevOps Server olabilir.

   Bu bir dağıtım grubu aracısı ise, yönetici bir dağıtım grubu yöneticisi, Azure DevOpskuruluş sahibi veya TFS ya da Azure DevOps Server yöneticisi olabilir.

   Bir kullanıcı, dağıtım grubu yöneticisi rolüne, Azure Pipelines'daki Dağıtım Grupları sayfasındaki Güvenlik sekmesinden ekleyebilirsiniz.

Aracıyı indirme ve yapılandırma

Sunucu URL 'SI ve kimlik doğrulaması

Etkileşimli veya hizmet modunu seçin

Aracının etkileşimli modda mı yoksa bir hizmet olarak mı çalıştırılacağını öğrenmek için bkz. Agents: Interactive vs. Service.

Bir hizmet olarak çalıştırmayı seçerseniz (önerdiğimiz), çalıştırdığınız Kullanıcı adı 20 karakter veya daha az olmalıdır.

Aracıyı çalıştırma

Etkileşimli olarak çalıştır

Aracıyı etkileşimli olarak çalışacak şekilde yapılandırdıysanız, çalıştırmak için:

.\run.cmd

Aracıyı yeniden başlatmak için CTRL + C tuşlarına basarak aracıyı durdurun ve sonra run.cmd yeniden başlatmak üzere çalıştırın.

Bir kez çalıştır

Etkileşimli olarak çalışacak şekilde yapılandırılmış aracılar için aracının yalnızca bir işi kabul etmesini seçebilirsiniz. Bu yapılandırmada çalıştırmak için:

.\run.cmd --once

Bu moddaki aracılar yalnızca bir işi kabul eder ve daha sonra düzgün şekilde çalışır (Azure Container Instances gibi bir hizmette Docker 'da çalıştırmak için yararlıdır).

Hizmet olarak çalıştır

Aracıyı hizmet olarak çalışacak şekilde yapılandırdıysanız, otomatik olarak başlatılır. Hizmetler ek bileşeninden aracı çalışma durumunu görüntüleyebilir ve denetleyebilirsiniz. Öğesini çalıştırın services.msc ve şunlardan birini arayın:

• "Azure Pipelines aracısı (aracının adı)".
• "VSTS Aracısı (aracınızın adı)".
• "vstsagent. (kuruluş adı). (aracınızın adı) ".

Aracıyı yeniden başlatmak için girişe sağ tıklayın ve Yeniden Başlat' ı seçin.

Aracınızı kullanmak için aracının havuzunu kullanarak bir iş çalıştırın. Farklı bir havuz seçmediyseniz, aracınız varsayılan havuzda olur.

Aracı değiştirme

Bir aracıyı değiştirmek için indirme ve aracı adımlarını yeniden yapılandırın.

Zaten var olan bir aracı ile aynı adı kullanarak bir aracı yapılandırdığınızda, var olan aracıyı değiştirmek isteyip istemediğiniz sorulur. Yanıt verirseniz Y , değiştirdiğiniz aracıyı (aşağıya bakın) kaldırdığınızdan emin olun. Aksi takdirde, birkaç dakika sonra aracılardan biri kapanır.

Aracıyı Kaldırma ve yeniden yapılandırma

Aracıyı kaldırmak için:

.\config remove

Aracıyı kaldırdıktan sonra yeniden yapılandırabilirsiniz.

Katılımsız yapılandırma

Aracı, insan müdahalesi olmadan bir betikten ayarlanabilir. --unattendedTüm soruların yanıtlarını geçirmeniz gerekir.

Bir aracıyı yapılandırmak için, kuruluşunuzun URL 'sini veya koleksiyon ya da koleksiyon ve kimlik bilgilerini, aracıları ayarlamaya yetkili bir kişiye bilmelidir. Diğer tüm yanıtlar isteğe bağlıdır. Herhangi bir komut satırı parametresi, bunun yerine bir ortam değişkeni kullanılarak belirtilebilir: adını büyük harf ve önüne içine koyun VSTS_AGENT_INPUT_ . Örneğin, VSTS_AGENT_INPUT_PASSWORD belirtmek yerine --password .

Gerekli seçenekler

• --unattended -Aracı Kurulumu bilgi istemez ve komut satırında tüm ayarların sağlanması gerekir
• --url <url> -Sunucunun URL 'SI. Örneğin: https://dev.azure.com/myorganization veya http://my-azure-devops-server:8080/tfs
• --auth <type> -kimlik doğrulama türü. Geçerli değerler:
  • pat (Kişisel erişim belirteci)
  • negotiate (Kerberos veya NTLM)
  • alt (Temel kimlik doğrulaması)
  • integrated(Windows varsayılan kimlik bilgileri)

Kimlik doğrulaması seçenekleri

• Şunu seçtiyseniz --auth pat :
  • --token <token> -kişisel erişim belirtecinizi belirtir
• Veya seçeneğini belirlediyseniz --auth negotiate--auth alt :
  • --userName <userName>-biçiminde bir Windows kullanıcı adı belirtir domain\userName veyauserName@domain.com
  • --password <password> -bir parolayı belirtir

Havuz ve aracı adları

• --pool <pool> -katılacak aracının havuz adı
• --agent <agent> -Aracı adı
• --replace -bir havuzdaki aracıyı değiştirin. Aynı ada sahip başka bir aracı dinliyorsa, çakışma ile başarısız olarak başlatılır

Aracı Kurulumu

• --work <workDirectory> -iş verilerinin depolandığı iş dizini. Varsayılan olarak _work Aracı dizin kökünün altında olur. Çalışma dizini belirli bir aracıya aittir ve birden çok aracı arasında paylaşılmamalıdır.
• --acceptTeeEula-Team Explorer Everywhere son kullanıcı lisans sözleşmesini kabul edin (yalnızca macos ve Linux)
• --disableloguploads -sunucuda konsol günlüğü çıkışı akışı veya gönderme. Bunun yerine, iş tamamlandıktan sonra bunları aracı konağının dosya sisteminden alabilirsiniz.

yalnızca Windows başlangıç

• --runAsService-aracıyı bir Windows hizmeti olarak çalışacak şekilde yapılandırın (yönetici izni gerektirir)
• --runAsAutoLogon -otomatik oturum açmayı yapılandırın ve aracıyı başlangıçta çalıştırın (yönetici izni gerektirir)
• --windowsLogonAccount <account>- --runAsService veya --runAsAutoLogon biçiminde Windows kullanıcı adı belirtmek için kullanılır domain\userName veyauserName@domain.com
• --windowsLogonPassword <password>- --runAsService--runAsAutoLogon Windows oturum açma parolasını belirtmek için veya ile kullanılır
• --overwriteAutoLogon - --runAsAutoLogon makinede mevcut otomatik oturum açmanın üzerine yazmak için ile kullanılır
• --noRestart - --runAsAutoLogon Aracı yapılandırması tamamlandıktan sonra konağın yeniden başlatılmasını durdurmak için ile birlikte kullanılır

Yalnızca dağıtım grubu

• --deploymentGroup -Aracıyı bir dağıtım grubu Aracısı olarak yapılandırma
• --deploymentGroupName <name> -öğesine --deploymentGroup katılacak aracının dağıtım grubunu belirtmek için ile kullanılır
• --projectName <name> - --deploymentGroup proje adını ayarlamak için ile kullanılır
• --addDeploymentGroupTags - --deploymentGroup dağıtım grubu etiketlerinin eklenmesi gerektiğini göstermek için ile kullanılır
• --deploymentGroupTags <tags> - --addDeploymentGroupTags dağıtım grubu aracısına ait etiketlerin virgülle ayrılmış listesini belirtmek için ile kullanılır-Örneğin, "Web, DB"

Yalnızca ortamlar

• --addvirtualmachineresourcetags -ortam kaynak etiketlerinin eklenmesi gerektiğini göstermek için kullanılır
• --virtualmachineresourcetags <tags> - --addvirtualmachineresourcetags ortam kaynak aracısına ait etiketlerin virgülle ayrılmış listesini belirtmek için ile kullanılır-Örneğin, "Web, DB"

.\config --help her zaman gerekli olan en son ve isteğe bağlı yanıtları listeler.

Tanılama

Kendi kendine barındırılan aracılarınızla ilgili sorun yaşıyorsanız tanılamayı çalıştırmayı deneyebilirsiniz. Aracıyı yapılandırdıktan sonra:

.\run --diagnostics

Bu, sorunu gidermenize yardımcı olabilecek bir tanılama paketi üzerinden çalışır. Tanılama özelliği, aracı sürümü 2.165.0 ile başlayarak kullanılabilir.

Diğer seçeneklerle ilgili yardım

Diğer seçenekler hakkında bilgi edinmek için:

.\config --help

Yardım, kimlik doğrulama alternatifleri ve Katılımsız yapılandırma hakkında bilgi sağlar.

Özellikler

Aracılarınızın özellikleri, havuza yalnızca işleyebileceği derlemeler ve yayınlar atanmış olacak şekilde kataloglandığında ve tanıtılabilir. Bkz. derleme ve yayın Aracısı özellikleri.

Birçok durumda, bir aracıyı dağıttıktan sonra yazılım veya yardımcı programları yüklemeniz gerekir. Genellikle, geliştirme makinenizde kullandığınız yazılım ve araçlara her türlü aracı yüklemelisiniz.

Örneğin, derlemeniz NPM göreviniiçeriyorsa, NPM 'nin yüklü olduğu havuzda derleme Aracısı olmadığı takdirde yapı çalışmaz.

SSS

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

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

      

2. Aracıyı içeren havuza tıklayın.

3. Aracının etkinleştirildiğinden emin olun.

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

   

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

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

Aracıyı otomatik olarak imzalanan sertifikayla çalıştırmak Nasıl yaparım? mı?

Aracıyı otomatik olarak imzalanan sertifikayla çalıştırma

Aracıyı bir Web proxy 'nin arkasında çalıştırmak Nasıl yaparım? mı?

Aracıyı bir Web proxy 'nin arkasında çalıştırma

Aracıyı yeniden başlatmak Nasıl yaparım?

Aracıyı etkileşimli olarak çalıştırıyorsanız, etkileşimli Çalıştıriçindeki yeniden başlatma yönergelerine bakın. Aracıyı hizmet olarak çalıştırıyorsanız, hizmet olarak çalıştır' daki adımları izleyerek aracıyı yeniden başlatın.

MyEnv0=MyEnvValue0
MyEnv1=MyEnvValue1
MyEnv2=MyEnvValue2
MyEnv3=MyEnvValue3
MyEnv4=MyEnvValue4

https://login.microsoftonline.com
https://app.vssps.visualstudio.com 
https://{organization_name}.visualstudio.com
https://{organization_name}.vsrm.visualstudio.com
https://{organization_name}.vstmr.visualstudio.com
https://{organization_name}.pkgs.visualstudio.com
https://{organization_name}.vssps.visualstudio.com

https://dev.azure.com
https://*.dev.azure.com
https://login.microsoftonline.com
https://management.core.windows.net
https://vstsagentpackage.azureedge.net
https://vssps.dev.azure.com