OmniLab Android Test Station

OmniLab ATS เป็นเครื่องมือทดสอบที่นักพัฒนาแอป Android และวิศวกรทดสอบสามารถใช้เพื่อใช้อินเทอร์เฟซผู้ใช้สำหรับการเรียกใช้ชุดโปรแกรมทดสอบ Android มาตรฐาน เช่น ชุดเครื่องมือทดสอบความเข้ากันได้ (CTS) ของ Android เครื่องมือนี้ทำหน้าที่เป็นอินเทอร์เฟซเว็บสำหรับเฟรมเวิร์กการทดสอบต่างๆ เช่น Trade Federation (TF) และ Google Mobly ซึ่งช่วยให้คุณเรียกใช้ CTS และการทดสอบหลายอุปกรณ์ในชุดอุปกรณ์ทดสอบได้โดยมีการตั้งค่าเพียงเล็กน้อย รวมถึงกำหนดเวลาเพื่อเรียกใช้การทดสอบอย่างต่อเนื่อง

ข้อมูลเบื้องต้นเกี่ยวกับ OmniLab ATS 2.0

OmniLab ATS 2.0 จะย้ายข้อมูลโครงสร้างพื้นฐานการดำเนินการทดสอบที่สำคัญจาก Trade Federation ไปยัง OmniLab การเปลี่ยนแปลงนี้จะทำให้แบ็กเอนด์มีประสิทธิภาพและเสถียรมากขึ้น โดยยังคงอินเทอร์เฟซผู้ใช้และเวิร์กโฟลว์ของ OmniLab ATS 1.0 ไว้

ประโยชน์หลักของ OmniLab ATS 2.0

  • โครงสร้างพื้นฐานที่ทันสมัย: ใช้ประโยชน์จากแพลตฟอร์ม OmniLab เพื่อปรับปรุงความเสถียรและประสิทธิภาพ
  • การเปลี่ยนผ่านที่ราบรื่น: ไม่มีการเปลี่ยนแปลง UI บนเว็บหรือเวิร์กโฟลว์การดำเนินการทดสอบหลัก
  • พร้อมสำหรับอนาคต: สอดคล้องกับโครงสร้างพื้นฐานการทดสอบแบบรวมของ Google ซึ่งช่วยให้ใช้ฟีเจอร์ใหม่ๆ ได้เร็วขึ้น

OmniLab ATS 2.0 มีฟีเจอร์ใหม่ๆ เช่น การอัปเดตแผนการทดสอบหลายรายการพร้อมกัน การจัดสรรอุปกรณ์ขั้นสูง และอื่นๆ อีกมากมาย โปรดดูข้อมูลอัปเดตในบันทึกประจำรุ่น

อัปเกรดเป็น OmniLab ATS 2.0:

หากต้องการใช้ OmniLab ATS 2.0 คุณต้องอัปเกรดสถานีเป็นบิลด์ R52 หรือใหม่กว่า ใช้แฟล็ก --force_ats_version 2 เพื่อเปลี่ยนไปใช้ Omnilab ATS 2.0 ใหม่ และใช้แฟล็ก --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

เราวางแผนที่จะทำให้ OmniLab ATS 2.0 เป็นเวอร์ชันเริ่มต้นในไตรมาสที่ 3 ปี 2026 เราวางแผนที่จะเลิกใช้งาน OmniLab ATS 1.0 ภายในสิ้นปี 2026

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการอัปเดตที่เฉพาะเจาะจง ความแตกต่างที่ทราบ และคำแนะนำในการอัปเกรดได้ที่คู่มือการอัปเกรด OmniLab ATS 2.0

ตั้งค่า OmniLab ATS

ส่วนนี้จะอธิบายวิธีติดตั้งและตั้งค่า OmniLab ATS

OmniLab ATS ใช้ซอร์สโค้ดจากตำแหน่งต่อไปนี้

ติดตั้ง OmniLab ATS

ปฏิบัติตามข้อกำหนดด้านฮาร์ดแวร์และซอฟต์แวร์สำหรับชุดโปรแกรมทดสอบที่คุณเรียกใช้

ดูข้อกำหนดสำหรับ CTS ได้ที่ source.android.com

OmniLab ATS ไม่มีข้อกำหนดด้านฮาร์ดแวร์เพิ่มเติม แต่เราขอแนะนำให้ใช้ข้อกำหนดของโฮสต์ CTS เป็นจุดเริ่มต้น

การติดตั้ง OmniLab ATS ทำได้ 2 วิธีดังนี้

ติดตั้งด้วยโปรแกรมติดตั้ง

โปรแกรมติดตั้งรองรับ Ubuntu 22.04 ขึ้นไป โปรแกรมติดตั้งจะติดตั้งและกำหนดค่าโปรแกรมและทรัพยากรทั้งหมดที่จำเป็นต่อการเรียกใช้ OmniLab ATS

วิธีใช้โปรแกรมติดตั้ง

  1. เรียกใช้โปรแกรมติดตั้งโดยทำดังนี้

    curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
    
  2. เรียกใช้ mtt version เพื่อตรวจสอบเวอร์ชันที่ติดตั้งของ OmniLab ATS CLI

ติดตั้งด้วยตนเอง

ติดตั้ง Docker
  1. ทำตามวิธีการติดตั้ง Docker Community Edition (CE) ในเครื่อง Linux

  2. ทำตามขั้นตอนหลังการติดตั้งเพื่อจัดการ Docker ในฐานะผู้ใช้รากที่ไม่ใช่

  3. คุณอาจต้องรีสตาร์ทหน้าต่างเทอร์มินัลหรือออกจากระบบและลงชื่อเข้าใช้อีกครั้งเพื่อให้การเปลี่ยนแปลงสิทธิ์มีผล

