OmniLab Android टेस्ट स्टेशन

OmniLab ATS एक टेस्टिंग टूल है. इसका इस्तेमाल Android डेवलपर और टेस्ट इंजीनियर, स्टैंडर्ड Android टेस्ट सुइट चलाने के लिए यूज़र इंटरफ़ेस का इस्तेमाल करने के लिए कर सकते हैं. जैसे, Android Compatibility Test Suite (CTS). यह टूल, ट्रेड फ़ेडरेशन (टीएफ़) और Google Mobly जैसे अलग-अलग टेस्ट फ़्रेमवर्क के लिए वेब इंटरफ़ेस के तौर पर काम करता है. इसकी मदद से, टेस्ट डिवाइसों के सेट पर सीटीएस और मल्टी-डिवाइस टेस्ट चलाए जा सकते हैं. इसके लिए, आपको ज़्यादा सेटअप करने की ज़रूरत नहीं पड़ती. साथ ही, टेस्ट को लगातार चलाने के लिए शेड्यूल भी सेट किया जा सकता है.

OmniLab ATS 2.0 के बारे में जानकारी

OmniLab ATS 2.0, जांच करने के लिए इस्तेमाल होने वाले बुनियादी इंफ़्रास्ट्रक्चर को Trade Federation से OmniLab पर माइग्रेट करता है. इस बदलाव से, ज़्यादा बेहतर और असरदार बैकएंड मिलता है. साथ ही, OmniLab ATS 1.0 का यूज़र इंटरफ़ेस और वर्कफ़्लो पहले जैसा ही रहता है.

OmniLab ATS 2.0 के मुख्य फ़ायदे:

  • आधुनिक इन्फ़्रास्ट्रक्चर: यह OmniLab प्लैटफ़ॉर्म का इस्तेमाल करता है, ताकि स्थिरता और परफ़ॉर्मेंस को बेहतर बनाया जा सके.
  • आसान ट्रांज़िशन: वेब यूज़र इंटरफ़ेस (यूआई) या टेस्ट चलाने के मुख्य वर्कफ़्लो में कोई बदलाव नहीं किया गया है.
  • भविष्य की तैयारी: यह Google के यूनिफ़ाइड टेस्टिंग इन्फ़्रास्ट्रक्चर के साथ काम करता है. इससे नई सुविधाओं को तेज़ी से अपनाया जा सकता है.

OmniLab ATS 2.0 में नई सुविधाएं शामिल हैं. जैसे, टेस्ट प्लान को एक साथ अपडेट करना, डिवाइस को बेहतर तरीके से असाइन करना वगैरह. इसमें और भी सुविधाएं जोड़ी जाएंगी. अपडेट के लिए, प्रॉडक्ट की जानकारी देखें.

OmniLab ATS 2.0 पर अपग्रेड करना:

OmniLab ATS 2.0 का इस्तेमाल करने के लिए, आपको अपने स्टेशन को बिल्ड R52 या इसके बाद के वर्शन पर अपग्रेड करना होगा. नए Omnilab ATS 2.0 पर स्विच करने के लिए, --force_ats_version 2 फ़्लैग का इस्तेमाल करें. साथ ही, नए बिल्ड पर अपग्रेड करने के लिए, --force_update फ़्लैग के साथ mtt start कमांड का इस्तेमाल करें:

mtt start --force_ats_version 2 --force_update

माइग्रेशन के दौरान, हमारा सुझाव है कि आप dogfood टैग का इस्तेमाल करें. इससे आपको OmniLab ATS 2.0 की सुविधाओं के साथ, सबसे नए स्टेबल बिल्ड को ऐक्सेस करने में मदद मिलेगी:

mtt start --force_ats_version 2 --tag dogfood --force_update

हम 2026 की तीसरी तिमाही में, OmniLab ATS 2.0 को डिफ़ॉल्ट वर्शन बनाने का प्लान कर रहे हैं. हमारा प्लान है कि 2026 के आखिर तक OmniLab ATS 1.0 को बंद कर दिया जाए.

खास अपडेट, पहले से मौजूद अंतर, और अपग्रेड करने से जुड़े दिशा-निर्देशों के बारे में ज़्यादा जानने के लिए, OmniLab ATS 2.0 को अपग्रेड करने से जुड़ी गाइड देखें.

OmniLab ATS सेट अप करना

इस सेक्शन में, OmniLab ATS को इंस्टॉल और सेट अप करने का तरीका बताया गया है.

OmniLab ATS, इन जगहों से सोर्स कोड का इस्तेमाल करता है:

OmniLab ATS इंस्टॉल करना

आपको जो टेस्ट सुइट चलाने हैं उनके लिए हार्डवेयर और सॉफ़्टवेयर से जुड़ी ज़रूरी शर्तों को पूरा करें.

सीटीएस की ज़रूरी शर्तें, source.android.com पर दी गई हैं.

OmniLab ATS के लिए, किसी अन्य हार्डवेयर की ज़रूरत नहीं होती. हालांकि, हमारा सुझाव है कि शुरुआत करने के लिए, सीटीएस होस्ट की ज़रूरी शर्तों का इस्तेमाल करें.

OmniLab ATS को इंस्टॉल करने के दो तरीके हैं:

इंस्टॉलर प्रोग्राम की मदद से इंस्टॉल करना

इंस्टॉलर प्रोग्राम, Ubuntu 22.04 और इसके बाद के वर्शन पर काम करता है. इंस्टॉलर, OmniLab ATS को चलाने के लिए ज़रूरी सभी प्रोग्राम और संसाधनों को इंस्टॉल और कॉन्फ़िगर करता है.

इंस्टॉल प्रोग्राम का इस्तेमाल करने के लिए:

  1. इंस्टॉलर प्रोग्राम चलाएं:

    curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
    
  2. OmniLab ATS CLI के इंस्टॉल किए गए वर्शन की जांच करने के लिए, mtt version चलाएं.

मैन्युअल तरीके से इंस्टॉल करना

Docker इंस्टॉल करना
  1. अपनी Linux मशीन पर Docker Community Edition (CE) इंस्टॉल करने के लिए दिए गए निर्देशों का पालन करें.

  2. Docker को नॉन-रूट उपयोगकर्ता के तौर पर मैनेज करने के लिए, इंस्टॉल करने के बाद के चरणों को पूरा करें.

  3. अनुमति में किए गए बदलावों को लागू करने के लिए, आपको टर्मिनल विंडो को रीस्टार्ट करना पड़ सकता है या साइन आउट करके फिर से साइन इन करना पड़ सकता है.

Python 3 इंस्टॉल करना

