Kendi kendine barındırılan macOS aracıları

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

Bu makalede, Azure DevOps Services ve Azure DevOps Server'ın geçerli sürümleriyle 3.x aracı yazılımını kullanma yönergeleri sağlanır. 3.x aracısını destekleyen Azure DevOps Server sürümlerinin listesi için bkz. Azure DevOps Server 3.x aracısını destekliyor.

Xcode uygulamaları derlemek ve dağıtmak için en az bir macOS aracısı gerekir. Bu aracı java ve Android uygulamaları da derleyebilir ve dağıtabilir.

Not

Bu makalede, kendi kendine barındırılan aracıyapılandırmanın nasıl yapılacağı açıklanmaktadır. Azure DevOps Services kullanıyorsanız ve Microsoft tarafından barındırılan bir ajan ihtiyaçlarınızı karşılıyorsa, kendi kendine barındırılan bir macOS ajanı ayarlamayı atlayabilirsiniz.

Aracılar hakkında bilgi edinin

Bir aracın ne olduğunu ve nasıl çalıştığını zaten biliyorsanız, aşağıdaki bölümlere doğrudan geçiş yapabilirsiniz. Ancak ne yaptıkları ve nasıl çalıştıkları hakkında daha fazla bilgi edinmek isterseniz bkz. Azure Pipelines aracılarını.

Önkoşulları denetleme

• Desteklenen işletim sistemleri
  • x64
    • macOS 10.15 "Catalina"
    • macOS 11.0 "Big Sur"
    • macOS 12.0 "Monterey"
    • macOS 13.0 "Ventura"
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"
  • ARM64
    • macOS 11.0 "Big Sur"
    • macOS 12.0 "Monterey"
    • macOS 13.0 "Ventura"
    • macOS 14.0 "Sonoma"
    • macOS 15.0 "Sequoia"

• Git - Git 2.9.0 veya üzeri (önerilen en son sürüm - Homebrew) ile kolayca yükleyebilirsiniz

• .NET - Aracı yazılımı .NET 6 üzerinde çalışır, ancak .NET önkoşulu olmaması için kendi .NET sürümünü yükler.
• TFVC - TFVC deposundan oluşturuyorsanız bkz. TFVC önkoşulları.

İzinleri hazırlama

Subversion deposundan derleme yapıyorsanız makineye Subversion istemcisini yüklemeniz gerekir.

İlk defa manuel olarak ajan kurulumu yapmanız gerekir. Aracıların nasıl çalıştığına ilişkin bir his edindikten sonra veya birçok aracıyı ayarlamayı otomatikleştirmek istiyorsanız, katılımsız yapılandırmayıkullanmayı göz önünde bulundurun.

Kendi kendine barındırılan aracılar için bilgi güvenliği

Aracıyı yapılandıran kullanıcının havuz yöneticisi izinlerine ihtiyacı vardır, ancak aracıyı çalıştıran kullanıcı bunu yapmaz.

Aracı tarafından denetlenen klasörler, şifresi çözülebilecek veya dışarı aktarılabilir gizli diziler içerdiğinden mümkün olduğunca az kullanıcıyla sınırlandırılmalıdır.

Azure Pipelines aracısı, dış kaynaklardan indirmiş olduğu kodu yürütmek için tasarlanmış bir yazılım ürünüdür. Bu, doğal olarak Uzaktan Kod Yürütme (RCE) saldırılarına yönelik bir hedef olabilir.

Bu nedenle, işlem hattı aracılarının her bir kullanımını iş yapmak için çevreleyen tehdit modelini göz önünde bulundurmak ve aracıyı çalıştıran kullanıcıya, aracının çalıştığı makineye, İşlem Hattı tanımına yazma erişimi olan kullanıcılara, yaml'nin depolandığı git depolarına verilebilen en düşük izinlerin ne olduğuna karar vermek önemlidir. veya yeni işlem hatları için havuza erişimi denetleyen kullanıcı grubunu seçin.

Aracıyı çalıştıran kimliğin, aracıyı havuza bağlama izinlerine sahip kimlikten farklı olması en iyi yöntemdir. Kimlik bilgilerini (ve aracıyla ilgili diğer dosyaları) oluşturan kullanıcı, bunları okuması gereken kullanıcıdan farklıdır. Bu nedenle, ajan makinesinin kendisine ve günlükler ve artefaktlar gibi hassas dosyalar içeren ajan klasörlerine verilen erişimi dikkatli bir şekilde değerlendirmek daha güvenlidir.