ติดตั้ง Python 3

OmniLab ATS CLI ต้องใช้ Ubuntu 22.04 ขึ้นไป CLI ได้รับการยืนยันกับ Python เวอร์ชัน 3.10 ถึง 3.13

หากต้องการติดตั้ง Python 3 ให้เรียกใช้คำสั่งต่อไปนี้

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

หากต้องการ Python 3 เวอร์ชันที่ไม่ได้รวมอยู่ในการแจกจ่ายมาตรฐาน ให้เพิ่มที่เก็บสำหรับ Python 3 ก่อนโดยทำอย่างใดอย่างหนึ่งต่อไปนี้

หากต้องการติดตั้ง Python 3 เวอร์ชันที่เฉพาะเจาะจง (เช่น 3.10) ให้เรียกใช้คำสั่งต่อไปนี้แทน

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

ดาวน์โหลด OmniLab ATS CLI

ดาวน์โหลดแพ็กเกจอินเทอร์เฟซบรรทัดคำสั่ง (CLI) ที่นี่

เริ่ม OmniLab ATS

เริ่ม OmniLab ATS ด้วยคำสั่งต่อไปนี้

mtt start

เมื่อเริ่มใช้ UI เป็นครั้งแรก ระบบอาจใช้เวลา 2-3 นาทีจึงจะปรากฏ CLI จะแสดง URL ของเว็บเพื่อเข้าถึง UI ในเบราว์เซอร์ โดยค่าเริ่มต้น URL ของเว็บคือ localhost:8000 หากจำเป็น คุณสามารถเปลี่ยนพอร์ตเริ่มต้นเมื่อเริ่มต้นระบบได้ด้วยแฟล็ก --port

หากมีเวอร์ชันใหม่พร้อมใช้งาน คุณสามารถอัปเดตเป็นเวอร์ชันปัจจุบันได้ คุณสามารถดูบันทึกประจำรุ่นสำหรับรุ่นล่าสุดได้

หากต้องการอัปเดตเป็นเวอร์ชันปัจจุบัน ให้เรียกใช้คำสั่งต่อไปนี้

mtt start --force_update

หากต้องการหยุดแอป ให้เรียกใช้คำสั่งต่อไปนี้

mtt stop

หากต้องการดูรายการคำสั่งอื่นๆ ให้ใช้คำสั่งต่อไปนี้

mtt --help

สำรองและกู้คืนฐานข้อมูล

หากต้องการสำรองข้อมูลฐานข้อมูล OmniLab ATS ให้หยุดแอปและเรียกใช้คำสั่งต่อไปนี้ ซึ่งจะสำรองข้อมูลฐานข้อมูลปัจจุบันลงในไฟล์ TAR ชื่อ mtt-backup.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 ATS อื่น คุณสามารถอัปโหลดไฟล์เพื่อคัดลอกการกำหนดค่าที่แก้ไขจากโฮสต์นั้นได้โดยคลิกปุ่มอัปโหลดไฟล์

กู้คืนข้อมูลสำรองของการกำหนดค่า

รูปที่ 1 กำลังกู้คืนข้อมูลสำรองของการกำหนดค่า

ตั้งค่าบัญชีบริการเริ่มต้น

คุณสามารถตั้งค่าบัญชีบริการที่ OmniLab ATS ใช้โดยค่าเริ่มต้นเมื่อเข้าถึงทรัพยากรของคุณ (เช่น Google Cloud Storage, Google ไดรฟ์) หากต้องการตรวจสอบสิทธิ์บัญชีบริการ ให้คลิกอัปโหลดคีย์บัญชีบริการ แล้วเลือกไฟล์คีย์ JSON ของบัญชีบริการ

ตั้งค่าบัญชีบริการ

รูปที่ 2 กำลังตั้งค่าบัญชีบริการ

เมื่อตรวจสอบสิทธิ์บัญชีบริการเรียบร้อยแล้ว อีเมลของบัญชีจะปรากฏที่มุมขวาบนของหน้า หากต้องการเปลี่ยนบัญชีบริการ ให้คลิกชื่อบัญชี นำบัญชีเริ่มต้นปัจจุบันออก แล้วอัปโหลดคีย์บัญชีบริการใหม่

เปลี่ยนบัญชีบริการ

รูปที่ 3 การเปลี่ยนบัญชีบริการ

นำเข้าชุดการกำหนดค่า

ชุดการกำหนดค่าคือกลุ่มการกำหนดค่าสำหรับการเรียกใช้ชุดโปรแกรมทดสอบ ซึ่งรวมถึงการดำเนินการกับอุปกรณ์ที่เกี่ยวข้องและช่องทางการสร้าง ชุดการกำหนดค่าจะโฮสต์อยู่ในที่เก็บข้อมูล Google Cloud Storage (GCS) ที่เฉพาะเจาะจง หลังจากตรวจสอบสิทธิ์ช่องทางบิลด์ GCS ด้วยบัญชี Google แล้ว คุณจะเห็นรายการชุดการกำหนดค่าทั้งหมดที่พร้อมใช้งาน

เลือกชุดการกำหนดค่าที่ต้องการเพิ่มลงในโฮสต์ Test Station แล้วคลิกนำเข้าที่เลือก

นำเข้าชุดการกำหนดค่า

รูปที่ 4 กำลังนำเข้าชุดการกำหนดค่า

รวมการตั้งค่า Wi-Fi

การทดสอบ CTS บางรายการกำหนดให้อุปกรณ์ของคุณเชื่อมต่อกับฮอตสปอต Wi-Fi หากต้องการเลือกเครือข่าย Wi-Fi ให้ป้อน WiFi SSID และ WiFi PSK (ไม่บังคับ)

การตั้งค่า WiFi