OmniLab ATS CLI के लिए, Ubuntu 22.04 या इसके बाद का वर्शन होना ज़रूरी है. सीएलआई की पुष्टि, Python के 3.10 से 3.13 वर्शन के हिसाब से की जाती है.

Python 3 इंस्टॉल करने के लिए, ये कमांड चलाएं:

sudo apt-get update
sudo apt install python3 python3-distutils

अगर आपको Python 3 का ऐसा वर्शन चाहिए जो आपके स्टैंडर्ड डिस्ट्रिब्यूशन में शामिल नहीं है, तो पहले Python 3 के लिए रिपॉज़िटरी जोड़ें. इसके लिए, इनमें से कोई एक तरीका अपनाएं:

  • इस निर्देश को चलाएं:

    sudo add-apt-repository ppa:deadsnakes/ppa
    
  • सोर्स से रिपॉज़िटरी बनाएं और इंस्टॉल करें.

Python 3 का कोई खास वर्शन (उदाहरण के लिए, 3.10) इंस्टॉल करने के लिए, ये कमांड चलाएं:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

OmniLab ATS सीएलआई डाउनलोड करना

कमांड लाइन इंटरफ़ेस (सीएलआई) पैकेज को यहां से डाउनलोड करें.

OmniLab ATS शुरू करें

इस कमांड की मदद से, OmniLab ATS को चालू करें:

mtt start

यूज़र इंटरफ़ेस (यूआई) को पहली बार शुरू करने पर, उसे दिखने में कुछ मिनट लग सकते हैं. सीएलआई, ब्राउज़र में यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने के लिए एक वेब यूआरएल दिखाता है. डिफ़ॉल्ट रूप से, वेब यूआरएल localhost:8000 होता है. ज़रूरत पड़ने पर, स्टार्टअप के समय डिफ़ॉल्ट पोर्ट को --port फ़्लैग की मदद से बदला जा सकता है.

अगर कोई नया वर्शन उपलब्ध है, तो मौजूदा वर्शन पर अपडेट किया जा सकता है. नई रिलीज़ के लिए, रिलीज़ नोट देखे जा सकते हैं.

मौजूदा वर्शन पर अपडेट करने के लिए, यह कमांड चलाएं:

mtt start --force_update

ऐप्लिकेशन को बंद करने के लिए, यह चलाएं:

mtt stop

अन्य निर्देशों की सूची देखने के लिए, इनका इस्तेमाल करें:

mtt --help

डेटाबेस का बैक अप लेना और उसे वापस लाना

OmniLab ATS डेटाबेस का बैक अप लेने के लिए, ऐप्लिकेशन को बंद करें और यह कमांड चलाएं. इससे मौजूदा डेटाबेस का बैक अप, आपकी होम डायरेक्ट्री में mtt-backup.tar नाम की TAR फ़ाइल में ले लिया जाता है:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

ऐप्लिकेशन को वापस लाने के लिए, उसे शुरू करने से पहले यह कमांड चलाएं:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

सेटअप विज़ार्ड

OmniLab ATS को पहली बार इंस्टॉल करने और चलाने के बाद, सेटअप विज़र्ड आपको कुछ चरणों के बारे में बताता है. इनकी मदद से, अपने एनवायरमेंट के हिसाब से टूल को पसंद के मुताबिक बनाया जा सकता है. यहां किए गए किसी भी बदलाव को, सेटिंग पेज पर जाकर बाद में फिर से कॉन्फ़िगर किया जा सकता है.

कॉन्फ़िगरेशन का बैकअप वापस लाना

अगर आपके पास किसी दूसरे OmniLab एटीएस होस्ट से बैक अप ली गई कॉन्फ़िगरेशन फ़ाइल है, तो उस फ़ाइल को अपलोड करके, उस होस्ट से किए गए किसी भी कॉन्फ़िगरेशन को कॉपी किया जा सकता है. इसके लिए, फ़ाइल अपलोड करें बटन पर क्लिक करें.

कॉन्फ़िगरेशन का बैकअप वापस लाना

पहली इमेज. कॉन्फ़िगरेशन का बैकअप वापस लाना.

डिफ़ॉल्ट सेवा खाता सेट करना

आपके पास एक ऐसा सेवा खाता सेट करने का विकल्प होता है जिसका इस्तेमाल OmniLab ATS, आपके संसाधनों को ऐक्सेस करते समय डिफ़ॉल्ट रूप से करता है. जैसे, Google Cloud Storage, Google Drive. अपने सेवा खाते की पुष्टि करने के लिए, सेवा खाते की कुंजी अपलोड करें पर क्लिक करें. इसके बाद, अपने सेवा खाते की JSON कुंजी फ़ाइल चुनें.

सेवा खाता सेट करना

दूसरी इमेज. सेवा खाते को सेट अप करना.

सेवा खाते की पुष्टि हो जाने के बाद, खाते का ईमेल पता पेज के सबसे ऊपर दाएं कोने में दिखता है. सेवा खाते को बदलने के लिए, खाते के नाम पर क्लिक करें. इसके बाद, मौजूदा डिफ़ॉल्ट खाते को हटाएं और नए सेवा खाते की कुंजी अपलोड करें.

सेवा खाता बदलना

तीसरी इमेज. सेवा खाते को बदलना.

कॉन्फ़िगरेशन सेट इंपोर्ट करना

कॉन्फ़िगरेशन सेट, टेस्ट सुइट चलाने के लिए कॉन्फ़िगरेशन का एक बंडल होता है. इसमें डिवाइस से जुड़ी कार्रवाइयां और बिल्ड चैनल शामिल होते हैं. कॉन्फ़िगरेशन सेट, Google Cloud Storage (GCS) के किसी खास बकेट में होस्ट किए जाते हैं. अपने Google खाते से GCS बिल्ड चैनल की पुष्टि करने के बाद, आपको उन सभी कॉन्फ़िगरेशन सेट की सूची दिखेगी जो आपके लिए उपलब्ध हैं.

अपने टेस्ट स्टेशन होस्ट में जोड़ने के लिए, कोई भी कॉन्फ़िगरेशन सेट चुनें. इसके बाद, चुने गए कॉन्फ़िगरेशन सेट इंपोर्ट करें पर क्लिक करें.

कॉन्फ़िगरेशन सेट इंपोर्ट करना

चौथी इमेज. कॉन्फ़िगरेशन सेट इंपोर्ट करना.

वाई-फ़ाई की सेटिंग शामिल करें

कुछ सीटीएस टेस्ट के लिए, आपके डिवाइस को वाई-फ़ाई हॉटस्पॉट से कनेक्ट करना ज़रूरी है. अपना वाई-फ़ाई नेटवर्क चुनने के लिए, वाई-फ़ाई एसएसआईडी और वाई-फ़ाई पीएसके डालें. हालांकि, वाई-फ़ाई पीएसके डालना ज़रूरी नहीं है.

