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

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

Xcode uygulamaları veya Xamarin.iOS projeleri oluşturmak ve dağıtmak için en az bir macOS aracınız gerekir. Bu aracı Ayrıca Java ve Android uygulamaları da derleme ve dağıtma.

Başlamadan önce:

• İşlem hatlarınız Azure Pipelines Microsoft tarafından barındırılan bir aracı ihtiyaçlarınıza uygunsa, kendinden konak bir macOS aracısı ayarlamayı atlayabilirsiniz.
• Aksi takdirde, macOS üzerinde bir aracı ayarlamak için doğru yere gelirsiniz. 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 arka plan bilgi için bkz. Azure Pipelines..

Önkoşulları denetleme

TFVC'yi kullanıyorsanız Oracle Java JDK 1.6 veya üst sürümüne de ihtiyacınız olacaktır. (Oracle JRE ve OpenJDK bu amaç için yeterli değildir.)

İzinleri hazırlama

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.

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 mı? Burada dur,izniniz var.

Aksi durumda:.

1. Bir tarayıcı açın ve Azure Pipelines veya TFS sunucunuz için Aracı Azure DevOps Server 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ı kuyrukları Ayarlar (dişli simgesi) seçin.

      

   2. Havuzları yönet'i seçin.

      

   1. Projenize gidin ve Aracı kuyrukları 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 DevOpsveya TFSya da Azure DevOps Server olabilir.

   Bu bir dağıtım grubu aracısı ise, yönetici bir dağıtım grubu yöneticisi, Azure DevOps kuruluş sahibi veyaTFS 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

Kimlik doğrulaması türü

Azure Pipelines

PAT 'iseçin ve ardından oluşturduğunuz PAT belirteci komut istemi penceresine yapıştırın.

TFS veya Azure DevOps Server

Aracınızı TFS'ye bağlanarak yapılandırarak aşağıdaki seçenekleri kullanabilirsiniz:

• Temel Bağlan kullanarak TFS veya Azure DevOps Server alternatif kimlik doğrulaması. Alternatif'i seçdikten sonra kimlik bilgileriniz istenir.

• Entegre macOS veya Linux'ta desteklenmiyor.

• TFS'Bağlan (Varsayılan) anlaşması Azure DevOps Server, NTLM veya Kerberos gibi bir Windows kimlik doğrulama şeması aracılığıyla oturum Windows kullanıcı dışında bir kullanıcı olarak kabul et. Anlaşma'ya karar verdikten sonra kimlik bilgileriniz istenir.

• PAT Yalnızca Azure Pipelines ve TFS 2017 ve daha yeni sürümlerde destekler. PAT'yi seçtikten sonra, oluşturduğunuz PAT belirteci komut istemi penceresine yapıştırın. Kişisel erişim belirteci (PAT) Azure DevOps Server veya TFS örneğiniz ve aracı makineniz güvenilir bir etki alanında değilse kullanın. PAT kimlik doğrulaması, etki alanı Azure DevOps Server veya TFS örneğiniz tarafından işleme tabi olur.

Etkileşimli olarak çalıştırma

Aracıyı etkileşimli modda mı yoksa hizmet olarak mı çalıştıracakları konusunda rehberlik için bkz. Aracılar: Etkileşimli ve hizmet.

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

1. Aracıyı bir hizmet olarak çalıştırdıysanız, hizmetini kaldırın.

2. Aracıyı ç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.

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

Bir kez çalıştır

Etkileşimli olarak çalıştıracak şekilde yapılandırılmış aracılar için, aracının yalnızca bir işi kabul etmelerini 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 uygun şekilde aşağı döner (örneğin, Azure Container Instances).

Başlatan hizmet olarak çalıştırma

Aracınızı ./svc.sh çalıştıracak ve başlatan bir LaunchAgent hizmeti olarak yönetecek betiği sağlaruz. Bu betik, siz aracıyı yapılandırdikten sonra oluşturulur. Hizmetin kullanıcı arabirimi testlerinizi çalıştırmak için kullanıcı arabirimine erişimi vardır.

Belirteçler

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

• {agent-name}

• {tfs-name}

Örneğin, adıyla bir aracı yapılandırmış (yukarıya our-osx-agent bakın). Aşağıdaki örneklerde şu {tfs-name} iki örnek de verilmiştir:

• Azure Pipelines: Kuruluş adı. Örneğin, hizmetine https://dev.azure.com/fabrikam bağlansanız, hizmet adı şu şekilde olur: vsts.agent.fabrikam.our-osx-agent

• TFS: Şirket içi TFS AT sunucunuz adı. Örneğin, hizmetine http://our-server:8080/tfs bağlansanız, hizmet adı şu şekilde olur: vsts.agent.our-server.our-osx-agent

Komutlar

Aracı dizinine değiştirme

Örneğin, giriş dizininizin myagent alt klasörüne yüklemiş olursanız:

cd ~/myagent$

Yükleme

Komut:

./svc.sh install

Bu komut, 'a göre başlatan bir plist ./runsvc.sh oluşturur. Bu betik ortamı ayarlar (daha fazla ayrıntı aşağıda verilmiştir) ve aracının ana bilgisayarlarını başlatır.