Aracı klasörüne yalnızca DevOps yöneticileri ve aracı işlemini çalıştıran kullanıcı kimliği için erişim vermek mantıklıdır. Yöneticilerin, derleme hatalarını anlamak veya Azure DevOps hatalarını bildirebilmek amacıyla günlük dosyalarını almak ya da dosya sistemini incelemek zorunda kalması gerekebilir.

Hangi kullanıcıyı kullanacağınıza karar verme

Bir defalık işlem olarak aracıyı kaydetmeniz gerekiyor. Aracı kuyruğu yönetme iznine sahip bir kişi, bu adımları tamamlamalıdır. Temsilci, günlük işlemlerde bu kişinin kimlik bilgilerini kullanmayacak, ancak kayıt işleminde bu bilgilere ihtiyaç duyulmaktadır. Ajanların nasıl iletişim kurduğu hakkında daha fazla bilgi edinin.

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

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

Kullanıcı bir Azure DevOps kuruluş sahibi mi, TFS mi yoksa Azure DevOps Server yöneticisi mi? burada durdurizniniz var.

Yoksa:

1. Bir tarayıcı açın ve Azure Pipelines kuruluşunuz veya Azure DevOps Server veya TFS sunucusu için Aracısı havuzları sekmesine gidin:

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

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

      

   3. Aracı havuzlarıseçin.

      

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

3. Kullanacağınız kullanıcı hesabı gösterilmiyorsa, yöneticinin hesabı eklemesini sağlayın. Yönetici bir aracı havuzu yöneticisi, Azure DevOps kuruluş sahibiveya TFS ya da Azure DevOps Server yöneticisiolabilir.

   Bu bir dağıtım grubu aracısıysa, yönetici bir dağıtım grubu yöneticisi, Azure DevOps kuruluş sahibiveya TFS ya da Azure DevOps Server yöneticisiolabilir.

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

Not

Şuna benzer bir ileti görürseniz: Üzgünüz, kimliği ekleyemedik. Lütfen farklı bir kimlik deneyin., büyük olasılıkla bir kuruluş sahibi, TFS veya Azure DevOps Server yöneticisi için yukarıdaki adımları izlemişsinizdir. Hiçbir şey yapmanıza gerek yok; aracı havuzunu yönetme izniniz zaten var.

Aracıyı indirme ve yapılandırma

Azure Pipelines

1. Önceki bölümde açıklandığı gibi izinleri hazırladığınız hesabı kullanarak makinede oturum açın.

2. Web tarayıcınızda Azure Pipelines'da oturum açın ve Aracısı havuzları sekmesine gidin:

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

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

      

   3. Aracı havuzlarıseçin.

      

3. Varsayılan havuzunu seçin, Aracılar sekmesini seçin ve Yeni aracıseçin.

4. Ajanı al iletişim kutusunda,macOS öğesine tıklayın.

5. İndir düğmesine tıklayın.

6. Sayfadaki yönergeleri izleyin.

7. tar dosyasındaki genişletilmiş özniteliği temizleyin: xattr -c vsts-agent-osx-x64-V.v.v.tar.gz.

8. Ajanı seçtiğiniz dizine çıkartın. Bu dizine cd gidin ve ./config.sh çalıştırın. Araçlar ve betikler her zaman boşlukları doğru şekilde kaçamayabileceğinden, dizin yolunun boşluk içermemesine dikkat edin.

Sunucu URL'si

Azure Pipelines: https://dev.azure.com/{your-organization}

Kimlik doğrulama türü

Bir aracıyı kaydettiğinizde, aşağıdaki kimlik doğrulama türlerinden birini seçin; aracı kurulumu sizden her kimlik doğrulama türü için gereken belirli ek bilgileri ister. Daha fazla bilgi için bkz. Şirket içinde barındırılan aracı kimlik doğrulama seçenekleri.

• Kişisel erişim belirteci
• Cihaz kodu akışı
• hizmet sorumlusu

Etkileşimli olarak çalıştırma