वाई-फ़ाई की सेटिंग

पांचवीं इमेज. वाई-फ़ाई हॉटस्पॉट की सेटिंग.

सेटअप विज़र्ड पूरा करने के बाद, पेज नई सेटिंग के साथ फिर से लोड होता है.

कोई डिवाइस कनेक्ट करें

किसी डिवाइस को टेस्ट करने के लिए, यूएसबी डीबगिंग की सुविधा चालू होनी चाहिए. डीबग करने की सुविधा चालू करने के लिए:

  1. डेवलपर के लिए सेटिंग और टूल और डीबग करने की सुविधा चालू करें में दिए गए निर्देशों का पालन करें.

  2. अगर आपको कस्टम एडीबी कुंजियों के साथ पहले से लोड किए गए टेस्ट Android बिल्ड इस्तेमाल करने हैं, तो कस्टम .adb_key फ़ाइलों को ~/.android/ डायरेक्ट्री में डालें.

    फ़ाइलें अपने-आप लोड हो जाती हैं और एडीबी को पास कर दी जाती हैं. इससे, उन बिल्ड पर चलने वाले डिवाइसों को फ़्लैश करने के बाद, यूएसबी डीबगिंग की सुविधा अपने-आप चालू हो जाती है.

  3. यूएसबी का इस्तेमाल करके, डिवाइस को होस्ट मशीन से कनेक्ट करें.

    वेब इंटरफ़ेस को रीफ़्रेश करने के एक मिनट के अंदर, डिवाइस OmniLab ATS के Devices टैब में दिखने लगता है. इस टैब पर, डिवाइसों की स्थिति भी देखी जा सकती है.

    कोई डिवाइस कनेक्ट करना

    छठी इमेज. डिवाइस कनेक्ट करना.

डिवाइस की अलग-अलग स्थितियां ये हैं:

  • उपलब्ध है - डिवाइस कनेक्ट है और टेस्ट के लिए तैयार है.
  • ऐलोकेट किया गया - डिवाइस कनेक्ट है और टेस्ट चल रहा है. हर डिवाइस पर एक बार में सिर्फ़ एक टेस्ट चलाया जा सकता है. इसलिए, नया टेस्ट चलाने से पहले, डिवाइस पर चल रहे मौजूदा टेस्ट को पूरा करना ज़रूरी है.

परीक्षण चलाना

कोई टेस्ट चुनें

OmniLab ATS में, पहले से बंडल किए गए सीटीएस कॉन्फ़िगरेशन का एक सेट होता है. इनमें से कोई टेस्ट चलाने के लिए, टेस्ट सुइट टैब पर जाएं. इसके बाद, चुने गए टेस्ट के लिए, टेस्ट चलाएं पर क्लिक करें.

कोई टेस्ट चुनें

सातवीं इमेज. कोई टेस्ट चुनना.

टेस्ट में बदलाव करने या नए टेस्ट जोड़ने के लिए, टेस्ट जोड़ना देखें.

टेस्ट रन को कॉन्फ़िगर करना

इस टेस्ट रन के लिए इस्तेमाल किए जाने वाले पैरामीटर में बदलाव करें. ज़्यादातर पैरामीटर, चुनी गई टेस्ट कॉन्फ़िगरेशन में तय की गई वैल्यू से पहले से भरे होते हैं.

इस चरण को डिफ़ॉल्ट वैल्यू का इस्तेमाल करके पूरा किया जा सकता है. हालांकि, अपनी ज़रूरत के हिसाब से किसी भी पैरामीटर को बदला जा सकता है. जैसे, फिर से कोशिश करने की ज़्यादा से ज़्यादा संख्या और कमांड.

टेस्ट रन को कॉन्फ़िगर करें

आठवीं इमेज. टेस्ट रन को कॉन्फ़िगर करना.

टेस्ट रन के पैरामीटर ये हैं:

  • Name - उस टेस्ट सुइट का नाम जिसे आपको चलाना है.
  • रन काउंट - शेड्यूल किए जाने पर, इस टेस्ट रन को कितनी बार चलाया जाना चाहिए. टेस्ट रन को शेड्यूल करने के लिए, Trade Federation का इस्तेमाल किया जाता है. यह एक साथ 20 टेस्ट रन चला सकता है. हालांकि, इसके लिए ज़रूरी है कि डिवाइस में इतनी क्षमता हो.
  • Max Retry - अगर कम से कम एक टेस्ट फ़ेल हो जाता है, तो टेस्ट रन को फिर से चलाने की ज़्यादा से ज़्यादा संख्या. आम तौर पर, इसे चार से छह बार फिर से कोशिश करने के लिए सेट किया जाता है, ताकि सीटीएस को पूरी तरह से चलाया जा सके और फ़्लेकी टेस्ट को हैंडल किया जा सके.
  • सूची में होने की समयसीमा खत्म होना - अगर कोई टेस्ट रन, सूची में है स्थिति में बहुत ज़्यादा समय तक रहता है, तो वह अपने-आप रद्द हो जाता है. यहां वह समय डालें जिसके बाद, रद्द करने की प्रोसेस शुरू हो. डिफ़ॉल्ट रूप से, यह रिपोर्ट हर 24 घंटे में अपलोड की जाती है.
  • कमांड - टेस्ट सुइट को चलाने के लिए कमांड. यहां कमांड लाइन के अन्य आर्ग्युमेंट डाले जा सकते हैं. उदाहरण के लिए, CTS 8.1 में किसी खास मॉड्यूल को चलाने के लिए, यह कमांड इस्तेमाल करें:

    cts-suite -m ShortModuleName
    
  • Retry Command - टेस्ट सुइट को फिर से चलाने के लिए कमांड. यहां कमांड लाइन के अतिरिक्त आर्ग्युमेंट जोड़े जा सकते हैं. उदाहरण के लिए, सीटीएस 8.1 में सिर्फ़ किसी खास मॉड्यूल को फिर से आज़माने के लिए, इसका इस्तेमाल करें:

    cts --retry 0 -m ShortModuleName
    

    फिर से कोशिश करने के लिए इस्तेमाल किए जाने वाले आर्ग्युमेंट, शुरुआती निर्देश के साथ उपलब्ध आर्ग्युमेंट से अलग हो सकते हैं. इसलिए, चुने गए टेस्ट सुइट के लिए, आधिकारिक साइट पर जाकर देखें कि कौनसे पैरामीटर इस्तेमाल किए जा सकते हैं.

  • पिछला टेस्ट रन - अगर आपको पिछले टेस्ट रन को फिर से चलाना है, तो:

    • लोकल - अगर रन को मौजूदा होस्ट पर शुरू किया गया था, तो टेस्ट रन की जानकारी देखते समय दिखने वाला टेस्ट रन आईडी डालें.

      लोकल लेवल पर पहले किया गया टेस्ट रन

      नौवीं इमेज. लोकल लेवल पर पहले की गई जांच.

    • रिमोट - अगर रन को किसी दूसरे होस्ट पर शुरू किया गया था, तो रिमोट को चुनकर, टेस्ट के नतीजों की फ़ाइल अपलोड करें. इसके बाद, टेस्ट के नतीजों की फ़ाइल अपलोड करें पर क्लिक करें और अपने लोकल स्टोरेज से कोई फ़ाइल चुनें.

      पिछला टेस्ट रन हटाएं

      दसवीं इमेज. पिछले टेस्ट रन को हटाएं.