รูปที่ 5 การตั้งค่าฮอตสปอต Wi-Fi

หลังจากทำตามวิซาร์ดการตั้งค่าเสร็จแล้ว หน้าเว็บจะโหลดซ้ำโดยใช้การตั้งค่าใหม่

เชื่อมต่ออุปกรณ์

ต้องเปิดใช้การแก้ไขข้อบกพร่อง USB เพื่อใช้อุปกรณ์สำหรับการทดสอบ วิธีเปิดใช้การแก้ไขข้อบกพร่อง

  1. ทำตามวิธีการในหัวข้อเปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปและการแก้ไขข้อบกพร่อง

  2. หากคุณวางแผนที่จะใช้บิลด์ Android ทดสอบที่โหลดคีย์ ADB ที่กำหนดเองไว้ล่วงหน้า ให้ใส่ไฟล์ .adb_key ที่กำหนดเองไว้ในไดเรกทอรี ~/.android/

    ระบบจะโหลดไฟล์โดยอัตโนมัติและส่งไปยัง ADB เพื่อเปิดใช้การแก้ไขข้อบกพร่อง USB โดยอัตโนมัติหลังจากแฟลชอุปกรณ์ที่ใช้บิลด์เหล่านั้น

  3. เชื่อมต่ออุปกรณ์กับเครื่องโฮสต์โดยใช้ USB

    อุปกรณ์จะปรากฏในแท็บอุปกรณ์ OmniLab ATS ภายใน 1 นาทีหลังจากรีเฟรชอินเทอร์เฟซเว็บ นอกจากนี้ คุณยังดูสถานะของอุปกรณ์ในแท็บนี้ได้ด้วย

    เชื่อมต่ออุปกรณ์

    รูปที่ 6 กำลังเชื่อมต่ออุปกรณ์

สถานะต่างๆ ของอุปกรณ์มีดังนี้

  • พร้อมใช้งาน - อุปกรณ์เชื่อมต่อแล้วและพร้อมทำการทดสอบ
  • จัดสรรแล้ว - อุปกรณ์เชื่อมต่ออยู่และกำลังทำการทดสอบ อุปกรณ์แต่ละเครื่องจะทำการทดสอบได้ครั้งละ 1 รายการเท่านั้น ดังนั้นอุปกรณ์จึงต้องทำการทดสอบปัจจุบันให้เสร็จก่อนจึงจะทำการทดสอบใหม่ได้

ทำการทดสอบ

เลือกการทดสอบ

OmniLab ATS มาพร้อมกับชุดการกำหนดค่า CTS ที่รวมไว้ล่วงหน้า หากต้องการเรียกใช้การทดสอบเหล่านี้ ให้ไปที่แท็บชุดโปรแกรมทดสอบ แล้วคลิกเรียกใช้การทดสอบสำหรับการทดสอบที่เลือก

เลือกการทดสอบ

รูปที่ 7 กำลังเลือกการทดสอบ

หากต้องการแก้ไขหรือเพิ่มการทดสอบใหม่ โปรดดูหัวข้อการเพิ่มการทดสอบ

กำหนดค่าการเรียกใช้การทดสอบ

แก้ไขพารามิเตอร์ที่จะใช้สำหรับการทดสอบนี้โดยเฉพาะ พารามิเตอร์ส่วนใหญ่จะป้อนข้อมูลล่วงหน้าด้วยค่าที่กำหนดไว้ในการกำหนดค่าการทดสอบที่เลือก

ขั้นตอนนี้สามารถดำเนินการให้เสร็จสมบูรณ์ได้โดยใช้ค่าเริ่มต้น แต่คุณสามารถเปลี่ยนพารามิเตอร์ใดก็ได้ เช่น Max Retry และ Command เพื่อให้เหมาะกับความต้องการของคุณ

กำหนดค่าการเรียกใช้การทดสอบ

รูปที่ 8 กำลังกำหนดค่าการดำเนินการทดสอบ