Başlangıç

Komut:

./svc.sh start

Çıkış:

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 sayı pid'tir. İkinci sayı sıfıra yakınsa bir sorun oluştu demektir.

Durum

Komut:

./svc.sh status

Çıkış:

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 sayı pid'tir. İkinci sayı sıfıra yakınsa bir sorun oluştu demektir.

Durdur

Komut:

./svc.sh stop

Çıkış:

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ırma

Kaldırmadan önce durdurmanız gerekir.

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ı istemiyorsanız, makineyi başlangıçta otomatik olarak oturum açmak ve kilitlemek üzere yapılandırabilirsiniz. Bkz. Başlangıç sırasında Mac'inizi otomatik olarak oturum açmak için ayarlama - Apple Desteği.

Ortam değişkenlerini güncelleştirme

Hizmeti yapılandırarak PATH, LANG, JAVA_HOME, ANT_HOME ve MYSQL_PATH. Değişkenleri güncelleştirmeniz gerekirse (ö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 dosyada depolanır, ayrıca ortam değişkeni değişikliklerini uygulamak .env 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ı veya çağrı betiklerini kurabilirsiniz.

1. 'yi runsvc.sh düzenleyin.

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

   # insert anything to setup env when running as a service
   

Hizmet Dosyaları

Hizmeti yüklemenizin ardından bazı hizmet dosyaları yerine konacak.

.plist hizmet dosyası

Bir .plist hizmet dosyası oluşturulur:

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

Örnek:

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

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

.service dosyası

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

Alternatif hizmet mekanizmaları

Betiği, aracınızı başlatan bir LaunchAgent hizmeti olarak çalıştırmanız ve ./svc.sh yönetmeniz için kullanışlı bir yol sağlariz. Ancak, tercih ederseniz herhangi bir hizmet mekanizmasını kullanabilirsiniz.

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

Aracıyı değiştirme

Bir aracıyı değiştirmek için Aracıyı indirme ve yapılandırma adımlarını tekrar izleyin.

Zaten var olan bir aracıyla aynı adı kullanarak bir aracı yapılandırıldığında, mevcut aracıyı değiştirmek istiyor musunuz? yanıtını Y verirsanız, değiştirerek aracıyı kaldır (aşağıya bakın) emin olun. Aksi takdirde, birkaç dakikalık çakışmaların ardından aracılardan biri kapanacak.

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

Aracıyı kaldırmak için:

1. Yukarıda açıklanan şekilde hizmeti durdurun ve kaldırın.

2. Aracıyı kaldırın.

   ./config.sh remove
   

3. Kimlik bilgilerinizi girin.

Aracıyı kaldırdikten sonra yeniden yapılandırılabilir.

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

Aracı, bir betikten insan müdahalesi gerekm yok olarak ayarlanmaz. Tüm soruların --unattended yanıtlarını ve yanıtlarını geçmelisiniz.

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

Tanılama

Kendi kendine barındırılan aracınız ile ilgili sorun varsa tanılama çalıştırmayı denemeniz gerekir. Aracıyı yapılandırdikten sonra:

./run.sh --diagnostics

Bu, sorunu gidermenize yardımcı olacak bir tanılama paketi aracılığıyla ecek. Tanılama özelliği aracı sürümü 2.165.0'dan başlayarak kullanılabilir.

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.

Özellikler

Yalnızca işleyilen derlemeler ve sürümler atanacak şekilde, aracının özellikleri kataler ve havuzda tanıtıldı. Bkz. Derleme ve sürüm aracısı özellikleri.

Çoğu durumda, aracıyı dağıtınca yazılım veya yardımcı programları yüklemeniz gerekir. Genellikle aracılarınızı geliştirme makinenize hangi yazılımları ve araçları kullanırsınız? yüklemeniz gerekir.

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

SSS

Nasıl yaparım? v2 aracı sürümüne sahip miyim?

1. 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. Aracıyı içeren havuza tıklayın.

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

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

   

5. Özelliğine Agent.Version bakın. Bu değeri yayımlanan en son aracı sürümüne göre kontrol edin. Aracı Azure Pipelines a bakın ve listelenen en yüksek sürüm numarasının sayfasını kontrol edin.

6. Her aracı, aracının daha yeni bir sürümünü gerektiren bir görevi çalıştırarak otomatik olarak kendini güncelleştirmesi. Bazı aracıları el ile güncelleştirmek için havuza sağ tıklayın ve Tüm aracıları güncelleştir'i seçin.

Başlatan hizmetin nasıl çalıştığını nereden öğrenebilirim?

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

Nasıl yaparım? otomatik olarak imzalanan sertifikayla çalıştıracak mısınız?

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

Nasıl yaparım? arkanızda çalıştıracak web proxy?

Aracıyı bir web proxy

Nasıl yaparım? yeniden başlatmak için

Aracıyı etkileşimli olarak çalıştıracaksanız Etkileşimli olarak çalıştırma konusunda yeniden başlatma yönergelerine bakın. Aracıyı bir hizmet olarak çalıştırdıysanız, Aracıyı Durdur ve ardından Başlat adımlarını izleyin.

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