डिवाइस चुनें

टेस्ट सुइट चलाने के लिए, डिवाइसों को चुनने के लिए चेकबॉक्स पर क्लिक करें. शार्ड की संख्या, चुने गए डिवाइसों की संख्या के हिसाब से अपने-आप बदल जानी चाहिए.

डिवाइस चुनना

11वीं इमेज. डिवाइसों को चुनना.

डिवाइस के सीरियल नंबर के अलावा, अन्य एट्रिब्यूट के हिसाब से डिवाइसों को चुनने के लिए, "डिवाइस की खास जानकारी" को मैन्युअल तरीके से डाला जा सकता है. उदाहरण के लिए, ऐसे तीन डिवाइस चुनने के लिए जिनके प्रॉडक्ट का नाम "bramble" है, यह डालें:

product:bramble;product:bramble;product:bramble

इन एट्रिब्यूट का इस्तेमाल किया जा सकता है:

  • build_id
  • device_serial
  • device_type
  • होस्टनाम
  • प्रॉडक्ट
  • प्रॉडक्ट का वैरिएंट
  • sim_state

टेस्ट रन को पूरा करने के लिए, चुने गए सभी डिवाइसों की स्थिति उपलब्ध होनी चाहिए. साथ ही, टेस्ट रन पूरा होने पर, वे सभी डिवाइस ऐलोकेट किए गए स्थिति में स्विच हो जाते हैं. टेस्ट रन सूची में है स्टेटस में तब होता है, जब वह डिवाइसों के उपलब्ध होने का इंतज़ार कर रहा होता है.

डिवाइस की कार्रवाइयां जोड़ना

डिवाइस ऐक्शन ऐसी स्क्रिप्ट होती हैं जिन्हें हर टेस्ट रन से पहले चलाया जा सकता है. डिवाइस पर की जाने वाली कुछ कार्रवाइयां पहले से कॉन्फ़िगर की गई होती हैं. जैसे, फ़्लैश करना और रीबूट करना. डिवाइस से जुड़ी नई कार्रवाइयाँ बनाने के लिए, डिवाइस से जुड़ी नई कार्रवाई बनाना देखें.

डिवाइस कार्रवाइयां

इमेज 12. डिवाइस से जुड़ी कार्रवाइयां.

टेस्ट रन में डिवाइस की कोई कार्रवाई जोड़ने के लिए, नई कार्रवाई जोड़ें पर क्लिक करें. इसके बाद, जो कार्रवाइयां जोड़नी हैं उनके चेकबॉक्स चुनें और कार्रवाइयां जोड़ें पर क्लिक करें. डिवाइस पर कार्रवाइयां एक-एक करके की जाती हैं. कार्रवाइयों को खींचकर और छोड़कर, उनके क्रम को बदला जा सकता है.

कार्रवाइयां जोड़ें

13वीं इमेज. कार्रवाइयों का क्रम बदला जा रहा है.

टेस्ट के लिए संसाधन सेट करना

टेस्ट रिसॉर्स ऐसी फ़ाइलें होती हैं जो टेस्ट रन को पूरा करने के लिए ज़रूरी होती हैं. उदाहरण के लिए, सीटीएस चलाने के लिए android-cts*.zip फ़ाइल की ज़रूरत होती है. साथ ही, किसी डिवाइस को फ़्लैश करने के लिए, आपको बिल्ड इमेज देनी होगी.

टेस्ट सुइट की ZIP फ़ाइल का डाउनलोड यूआरएल, डिफ़ॉल्ट रूप से पार्टनर को दिए गए Google Drive के लिंक पर सेट होना चाहिए. ब्राउज़ करें पर क्लिक करके, कोई दूसरी फ़ाइल चुनी जा सकती है. पॉप-अप विंडो में, फ़ाइल डाउनलोड करने का लिंक डाला जा सकता है. इसके अलावा, पुष्टि किए गए बिल्ड चैनल से किसी फ़ाइल का इस्तेमाल किया जा सकता है या लोकल स्टोरेज से इस्तेमाल करने के लिए कोई फ़ाइल अपलोड की जा सकती है.

टेस्ट से जुड़े संसाधन

इमेज 14. टेस्ट के लिए संसाधन.

वेब यूआरएल की मदद से टेस्ट रिसॉर्स चुनने के लिए, पॉप-अप विंडो नीचे दी गई है. डाउनलोड यूआरएल लिंक डालें और चुने गए विकल्प की पुष्टि करने के लिए, चुनें बटन पर क्लिक करें.

Test Resource Selector - Web URL

15वीं इमेज. टेस्ट रिसॉर्स सिलेक्टर - वेब यूआरएल.

अगर आपने Google Drive, Google Cloud Storage (GCS) या अन्य चैनलों पर संसाधन अपलोड किए हैं, तो उस चैनल के टैब पर जाकर भी संसाधन चुने जा सकते हैं. यहां Google Drive से कोई संसाधन चुनने का उदाहरण दिया गया है.

टेस्ट रिसॉर्स सिलेक्टर - Google Drive

16वीं इमेज. टेस्ट रिसॉर्स सिलेक्टर - Google Drive.

फ़ाइलें चुनने के अलावा, फ़ाइल नाम फ़ील्ड में वाइल्डकार्ड वर्ण भी इस्तेमाल किए जा सकते हैं. दस्तावेज़ यहां देखे जा सकते हैं.

Test Resource Selector - Wildcard Pattern Support

17वीं इमेज. टेस्ट रिसॉर्स सिलेक्टर - वाइल्डकार्ड पैटर्न के लिए सहायता.