พารามิเตอร์การทดสอบมีดังนี้

  • Name - ชื่อชุดโปรแกรมทดสอบที่ต้องการเรียกใช้
  • จำนวนการเรียกใช้ - จำนวนครั้งที่ควรเรียกใช้การทดสอบนี้เมื่อกำหนดเวลาไว้ การทดสอบจะกำหนดเวลาโดยใช้ Trade Federation ซึ่งจะทำการทดสอบพร้อมกันสูงสุด 20 ครั้งหากมีความสามารถในการดำเนินการดังกล่าว
  • Max Retry - จำนวนครั้งสูงสุดในการลองทำการทดสอบอีกครั้งหากการทดสอบล้มเหลวอย่างน้อย 1 ครั้ง โดยปกติแล้วจะตั้งค่าให้ลองใหม่ 4-6 ครั้งสำหรับการเรียกใช้ CTS แบบเต็มเพื่อจัดการกับการทดสอบที่ไม่เสถียร
  • หมดเวลาคิว - หากการทดสอบยังคงอยู่ในสถานะอยู่ในคิวนานเกินไป ระบบจะยกเลิกการทดสอบโดยอัตโนมัติ ระบุระยะเวลาที่ต้องรอก่อนการยกเลิกที่นี่ ซึ่งค่าเริ่มต้นคือ 24 ชั่วโมง
  • Command - คำสั่งเพื่อเรียกใช้ชุดโปรแกรมทดสอบ คุณสามารถป้อนอาร์กิวเมนต์บรรทัดคำสั่งเพิ่มเติมได้ที่นี่ ตัวอย่างเช่น เรียกใช้โมดูลที่เฉพาะเจาะจงใน CTS 8.1 ด้วยคำสั่งต่อไปนี้

    cts-suite -m ShortModuleName
    
  • คำสั่งลองใหม่ - คำสั่งสำหรับลองใช้ชุดโปรแกรมทดสอบอีกครั้ง คุณเพิ่มอาร์กิวเมนต์บรรทัดคำสั่งเพิ่มเติมได้ที่นี่ เช่น หากต้องการลองใหม่เฉพาะโมดูลที่เจาะจงใน CTS 8.1 ให้ใช้คำสั่งต่อไปนี้

    cts --retry 0 -m ShortModuleName
    

    อาร์กิวเมนต์การลองใหม่อาจแตกต่างจากอาร์กิวเมนต์ที่ใช้ได้กับคำสั่งเริ่มต้น ดังนั้นโปรดตรวจสอบพารามิเตอร์ที่รองรับในเว็บไซต์อย่างเป็นทางการสำหรับชุดโปรแกรมทดสอบที่เลือก

  • การทดสอบที่ดำเนินการก่อนหน้านี้ - หากต้องการทำการทดสอบที่ดำเนินการก่อนหน้านี้อีกครั้ง ให้ทำดังนี้

    • ในเครื่อง - หากการทำงานเริ่มต้นในโฮสต์ปัจจุบัน ให้ป้อนรหัสการทดสอบที่เห็นเมื่อดูรายละเอียดของการทดสอบ

      การรันเพื่อทดสอบในเครื่องครั้งก่อนหน้า

      รูปที่ 9 การทดสอบก่อนหน้าในเครื่อง

    • ระยะไกล - หากการเรียกใช้เริ่มต้นในโฮสต์อื่น ให้อัปโหลดไฟล์ผลการทดสอบโดยเลือกระยะไกล คลิกอัปโหลดไฟล์ผลการทดสอบ แล้วเลือกไฟล์จากพื้นที่เก็บข้อมูลในเครื่อง

      นำการเรียกใช้การทดสอบก่อนหน้าออก

      รูปที่ 10 นำการทดสอบที่ดำเนินการก่อนหน้านี้ออก

อุปกรณ์บางรุ่น

คลิกช่องทำเครื่องหมายเพื่อเลือกอุปกรณ์ที่จะจัดสรรสำหรับการเรียกใช้ชุดโปรแกรมทดสอบ จำนวนชาร์ดควรเปลี่ยนโดยอัตโนมัติเพื่อให้ตรงกับจำนวนอุปกรณ์ที่เลือก

เลือกอุปกรณ์

รูปที่ 11 กำลังเลือกอุปกรณ์

หากต้องการเลือกอุปกรณ์ตามแอตทริบิวต์อื่นๆ นอกเหนือจากหมายเลขซีเรียลของอุปกรณ์ คุณสามารถป้อน "ข้อมูลจำเพาะของอุปกรณ์" ด้วยตนเองได้ เช่น หากต้องการเลือกอุปกรณ์ 3 เครื่องที่มีชื่อผลิตภัณฑ์เป็น "bramble" ให้ป้อนข้อมูลต่อไปนี้

product:bramble;product:bramble;product:bramble

แอตทริบิวต์ที่รองรับมีดังนี้

  • build_id
  • device_serial
  • device_type
  • ชื่อโฮสต์
  • ผลิตภัณฑ์
  • product_variant
  • sim_state

อุปกรณ์ที่เลือกทั้งหมดต้องอยู่ในสถานะพร้อมใช้งานจึงจะทำการทดสอบได้ และอุปกรณ์ทั้งหมดจะเปลี่ยนเป็นสถานะจัดสรรแล้วเมื่อทำการทดสอบ การทดสอบจะอยู่ในสถานะอยู่ในคิวขณะรอให้อุปกรณ์พร้อมใช้งาน

เพิ่มการทำงานของอุปกรณ์

การดำเนินการของอุปกรณ์คือสคริปต์ที่สามารถเรียกใช้ก่อนการทดสอบแต่ละครั้ง การดำเนินการบางอย่างของอุปกรณ์ได้รับการกำหนดค่าไว้แล้ว เช่น การแฟลชและการรีบูต หากต้องการสร้างการดำเนินการใหม่ของอุปกรณ์ โปรดดูหัวข้อสร้างการดำเนินการใหม่ของอุปกรณ์

การทำงานของอุปกรณ์

รูปที่ 12 การดำเนินการของอุปกรณ์

หากต้องการเพิ่มการดำเนินการของอุปกรณ์ในการทดสอบ ให้คลิกเพิ่มการดำเนินการใหม่ เลือกช่องทำเครื่องหมายสำหรับการดำเนินการที่จะเพิ่ม แล้วคลิกเพิ่มการดำเนินการ ระบบจะดำเนินการกับอุปกรณ์ตามลำดับ คุณจัดลำดับการดำเนินการใหม่ได้โดยการลาก

เพิ่มการดำเนินการ

รูปที่ 13 กำลังจัดลำดับการดำเนินการใหม่

ตั้งค่าแหล่งข้อมูลการทดสอบ

ทรัพยากรการทดสอบคือไฟล์ที่จำเป็นสำหรับการดำเนินการทดสอบ เช่น การเรียกใช้ CTS ต้องใช้ไฟล์ android-cts*.zip และการแฟลชอุปกรณ์กำหนดให้คุณต้องระบุอิมเมจของบิลด์

URL สำหรับดาวน์โหลดไฟล์ ZIP ของชุดโปรแกรมทดสอบควรเป็นลิงก์ Google ไดรฟ์ที่ให้ไว้กับพาร์ทเนอร์โดยค่าเริ่มต้น คุณเลือกไฟล์อื่นได้โดยคลิกเรียกดู ในหน้าต่างป๊อปอัป คุณสามารถป้อนลิงก์ดาวน์โหลดไฟล์ ใช้ไฟล์จากช่องทางบิลด์ที่ตรวจสอบสิทธิ์แล้ว หรืออัปโหลดไฟล์เพื่อใช้จากพื้นที่เก็บข้อมูลในเครื่อง