Aracıyı etkileşimli modda mı yoksa hizmet olarak mı çalıştıracaklarına ilişkin yönergeler için bkz. Aracılar: Etkileşimli ve hizmet.

Aracıyı etkileşimli olarak çalıştırmak için:

1. Aracı hizmet olarak çalıştırıyorsanız hizmetikaldırın.

2. Ajanı çalıştırın.

   ./run.sh
   

Aracıyı yeniden başlatmak için Ctrl+C tuşlarına basın ve ardından run.sh çalıştırarak yeniden başlatın.

Ajanınızı kullanmak için ajan havuzunu kullanarak bir işi çalıştırın. Farklı bir havuz seçmediyseniz, aracınız Varsayılan havuzuna yerleştirilir.

Bir defa çalıştır

Etkileşimli ç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.sh --once

Bu modda aracılar yalnızca bir işi kabul eder ve ardından düzgün bir şekilde kapatılır (Azure Container Instances gibi bir hizmette çalıştırmak için kullanışlıdır).

launchd hizmeti olarak çalıştırma

Sizin için aracınızı bir ./svc.sh LaunchAgent hizmeti olarak çalıştırıp yönetmeniz amacıyla launchd betiğini sağlıyoruz. Bu betik, aracıyı yapılandırdıktan sonra oluşturulur. Hizmetin kullanıcı arabirimi testlerinizi çalıştırmak için kullanıcı arabirimine erişimi vardır.

Not

Diğer yaklaşımları tercih ediyorsanız, tercih ettiğiniz hizmet mekanizması türünü kullanabilirsiniz. Bkz. Hizmet dosyaları.

Tokenlar

Aşağıdaki bölümde, bu belirteçler değiştirilir:

• {agent-name}

• {tfs-name}

Örneğin, our-osx-agentadlı bir aracı yapılandırdınız (önceki örnekte gösterildiği gibi). Aşağıdaki örneklerde {tfs-name} şunlardan biri:

• Azure Pipelines: Kuruluşunuzun adı. Eğer https://dev.azure.com/fabrikam'a bağlanırsanız, hizmet adı vsts.agent.fabrikam.our-osx-agent olur.

• TFS: Şirket içi TFS AT sunucunuzun adı. Eğer http://our-server:8080/tfs'a bağlanırsanız, hizmet adı vsts.agent.our-server.our-osx-agent olur.

Komutlar

Ajan dizinine geçin

Örneğin, giriş dizininizin myagent alt klasörüne yüklediyseniz:

cd ~/myagent$

Yüklemek

Komut:

./svc.sh install

Bu komut, launchd'i işaret eden bir ./runsvc.sh plist'i oluşturur. Bu betik ortamı ayarlar ve (daha fazla ayrıntı aşağıdaki bölümde) ajanın ana bilgisayarını başlatır.

Başla

Komut:

./svc.sh start

Çıktı:

starting vsts.agent.{tfs-name}.{agent-name}
status vsts.agent.{tfs-name}.{agent-name}:

/Users/{your-name}/Library/LaunchAgents/vsts.agent.{tfs-name}.{agent-name}.plist

Started:
13472 0 vsts.agent.{tfs-name}.{agent-name}

Hizmet çalışıyorsa, sol taraftaki sayı pid'dir. İkinci sayı sıfır değilse bir sorun oluştu demektir.

Durum

Komut:

./svc.sh status

Çıktı:

status vsts.agent.{tfs-name}.{agent-name}:

/Users/{your-name}/Library/LaunchAgents/vsts.{tfs-name}.{agent-name}.testsvc.plist

Started:
13472 0 vsts.agent.{tfs-name}.{agent-name}

Hizmet çalışıyorsa, sol taraftaki sayı pid'dir. İkinci sayı sıfır değilse bir sorun oluştu demektir.

Durmak

Komut:

./svc.sh stop

Çıktı:

stopping vsts.agent.{tfs-name}.{agent-name}
status vsts.agent.{tfs-name}.{agent-name}:

/Users/{your-name}/Library/LaunchAgents/vsts.{tfs-name}.{agent-name}.testsvc.plist

Stopped

Kaldır

Kaldırma işlemine başlamadan önce durmalısınız.

Komut:

./svc.sh uninstall