OmniLab ATS के लोकल फ़ाइल स्टोरेज से भी कोई फ़ाइल चुनी जा सकती है. इस स्टोरेज में फ़ाइलें अपलोड की जा सकती हैं या सीधे तौर पर लोकल फ़ाइलों और डायरेक्ट्री का इस्तेमाल किया जा सकता है.

टेस्ट रिसॉर्स सिलेक्टर - लोकल फ़ाइल स्टोर

18वीं इमेज. टेस्ट रिसॉर्स सिलेक्टर - लोकल फ़ाइल स्टोर.

फिर से चलाने के कॉन्फ़िगरेशन जोड़ना

प्राइमरी रन पूरा होने और उसके नतीजे लोड होने के बाद, फिर से रन होने वाले टेस्ट शेड्यूल किए जा सकते हैं. हालांकि, इसके लिए अलग डिवाइस, कार्रवाइयां या संसाधनों का इस्तेमाल किया जा सकता है.

फिर से चलाने के कॉन्फ़िगरेशन जोड़ें

19वीं इमेज. फिर से चलाने के कॉन्फ़िगरेशन जोड़े जा रहे हैं.

टेस्ट रन की सुविधा चालू करें

टेस्ट रन के लिए ज़रूरी जानकारी डालने के बाद, टेस्ट रन शुरू करें पर क्लिक करें. अगर सारी जानकारी मान्य है, तो टेस्ट रन शुरू हो जाता है. इसके बाद, आपको टेस्ट रन की जानकारी और प्रोग्रेस देखने के लिए, एक पेज पर रीडायरेक्ट कर दिया जाता है.

टेस्ट रन शुरू करें

20वीं इमेज. टेस्ट रन की सुविधा चालू करना.

टेस्ट प्लान बनाना

टेस्ट प्लान का इस्तेमाल, समय-समय पर टेस्ट रन बनाने के लिए किया जाता है. उदाहरण के लिए, हर दिन शाम 5 बजे सीटीएस 9.0 चलाना. नया टेस्ट प्लान बनाने के लिए, नया टेस्ट प्लान बनाएं पर क्लिक करें.

टेस्ट प्लान बनाना

इमेज 21. टेस्ट प्लान बनाना.

टेस्ट प्लान कॉन्फ़िगर करना

टेस्ट प्लान का नाम और वे लेबल डालें जिन्हें आपको जोड़ना है. इसके बाद, इस्तेमाल करने के लिए कोई शेड्यूल चुनें.

  • मैन्युअल - टेस्ट प्लान, टेस्ट रन सिर्फ़ तब बनाता है, जब कोई उपयोगकर्ता टेस्ट प्लान की सूची वाले पेज पर, टेस्ट प्लान चलाएं पर क्लिक करता है.
  • समय-समय पर - टेस्ट प्लान, चुने गए शेड्यूल के हिसाब से टेस्ट रन को अपने-आप शेड्यूल करता है. उदाहरण के लिए, हर दिन शाम 5:00 बजे टेस्ट रन शेड्यूल करना.
  • कस्टम - टेस्ट प्लान, डाले गए क्रॉन एक्सप्रेशन के आधार पर टेस्ट रन को अपने-आप शेड्यूल करता है. उदाहरण के लिए, हर दिन शाम 5:00 बजे टेस्ट रन शेड्यूल करने के लिए, क्रॉन एक्सप्रेशन 0 17 * * * है.

टेस्ट प्लान कॉन्फ़िगर करना

22वीं इमेज. टेस्ट प्लान कॉन्फ़िगर करना.

टेस्ट सुइट जोड़ना

टेस्ट प्लान के हिसाब से शेड्यूल किए जाने वाले टेस्ट सुइट जोड़ें. इसके लिए, + टेस्ट रन कॉन्फ़िगरेशन जोड़ें पर क्लिक करें. नाम ड्रॉपडाउन से कोई टेस्ट सुइट चुनें और अगला चरण पर क्लिक करें. इसके बाद, वे डिवाइस चुनें जिन पर आपको टेस्ट चलाना है. इसके बाद, कॉन्फ़िगरेशन जोड़ें पर क्लिक करें. हर टेस्ट प्लान के लिए, एक से ज़्यादा कॉन्फ़िगरेशन जोड़े जा सकते हैं.

टेस्ट रन को कॉन्फ़िगर करें

23वीं इमेज. टेस्ट रन को कॉन्फ़िगर करना.

डिवाइस की कार्रवाइयां जोड़ना

डिवाइस पर की जाने वाली उन कार्रवाइयों को जोड़ें जिन्हें हर टेस्ट रन से पहले पूरा करना है. ज़्यादा जानकारी के लिए, डिवाइस से जुड़ी कार्रवाइयाँ जोड़ना देखें.

डिवाइस से जुड़ी कार्रवाइयां जोड़ना

24वीं इमेज. डिवाइस की कार्रवाइयां जोड़ना.

टेस्ट के लिए संसाधन सेट करना

टेस्ट प्लान में टेस्ट रिसॉर्स जोड़ने का तरीका, अलग-अलग टेस्ट रन में उन्हें जोड़ने के तरीके जैसा ही है. ज़्यादा जानकारी के लिए, टेस्ट के लिए संसाधन सेट करना लेख पढ़ें.

टेस्ट के लिए संसाधन सेट करना

25वीं इमेज. टेस्ट के लिए संसाधन सेट किए जा रहे हैं.

टेस्ट रन देखें

टेस्ट रन की सूची

टेस्ट रन पेज पर, शेड्यूल किए गए टेस्ट रन की सूची देखें. किसी टेस्ट रन के बारे में ज़्यादा जानकारी देखने के लिए, देखें पर क्लिक करें.

फ़िल्टर बार में कोई स्ट्रिंग डालकर और Enter बटन दबाकर भी सूची को फ़िल्टर किया जा सकता है. एक से ज़्यादा फ़िल्टर इस्तेमाल करने के लिए, उन्हें कॉमा लगाकर अलग करें. फ़िल्टर, उन सभी पंक्तियों को दिखाता है जिनमें किसी भी कॉलम में सटीक टेक्स्ट (कोई सबस्ट्रिंग मैच नहीं) शामिल होता है. इसमें स्थिति और बनाया गया कॉलम शामिल नहीं होता.

खाली फ़िल्टर सभी लाइनें दिखाता है. फ़िलहाल, खाली वैल्यू वाली लाइनों को फ़िल्टर करने का कोई तरीका नहीं है.

टेस्ट रन की सूची

इमेज 26. टेस्ट रन की सूची.

टेस्ट रन की जानकारी

यहां टेस्ट रन की जानकारी देखी जा सकती है. जैसे, स्टेटस, लॉग, और नतीजे.

टेस्ट रन की जानकारी

