OmniLab ATS, Android geliştiricilerinin ve test mühendislerinin kullanabileceği bir test aracıdır Android test paketlerini çalıştırmak için bir kullanıcı arayüzü Android Uyumluluk Test Paketi (CTS) Bu araç test çerçeveleri gibi çeşitli test çerçeveleri için bir web arayüzü işlevi Ticaret Federasyonu (TF) ve Google Mobly, CTS'yi çalıştırmanıza ve minimum kurulum düzeyiyle bir dizi test cihazında çoklu cihaz testlerinin yanı sıra testlerin sürekli yürütülmesi için bir zaman çizelgesi oluşturmalıdır.
OmniLab ATS'yi kurma
Bu bölümde, OmniLab ATS'yi nasıl yükleyeceğiniz ve ayarlayacağınız açıklanmaktadır.
OmniLab ATS, aşağıdaki konumlardaki kaynak kodlarını kullanır:
- OmniLab ATS kaynak kodu
- TradeFed Cluster kaynak kodu
OmniLab ATS'yi yükleme
Çalıştırdığınız test paketleri için tüm donanım ve yazılım gereksinimlerine uyun.
CTS ile ilgili koşulları source.android.com adresinde bulabilirsiniz.
OmniLab ATS için ek donanım gereksinimi yoktur ancak şunları öneririz: CTS barındırıcı şartını kullanarak bir başlangıç noktası olarak düşünebilirsiniz.
OmniLab ATS'yi yüklemenin iki yolu vardır:
- Yükleyici programını çalıştırın.
- Manuel olarak yükleyin. Bu işlem, birden fazla yükleme gerektirir. programlar ve kaynaklar.
Yükleyici programıyla yükleme
Ubuntu 20.04 ve sonraki sürümlerde, yükleyici programı tüm programları yükler ve yapılandırır ve OmniLab ATS'yi çalıştırmak için gereken kaynaklar.
Yükleme programını kullanmak için:
Yükleyici programını çalıştırın:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
OmniLab ATS CLI'ın yüklü sürümünü kontrol etmek için
mtt version
komutunu çalıştırın.
Manuel olarak yükleme
Docker'ı yükleme
Şunu izleyin: Docker Community Edition (CE)'ı yükleme talimatları indirin.
Docker'ı root olmayan bir kullanıcı olarak yönetmek için yükleme sonrası adımları uygulayın.
Terminal pencerenizi yeniden başlatmanız veya oturumu kapatıp tekrar açmanız gerekebilir adresine gidin.
Python 3'ü yükleyin
OmniLab ATS CLI, Python'un 3.7-3.11 arasındaki sürümleriyle doğrulanır.
Ubuntu 16.04 veya önceki sürümler için önce bir yaparak Python 3 deposunu ekleyin şunlardan biri:
Python 3'ü yüklemek için şu komutları çalıştırın:
sudo apt-get update
sudo apt install python3 python3-distutils
Belirli bir Python 3 sürümünü (ör. 3.10) yüklemek için bunun yerine aşağıdaki komutları çalıştırın:
sudo apt-get update
sudo apt install python3.10 python3.10-distutils
OmniLab ATS CLI'ı edinme
Komut satırı arayüzü (KSA) paketini buradan indirin.
OmniLab ATS'yi başlat
OmniLab ATS'yi aşağıdaki komutla başlatın:
mtt start
Kullanıcı arayüzü ilk başlatıldığında, görünmesi birkaç dakika sürebilir. CLI, tarayıcıda kullanıcı arayüzüne erişmek için bir web URL'si gösterir. Varsayılan olarak web URL'si
localhost:8000
Gerekirse başlatma sırasında varsayılan bağlantı noktasını
--port
işareti.
Daha yeni bir sürüm varsa mevcut sürüme güncelleyebilirsiniz. Şunları yapabilirsiniz: Sürüm Notları'na göz atın. en son sürümler için.
Geçerli sürüme güncellemek için şu komutu çalıştırın:
mtt start --force_update
Uygulamayı durdurmak için şu komutu çalıştırın:
mtt stop
Diğer komutların listesini görüntülemek için şunu kullanın:
mtt --help
Veritabanını yedekleme ve geri yükleme
OmniLab ATS veritabanını yedeklemek için uygulamayı durdurun ve aşağıdaki komutu çalıştırın:
Bu işlem, mevcut veritabanını mtt-backup.tar
adlı bir TAR dosyasına yedekler.
ana dizininiz:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."
Geri yüklemek için uygulamayı başlatmadan önce aşağıdaki komutu çalıştırın:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"
Kurulum Sihirbazı
OmniLab ATS'yi ilk kez yükleyip çalıştırdıktan sonra Kurulum Sihirbazı, aracı ortamınıza göre özelleştirmenize yardımcı olmak için sizi birkaç adımda yönlendirir. Herhangi biri Burada yaptığınız değişiklikler daha sonra Ayarlar sayfasından yeniden yapılandırılabilir.
Yapılandırma yedeğini geri yükleme
Başka bir OmniLab ATS ana makinesinden yedeklenmiş bir yapılandırma dosyanız varsa Dosya Yükle düğmesini tıklayarak bu ana makinede değiştirilen tüm yapılandırmaları kopyalamak için dosyayı yükleyebilirsiniz.
Şekil 1. Yapılandırma Yedeklemesini Geri Yükleme.
Varsayılan hizmet hesabını ayarlama
Bir hizmet hesabı ayarlayabilirsiniz OmniLab ATS'nin kaynaklarınıza erişirken varsayılan olarak kullandığı Google Cloud Storage, Google Drive) ekleyin. Hizmet hesabınızın kimliğini doğrulamak için şunu tıklayın: Hizmet Hesabı Anahtarını Yükle'yi tıklayın ve hizmet hesabınızın JSON anahtar dosyasını seçin.
Şekil 2. Hizmet hesabını ayarlama.
Hizmet hesabının kimliği başarıyla doğrulandığında, hesap e-posta adresi adresi sayfanın sağ üst köşesinde görünür. Hizmeti değiştirmek için hesap adını tıklayın, mevcut varsayılan hesabı kaldırın ve yeni bir hizmet hesabı anahtarı var.
Şekil 3. Hizmet hesabını değiştirme.
Yapılandırma kümelerini içe aktar
Yapılandırma kümesi, ilgili test paketlerini çalıştırmak için cihaz işlemleri yapabilir ve kanallar oluşturabilirsiniz. Yapılandırma kümeleri belirli bir Google Cloud Storage (GCS) paketi. GCS derleme kanalını Google Hesabı'nı seçtiğinizde, kullanabileceğiniz tüm yapılandırma gruplarının listesini görürsünüz.
Test Station ana makinenize eklemek istediğiniz yapılandırma kümelerini seçin ve Seçilenleri İçe Aktar.
4.Şekil Yapılandırma Kümesini içe aktarma
Kablosuz ayarlarını dahil etme
Bazı CTS testleri için cihazınızın bir kablosuz hotspot'a bağlanması gerekir. Seçmek için Kablosuz ağ, Kablosuz SSID ve isteğe bağlı Kablosuz PSK değerini girin.
5. Şekil. Kablosuz hotspot ayarları.
Kurulum Sihirbazı tamamlandıktan sonra sayfa yeni ayarlarla yeniden yüklenir geçerlidir.
Cihaz bağla
Bir cihazı test etmek için USB üzerinden hata ayıklama özelliği etkinleştirilmelidir. Hata ayıklamayı etkinleştirmek için:
Şu adresteki talimatları uygulayın: Geliştirici seçeneklerini etkinleştir ve hata ayıklama ile ilgili daha fazla bilgi edinin.
Özel ADB anahtarlarıyla önceden yüklenmiş test Android derlemelerini kullanmayı planlıyorsanız
~/.android/
dizinindeki özel.adb_key
dosyaları.Dosyalar otomatik olarak yüklenir ve cihaz bu derlemeleri çalıştıracak şekilde yüklendikten sonra USB hata ayıklama özelliğini otomatik olarak etkinleştirmek için ADB'ye iletilir.
Cihazı, USB kullanarak ana makineye bağlayın.
Cihaz, işlem tamamlandıktan sonra bir dakika içinde OmniLab ATS Cihazlar sekmesinde görünür web arayüzü yenileniyor. Cihazların durumunu şurada da görüntüleyebilirsiniz: bu sekmeden erişebilirsiniz.
6. Şekil. Bir cihaz bağlama.
Farklı cihaz durumları şunlardır:
- Kullanılabilir - Cihaz bağlı ve test çalıştırmaya hazırdır.
- Ayrılmış - Cihaz bağlıdır ve bir test yürütmektedir. Her biri Aynı anda yalnızca bir test çalıştırabileceğinden cihazın testini tamamlaması gerekir ve mevcut testi kontrol edin.
Testi çalıştırma
Bir test seçin
OmniLab ATS, önceden paketlenmiş bir dizi CTS yapılandırması ile birlikte gelir. Aşağıdakilerden birini çalıştırmak için Test Paketleri sekmesine gidin ve seçilen test için Testi çalıştır'ı testi.
7.Şekil Test seçme.
Testleri düzenlemek veya yeni testler eklemek için Test ekleme bölümüne bakın.
Test çalıştırmasını yapılandırma
Bu özel test çalıştırması için kullanılacak parametreleri düzenleyin. Çoğu parametre seçilen test yapılandırmasında tanımlanan değerlerle önceden doldurulur.
Bu adım, varsayılan değerler kullanılarak tamamlanabilir ancak Max Retry ve Command gibi parametreleri ihtiyaçlarınıza göre ayarlayın.
8. Şekil. Test çalıştırması yapılandırma.
Test çalıştırması parametreleri şunlardır:
- Ad - Çalıştırmak istediğiniz test paketinin adı.
- Çalıştırma Sayısı: Bu test çalıştırmasının için iyi bir fırsattır. Test çalıştırmaları, Trade Federation kullanılarak planlanır. Bu araç, kapasitesi varsa 20'ye kadar test çalıştırmasını paralel olarak yürütür.
- Maksimum Yeniden Deneme - En az bir test çalıştırması varsa bir test çalıştırmasının maksimum yeniden deneme sayısı test başarısız olur. Bu değer, genellikle kararsız testleri ele almak için tam bir CTS çalıştırması için 4-6 yeniden deneme olarak ayarlanır.
- Sıra Zaman Aşımı: Bir test çalıştırması çok uzun süre Sırada durumunda kalırsa otomatik olarak iptal edilir. Önce beklenecek süreyi belirtin buradan iptal edebilirsiniz. Varsayılan değer 24 saattir.
Command: Test paketini çalıştırma komutu. Buraya ek komut satırı bağımsız değişkenleri girebilirsiniz. Örneğin, CTS 8.1'de belirli bir modül şununla:
cts-suite -m ShortModuleName
Tekrar Deneme Komutu: Bir test paketini yeniden deneme komutu. Ekleyebileceğiniz: komut satırı bağımsız değişkenlerine buradan göz atabilirsiniz. Örneğin, yalnızca bir kez CTS 8.1'deki belirli modüller için şunu kullanın:
cts --retry 0 -m ShortModuleName
Yeniden deneme bağımsız değişkenleri, ilk komutta kullanılabilen bağımsız değişkenlerden farklı olabilir. Bu nedenle, seçilen test için resmi sitede desteklenen parametreleri kontrol edin paketinde yer alır.
Önceki Test Çalıştırması - Önceki bir test çalıştırmasını yeniden çalıştırmak isterseniz:
Yerel - Çalıştırma mevcut ana makinede başlatıldıysa test çalıştırmasını girin Test çalıştırmasının ayrıntıları görüntülenirken görülen kimlik.
9. Şekil. Önceki yerel test çalıştırması.
Uzaktan - Çalıştırma farklı bir ana makinede başlatıldıysa testi Remote'u seçip Test Sonuçlarını Yükle'yi tıklayarak test sonuçlarını yükleyin Dosya'ya gidin ve yerel depolama alanınızdan dosya seçin.
Şekil 10. Uzaktan önceki test çalıştırması.
Cihazları seçin
Testi çalıştırmak üzere ayrılacak cihazları seçmek için onay kutularını tıklayın paketinde yer alır. Kırık sayısı, parça sayısı ile eşleşecek şekilde otomatik olarak cihaz seçildi.
Şekil 11. Cihazlar seçiliyor.
Cihazları, cihaz serileri dışındaki özelliklere göre seçmek için manuel olarak "Cihaz Özellikleri"ni girin. Örneğin, ürün adı şu şekilde olan 3 cihaz seçmek için: "bramble" için aşağıdakini girin:
product:bramble;product:bramble;product:bramble
Desteklenen özellikler şunlardır:
- build_id
- device_serial
- device_type [cihaz_türü]
- ana makine adı
- ürün
- product_variant
- sim_state
Test çalıştırmasını yürütmek için seçili tüm cihazların Kullanılabilir durumunda olması gerekir. ve test çalıştırması yürütüldüğünde tümü Ayrılan durumuna geçer. CEVAP test çalıştırması, cihazların etkinleştirilmesi beklenirken Sıraya durumundadır kullanılabilir.
Cihaz ekleme işlemleri
Cihaz işlemleri, her test çalıştırmasından önce yürütülebilecek komut dosyalarıdır. Biraz yanıp sönme ve yeniden başlatma gibi cihaz işlemleri halihazırda yapılandırılmıştır. Alıcı: yeni cihaz işlemleri oluşturmak için bkz. Yeni bir cihaz işlemi oluşturun.
Şekil 12. Cihaz işlemleri.
Test çalıştırmasına bir cihaz işlemi eklemek için Yeni işlem ekle'yi tıklayın, Eklenecek işlemlerin onay kutularını işaretleyip İşlem Ekle'yi tıklayın. Cihaz işlemleri sırayla gerçekleştirilir. İşlemleri sürükleyerek yeniden sıralayabilirsiniz.
Şekil 13. İşlemler yeniden sıralanıyor.
Test kaynaklarını ayarlama
Test kaynakları, test çalıştırmak için gereken dosyalardır. Örneğin,
CTS bir android-cts*.zip
dosyası gerektirir ve bir cihazın yanıp sönmesi için şunları yapmanız gerekir:
derleme görüntüsünü sağlar.
Test paketi zip dosyasının indirme URL'si varsayılan olarak iş ortaklarına verilen Google Drive bağlantıları olmalıdır. Göz at'ı tıklayarak farklı bir dosya seçebilirsiniz. Pop-up pencerede bir dosya indirme bağlantısı girebilir, kimliği doğrulanmış derleme kanalından veya yerel depolama alanından kullanmak üzere bir dosya yükleyin.
Şekil 14. Kaynakları test edin.
Aşağıda, web URL'sine göre test kaynağı seçmek için kullanılan pop-up pencere gösterilmektedir. Şunları yapabilirsiniz: indirme URL'si bağlantısını girin ve şunu onaylamak için Seç düğmesini tıklayın: seçim.
Şekil 15. Test Kaynak Seçici - Web URL'si.
Google Grive, Google Cloud Storage (GCS) veya Dilerseniz ilgili kanalın sekmesine gidip oradalar. Google Drive'dan kaynak seçmeyle ilgili bir örneği aşağıda bulabilirsiniz.
Şekil 16. Test Kaynak Seçici - Google Drive.
Sadece dosya seçmeye ek olarak, Dosya adı alanına girin. Dokümanları burada bulabilirsiniz.
Şekil 17. Test Kaynak Seçici - Joker karakter modeli desteği.
OmniLab ATS'nin yerel dosya depolama alanından da dosya seçebilirsiniz. Bu depolama alanına dosya yükleyebilir veya yerel dosyaları ve dizinleri doğrudan kullanabilirsiniz.
Şekil 18. Test Kaynak Seçici - Yerel dosya deposu.
Yeniden çalıştırma yapılandırmaları ekle
Birincil çalıştırma tamamlandıktan sonra başlayan tekrarlar planlayabilirsiniz. ancak farklı cihaz, işlem veya kaynaklar kullanabiliyor.
19. Şekil. Yeniden çalıştırma yapılandırmaları ekleme.
Test çalıştırması başlatma
Test çalıştırması için gerekli bilgileri girdikten sonra Testi Başlat"ı tıklayın. Çalıştırın. Tüm bilgiler geçerliyse test çalıştırması başlar ve test çalıştırmasının ayrıntılarını ve ilerleme durumunu görüntüleyebileceğiniz bir sayfaya yönlendirilirsiniz.
Şekil 20. Test çalıştırması başlatılıyor.
Test planı oluşturma
Test planları, periyodik bir programa göre test çalıştırmaları oluşturmak amacıyla kullanılır. Örneğin, her gün saat 17:00'de CTS 9.0 çalıştırıyorum. Yeni bir test planı oluşturmak için Yeni test planı oluştur'u tıklayın.
Şekil 21. Test planı oluşturma.
Test planını yapılandırma
Test planının adını ve eklemek istediğiniz etiketleri girin. Ardından bir zaman çizelgesine uymanız gerekir.
- Manuel - Test planı, yalnızca bir kullanıcı şu öğeyi tıkladığında test çalıştırmaları oluşturur: Test planı listesi sayfasında test planını çalıştırın.
- Periyodik: Test planı, periyodik program seçildi. Örneğin, her gün saat 12:00'de bir test çalıştırması 17:00 seçeneğini tıklayın.
- Özel: Test planı, test çalıştırmalarını
cron ifadesi girildi. Örneğin,
her gün saat 17:00'de bir test çalıştırması planlamak için cron ifadesi
0 17 * * *
Şekil 22. Test planı yapılandırma.
Test paketleri ekle
Test planı tarafından programlanmasını istediğiniz test paketlerini eklemek için + Ekle test çalıştırması yapılandırmasını inceleyin. Ad açılır listesinden bir test paketi seçin ve Sonraki adım. Ardından, testi çalıştırmak istediğiniz cihazları seçin ve Add Configuration'ı (Yapılandırma Ekle) tıklayın. Her test için birden fazla yapılandırma ekleyebilirsiniz daha fazla bilgi edineceksiniz.
Şekil 23. Test çalıştırması yapılandırma.
Cihaz ekleme işlemleri
Her test çalıştırmasından önce yürütülmesini istediğiniz cihaz işlemlerini ekleyin. Daha fazla ayrıntı için Cihaz işlemleri ekleme başlıklı makaleye bakın.
Şekil 24. Cihaz işlemleri ekleniyor.
Test kaynaklarını ayarlama
Test planlarına test kaynakları eklemek, onları bireysel teste eklemekle aynıdır koşar. Daha fazla bilgi için Test kaynaklarını ayarlama bölümüne bakın.
Şekil 25. Test kaynaklarını ayarlama.
Test çalıştırmalarını göster
Test çalıştırma listesi
Test Çalıştırmaları sayfasındaki planlanmış test çalıştırmalarının listesini görüntüleyin. Test çalışmasıyla ilgili daha fazla ayrıntı görmek için Görüntüle'yi tıklayın.
Filtre çubuğuna bir dize girerek ve Enter tuşuna basarak da listeyi filtreleyebilirsiniz. Filtreleri birbirinden ayırarak birden çok filtre kullanabilirsiniz. virgül olabilir. Filtre, tam metni (alt dize içermeyen) içeren tüm satırları döndürür eşleme) herhangi bir sütunda (Durum ve Oluşturuldu hariç) görünür.
Boş bir filtre tüm satırları döndürür. Şu anda satırları filtrelemenin bir yolu yoktur kullanabilirsiniz.
Şekil 26. Test çalıştırması listesi.
Test çalıştırması ayrıntıları
Bir test çalıştırmasının durumu, günlükler ve sonuç.
Şekil 27. Test çalıştırması ayrıntıları.
Test çalıştırma durumu
Test çalıştırması ilerleme durumu, Durum bölümünde gösterilir. Konuyla ilgili bir indirme işleminin ilerleme durumu, iptal nedeni veya hata mesajı gibi burada da gösteriliyor.
28. Şekil. Test çalıştırması durumu.
Test çalıştırma durumları şunlardır:
- Beklemede: Gerekli kaynaklar indiriliyor.
- Kuyruğa alındı - Test, bir cihaz kullanılabilir olduğunda çalıştırılmaya hazırdır.
- Çalışıyor - Test, tahsis edilen bir cihazda çalışmaktadır.
- Tamamlandı: Test tamamlandı ve sonuçları raporlandı.
- İptal edildi: Test, kullanıcı tarafından iptal edilmiştir veya şunu yapmaya çalışırken zaman aşımına uğramıştır kullanılabilir cihazları bulabilir.
- Hata: Testin çalışmasını engelleyen bir hata oluştu.
Test çalıştırmasını iptal etme
Test çalıştırması tamamlanmadıysa İptal'i ve ardından ardından onay iletişim kutusunda Evet'i tıklayın. Test çalıştırmaları ayrıca daha uzun süre Sırada durumunda kalırsa otomatik olarak iptal edilir queue_timeout_seconds alanına ekleyin. Çalışıyor durumundayken test çalıştırmasını iptal etme birkaç dakika sürebilir.
29. Şekil. Test çalıştırmasını iptal etme
Test çalıştırması sonuçları
Test çalıştırması bittikten sonra, sonuçlar toplanır ve görüntülenir. Her çalıştırma için oku tıklayarak ek ayrıntıları görüntüleyebilirsiniz. Çıktıyı Görüntüle'yi tıklayın.
Files'ı kullanarak toplanan test yapılarını görebilirsiniz. Örneğin, test_result.xml
ve
test_result_failures.html
.
Şekil 30. Test çalıştırması sonuçları.
Canlı ana makine ve Tradefed günlüklerini Günlükler sekmesinde görüntüleyebilirsiniz.
Şekil 31. Günlükler sekmesi.
Modüllerin sonuçları Test Sonuçları sekmesinde yer alır.
Şekil 32. Test Sonuçları sekmesi.
Test kaynağı olarak kullanılan dosyaları Aç'ı tıklayarak indirebilirsiniz. Test Kaynakları sekmesi.
Şekil 33. Test Kaynakları sekmesi.
Test çalıştırmasının ayrıntılarını (ör. create_time) görmek için Yapılandırma sekmesine gidin.
Şekil 34. Config (Yapılandırma) sekmesini tıklayın.
İleri seviye özellikler
Yapılandırma dosyalarını yönet
OmniLab ATS, testler, derleme kanalları ve cihaz işlemleri gibi önceden tanımlanmış seçenekleri yüklemek için YAML ile yazılmış yapılandırma dosyalarını kullanır. Aşağıda örnek bir yapılandırma dosyası verilmiştir:
// example_file.yaml
tests:
- id : android.cts.9_0.arm
name: CTS 9.0 (ARM)
test_resource_defs:
- name: android-cts.zip
default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
test_resource_type: TEST_PACKAGE
command: cts
env_vars:
- name: TF_PATH
value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
- name: LD_LIBRARY_PATH
value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
setup_scripts:
output_file_patterns:
- android-cts/logs/latest/.*
- android-cts/results/latest/.*\.html
- android-cts/results/latest/compatibility_result\..*
- android-cts/results/latest/logo.png
- android-cts/results/latest/test_result.xml
result_file: test_result.xml
java_properties:
- name: CTS_ROOT
value: ${TF_WORK_DIR}
context_file_dir: android-cts/results/
context_file_pattern: '[\d_\.]+\.zip'
retry_command_line: retry --retry 0
runner_sharding_args: --shard-count ${TF_SHARD_COUNT}
build_channels:
- id: google_drive
name: Google Drive
provider_name: Google Drive
device_actions:
- id: flash
name: Flash
test_resource_defs:
- name: bootloader.img
test_resource_type: DEVICE_IMAGE
- name: radio.img
test_resource_type: DEVICE_IMAGE
- name: img.zip
test_resource_type: DEVICE_IMAGE
tradefed_target_preparers:
- class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
option_values:
- name: work-dir
values:
- ${TF_WORK_DIR}
- name: host-setup-command
values:
- adb -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL flash bootloader bootloader.img
- fastboot -s $SERIAL flash radio radio.img
- fastboot -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL -w update img.zip
- adb -s $SERIAL wait-for-device
- name: host-cmd-timeout
values:
- 10m
OmniLab ATS örneğinizi oluşturduğunuzda yapılandırmanızı diğer kullanıcılara gönderebilirsiniz. Bunu yapmak için Ayarlar sayfasına gidin ve sağ üstteki Dışa aktar'ı tıklayın.
35. Şekil. Yapılandırma dosyası yönetimi.
Yapılandırma dosyanız indirildikten sonra dosyayı diğer kullanıcılarla paylaşın. Bunun için yapılandırma dosyasını OmniLab ATS örneğine eklemek için İçe aktar'ı tıklayın ve yapılandırma dosyasını seçin.
Yeni cihaz işlemi oluşturma
Cihaz işlemleri, cihaz kurulum sürecini otomatikleştirmek için kullanılır. İşlemler testin çalıştırıldığı her cihazda çalıştırılan komut dosyalarıdır. ve yeniden denemelerden önceki kısımlar dahil. Kullanılabilir cihaz işlemlerinin listesini görüntülemek için şuraya gidin: Ayarlar sayfasına gidin ve Cihaz İşlemleri sekmesini tıklayın. Çeşitli cihaz işlemleri, yeniden başlatma ve yanıp sönme gibi önceden yapılandırılmıştır.
Şekil 36. Cihaz İşlemleri sekmesi.
Yeni cihaz işlemi ekleme
Yeni cihaz işlemi'ni tıklayın.
37 Şekil. Yeni cihaz işlem düğmesi.
Ad ve açıklama girin.
38. Şekil. Cihaz işleminin adı.
Hedef Hazırlayıcı Ekle'yi tıklayın.
Ticaret Federasyonu Hedefini girin Hazırlayıcının tam sınıf adı, örneğin,
com.android.tradefed.targetprep.RunHostCommandTargetPreparer
.39. Şekil. Hedef hazırlayıcı ekleniyor.
Kullanılabilir hedef hazırlayıcıların listesini com.android.tradefed.targetprep referansında bulabilirsiniz.
Şekil 40. Hedef Hazırlayıcı listesi.
Hedef hazırlayıcıyla kullanılacak seçenekleri ekleyin. Mevcut seçenekleri görmek için: kontrol etmek targetprep kodunu ekleyin:
Şekil 41. İşlem seçeneği örneği.
Bir seçenek eklemek için Add Target Preparer Option'ı (Hedef Hazırlayıcı Seçeneği Ekle) tıklayın ve değerleridir.
Şekil 42. İşlem komutu örneği.
Cihaz işlemini yürütmek için gereken test kaynaklarını (ör. önyükleme için resim oluşturma) tanımlayın. Kaynak tanımı eklemek için Test Kaynağı ekleyin ve zorunlu alanları doldurun. Dosyalarınızın nerede olduğunu biliyorsanız göz at'ı tıklayarak varsayılan bir indirme URL'si sağlayabilirsiniz. Hedef hazırlayanlar, dizini test kaynağı olarak kabul ederse Sıkıştırmayı aç'ı seçin. Daha sonra, göreli Destination dizinini belirtin. altındaki Dosya Adları'na sıkıştırılmış. Herhangi bir dosya adı sağlanmazsa, test kaynağı.
Şekil 43. İşlem testi kaynakları.
Güncelle'yi tıklayın.
Şekil 44. İşlemin kaydettiği değişiklikler.
Testleri yönetin
Testi düzenleme
Kayıtlı bir testi düzenlemek için Testler sayfasına gidin ve test edin. Test yapılandırmasını değiştirdikten sonra, Güncelle
45.şekilde Testi düzenleme
Yeni test ekle
Yeni bir test eklemek için Testler sayfasına gidin ve Yeni Test Oluştur'u tıklayın. Girin ilgili bilgileri girin ve Oluştur'u tıklayın.
Şekil 46. Test oluşturma.
47.Şekil Test kopyalanıyor.
Ana makine yapılandırmalarını dışa aktarma
Bir ana makineyi yapılandırdıktan sonra ana makinenin yapılandırmalarını bir dosyaya aktarabilirsiniz. Kayıtlı yapılandırmaları kopyalamak için bu dosyayı diğer ana makinelere yükleyebilirsiniz.
Bir ana makinenin yapılandırmalarını dışa aktarmak için Ayarlar sayfasına gidip sağ üst köşedeki Dışa aktar'ı tıklayın.
48. Şekil. Ana makine yapılandırmasını dışa aktarma.
Bir ana makine yapılandırma dosyasını içe aktarmak için Ayarlar sayfasına gidin ve İçe aktar'ı tıklayın.
Şekil 49. Ana makine yapılandırmasını içe aktarma.
Yerel dosyaları ve dizinleri kullanın
R11 sürümünden itibaren $HOME/.ats_storage
dizinindeki dosyalar
OmniLab ATS üzerinden otomatik olarak erişilebilir. İlgili klasöre bir dosya kopyalayın veya taşıyın
seçebilirsiniz. Bunu, dosyayı planlarken Local File (Yerel Dosya) sekmesinden
test çalıştırması yapabilirsiniz.
cp /path/to/file $HOME/.ats_storage
50.şekilde: $HOME/.ats_storage
dizininden bir dosya seçin.
Yerel dosya deposuna daha fazla dizin eklemek için
--mount_local_path
işareti.
mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2
Şekil 51. Yerel dosya deposuna eklenen ek dizinler.
Çoklu ana makine modunu etkinleştir
Çoklu ana makine modunda, kullanıcılar tek bir ATS denetleyici ana makinesiyle şunları yönetebilir: cihazlar ve testler için geçerlidir.
Şekil 52. Çoklu ana makine modu mimarisi.
ATS denetleyicisini başlatmak için aşağıdaki komutu kullanın:
mtt start --operation_mode=ON_PREMISE
Kontrol kumandasına
http://${CONTROLLER_HOSTNAME}:8000
adresinden erişilebilir.Çalışanları başlatmak için aşağıdaki komutu kullanın:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
Ağınız, ana makinelerin birbiriyle iletişim kurmasına izin vermiyorsa aşağıdaki daha gelişmiş kurulum talimatlarını uygulamanız gerekir: ATS çalışanı üzerinde.
SSH tünellerini kullanarak iki ana makineyi birbirine bağlayın. Şu bağlantı için bağlantı noktası seçin: bağlantı noktaları hakkında daha fazla bilgi edinin. Örneğin, 9000 ve 9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
ATS'yi yapılandırın ve başlatın.
DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \ --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \ --operation_mode=ON_PREMISE
Dosya temizleyici
Dosya temizleyici, e-tablonuza göre dosyaları temizlemek için saatlik kullanıcı tanımlı yapılandırmalar var. ATS'nin testi arşivlemek için iki varsayılan yapılandırması vardır sonuçları çalıştırıp geçici dosyaları silebilirsiniz. Bu kılavuzda, DMAIC ve Yalın Altı Sigma yaklaşımının politikaları ve yapılandırmayı inceleyin.
Politikalar
Politika, dosyalar veya dizinler üzerinde gerçekleştirilecek işlemi tanımlar. ölçütleri nasıl belirleyeceğinizi öğrendiniz. Kullanılabilir işlemler tabloda gösterilir:
İşlem türü | Parametreler |
---|---|
ARCHIVE | remove_file : true ise dosyayı arşivledikten sonra kaldırın. |
DELETE |
Kriterler, dosya özelliklerine ve sistem bilgilerine dayanır. Uygun aşağıdaki ölçütler tabloda gösterilir:
Ölçüt türü | Açıklama | Parametreler |
---|---|---|
LAST_MODIFIED_TIME | Dosyaları son değişiklik tarih ve saatine göre filtreleyin. | ttl : 10m , 2h , 7 days , 4w gibi çeşitli zaman ifadeleri desteklenir. Desteklenen biçimler için pytimeparse bölümüne bakın. |
LAST_ACCESS_TIME | Dosyaları son erişim tarihlerine ve saatlerine göre filtreleyin. | LAST_MODIFIED_TIME ile aynı. |
NAME_MATCH | Normal ifade kullanarak dosyaları adlarına göre filtreleyin. | pattern : Normal ifade (ör. sonuç ZIP dosyalarıyla eşleştirmek için [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip ). |
SYSTEM_AVAILABLE_SPACE | Sistemdeki kullanılabilir alana göre işlemleri tetikleyin. | threshold : Kullanılabilir alan eşiğin altına düştüğünde işlemi tetikleyin. Örneğin, 200 (B), 200KB , 200MB , 200GB , 2TB . |
Şekil 53. Yeni bir dosya temizleyici politikası ekleyin.
Yapılandırmalar
Yapılandırma, bir veya daha fazla politikayı belirli dizinlerle birleştirir. Dosyalar ve belirtilen dizinlerdeki dizinler, tanımlanmış politikalar. Politikalar, yapılandırmada göründükleri sırayla uygulanır.
Tüm hedef dizinler, /data
dizininin altında olmalıdır. Eğer
config, hedef dizini logs
olarak belirtiyorsa, şu şekilde yorumlanır:
/data/logs
.
Şekil 54. Dosya temizleyici yapılandırmasını düzenleyin.
Sıfırla
Ayarları Sıfırla'yı tıkladığınızda dosya temizleyici yapılandırması, eski haline döner. varsayılan duruma getirin. Bu işlem TÜM özel öğeleri temizler.
55. Şekil. Dosya temizleyici ayarlarını sıfırlayın.
Destek
Hata raporları
OmniLab ATS'ye yaptığınız katkı, aracın iyileştirilmesine yardımcı olur. görüşlerinizi öğrenmek istiyoruz! Bkz. OmniLab ATS sürüm notları ziyaret edin. Hataları bildirmek veya öneride bulunmak için hata raporu gönderin. İş ortakları, hataları veya önerileri iş ortağı kanallarını kullanarak bildirmelidir.