Otomatik oturum açma ve kilitleme

Normalde aracı hizmeti yalnızca kullanıcı oturum açtığında çalışır. Makine yeniden başlatıldığında aracı hizmetinin otomatik olarak başlatılmasını istiyorsanız, makineyi otomatik olarak oturum açmak ve başlangıçta kilitlemek üzere yapılandırabilirsiniz. Bkz. Mac'inizi başlatma sırasında otomatik olarak oturum açmak için ayarlama - Apple Desteği.

Not

Daha fazla bilgi için Terminally Geeky: otomatik oturum açmayı daha güvenli kullanın bloguna bakın. Bu blogda bahsedilen .plist dosyası artık kaynakta kullanılamayabilir, ancak burada bir kopya bulunabilir: Lifehacker -oturum açmadan önce OS X'in masaüstünüzü yüklemesini sağlayın.

Ortam değişkenlerini güncelleştirme

Hizmeti yapılandırdığınızda, geçerli oturum açma kullanıcınız için PATH, LANG, JAVA_HOME, ANT_HOME ve MYSQL_PATH gibi bazı kullanışlı ortam değişkenlerinin anlık görüntüsünü alır. Değişkenleri güncelleştirmeniz gerekiyorsa (örneğin, bazı yeni yazılımları yükledikten sonra):

./env.sh
./svc.sh stop
./svc.sh start

Ortam değişkenlerinin anlık görüntüsü aracı kök dizini altındaki .env dosyada depolanır. Ayrıca, ortam değişkeni değişikliklerini uygulamak için bu dosyayı doğrudan değiştirebilirsiniz.

Hizmet başlamadan önce yönergeleri çalıştırma

Hizmet başlatıldığında çalıştırmak için kendi yönergelerinizi ve komutlarınızı da çalıştırabilirsiniz. Örneğin, ortamı ayarlayabilir veya betikleri çağırabilirsiniz.

1. runsvc.shdüzenleyin.

2. Aşağıdaki satırı yönergelerinizle değiştirin:

   # insert anything to setup env when running as a service
   

Hizmet Dosyaları

Hizmeti yüklediğinizde, bazı hizmet dosyaları yerine konur.

.plist hizmet dosyası

Bir .plist hizmet dosyası oluşturulur:

~/Library/LaunchAgents/vsts.agent.{tfs-name}.{agent-name}.plist

Örneğin:

~/Library/LaunchAgents/vsts.agent.fabrikam.our-osx-agent.plist

./svc.sh install bu dosyayı şu şablondan oluşturur: ./bin/vsts.agent.plist.template

.service dosyası

./svc.sh start, yukarıda açıklanan plist hizmet dosyasının yolunu içeren .service dosyasını okuyarak hizmeti bulur.

Alternatif hizmet mekanizmaları

./svc.sh betiğini, aracınızı launchd LaunchAgent hizmeti olarak çalıştırmanız ve yönetmeniz için kullanışlı bir yol olarak sunuyoruz. Ancak tercih ettiğiniz hizmet mekanizmasını kullanabilirsiniz.

Yukarıda açıklanan şablonu, diğer hizmet dosyası türlerinin oluşturulmasını kolaylaştırmak için kullanabilirsiniz. Örneğin, kullanıcı arabirimi testlerine ihtiyacınız yoksa ve otomatik oturum açma ve kilitlemeyi yapılandırmak istemiyorsanız şablonu, başlatma daemon'ı olarak çalışan bir hizmet oluşturacak şekilde değiştirirsiniz. Bkz. Apple Geliştirici Kitaplığı: Başlatma Daemon'ları ve Aracıları Oluşturma.

Temsilciyi değiştir

tr-TR: Aracıyı değiştirmek için Aracıyı indirme ve yapılandırma adımlarını tekrar izleyin.

Aracıyı zaten var olan bir aracıyla aynı adı kullanarak yapılandırdığınızda, mevcut aracıyı değiştirmek isteyip istemediğiniz sorulur. Yyanıtını verirseniz, yerine geçirdiğiniz etkeni (aşağıya bakın) kaldırdığınızdan emin olun. Aksi takdirde, birkaç dakikalık çatışmalardan sonra ajanlardan biri kapanır.