27वीं इमेज. टेस्ट रन की जानकारी.

टेस्ट रन का स्टेटस

टेस्ट रन की प्रोग्रेस, स्टेटस सेक्शन में दिखती है. अगर डाउनलोड से जुड़ा कोई मैसेज है, जैसे कि डाउनलोड की प्रोग्रेस, रद्द करने की वजह या गड़बड़ी का मैसेज, तो वह भी यहां दिखता है.

टेस्ट रन का स्टेटस

28वीं इमेज. टेस्ट रन का स्टेटस.

टेस्ट रन की स्थितियां ये हैं:

  • डाउनलोड होना बाकी है - ज़रूरी संसाधन डाउनलोड किए जा रहे हैं.
  • Queued - डिवाइस उपलब्ध होने पर, टेस्ट को रन किया जा सकता है.
  • चल रहा है - टेस्ट, असाइन किए गए डिवाइस पर चल रहा है.
  • पूरा हो गया - टेस्ट पूरा हो गया है और इसके नतीजे रिपोर्ट कर दिए गए हैं.
  • रद्द किया गया - उपयोगकर्ता ने टेस्ट रद्द कर दिया या उपलब्ध डिवाइसों को ढूंढने के दौरान, टाइम आउट हो गया.
  • गड़बड़ी - कोई गड़बड़ी हुई है, जिसकी वजह से टेस्ट नहीं चल सका.

टेस्ट रन को रद्द करना

अगर टेस्ट रन पूरा नहीं हुआ है, तो उसे रद्द किया जा सकता है. इसके लिए, रद्द करें पर क्लिक करें. इसके बाद, पुष्टि करने वाले डायलॉग बॉक्स में हां पर क्लिक करें. अगर टेस्ट रन, queue_timeout_seconds फ़ील्ड में तय की गई समयसीमा से ज़्यादा समय तक सूची में रहते हैं, तो वे अपने-आप रद्द हो जाते हैं. चल रहा है स्टेटस के दौरान, टेस्ट रन को रद्द करने पर, इसे लागू होने में कुछ मिनट लग सकते हैं.

टेस्ट रन रद्द करें

इमेज 29. टेस्ट रन को रद्द करना.

टेस्ट रन के नतीजे

टेस्ट रन पूरा होने के बाद, नतीजे इकट्ठा करके दिखाए जाते हैं. हर रन के लिए ऐरो पर क्लिक करके, ज़्यादा जानकारी देखी जा सकती है. इकट्ठा किए गए टेस्ट आर्टफ़ैक्ट देखने के लिए, आउटपुट फ़ाइलें देखें पर क्लिक करें. जैसे, test_result.xml और test_result_failures.html.

टेस्ट रन के नतीजे

तीसवीं इमेज. टेस्ट रन के नतीजे.

लॉग टैब में, लाइव होस्ट और Tradefed लॉग देखे जा सकते हैं.

टेस्ट रन के लॉग

31वीं इमेज. लॉग टैब.

अलग-अलग मॉड्यूल के नतीजे, टेस्ट के नतीजे टैब में मौजूद होते हैं.

जांच के नतीजों वाला टैब

32वीं इमेज. जांच के नतीजे टैब.

टेस्ट रिसॉर्स टैब में खोलें पर क्लिक करके, टेस्ट रिसॉर्स के तौर पर इस्तेमाल की गई फ़ाइलें डाउनलोड की जा सकती हैं.

टेस्ट रिसॉर्स टैब

इमेज 33. टेस्ट रिसॉर्स टैब.

टेस्ट रन की जानकारी देखने के लिए, Config टैब पर जाएं. जैसे, create_time.

टेस्ट कॉन्फ़िगरेशन टैब

34वीं इमेज. कॉन्फ़िगरेशन टैब.

बेहतर सुविधाएं

कॉन्फ़िगरेशन फ़ाइलें मैनेज करना

OmniLab ATS, YAML में लिखी गई कॉन्फ़िगरेशन फ़ाइलों का इस्तेमाल करता है. इससे, पहले से तय किए गए विकल्पों को लोड किया जाता है. जैसे, टेस्ट, बिल्ड चैनल, और डिवाइस से जुड़ी कार्रवाइयां. यहां कॉन्फ़िगरेशन फ़ाइल का एक उदाहरण दिया गया है:

// 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 इंस्टेंस सेट अप करते समय, अपने कॉन्फ़िगरेशन को फ़ाइल के तौर पर एक्सपोर्ट करके, अन्य उपयोगकर्ताओं के साथ शेयर किया जा सकता है. इसके लिए, सेटिंग पेज पर जाएं और सबसे ऊपर दाईं ओर मौजूद, एक्सपोर्ट करें पर क्लिक करें.

कॉन्फ़िगरेशन फ़ाइल मैनेजमेंट

35वीं इमेज. कॉन्फ़िगरेशन फ़ाइल मैनेजमेंट.

कॉन्फ़िगरेशन फ़ाइल डाउनलोड होने के बाद, उसे अन्य उपयोगकर्ताओं के साथ शेयर करें. वे Import पर क्लिक करके और कॉन्फ़िगरेशन फ़ाइल को चुनकर, उसे अपने OmniLab ATS इंस्टेंस में जोड़ सकते हैं.

डिवाइस के लिए नई कार्रवाई बनाना

डिवाइस की कार्रवाइयों का इस्तेमाल, डिवाइस सेटअप की प्रोसेस को ऑटोमेट करने के लिए किया जाता है. कार्रवाइयां ऐसी स्क्रिप्ट होती हैं जो हर टेस्ट रन से पहले, हर उस डिवाइस पर चलाई जाती हैं जिस पर टेस्ट चल रहा है. इसमें फिर से कोशिश करने से पहले की कार्रवाइयां भी शामिल हैं. उपलब्ध डिवाइस ऐक्शन की सूची देखने के लिए, सेटिंग पेज पर जाएं और डिवाइस ऐक्शन टैब पर क्लिक करें. डिवाइस की कई कार्रवाइयां पहले से कॉन्फ़िगर की गई होती हैं. जैसे, रीबूट करना और फ़्लैश करना.

डिवाइस से जुड़ी कार्रवाइयों वाला टैब

36वीं इमेज. डिवाइस से जुड़ी कार्रवाइयां टैब.