แหล่งข้อมูลการทดสอบ

รูปที่ 14 แหล่งข้อมูลสำหรับการทดสอบ

ด้านล่างนี้คือหน้าต่างป๊อปอัปสำหรับเลือกแหล่งข้อมูลทดสอบตาม URL ของเว็บ คุณสามารถป้อนลิงก์ URL สำหรับดาวน์โหลด แล้วคลิกปุ่มเลือกเพื่อยืนยันการเลือก

Test Resource Selector - Web URL

รูปที่ 15 ตัวเลือกแหล่งข้อมูลทดสอบ - URL ของเว็บ

หากคุณอัปโหลดแหล่งข้อมูลไปยัง Google ไดรฟ์, Google Cloud Storage (GCS) หรือช่องทางอื่นๆ คุณยังสามารถไปยังแท็บของช่องทางที่ต้องการและเลือกแหล่งข้อมูลจากที่นั่นได้ด้วย ตัวอย่างการเลือกทรัพยากรจาก Google ไดรฟ์มีดังนี้

Test Resource Selector - Google ไดรฟ์

รูปที่ 16 เครื่องมือเลือกทรัพยากรทดสอบ - Google ไดรฟ์

นอกจากจะเลือกไฟล์ได้แล้ว ระบบยังรองรับอักขระไวลด์การ์ดในช่องชื่อไฟล์ด้วย ดูเอกสารประกอบได้ที่นี่

ตัวเลือกทรัพยากรทดสอบ - การรองรับรูปแบบไวลด์การ์ด

รูปที่ 17 ตัวเลือกทรัพยากรทดสอบ - รองรับรูปแบบไวลด์การ์ด

นอกจากนี้ คุณยังเลือกไฟล์จากที่จัดเก็บไฟล์ในเครื่องของ OmniLab ATS ได้ด้วย คุณสามารถอัปโหลดไฟล์ไปยังพื้นที่เก็บข้อมูลนี้ หรือใช้ไฟล์และไดเรกทอรีในเครื่องโดยตรง

ตัวเลือกทรัพยากรทดสอบ - ที่เก็บไฟล์ในเครื่อง

รูปที่ 18 ตัวเลือกทรัพยากรทดสอบ - ที่เก็บไฟล์ในเครื่อง

เพิ่มการกำหนดค่าการเรียกใช้ซ้ำ

คุณสามารถกำหนดเวลาการเรียกใช้ซ้ำที่เริ่มหลังจากที่การเรียกใช้หลักเสร็จสมบูรณ์และโหลดผลลัพธ์ แต่สามารถใช้อุปกรณ์ การดำเนินการ หรือทรัพยากรที่แตกต่างกันได้

เพิ่มการกำหนดค่าการเรียกใช้ซ้ำ

รูปที่ 19 กำลังเพิ่มการกำหนดค่าการเรียกใช้ซ้ำ

เริ่มการทดสอบ

หลังจากป้อนข้อมูลที่จำเป็นสำหรับการทดสอบแล้ว ให้คลิกเริ่มการทดสอบ หากข้อมูลทั้งหมดถูกต้อง การทดสอบจะเริ่มขึ้น และระบบจะเปลี่ยนเส้นทางคุณไปยังหน้าเพื่อดูรายละเอียดและความคืบหน้าของการทดสอบ

เริ่มการทดสอบ

รูปที่ 20 กำลังเริ่มการทดสอบ

สร้างแผนการทดสอบ

แผนการทดสอบใช้เพื่อสร้างการทดสอบตามกำหนดการเป็นระยะๆ เช่น เรียกใช้ CTS 9.0 ทุกวันเวลา 17:00 น. หากต้องการสร้างแผนการทดสอบใหม่ ให้คลิกสร้างแผนการทดสอบใหม่

สร้างแผนการทดสอบ

รูปที่ 21 การสร้างแผนการทดสอบ

กำหนดค่าแผนการทดสอบ

ป้อนชื่อแผนการทดสอบและป้ายกำกับที่ต้องการเพิ่ม จากนั้นเลือกกำหนดเวลาที่จะใช้

  • ด้วยตนเอง - แผนการทดสอบจะสร้างการทดสอบก็ต่อเมื่อผู้ใช้คลิกเรียกใช้แผนการทดสอบในหน้ารายการแผนการทดสอบ
  • เป็นระยะ - แผนการทดสอบจะกำหนดเวลาการทดสอบโดยอัตโนมัติตามกำหนดเวลาเป็นระยะที่เลือก เช่น ตั้งเวลาให้เรียกใช้การทดสอบทุกวันเวลา 17:00 น.
  • กำหนดเอง - แผนการทดสอบจะกำหนดเวลาการทดสอบโดยอัตโนมัติตามนิพจน์ Cron ที่ป้อน ตัวอย่างเช่น หากต้องการตั้งเวลาให้การทดสอบทำงานทุกวันเวลา 17:00 น. นิพจน์ Cron จะเป็น 0 17 * * *

กำหนดค่าแผนการทดสอบ

รูปที่ 22 การกำหนดค่าแพ็กเกจทดสอบ

เพิ่มชุดโปรแกรมทดสอบ

เพิ่มชุดโปรแกรมทดสอบที่คุณต้องการกำหนดเวลาตามแผนการทดสอบโดยคลิก + เพิ่มการกำหนดค่าการเรียกใช้การทดสอบ เลือกชุดโปรแกรมทดสอบจากเมนูแบบเลื่อนลงชื่อ แล้วคลิกขั้นตอนถัดไป จากนั้นเลือกอุปกรณ์ที่ต้องการทำการทดสอบ แล้วคลิกเพิ่มการกำหนดค่า คุณสามารถเพิ่มการกำหนดค่าหลายรายการสำหรับแผนการทดสอบแต่ละแผนได้