Bir aracıyı kaldır ve yeniden yapılandır

Aracıyı kaldırmak için:

1. Önceki bölümde açıklandığı gibi hizmeti durdurun ve kaldırın.

2. Temsilciyi kaldırın.

   ./config.sh remove
   

3. Kimlik bilgilerinizi girin.

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

Katılımsız konfigürasyon

Aracı, insan müdahalesi olmadan bir komut dosyasından ayarlanabilir. --unattended'u ve tüm soruların yanıtlarını geçmelisiniz.

Aracıyı yapılandırmak için kuruluşunuzun URL'sini veya aracıları ayarlama yetkisi olan birinin koleksiyonunu ve kimlik bilgilerini bilmesi gerekir. Diğer tüm yanıtlar isteğe bağlıdır. Bunun yerine herhangi bir komut satırı parametresi bir ortam değişkeni kullanılarak belirtilebilir: adını büyük harfe koyun ve VSTS_AGENT_INPUT_ekleyin. Örneğin, VSTS_AGENT_INPUT_PASSWORDbelirtmek yerine --password.

Gerekli seçenekler

• --unattended - aracı kurulumu bilgi istemez ve tüm ayarlar komut satırında sağlanmalıdır
• --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 şunlardır:
  • pat (Kişisel erişim belirteci) - PAT, Azure DevOps Services ile çalışan tek şemadır.
  • alt (Temel kimlik doğrulaması)

Kimlik doğrulama seçenekleri

• --auth patseçtiyseniz:
  • --token <token> - Kişisel erişim belirtecinizi belirtir
  • PAT, Azure DevOps Services ile çalışan tek şemadır.
• --auth negotiate veya --auth altseçtiyseniz:
  • --userName <userName> - bir kullanıcı adı belirtir
  • --password <password> - bir parola belirtir

Havuz ve ajan adları

• --pool <pool> - Aracının katılacağı havuz adı
• --agent <agent> - temsilci adı
• --replace - havuzdaki temsilciyi değiştirin. Dinleyen başka bir aracı varsa ve aynı adla çalışıyorsa, çakışma nedeniyle başarısızlığa neden olur.

Aracı kurulumu

• --work <workDirectory> - iş verilerinin depolandığı iş dizini. Varsayılan olarak, _work aracı dizininin kökü altında bulunur. İş 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şmesi'ni kabul edin (yalnızca macOS ve Linux)
• --disableloguploads - konsol günlüğü çıkışını sunucuya akışla aktarmayın veya göndermeyin. Bunun yerine, iş tamamlandıktan sonra aracı bilgisayarın dosya sisteminden alabilirsiniz.

Yalnızca dağıtım grubu

• --deploymentGroup - aracıyı dağıtım grubu aracısı olarak yapılandırma
• --deploymentGroupName <name>, aracının katılacağı dağıtım grubunu belirtmek için --deploymentGroup ile birlikte kullanılır.
• --projectName <name> - proje adını ayarlamak için --deploymentGroup ile kullanılır
• --addDeploymentGroupTags - dağıtım grubu etiketlerinin eklenmesi gerektiğini belirtmek için --deploymentGroup ile birlikte kullanılır
• --deploymentGroupTags <tags> - dağıtım grubu aracısının etiketlerinin virgülle ayrılmış listesini belirtmek için --addDeploymentGroupTags ile birlikte kullanılır ; örneğin "web, db"

Yalnızca ortamlar

• --addvirtualmachineresourcetags - Ortam kaynak etiketlerinin eklenmesi gerektiğini belirtmek için kullanılır
• --virtualmachineresourcetags <tags> - ortam kaynak aracısının etiketlerinin virgülle ayrılmış listesini belirtmek için --addvirtualmachineresourcetags ile birlikte kullanılır ; örneğin "web, db"

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

Tanılama

Kendi barındırdığınız ajanla ilgili sorunlar yaşıyorsanız, tanılama çalıştırmayı deneyebilirsiniz. Acenteyi yapılandırdıktan sonra:

./run.sh --diagnostics

Bu, sorunu çözmenize yardımcı olabilecek bir tanılama süitinde çalıştırılacaktır. Tanılama özelliği aracı 2.165.0 sürümünden itibaren kullanılabilir.

Öz barındırılan aracılar için ağ tanılaması