डिवाइस के लिए नई कार्रवाई जोड़ना

  1. डिवाइस के लिए नई कार्रवाई पर क्लिक करें.

    नए डिवाइस के लिए ऐक्शन बटन

    37वीं इमेज. डिवाइस का नया ऐक्शन बटन.

  2. नाम और ब्यौरा डालें.

    डिवाइस से जुड़ी कार्रवाई का नाम

    38वीं इमेज. डिवाइस की कार्रवाई का नाम.

  3. टारगेट प्रिपेयरर जोड़ें पर क्लिक करें.

  4. Trade Federation टारगेट प्रिपेयरर का पूरा क्लास नेम डालें. उदाहरण के लिए, com.android.tradefed.targetprep.RunHostCommandTargetPreparer.

    टारगेट प्रिपेयरर जोड़ें

    इमेज 39. टारगेट प्रिपेयरर जोड़ना.

    उपलब्ध टारगेट प्रिपेयरर की सूची, com.android.tradefed.targetprep रेफ़रंस में देखी जा सकती है.

    टारगेट प्रिपेयरर लिस्ट

    40वीं इमेज. टारगेट प्रिपेयरर की सूची.

  5. टारगेट प्रिपेयरर के साथ इस्तेमाल करने के लिए कोई भी विकल्प जोड़ें. उपलब्ध विकल्प देखने के लिए, एओएसपी में हर टारगेट प्रिपेयरर के सोर्स कोड के लिए, targetprep देखें:

    कार्रवाई के विकल्प का उदाहरण

    इमेज 41. कार्रवाई के विकल्प का उदाहरण.

  6. कोई विकल्प जोड़ने के लिए, टारगेट प्रिपेयरर विकल्प जोड़ें पर क्लिक करें और ज़रूरी वैल्यू डालें.

    कार्रवाई के निर्देश का उदाहरण

    42वीं इमेज. कार्रवाई के निर्देश का उदाहरण.

  7. डिवाइस पर कार्रवाई करने के लिए ज़रूरी टेस्ट रिसॉर्स तय करें. उदाहरण के लिए, फ़्लैश करने के लिए इमेज बनाएं. संसाधन की परिभाषा जोड़ने के लिए, टेस्ट संसाधन जोड़ें पर क्लिक करें और ज़रूरी फ़ील्ड भरें. अगर आपको पता है कि आपकी फ़ाइलें कहां मौजूद हैं, तो ब्राउज़ करें पर क्लिक करके, डिफ़ॉल्ट डाउनलोड यूआरएल दिया जा सकता है. अगर टारगेट तैयार करने वाले लोग, डायरेक्ट्री को टेस्ट रिसॉर्स के तौर पर स्वीकार करते हैं, तो डीकंप्रेस करें को चुनें. इसके बाद, कुछ समय के लिए इस्तेमाल की जाने वाली डायरेक्ट्री के तहत, डेस्टिनेशन डायरेक्ट्री और डीकंप्रेस की जाने वाली फ़ाइलों के नाम बताएं. अगर फ़ाइलों के नाम नहीं दिए गए हैं, तो टेस्ट रिसॉर्स से सभी फ़ाइलों को डीकंप्रेस कर दिया जाता है.

    ऐक्शन टेस्ट रिसॉर्स

    इमेज 43. कार्रवाई की जांच करने के लिए संसाधन.

  8. अपडेट करें पर क्लिक करें.

    बदलावों को सेव करने की कार्रवाई

    इमेज 44. बदलावों को सेव करने की कार्रवाई.

टेस्ट मैनेज करना

किसी टेस्ट में बदलाव करना

सेव किए गए किसी टेस्ट में बदलाव करने के लिए, टेस्ट पेज पर जाएं. इसके बाद, जिस टेस्ट में बदलाव करना है उसकी लाइन में मौजूद, बदलाव करें पर क्लिक करें. टेस्ट कॉन्फ़िगरेशन में बदलाव करने के बाद, अपडेट करें पर क्लिक करें.

किसी टेस्ट में बदलाव करना

45वीं इमेज. किसी टेस्ट में बदलाव करना.

नया टेस्ट जोड़ें

कोई नया टेस्ट जोड़ने के लिए, टेस्ट पेज पर जाएं और नया टेस्ट बनाएं पर क्लिक करें. सही जानकारी डालें और बनाएं पर क्लिक करें.

टेस्ट बनाना

इमेज 46. टेस्ट बनाना.

किसी टेस्ट को कॉपी करना

इमेज 47. टेस्ट कॉपी करना.

होस्ट कॉन्फ़िगरेशन एक्सपोर्ट करना

होस्ट को कॉन्फ़िगर करने के बाद, होस्ट के कॉन्फ़िगरेशन को किसी फ़ाइल में एक्सपोर्ट किया जा सकता है. सेव किए गए कॉन्फ़िगरेशन को कॉपी करने के लिए, इस फ़ाइल को अन्य होस्ट पर अपलोड किया जा सकता है.

किसी होस्ट के कॉन्फ़िगरेशन एक्सपोर्ट करने के लिए, सेटिंग पेज पर जाएं और सबसे ऊपर दाएं कोने में मौजूद, एक्सपोर्ट करें पर क्लिक करें.

होस्ट कॉन्फ़िगरेशन एक्सपोर्ट किए जा रहे हैं

इमेज 48. होस्ट कॉन्फ़िगरेशन को एक्सपोर्ट करना.

होस्ट कॉन्फ़िगरेशन फ़ाइल इंपोर्ट करने के लिए, सेटिंग पेज पर जाएं. इसके बाद, सबसे ऊपर दाएं कोने में मौजूद, इंपोर्ट करें पर क्लिक करें.

होस्ट कॉन्फ़िगरेशन इंपोर्ट किए जा रहे हैं

इमेज 49. होस्ट कॉन्फ़िगरेशन इंपोर्ट करना.

लोकल फ़ाइलों और डायरेक्ट्री का इस्तेमाल करना

R11 वर्शन से, $HOME/.ats_storage डायरेक्ट्री में मौजूद फ़ाइलें OmniLab ATS में अपने-आप ऐक्सेस हो जाती हैं. किसी फ़ाइल को उस डायरेक्ट्री में कॉपी करें या ले जाएं. इसके बाद, टेस्ट रन शेड्यूल करते समय, उसे लोकल फ़ाइल टैब से चुना जा सकता है.

cp /path/to/file $HOME/.ats_storage

लोकल फ़ाइल चुनना

50वीं इमेज. $HOME/.ats_storage डायरेक्ट्री से कोई फ़ाइल चुनना.

--mount_local_path फ़्लैग की मदद से, लोकल फ़ाइल स्टोर में अन्य डायरेक्ट्री माउंट की जा सकती हैं.

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

माउंट की गई अन्य डायरेक्ट्री

इमेज 51. लोकल फ़ाइल स्टोर में माउंट की गई अतिरिक्त डायरेक्ट्री.

एक से ज़्यादा होस्ट वाला मोड चालू करना