กำหนดค่าการเรียกใช้การทดสอบ

รูปที่ 23 กำลังกำหนดค่าการดำเนินการทดสอบ

เพิ่มการทำงานของอุปกรณ์

เพิ่มการดำเนินการของอุปกรณ์ที่ต้องการให้ดำเนินการก่อนการทดสอบแต่ละครั้ง ดูรายละเอียดเพิ่มเติมได้ที่การเพิ่มการดำเนินการของอุปกรณ์

เพิ่มการทำงานของอุปกรณ์

รูปที่ 24 กำลังเพิ่มการดำเนินการของอุปกรณ์

ตั้งค่าแหล่งข้อมูลการทดสอบ

การเพิ่มทรัพยากรการทดสอบลงในแผนการทดสอบจะเหมือนกับการเพิ่มทรัพยากรลงในการทดสอบแต่ละครั้ง ดูรายละเอียดเพิ่มเติมได้ที่การตั้งค่าทรัพยากรทดสอบ

ตั้งค่าแหล่งข้อมูลการทดสอบ

รูปที่ 25 กำลังตั้งค่าทรัพยากรการทดสอบ

ดูการเรียกใช้การทดสอบ

รายการการรันเพื่อทดสอบ

ดูรายการการทดสอบที่กำหนดเวลาไว้ในหน้าการทดสอบ คลิกดูเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับการทดสอบการเรียกใช้

นอกจากนี้ คุณยังกรองรายการได้โดยป้อนสตริงลงในแถบตัวกรอง แล้วกดแป้น Enter คุณใช้ตัวกรองหลายรายการได้โดยคั่นด้วยคอมมา ตัวกรองจะแสดงผลแถวทั้งหมดที่มีข้อความตรงกันทุกประการ (ไม่มีการจับคู่สตริงย่อย) ในคอลัมน์ใดก็ได้ ยกเว้นสถานะและวันที่สร้าง

ตัวกรองที่ว่างเปล่าจะแสดงผลแถวทั้งหมด ปัจจุบันยังไม่มีวิธีกรองแถวที่มีค่าว่าง

รายการทดสอบการเรียกใช้

รูปที่ 26 รายการการรันเพื่อทดสอบ

รายละเอียดการรันเพื่อทดสอบ

คุณสามารถดูรายละเอียดของการทดสอบได้ที่นี่ เช่น สถานะ บันทึก และผลลัพธ์

รายละเอียดการรันเพื่อทดสอบ

รูปที่ 27 รายละเอียดการทดสอบ

สถานะการรันเพื่อทดสอบ

ความคืบหน้าของการทดสอบจะแสดงในส่วนสถานะ หากมีข้อความที่เกี่ยวข้อง เช่น ความคืบหน้าในการดาวน์โหลด เหตุผลการยกเลิก หรือข้อความแสดงข้อผิดพลาด ข้อความดังกล่าวจะแสดงที่นี่ด้วย

สถานะการวิ่งทดสอบ

รูปที่ 28 สถานะการทดสอบการเรียกใช้

สถานะการเรียกใช้การทดสอบมีดังนี้

  • รอดำเนินการ - กำลังดาวน์โหลดทรัพยากรที่จำเป็น
  • อยู่ในคิว - การทดสอบพร้อมที่จะทำงานเมื่ออุปกรณ์พร้อมใช้งาน
  • กำลังทำงาน - การทดสอบกำลังทำงานบนอุปกรณ์ที่จัดสรรไว้
  • เสร็จสมบูรณ์ - การทดสอบเสร็จสมบูรณ์และรายงานผลแล้ว
  • ยกเลิกแล้ว - ผู้ใช้ยกเลิกการทดสอบหรือหมดเวลาขณะพยายามค้นหาอุปกรณ์ที่พร้อมใช้งาน
  • ข้อผิดพลาด - เกิดข้อผิดพลาดที่ทำให้การทดสอบไม่ทำงาน

ยกเลิกการรันเพื่อทดสอบ

หากการทดสอบยังไม่เสร็จสมบูรณ์ คุณสามารถยกเลิกได้โดยคลิกยกเลิก แล้วคลิกใช่ในกล่องโต้ตอบเพื่อยืนยัน นอกจากนี้ ระบบจะยกเลิกการเรียกใช้การทดสอบโดยอัตโนมัติหากยังคงอยู่ในสถานะอยู่ในคิวนานกว่าช่อง queue_timeout_seconds การยกเลิกการทดสอบขณะอยู่ในสถานะกำลังทำงานอาจใช้เวลา 2-3 นาทีจึงจะมีผล

ยกเลิกการรันเพื่อทดสอบ

รูปที่ 29 กำลังยกเลิกการทดสอบ

ผลการรันเพื่อทดสอบ

หลังจากที่การทดสอบเสร็จสิ้นแล้ว ระบบจะรวบรวมและแสดงผลลัพธ์ คุณดูรายละเอียดเพิ่มเติมได้โดยคลิกลูกศรสำหรับการเรียกใช้แต่ละครั้ง คลิกดูไฟล์เอาต์พุตเพื่อดูอาร์ติแฟกต์การทดสอบที่รวบรวมไว้ เช่น test_result.xml และ test_result_failures.html

ผลการรันเพื่อทดสอบ

รูปที่ 30 ผลการทดสอบการเรียกใช้

คุณดูบันทึกของโฮสต์และ Tradefed แบบเรียลไทม์ได้ในแท็บบันทึก

