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

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

İşlerinizi çalıştırmak için en az bir aracı gerekir. Linux aracısı Java ve Android uygulamaları dahil olmak üzere farklı türlerde uygulamalar derleme ve dağıtma. Ubuntu, Red Hat ve CentOS'u destekliyoruz.

Başlamadan önce:

• İşlem hatlarınız Azure Pipelines Microsoft tarafından barındırılan bir aracı ihtiyaçlarına uygunsa, özel linux aracısı ayarlamayı atlayabilirsiniz.
• Aksi takdirde Linux'ta 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 bilgi için bkz. Azure Pipelines..

Önkoşulları denetleme

Subversion

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.

İ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ı Azure DevOps olabilir.

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 izin olduğunu onaylayın

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

kullanıcı Azure DevOps kuruluş sahibi veya TFS veya Azure DevOps Server yöneticisi mi? Burada, izninizin olduğunu görürsünüz.

Aksi durumda:.

1. bir tarayıcı açın ve Azure Pipelines kuruluşunuzun veya Azure DevOps Server ya da TFS sunucunuzun 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. 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, bunu eklemek için bir yönetici alın. yönetici, bir aracı havuzu yöneticisi, bir Azure DevOps kuruluş sahibiveya bir TFS ya da Azure DevOps Server yöneticisiolabilir.

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

   Dağıtım grubu yöneticisi rolüne bir kullanıcıyı, Azure Pipelinesdağıtım grupları sayfasındaki güvenlik sekmesinde ekleyebilirsiniz.

Aracıyı indirme ve yapılandırma

Sunucu URL 'SI

Kimlik doğrulaması türü

Azure Pipelines

Patöğesini seçin ve ardından oluşturduğunuz Pat belirtecini komut istemi penceresine yapıştırın.

TFS veya Azure DevOps Server

Aracınızı TFS 'ye bağlanacak şekilde yapılandırdığınızda, aşağıdaki seçeneklere sahip olursunuz:

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

• Tümleşik MacOS veya Linux 'ta desteklenmez.

• Bağlan (varsayılan ), TFS veya Kerberos gibi Windows bir kimlik doğrulama düzeni aracılığıyla oturum açmış kullanıcı dışında bir kullanıcı olarak Azure DevOps Server. Anlaş ' ı seçtikten sonra kimlik bilgileri istenir.

• Pat yalnızca Azure Pipelines ve TFS 2017 ve daha yeni sürümlerde desteklenir. PAT öğesini seçtikten sonra, oluşturduğunuz Pat belirtecini komut istemi penceresine yapıştırın. Azure DevOps Server veya TFS örneğiniz ve aracı makineniz güvenilen bir etki alanında değilse, kişisel erişim belirteci (PAT) kullanın. PAT kimlik doğrulaması, etki alanı denetleyicisi yerine Azure DevOps Server veya TFS örneğiniz tarafından işlenir.

Etkileşimli olarak çalıştır

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.

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

1. Aracıyı hizmet olarak çalıştırıyorsanız, hizmeti 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 sonra run.sh yeniden başlatmak için çalıştırın.

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.

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

Systemd hizmeti olarak çalıştır

Aracınız bu işletim sistemlerinde çalışıyorsa aracıyı hizmet olarak çalıştırabilirsiniz systemd :

• Ubuntu 16 LTS veya üzeri
• Red hat 7,1 veya üzeri

./svc.shAracınızı hizmet olarak çalıştırmanız ve yönetmeniz için örnek bir betik sağlıyoruz systemd . Bu betik, aracıyı yapılandırdıktan sonra oluşturulacaktır. Bunu incelemeniz ve gerekirse, çalıştırmadan önce betiği güncelleştirmeniz önerilir.

Bazı önemli uyarılar:

• Aracınızı bir hizmet olarak çalıştırırsanız, aracı hizmetini kullanıcı olarak çalıştıramazsınız root .
• SELinux çalıştıran kullanıcılar, belirtilen betikle ilgili sorunlar bildirdi . Başlangıç noktası olarak Bu aracı sorununa bakın. SELinux, resmi olarak desteklenen bir yapılandırma değildir.

Komutlar

Aracı dizinine Değiştir

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

cd ~/myagent$

Yükleme

Komutundaki

sudo ./svc.sh install [username]

Bu komut, öğesine işaret eden bir hizmet dosyası oluşturur ./runsvc.sh . Bu betik ortamı ayarlar (daha fazla ayrıntı) ve aracılar ana bilgisayarını başlatır. usernameParametre belirtilmezse, Kullanıcı adı sudo komutu tarafından ayarlanan $SUDO _USER ortam değişkeninden alınır. Bu değişken, komutu çağıran kullanıcının adına her zaman eşittir sudo .

Başlangıç

sudo ./svc.sh start

Durum

sudo ./svc.sh status

Durdur

sudo ./svc.sh stop

Kaldırma

Kaldırmadan önce durdurmanız gerekir.

sudo ./svc.sh uninstall

Ortam değişkenlerini güncelleştirme

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

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

Ortam değişkenlerinin anlık görüntüsü dosyasında depolanır ( içinde depolanır), aracı kök dizini altında, ortam değişkeni değişikliklerini uygulamak için bu dosyaları .envPATH doğrudan da .path 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.

systemd hizmet dosyası

Bir systemd hizmet dosyası oluşturulur:

/etc/systemd/system/vsts.agent.{tfs-name}.{agent-name}.service

Örneğin, adıyla bir aracı yapılandırmış (yukarıya our-linux-agent bakın). Hizmet dosyası şu iki dosyadan biri olur:

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

• TFS veya Azure DevOps Server:Şirket içi sunucunuz adı. Örneğin, hizmetine http://our-server:8080/tfs bağlansanız, hizmet adı şu şekilde olur: /etc/systemd/system/vsts.agent.our-server.our-linux-agent.service

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

.service dosyası

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

Alternatif hizmet mekanizmaları

Aracınızı ./svc.sh sistemli hizmet olarak çalıştırmanız ve yönetmeniz için betiği kullanışlı bir yol olarak sağlaruz. Ancak, tercih ederseniz ne tür bir hizmet mekanizmasını (örneğin: initd veya upstart) kullanabilirsiniz.

Diğer hizmet dosyası türleri oluşturmayı kolaylaştırmak için yukarıda açıklanan şablonu kullanabilirsiniz.

Aracı hatalarından kaçınmak için cgroup kullanma

Aracının başarısız olduğu veya kullanılamaz hale geldiği durumların önüne geçilmesi önemlidir çünkü aksi takdirde aracı işlem hattı günlüklerini akışla aktaramaz veya işlem hattı durumunu sunucuya geri bildiremezse. Cgroup'ları ve daha düşük bir kullanarak yüksek bellek baskısı nedeniyle bu tür bir sorunun riskini oom_score_adj azaltabilirsiniz. Bunu tamamladikten sonra Linux, aracı sürecinden bellek geri gelmeden önce işlem hattı iş işlemlerinden sistem belleğini geri kullanır. cgroups ve OOM puanını yapılandırmayı öğrenin.

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

Hizmet komutlarını çalıştırmak neden sudo gerekir?

./svc.shsystemctl, gerektiren öğesini kullanır sudo .

Kaynak kodu: GitHub üzerindeki systemd. svc. sh. Template

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? bir arka web proxy?

Aracıyı bir web proxy

Nasıl yaparım? yeniden başlatın

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