Kendi kendine barındırılan aracıların ağ sorunlarını gidermek için kullanılabilecek ek günlükleri toplamak amacıyla Agent.Diagnostic değerini true olarak ayarlayın. Daha fazla bilgi için bkz. Kendinden barındırılan aracılar için ağ tanılama işlemleri.

Diğer seçeneklerle ilgili yardım

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

./config.sh --help

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

Yetenekler

Temsilcinizin yetenekleri kataloglanır ve havuzda tanıtılır, böylece sadece işleyebileceği derleme ve yayınlar ona atanır. Bkz. Derleme ve Yayınlama Aracısı Özellikleri.

Çoğu durumda, aracıyı dağıttığınızda yazılım veya yardımcı programlar yüklemeniz gerekir. Genellikle geliştirme makinenizde kullandığınız yazılım ve araçları aracılarınıza yüklemeniz gerekir.

Örneğin, derlemeniznpm görevini içeriyorsa, havuzda npm yüklü bir derleme aracısı olmadığı sürece derleme çalışmaz.

Önemli

Özellikler tüm ortam değişkenlerini ve aracı çalıştırıldığında ayarlanan değerleri içerir. Aracı çalışırken bu değerlerden herhangi biri değişirse, yeni değerleri almak için aracının yeniden başlatılması gerekir. Yeni bir yazılımı bir aracıya yükledikten sonra, yeni özelliğin havuzda görünmesi ve derlemenin çalışabilmesi için aracıyı yeniden başlatmanız gerekir.

Çevre değişkenlerini bir özellik olarak hariç tutmak istiyorsanız, göz ardı edilecek değişkenleri virgülle ayrılmış bir listede belirterek bir VSO_AGENT_IGNORE ortam değişkeni ayarlayabilirsiniz.

Sıkça Sorulan Sorular

En güncel ajan sürümüne sahip olduğumdan nasıl emin olabilirim?

1. Aracı havuzları sekmesine gidin:

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

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

      

   3. Aracı havuzlarıseçin.

      

2. Ajanı içeren havuza tıklayın.

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

4. Yetenekler sekmesine gidin:

   1. Aracı havuzları sekmesinden istediğiniz aracı havuzunu seçin.

      Ajan havuzlarından

   2. Önce Ajanlar seçin ve ardından istediğiniz ajanı seçin.

      

   3. Özellikleri 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ılarda yüklü yazılımların listesi için bkz. Microsoft tarafından barındırılan aracıkullanma .

5. Agent.Version özelliğini arayın. Bu değeri en son yayımlanan aracı sürümüyle karşılaştırabilirsiniz. Azure Pipelines Agent bölümüne bakın ve listelenen en yüksek sürüm numarasını kontrol etmek için sayfayı inceleyin.

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ştirseçin.

En güncel ajan sürümüne sahip olduğumdan nasıl emin olabilirim?

1. Aracı havuzları sekmesine gidin:

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

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

      

   3. Aracı havuzlarıseçin.

      

2. Ajanı içeren havuza tıklayın.

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

4. Yetenekler sekmesine gidin:

   1. Aracı havuzları sekmesinden istediğiniz aracı havuzunu seçin.

      Ajan havuzlarından

   2. Önce Ajanlar seçin ve ardından istediğiniz ajanı seçin.

      

   3. Özellikleri 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ılarda yüklü yazılımların listesi için bkz. Microsoft tarafından barındırılan aracıkullanma .

5. Agent.Version özelliğini arayın. Bu değeri en son yayımlanan aracı sürümüyle karşılaştırabilirsiniz. Azure Pipelines Agent bölümüne bakın ve listelenen en yüksek sürüm numarasını kontrol etmek için sayfayı inceleyin.

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ştirseçin.

Başlatılan hizmetin nasıl çalıştığı hakkında nereden daha fazla bilgi edinebilirim?

Apple Geliştirici Kitaplığı: Başlatma Daemon'ları ve Aracıları oluşturma

Bir güvenlik duvarı çalıştırıyorum ve kodum Azure Repos'ta. Ajanın hangi URL'lerle iletişim kurması gerekiyor?

Güvenlik duvarının arkasındaki güvenli bir ağda aracı çalıştırıyorsanız, aracının aşağıdaki URL'ler ve IP adresleriyle iletişim başlataadığından emin olun.