मल्टी-होस्ट मोड की मदद से, उपयोगकर्ता एक ही एटीएस कंट्रोलर होस्ट का इस्तेमाल करके, कई एटीएस वर्कर होस्ट पर डिवाइसों और टेस्ट को मैनेज कर सकते हैं.

मल्टी-होस्ट मोड आर्किटेक्चर

52वीं इमेज. मल्टी-होस्ट मोड का आर्किटेक्चर.

  1. एटीएस कंट्रोलर को शुरू करने के लिए, इस कमांड का इस्तेमाल करें:

    mtt start --operation_mode=ON_PREMISE
    
  2. देखें कि कंट्रोलर को http://${CONTROLLER_HOSTNAME}:8000 पर ऐक्सेस किया जा सकता है या नहीं.

  3. वर्कर शुरू करने के लिए, इस कमांड का इस्तेमाल करें:

    mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
    

अगर आपका नेटवर्क, होस्ट को एक-दूसरे से कम्यूनिकेट करने की अनुमति नहीं देता है, तो आपको एटीएस वर्कर पर सेटअप करने के लिए, यहां दिए गए ऐडवांस निर्देशों का पालन करना होगा.

  1. एसएसएच टनल का इस्तेमाल करके, दोनों होस्ट को कनेक्ट करें. प्राइमरी और फ़ाइल सर्वर पोर्ट के लिए पोर्ट चुनें. उदाहरण के लिए, 9000 और 9006.

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. एटीएस को कॉन्फ़िगर करें और शुरू करें.

    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
    

फ़ाइल क्लीनर

फ़ाइल क्लीनर एक क्रॉन जॉब है, जो हर घंटे चलता है. यह उपयोगकर्ता के तय किए गए कॉन्फ़िगरेशन के आधार पर फ़ाइलों को मिटाता है. एटीएस में, टेस्ट रन के नतीजों को संग्रहित करने और कुछ समय के लिए सेव की गई फ़ाइलों को मिटाने के लिए, दो डिफ़ॉल्ट कॉन्फ़िगरेशन होते हैं. इस गाइड में, अपनी फ़ाइलों को असरदार तरीके से मैनेज करने के लिए, नीतियों और कॉन्फ़िगरेशन को पसंद के मुताबिक बनाने का तरीका बताया गया है.

नीतियां

नीति से यह तय होता है कि फ़ाइलों या डायरेक्ट्री पर कौनसी कार्रवाई की जानी चाहिए. साथ ही, टारगेट चुनने की शर्तें क्या होनी चाहिए. टेबल में, उपलब्ध ऑपरेशन दिखाए गए हैं:

कार्रवाई का टाइपपैरामीटर
ARCHIVEremove_file: अगर true, तो संग्रहित करने के बाद फ़ाइल को हटा दें.
DELETE

ये शर्तें, फ़ाइल के एट्रिब्यूट और सिस्टम की जानकारी पर आधारित होती हैं. उपलब्ध शर्तें, टेबल में दिखाई गई हैं:

मानदंड का टाइपब्यौरापैरामीटर
LAST_MODIFIED_TIMEफ़ाइलों को उनमें आखिरी बार किए गए बदलाव की तारीख और समय के हिसाब से फ़िल्टर करें.ttl: समय को अलग-अलग तरह से दिखाया जा सकता है. उदाहरण के लिए, 10m, 2h, 7 days, 4w. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट देखने के लिए, pytimeparse पर जाएं.
LAST_ACCESS_TIMEफ़ाइलों को पिछली बार ऐक्सेस करने की तारीख और समय के हिसाब से फ़िल्टर करें.LAST_MODIFIED_TIME के बराबर.
NAME_MATCHरेगुलर एक्सप्रेशन का इस्तेमाल करके, फ़ाइलों को उनके नाम के हिसाब से फ़िल्टर करें.pattern: रेगुलर एक्सप्रेशन, जैसे कि नतीजे वाली ZIP फ़ाइलों से मैच करने के लिए [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip.
SYSTEM_AVAILABLE_SPACEसिस्टम में उपलब्ध स्टोरेज के आधार पर कार्रवाइयां ट्रिगर करना.threshold: उपलब्ध स्टोरेज तय सीमा से कम होने पर, कार्रवाई ट्रिगर करें. उदाहरण के लिए, 200(B), 200KB, 200MB, 200GB, 2TB.

फ़ाइल क्लीनर से जुड़ी नई नीति

इमेज 53. फ़ाइल क्लीनर की नई नीति जोड़ें.

कॉन्फ़िगरेशन

कॉन्फ़िगरेशन में, एक या उससे ज़्यादा नीतियों को खास डायरेक्ट्री के साथ जोड़ा जाता है. तय की गई डायरेक्ट्री में मौजूद फ़ाइलों और डायरेक्ट्री को, तय की गई नीतियों के आधार पर प्रोसेस किया जाता है. नीतियां उसी क्रम में लागू होती हैं जिस क्रम में वे कॉन्फ़िगरेशन में दिखती हैं.

सभी टारगेट डायरेक्ट्री, /data डायरेक्ट्री में होनी चाहिए. अगर आपके कॉन्फ़िगरेशन में टारगेट डायरेक्ट्री को logs के तौर पर तय किया गया है, तो इसे /data/logs के तौर पर समझा जाता है.

फ़ाइल क्लीनर कॉन्फ़िगरेशन में बदलाव करना

इमेज 54. फ़ाइल क्लीनर कॉन्फ़िगरेशन में बदलाव करें.

रीसेट करें

सेटिंग रीसेट करें पर क्लिक करने से, फ़ाइल क्लीनर का कॉन्फ़िगरेशन अपनी डिफ़ॉल्ट स्थिति में वापस आ जाता है. ऐसा करने पर, पसंद के मुताबिक बनाए गए सभी आइटम मिट जाएंगे.

फ़ाइल क्लीनर की सेटिंग रीसेट करना

इमेज 55. फ़ाइल क्लीनर की सेटिंग रीसेट करें.

सहायता

गड़बड़ी की रिपोर्ट

OmniLab ATS में आपके योगदान से, टूल को बेहतर बनाने में मदद मिलती है. इसलिए, हमें आपके सुझाव, शिकायत या राय का इंतज़ार रहेगा! नई रिलीज़ के बारे में जानने के लिए, OmniLab ATS के रिलीज़ नोट देखें. गड़बड़ियों की शिकायत करने या सुझाव देने के लिए, गड़बड़ी की रिपोर्ट सबमिट करें. पार्टनरों को अपने पार्टनर चैनलों का इस्तेमाल करके, गड़बड़ियों की शिकायत करनी चाहिए या सुझाव देने चाहिए.