บันทึกการรันเพื่อทดสอบ

รูปที่ 31 แท็บบันทึก

ผลลัพธ์ของแต่ละโมดูลจะอยู่ในแท็บผลการทดสอบ

แท็บผลการทดสอบ

รูปที่ 32 แท็บผลการทดสอบ

คุณสามารถดาวน์โหลดไฟล์ที่ใช้เป็นแหล่งข้อมูลทดสอบได้โดยคลิกเปิดในแท็บแหล่งข้อมูลทดสอบ

แท็บแหล่งข้อมูลการทดสอบ

รูปที่ 33 แท็บแหล่งข้อมูลการทดสอบ

หากต้องการดูรายละเอียดของการเรียกใช้การทดสอบ เช่น 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 การจัดการไฟล์การกำหนดค่า

หลังจากดาวน์โหลดไฟล์การกำหนดค่าแล้ว ให้แชร์ไฟล์กับผู้ใช้รายอื่น โดยสามารถเพิ่มไฟล์การกำหนดค่าลงในอินสแตนซ์ OmniLab ATS ได้โดยคลิกนำเข้า แล้วเลือกไฟล์การกำหนดค่า

สร้างการดำเนินการใหม่ของอุปกรณ์

การดำเนินการของอุปกรณ์ใช้สำหรับการทำให้กระบวนการตั้งค่าอุปกรณ์เป็นแบบอัตโนมัติ การดำเนินการคือสคริปต์ที่ดำเนินการในอุปกรณ์แต่ละเครื่องที่การทดสอบทำงานอยู่ก่อนการเรียกใช้การทดสอบแต่ละครั้ง รวมถึงก่อนการลองใหม่ หากต้องการดูรายการการดำเนินการกับอุปกรณ์ที่พร้อมใช้งาน ให้ไปที่หน้าการตั้งค่า แล้วคลิกแท็บการดำเนินการกับอุปกรณ์ การดำเนินการกับอุปกรณ์หลายรายการได้รับการกำหนดค่าไว้แล้ว เช่น การรีบูตและการแฟลช

แท็บการดำเนินการของอุปกรณ์

รูปที่ 36 แท็บการดำเนินการกับอุปกรณ์

เพิ่มการทำงานใหม่ของอุปกรณ์

  1. คลิกการดำเนินการใหม่ของอุปกรณ์

    ปุ่มดำเนินการสำหรับอุปกรณ์ใหม่

    รูปที่ 37 ปุ่มดำเนินการของอุปกรณ์ใหม่

  2. ใส่ชื่อและคำอธิบาย

    ชื่อการทำงานของอุปกรณ์

    รูปที่ 38 ชื่อการทำงานของอุปกรณ์

  3. คลิกเพิ่มผู้จัดเตรียมเป้าหมาย

  4. ป้อนชื่อคลาสแบบเต็มของเครื่องมือจัดเตรียมเป้าหมาย Trade Federation เช่น com.android.tradefed.targetprep.RunHostCommandTargetPreparer

    เพิ่มผู้จัดเตรียมเป้าหมาย

    รูปที่ 39 การเพิ่มเครื่องมือเตรียมเป้าหมาย

    ดูรายการเครื่องมือเตรียมเป้าหมายที่ใช้ได้ในข้อมูลอ้างอิง com.android.tradefed.targetprep

    รายการผู้เตรียมเป้าหมาย

    รูปที่ 40 รายการผู้จัดเตรียมเป้าหมาย

  5. เพิ่มตัวเลือกที่จะใช้กับเครื่องมือเตรียมการเป้าหมาย หากต้องการดูตัวเลือกที่ใช้ได้ ให้ตรวจสอบ targetprep เพื่อดูซอร์สโค้ดสำหรับผู้จัดเตรียมเป้าหมายแต่ละรายใน AOSP ดังนี้

    ตัวอย่างตัวเลือกการดำเนินการ

    รูปที่ 41 ตัวอย่างตัวเลือกการดำเนินการ

  6. หากต้องการเพิ่มตัวเลือก ให้คลิกเพิ่มตัวเลือกเครื่องมือเตรียมเป้าหมาย แล้วป้อนค่าที่จำเป็น

    ตัวอย่างคำสั่งการดำเนินการ

    รูปที่ 42 ตัวอย่างคำสั่งการดำเนินการ

  7. กำหนดทรัพยากรการทดสอบที่จำเป็นต่อการดำเนินการของอุปกรณ์ เช่น สร้างอิมเมจสำหรับการแฟลช หากต้องการเพิ่มคำจำกัดความของทรัพยากร ให้คลิกเพิ่มทรัพยากรทดสอบ แล้วกรอกข้อมูลในช่องที่ต้องกรอก หากทราบตำแหน่งของไฟล์ คุณสามารถระบุ URL การดาวน์โหลดเริ่มต้นได้โดยคลิกเรียกดู หากเครื่องมือเตรียมการเป้าหมายยอมรับไดเรกทอรีเป็นทรัพยากรการทดสอบ ให้เลือกคลายการบีบอัด จากนั้นระบุไดเรกทอรีปลายทางที่เกี่ยวข้องในไดเรกทอรีการทำงานชั่วคราวและชื่อไฟล์ที่จะคลายการบีบอัด หากไม่ได้ระบุชื่อไฟล์ ระบบจะคลายการบีบอัดไฟล์ทั้งหมดจากทรัพยากรทดสอบ

    แหล่งข้อมูลการทดสอบการดำเนินการ

    รูปที่ 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 ไดเรกทอรีเพิ่มเติมที่ต่อเชื่อมในที่เก็บไฟล์ในเครื่อง

เปิดใช้โหมดผู้ร่วมจัดการประชุมหลายคน