Etki alanı URL'si	Açıklama
https://{organization_name}.pkgs.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için Azure DevOps Paketleme API'si
https://{organization_name}.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için
https://{organization_name}.vsblob.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için Azure DevOps Telemetrisi
https://{organization_name}.vsrm.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için Sürüm Yönetim Hizmetleri
https://{organization_name}.vssps.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için Azure DevOps Platform Hizmetleri
https://{organization_name}.vstmr.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için Azure DevOps Test Yönetim Hizmetleri
https://*.blob.core.windows.net	Azure Artifacts
https://*.dev.azure.com	dev.azure.com etki alanını kullanan kuruluşlar için
https://*.vsassets.io	CDN aracılığıyla Azure Artifacts
https://*.vsblob.visualstudio.com	dev.azure.com etki alanını kullanan kuruluşlar için Azure DevOps Telemetrisi
https://*.vssps.visualstudio.com	dev.azure.com etki alanını kullanan kuruluşlar için Azure DevOps Platform Hizmetleri
https://*.vstmr.visualstudio.com	dev.azure.com etki alanını kullanan kuruluşlar için Azure DevOps Test Yönetim Hizmetleri
https://app.vssps.visualstudio.com	{organization_name}.visualstudio.com etki alanını kullanan kuruluşlar için
https://dev.azure.com	dev.azure.com etki alanını kullanan kuruluşlar için
https://login.microsoftonline.com	Microsoft Entra oturum açma
https://management.core.windows.net	Azure Yönetim API'leri
https://vstsagentpackage.azureedge.net https://download.agent.dev.azure.com	Ajan paketi

Önemli

Azure DevOps için Edgio CDN kullanımdan kaldırılıyor ve bu, aracı yazılımı indirme için güvenlik duvarı kurallarında izin verilen yeni bir etki alanı URL'sini gerektiriyor. Ajana indirme izni vermek için beyaz listeye eklenecek yeni etki alanı https://*.dev.azure.com'dir. Güvenlik duvarı kurallarınız joker karakterlere izin vermiyorsa kullanın https://download.agent.dev.azure.com.

Azure DevOps ekibi bu değişikliği aşağıdaki tarihe kadar yapmanızı önerir:

• Azure DevOps Services için 1 Mayıs 2025
• Azure DevOps Server için 15 Mayıs 2025

Daha fazla bilgi için bkz. İşlem Hatlarında Aracılar için CDN Etki Alanı URL'si değişikliği.

Kuruluşunuzun mevcut güvenlik duvarı veya IP kısıtlamalarıyla çalıştığından emin olmak için, dev.azure.com ve *dev.azure.com açık olduğundan emin olun ve izinle listelenen IP'lerinizi IP sürümünüz temelinde aşağıdaki IP adreslerini içerecek şekilde güncelleştirin. şu anda 13.107.6.183 ve 13.107.9.183 IP adreslerini beyaz listeye alıyorsanız, olduğu gibi bırakın, çünkü onları kaldırmanız gerekmez.

IP V4 aralıkları

13.107.6.0/24
13.107.9.0/24
13.107.42.0/24
13.107.43.0/24
150.171.22.0/24 
150.171.23.0/24 
150.171.73.0/24 
150.171.74.0/24 
150.171.75.0/24 
150.171.76.0/24

IP V6 aralıkları

2620:1ec:4::/48
2620:1ec:a92::/48
2620:1ec:21::/48
2620:1ec:22::/48
2620:1ec:50::/48 
2620:1ec:51::/48 
2603:1061:10::/48

Not

İzin verilen adresler hakkında daha fazla bilgi için bkz. İzin verilen adres listeleri ve ağ bağlantıları.

Aracıyı kendi kendine imzalanmış sertifikayla nasıl çalıştırırım?

Aracıyı kendi imzaladığı sertifika ile çalıştırma

Aracıyı bir web ara sunucusunun arkasında nasıl çalıştırabilirim?

Aracıyı bir web ara sunucusu arkasında çalıştırma

Aracıyı nasıl yeniden başlatabilirim?

Aracıyı etkileşimli olarak çalıştırıyorsanız, Etkileşimliçalıştırma başlığındaki yeniden başlatma yönergelerine bakın. Aracıyı hizmet olarak çalıştırıyorsanız, önce Durdur'u ve ardından Başlat'ı için adımları izleyin.

Aracıyı web proxy'sini atlayacak ve Azure Pipelines'a bağlanacak şekilde nasıl yapılandırabilirim?

Aracının proxy'nizi atlayıp azure pipelines'a doğrudan bağlanmasını istiyorsanız, aracının aşağıdaki URL'lere erişmesini sağlamak için web proxy'nizi yapılandırmanız gerekir.

*.visualstudio.com etki alanını kullanan kuruluşlar için:

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

dev.azure.com etki alanını kullanan kuruluşlar için:

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

Kuruluşunuzun mevcut güvenlik duvarı veya IP kısıtlamalarıyla çalıştığından emin olmak için, dev.azure.com ve *dev.azure.com açık olduğundan emin olun ve izinle listelenen IP'lerinizi IP sürümünüz temelinde aşağıdaki IP adreslerini içerecek şekilde güncelleştirin. şu anda 13.107.6.183 ve 13.107.9.183 IP adreslerini beyaz listeye alıyorsanız, olduğu gibi bırakın, çünkü onları kaldırmanız gerekmez.

IP V4 aralıkları

13.107.6.0/24
13.107.9.0/24
13.107.42.0/24
13.107.43.0/24
150.171.22.0/24 
150.171.23.0/24 
150.171.73.0/24 
150.171.74.0/24 
150.171.75.0/24 
150.171.76.0/24

IP V6 aralıkları

2620:1ec:4::/48
2620:1ec:a92::/48
2620:1ec:21::/48
2620:1ec:22::/48
2620:1ec:50::/48 
2620:1ec:51::/48 
2603:1061:10::/48

Not

Bu yordam, aracının bir web proxy'sini atlamasına olanak tanır. Derleme işlem hattınız ve betikleriniz, derlemenizde çalıştırdığınız her görev ve araç için web proxy'nizi atlamayı işlemeye devam etmelidir.

Örneğin, bir NuGet görevi kullanıyorsanız, web proxy'nizi kullandığınız NuGet akışını barındıran sunucunun URL'sini atlamayı destekleyecek şekilde yapılandırmanız gerekir.

TFVC önkoşulları

TFVC kullanacaksanız, Oracle Java JDK 1.6 veya üzeri de gerekecektir. (Oracle JRE ve OpenJDK bu amaç için yeterli değildir.)

TEE eklentisi TFVC işlevselliği için kullanılır. TFVC ile çalışmayı planlıyorsanız yapılandırma sırasında kabul etmeniz gereken bir EULA'sı vardır.

TEE eklentisi artık korunmadığından ve bazı güncel olmayan Java bağımlılıkları içerdiğinden, Agent 2.198.0'dan başlayarak aracı dağıtımına eklenmez. Ancak, bir TFVC deposunu kullanıma alıyorsanız, TEE eklentisi kullanıma alma görevi sırasında indirilir. TEE eklentisi, iş yürütüldikten sonra kaldırılır.

Not

Not: Bu indirme mekanizması nedeniyle ödeme işleminizin başlamasının uzun sürdüğünü fark edebilirsiniz.

Aracı bir ara sunucu veya güvenlik duvarının arkasında çalışıyorsa, şu siteye erişim sağlamak için kabul etmeniz gerekir: https://vstsagenttools.blob.core.windows.net/. TEE eklentisi bu adresten indirilir.

Şirket içinde barındırılan bir aracı kullanıyorsanız ve TEE indirmeyle ilgili sorunlarla karşılaşıyorsanız, TEE'yi el ile yükleyebilirsiniz:

1. DISABLE_TEE_PLUGIN_REMOVAL ortamı veya işlem hattı değişkenini trueolarak ayarlayın. TFVC deposu kullanıma alındıktan sonra bu değişken, aracının TEE eklentisini kaldırmasını engeller.
2. GitHub'ınTeam Explorer Everywhere sürümünden TEE-CLC sürüm 14.135.0'ı el ile indirin.
3. TEE-CLC-14.135.0 klasörünün içeriğini <agent_directory>/externals/tee'e ayıklayın.