เมื่อใช้โหมดหลายโฮสต์ ผู้ใช้จะใช้โฮสต์ตัวควบคุม ATS เพียงรายการเดียวเพื่อจัดการอุปกรณ์และการทดสอบในโฮสต์ผู้ปฏิบัติงาน ATS หลายรายการได้

สถาปัตยกรรมโหมดหลายโฮสต์

รูปที่ 52 สถาปัตยกรรมโหมดหลายโฮสต์

  1. หากต้องการเริ่มใช้ตัวควบคุม ATS ให้ใช้คำสั่งต่อไปนี้

    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
    

หากเครือข่ายไม่อนุญาตให้โฮสต์สื่อสารกัน คุณต้องทำตามวิธีการตั้งค่าขั้นสูงด้านล่างใน ATS Worker

  1. เชื่อมต่อโฮสต์ทั้ง 2 รายการโดยใช้ SSH Tunnel เลือกพอร์ตสำหรับพอร์ตหลักและพอร์ตเซิร์ฟเวอร์ไฟล์ เช่น 9000 และ 9006

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. กำหนดค่าและเริ่ม ATS

    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
    

โปรแกรมล้างไฟล์

เครื่องมือล้างไฟล์เป็นงาน Cron ที่ทำงานทุกชั่วโมงเพื่อล้างไฟล์ตามการกำหนดค่าที่ผู้ใช้กำหนด ATS มีการกำหนดค่าเริ่มต้น 2 รายการเพื่อเก็บผลการเรียกใช้การทดสอบและลบไฟล์ชั่วคราว คู่มือนี้จะอธิบายวิธีปรับแต่งนโยบายและการกำหนดค่าเพื่อจัดการไฟล์อย่างมีประสิทธิภาพ

นโยบาย

นโยบายจะกำหนดการดำเนินการที่จะทำกับไฟล์หรือไดเรกทอรี และเกณฑ์ในการเลือกเป้าหมาย การดำเนินการที่ใช้ได้จะแสดงในตารางดังนี้

ประเภทการดำเนินการพารามิเตอร์
ARCHIVEremove_file: หาก true ให้นำไฟล์ออกหลังจากเก็บถาวร
DELETE

โดยเกณฑ์จะอิงตามแอตทริบิวต์ของไฟล์และข้อมูลระบบ เกณฑ์ที่ใช้ได้จะแสดงในตาราง

ประเภทของหลักเกณฑ์คำอธิบายพารามิเตอร์
LAST_MODIFIED_TIMEกรองไฟล์ตามวันที่และเวลาที่แก้ไขล่าสุดttl: ระบบรองรับการแสดงเวลาหลายรูปแบบ เช่น 10m, 2h, 7 days, 4w ดูรูปแบบที่รองรับได้ที่ pytimeparse
LAST_ACCESS_TIMEกรองไฟล์ตามวันที่และเวลาที่เข้าถึงล่าสุดเหมือนกับ LAST_MODIFIED_TIME
NAME_MATCHกรองไฟล์ตามชื่อโดยใช้นิพจน์ทั่วไปpattern: นิพจน์ทั่วไป เช่น [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip เพื่อจับคู่ไฟล์ ZIP ของผลลัพธ์
SYSTEM_AVAILABLE_SPACEทริกเกอร์การดำเนินการตามพื้นที่ว่างในระบบthreshold: ทริกเกอร์การดำเนินการเมื่อพื้นที่ว่างต่ำกว่าเกณฑ์ เช่น 200(B), 200KB, 200MB, 200GB, 2TB

นโยบายใหม่เกี่ยวกับเครื่องมือล้างไฟล์

รูปที่ 53 เพิ่มนโยบายเครื่องมือล้างไฟล์ใหม่

การกำหนดค่า

การกำหนดค่าจะรวมนโยบายอย่างน้อย 1 รายการเข้ากับไดเรกทอรีที่เฉพาะเจาะจง ระบบจะประมวลผลไฟล์และไดเรกทอรีภายในไดเรกทอรีที่ระบุตามนโยบายที่กำหนดไว้ ระบบจะใช้นโยบายตามลำดับที่ปรากฏในการกำหนดค่า

ไดเรกทอรีเป้าหมายทั้งหมดต้องอยู่ภายใต้ไดเรกทอรี /data หากการกำหนดค่าระบุไดเรกทอรีเป้าหมายเป็น logs ระบบจะตีความว่าเป็น /data/logs

แก้ไขการกำหนดค่าเครื่องมือล้างไฟล์

รูปที่ 54 แก้ไขการกำหนดค่าเครื่องมือล้างไฟล์

รีเซ็ต

การคลิกรีเซ็ตการตั้งค่าจะเปลี่ยนการกำหนดค่าเครื่องมือล้างไฟล์กลับเป็นสถานะเริ่มต้น การดำเนินการนี้จะล้างรายการที่กำหนดเองทั้งหมด

รีเซ็ตการตั้งค่าเครื่องมือล้างไฟล์

รูปที่ 55 รีเซ็ตการตั้งค่าเครื่องมือล้างไฟล์

การสนับสนุน

รายงานข้อบกพร่อง

การมีส่วนร่วมของคุณใน OmniLab ATS จะช่วยปรับปรุงการพัฒนาเครื่องมือ และเราต้องการความคิดเห็นจากคุณ ดูรายละเอียดเกี่ยวกับรุ่นล่าสุดได้ที่บันทึกประจำรุ่นของ OmniLab ATS หากต้องการรายงานข้อบกพร่องหรือเสนอคำแนะนำ โปรดส่งรายงานข้อบกพร่อง พาร์ทเนอร์ควรรายงานข้อบกพร่องหรือคำแนะนำโดยใช้ช่องทางของพาร์ทเนอร์