checkbox-cli - מקוון בענן

תָכְנִית:

שֵׁם

checkbox_ng - תיעוד של CheckboxNG

CheckboxNG הוא כלי לבדיקת חומרה שימושי לאישור מחשבים ניידים, שולחניים ושרתים
עם אובונטו. זוהי גרסה חדשה של Checkbox הבנויה ישירות על גבי PlainBox

CheckboxNG מחליף תיבת סימון, במידת הצורך.

אזהרה:
התיעוד נמצא בפיתוח. יש דברים שגויים, לא מדויקים או מתארים
יעדי פיתוח ולא המצב הנוכחי.

התקנה

ניתן להתקין את CheckboxNG מ-PPA (מומלץ) או pypi ב-Ubuntu Precise (12.04) או
חדש יותר.

$ sudo add-apt-repository ppa:checkbox-dev/ppa && sudo apt-get update && sudo apt-get install checkbox-ng

רץ יציב שחרור עדכון בדיקות

ל-CheckboxNG יש תמיכה מיוחדת להפעלת בדיקות עדכוני מהדורות יציבות במכשיר אוטומטי
דֶרֶך. זה מפעיל את כל העבודות מ- sru.whitelist ושולח את התוצאות ל-
אתר הסמכה.

כדי להפעיל בדיקות SRU תצטרך לדעת את מה שנקרא Secure ID של המכשיר שאתה
בדיקה. ברגע שאתה יודע שכל מה שאתה צריך לעשות זה להריץ:

$ checkbox sru $secure_id submission.xml

הארגומנט השני, submission.xml, הוא שם של קובץ ה-fallback שנוצר רק
כאשר שליחת הנתונים לאתר ההסמכה לא מצליחה מכל סיבה שהיא.

דיווח באגים

כדי לדווח על באגים בפרויקט Checkbox תזדקק לחשבון launchpad. אולי תמצא
הוראות on אֵיך ל לִיצוֹר אחד <https://help.launchpad.net/YourAccount/NewAccount>
מוֹעִיל. ברגע שיש לך חשבון אתה יכול לדווח באגים <https://bugs.launchpad.net/checkbox-
project/+filebug>.

בעמוד זה תוכל לבחור את הפרויקט שבו ברצונך להגיש את הבאג (אנו משתמשים במספר של
פרויקטים לתיאום מהדורות ואנו מעדיפים שיהיו באגים הקשורים למתאים
חלק מ-Checkbox). אם אתה מכיר את הפרויקט הנכון לשימוש, פשוט השתמש בו ותגיש את הבאג. אם
אתה לא כל כך מכיר את ה-Checkbox הפנימיות או שאתה בספק, פשוט תייק את זה על הבסיס
פרויקט 'Checkbox' (תוכל להשתמש זֶה ישיר קישור
<https://bugs.launchpad.net/checkbox/+filebug>.) חבר בצוות הפיתוח יעשה זאת
סקור את הבאג שלך והקצה אותו מחדש למיקום המתאים. מספר הבאג לא
לשנות כשזה קורה.

LA תיבת ביקורת לַעֲרוֹם

מחסנית הצ'קבוקס היא אוסף של פרויקטים שיחד מהווים בדיקה מלאה
ופתרון הסמכה. הוא מורכב מהחלקים הבאים (ראה טבלה למטה עבור
פרטים נוספים). כל הפרויקטים מקושרים מ- Launchpad פּרוֹיֶקט קבוצה
<https://launchpad.net/checkbox-project>.

אדריכלות תרשים
[תמונה: דיאגרמת אדריכלות] [תמונה]

תרשים זה מכיל קירוב ברמה גבוהה של ארכיטקטורת Checkbox הנוכחית.
ישנם שלושה "עמודים" עיקריים. בצד שמאל יש לנו סוף מוצרים. אלה כלים ממשיים
שההסמכה והמהנדסים משתמשים בה. בצד ימין יש לנו את מבחן שוק. זה
שוק פתוח של ספקי בדיקות וספקים. הבדיקות עטופות במיכלים הידועים בשם
ספקים. במרכז יש לנו שלושה מרכיבים משותפים. אלה מיישמים את עיקר ה
מסגרת וממשקי משתמש לביצוע בדיקות. סוף סוף בפינה השמאלית התחתונה שם
הוא חלק מתיבת סימון (ספרייה) המשותף עם HEXR עבור משימות מסוימות. HEXR הוא א
יישום אינטרנט מחוץ לתחום המשמש חלק מתהליך ההסמכה. חיצים מרמזים
תקשורת עם צורת החץ מראה מי קורא למי.

כאמור, בעמודה המרכזית ישנם שלושה מרכיבים עיקריים של קוד משותף
(משותף לכל המשתמשים במוצרי הקצה הנדונים להלן). הקוד המשותף הוא
מורכב מ-plainbox, checkbox-ng ו-checkbox-gui. אחריות המרכיבים הם
נדון ביתר פירוט בטבלה שלהלן. כאן אנו יכולים לראות ש-checkbox-gui השתמש ב-DBus
API נחשף על ידי checkbox-ng, אשר בתורו משתמש ב-checkbox-support (ספריית עוזר
מופרדים אז שתפו קצת קוד עם HEXR) ו-plainbox.

בעמודה הימנית יש ספקי בדיקה שונים. פרויקט תיבת הסימון הוא
ייצור ותחזוקה של מספר ספקים (ראה טבלה למטה) אבל זה צפוי
שהמשתמשים במורד הזרם שלנו יפיקו גם ספקים משלהם (ספציפיים ללקוח או
פּרוֹיֶקט). בסופו של דבר חלק מהספקים עשויים להגיע מצדדים שלישיים שיאמצו את ה
פורמט.

לבסוף בפינה השמאלית התחתונה, הספרייה המשותפת, ספרייה זו מכילה מנתחים רבים
של פורמטים שונים של קבצים ותבניות פלט. מבחינה טכנית ספריה זו היא תלות של
HEXR, checkbox-ng ו של ספקים. בתור מורכבות נוספת יש לקרוא לספרייה
מקוד python3 וקוד python2.

הערה:
התקשורת בין checkbox-ng ל-plainbox היא דו-כיוונית. Plainbox מציע
כמה ממשקי בסיס ונקודות הרחבה. כולם נחשפים דרך plainbox
(באמצעות ממשקי API נפוצים) אך חלקם מיושמים בפועל ב-checkbox-ng.

אזהרה:
כל ממשקי ה-API הפנימיים אינם יציבים למחצה. ה-API של DBus יציב יותר בפועל אבל צריך
לא ניתן לסמוך עליו. מומלץ למזג פרויקטים לתוך lp:checkbox שבו API
ניתן לטפל במעברים בחן. ה-API היציב היחיד הוא פורמט הקובץ
מפרט (הגדרות עבודה ואורות לבן). מפרט המשגר ​​יהיה
התייצב במהדורה הבאה.

רכיב תיאורים
┌─────────────────────────┬─────────────────────── ──────────────────┬───────────────────────
│פרויקט │ אחראי על │ סוג │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│ תיבת סימון הדור הבא │ │ יישום │
│(GUI) │ · ה-C++/QML │ │
│ │ ממשק משתמש │ │
│ │ │ │
│ │ · הגרפי │ │
│ │ משגר עבור │ │
│ │ ספקים, למשל │ │
│ │ תיבת סימון-אישור-לקוח │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│ תיבת סימון הדור הבא │ │ יישום │
│(CLI) │ · שורת הפקודה python │ │
│ │ ממשק │ │
│ │ │ │
│ │ · ממשק המשתמש בטקסט │ │
│ │ │ │
│ │ · פקודת בדיקת SRU │ │
│ │ │ │
│ │ · ממשקי API נוספים להסמכה │ │
│ │ │ │
│ │ · שליחת נתונים ל-Launchpad │ │
│ │ │ │
│ │ · שליחת נתונים אל HEXR │ │
│ │ │ │
│ │ · שירות ה-DBus הדרוש על ידי │ │
│ │ GUI │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────

│ אישור לקוח │ │ ספק │
│ספק │ · קנוני-אישור-לקוח │ │
│ │ בר הפעלה │ │
│ │ │ │
│ │ · הסמכת לקוח │ │
│ │ רשימות הלבנות │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│הסמכת שרת │ │ ספק │
│ספק │ · הסמכת שרת │ │
│ │ רשימות הלבנות │ │
│ │ │ │
│ │ · רשימות היתרים נוספות של שרתים │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│ שרת מערכת על שבב │ │ ספק │
│ספק הסמכה │ · הסמכת שרת SoC │ │
│ │ רשימות הלבנות │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│ספק תיבת סימון │ │ ספק │
│ │ · כמעט כל הגדרות התפקיד │ │
│ │ │ │
│ │ · רוב ה"סקריפטים" המותאמים אישית │ │
│ │ │ │
│ │ · ברירת מחדל ורשימת הלבנים של SRU │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│ספק משאבים │ │ ספק │
│ │ · כמעט כל משרות המשאבים │ │
│ │ │ │
│ │ · כמעט כל המשאבים "סקריפטים" │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│תמיכה בתיבת סימון │ │ ספרייה │
│ │ · קוד תמיכה למגוון │ │
│ │ ספקים │ │
│ │ │ │
│ │ · מנתחים לפורמטים רבים של טקסט │ │
├─────────────────────────┼─────────────────────── ──────────────────┼────────────────────────
│PlainBox │ │ ספרייה ופיתוח │
│ │ · כמעט כל לוגיקה הליבה │ ערכת כלים │
│ │ │ │
│ │ · RFC822 (הגדרת תפקיד) │ │
│ │ מנתח │ │
│ │ │ │
│ │ · טיפול בתצורה │ │
│ │ │ │
│ │ · פגישת בדיקה │ │
│ │ (השעיה/המשך) │ │
│ │ │ │
│ │ · רץ עבודה │ │
│ │ │ │
│ │ · משגר מהימן │ │
│ │ │ │
│ │ · פותר תלות │ │
│ │ │ │
│ │ · טיפול בשורת הפקודה │ │
│ │ │ │
│ │ · ה-XML, HTML ו-XSLX │ │
│ │ יצואנים │ │
│ │ │ │
│ │ · ועוד... │ │
│ │ │ │
│ │ · ערכת כלים לפיתוח ספק │ │
│ │ │ │
│ │ · 'ספק startbox רגיל' │ │
│ │ │ │
│ │ · יישום 'manage.py' │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────

│תיבת סימון מדור קודם (לא │ │ יישום מונוליטי │
│ שמור יותר) │ · יישומים │ ספרייה ונתונים │
│ │ │ │
│ │ · Qt4 GUI │ │
│ │ │ │
│ │ · Gtk2 GUI │ │
│ │ │ │
│ │ · Urwid (טקסט) GUI │ │
│ │ │ │
│ │ · ליבה │ │
│ │ │ │
│ │ · תוסף ואירוע / הודעה │ │
│ │ מנוע │ │
│ │ │ │
│ │ · כמעט כל תכונה │ │
│ │ הטמיע תוסף ליבה │ │
│ │ │ │
│ │ · נתונים │ │
│ │ │ │
│ │ · משרות ורשימות הלבנים │ │
└─────────────────────────┴─────────────────────── ──────────────────┴──────────────────────────

CHANGELOG

הערה:
יומן שינויים זה מכיל רק סיכום של שינויים. לחשבונאות מדויקת יותר של
היסטוריית פיתוח אנא בדוק את היסטוריית המקור ישירות.

CheckboxNG 0.23 (לא פורסם)
· תיקוני באגים: https://launchpad.net/checkbox-ng/+milestone/0.23

CheckboxNG 0.22
· תיקוני באגים: https://launchpad.net/checkbox-ng/+milestone/0.22

CheckboxNG 0.3
· תיקוני באגים: https://launchpad.net/checkbox-ng/+milestone/0.3

CheckboxNG 0.2
· תיקוני באגים: https://launchpad.net/checkbox-ng/+milestone/0.2

CheckboxNG 0.1
· שיחרור ראשוני

· תמיכה בהצגת תצורה

· תמיכה בהפעלת מבחני SRU (בדיקות רגרסיה אוטומטיות)

מבחן סקריפטים

'סקריפטים' למבחן הם תוכנות קטנות המשמשות כדי לסייע ביישום בדיקות.

בדיקת_בהירות
סקריפט זה בודק את הבהירות של התאורה האחורית של המערכות ניתן לשנות באמצעות
ממשקי ליבה ב-/sys/class/backlight. ייתכן שיש יותר מממשק אחד לבחירה
מ, כך שהממשק הנכון לשימוש נבחר באמצעות ההיוריסטיקה שנקבעה ב
https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-class-backlight. הבהירות
מטופל על ידי עדכון קובץ הבהירות של הממשק וה-actual_brightness
הקובץ נבדק כדי לראות אם הערך שונה לבהירות שנבחרה.

פרופילים תְצוּרָה

פרופילי ביצוע, או משגרים, מאפשרים לציין קבוצה מוגדרת מראש של תצורה
אפשרויות המאפשרות התאמה אישית של מסך הפתיחה, רשימות הלבנים המוצגות וכן
שמירת תוצאות באופן מקומי או שליחת קובץ ההגשה ל-Launchpad או לאישור
מסד נתונים/HEXR, כמו גם כמה פרמטרים אחרים.

הגדרות הפרופיל הן חלק מסקריפט למפעיל ומשתמשות ב-checkbox-gui או
checkbox-launcher (במצב טקסט/CLI) כשבנג לפירוש המפתח/ערכים.

מסמך זה מספק התייחסות לפונקציונליות ותחביר של משגר. כדי להבין את
עיצוב ומושגים ולראות מספר דוגמאות, מומלץ לקרוא את הדרכה על איך
ליצור משגרים והקשר שלהם עם תיבת סימון מדור קודם.

תחביר
מכיוון ש-checkbox-gui הוא יישום Qt, ההגדרות חייבות לפעול לפי הכללים בסגנון INI של
הגדרות Q <http://qt-project.org/doc/qt-5/QSettings.html> כיתה.

ערכי מרובות שורות נתמכים אך חייבים להיות מוקפים במירכאות כפולות ושורות נוספות
חייב להתחיל ברווח אחד, למשל:

[קטגוריה]
key = "שלום
עוֹלָם"

· מתוך QML:

settings.value("category/key", i18n.tr("default_value"))

· מ-C++:

settings->value("קטגוריה/מפתח", app.tr("default_value"))

לעומת זאת, משגרים ספציפיים לתיבת סימון חייבים לעקוב פיתון ConfigParser
<https://docs.python.org/3/library/configparser.html#supported-ini-file-structure> תחביר.

כמו כן, הגדרות מסוימות הגיוניות רק עבור GUI או CLI, ולכן אינן מובנות על ידי
האחר. אלה מצוינים להלן.

נתמך הגדרות
ברוך הבא/כותרת
כותרת יישום QML וכותרת מסך פתיחה. ברירת מחדל ל מערכת בדיקות.

ברוך הבא/טקסט
הודעת פתיחה שתוצג במסך הראשון (תיבת סימון-gui תומך בטקסט עשיר
המאפשר סימון בסגנון HTML). ברירת מחדל ל ברוך הבא ל מערכת בדיקה. [...]

suite/whitelist_filter
ביטוי רגולרי כדי להתאים לקבוצת משנה של שמות קבצים ברשימת ההיתרים. ב-checkbox-gui it
ברירת מחדל ל .*. ל-checkbox-launcher אין לו ברירת מחדל ו צריך להיות מוגדרים.

suite/whitelist_selection
דפוס שרשימות הלבנים צריכות להתאים כדי להיבחר מראש. ביטוי רגולרי של Python.
אין לו ברירת מחדל ו צריך להיות מוגדר. (CLI בלבד)

חבילה/דלג על_בחירה_לבנה
אם מוגדר כ-true, המשתמש לא יקבל בחירה ברשימת היתרים. רק הנבחרים מראש
אלה (ראה רשימה_לבינה) ייבחרו. (CLI בלבד).

suite/skip_test_selection
אם מוגדר כ-true, המשתמש לא יורשה לבטל את בחירת הבדיקות לפני ההפעלה: כל הבדיקות
ברשימת ההיתרים שנבחרה יופעל. (CLI בלבד)

הגשה/הודעה
טקסט הכותרת של חלון ההגשה הקופץ , המוצג למשתמש לאחר ההגשה
הושלם. (GUI בלבד)

submission/input_type
הצג שדה קלט טקסט כדי להזין את המזהה המאובטח או את כתובת ה-LP (ברירת מחדל). ל
פשוט שמור את התוצאות בדיסק, חייב להשתמש ב- אף לא אחד ערך. כדי לאמת באמצעות ביטוי רגולרי,
חייב להיות regex. (GUI בלבד)

הגשה/רגקס
ביטוי רגולרי לאימות קלט בשדה ההגשה (למשל, אימייל, secure_id)
אם input_type הוא ביטוי רגיל. (GUI בלבד). RegExpValidator, ברירת מחדל .*

submission/input_placeholder
טקסט זמני להכנסת שדה הקלט, משמש להנחיית המשתמש. Launchpad אימייל 
כתובת (ברירת מחדל) או לאבטח ID (15 or 18 דמויות). (GUI בלבד)

submission/secure_id
מוגדר מראש ל-secure_id למילוי שדה הטקסט.

submission/ok_btn_text
התווית של כפתור "שלח". חפש תוצאות (ברירת מחדל) או שמור תוצאות. (GUI
בלבד)

submission/cancel_warning
הראה למשתמש אם הוא רוצה לצאת מבלי ששמר את הדוח. אתה לקראת
כדי לצאת מהרצת הבדיקה הזו מבלי לשמור את דוח התוצאות שלך. האם אתה רוצה לשמור את
להגיש תלונה? (GUI בלבד)

submission/submit_to_hexr
בוליאנית, הוסף כותרת נוספת כדי לשלוח גם את התוצאות ל-HEXR (עובד עם
הובלת הסמכה)

exporter/xml_export_path
מיקום לשמירת קובץ הגשת ה-XML, אם מוגדר למחרוזת ריקה יפתח א
דו-שיח של שמירת קובץ. בְּרִירַת מֶחדָל: /tmp/submission.xml (GUI בלבד)

transport/submit_to
נקודת קצה תחבורה. ברירת מחדל ל . תומך בהגשה ל-LP (ברירת המחדל,
ערך שיגור), הסמכה, או מקומי (שמור לדיסק)

transport/submit_url
כתובת אתר להגשת תוצאות. זה מאפשר להעלות לאתרים שונים, למשל
זה יכול להעלות ישירות אל hexr, או לאתרי ההיערכות. משמש רק עם
הסמכה submit_to value.

transport/config_filename
שם של קובץ תצורה מותאם אישית לטעינה. קבצי תצורה משמשים בעיקר להגדרה
משתני סביבה. (CLI בלבד)

transport/dont_suppress_output
אם הוגדר, משאבים, משרות מקומיות וקבצים מצורפים יועברו למסך, זה
מייצר הרבה טקסט ומיועד בעיקר לניפוי באגים. (CLI בלבד)

CHECKBOX/PLAINBOX משיקים הדרכה

מסמך זה מספק הסבר מדוע יש צורך במשגרים, מה אתה יכול להשיג
איתם, ועובר על מספר דוגמאות כדי לתאר טוב יותר את היכולות שלהם. למשך
התייחסות מפורטת לאילו הגדרות נתמכות על ידי משגרים, ותחביר ספציפי עבור
קבצי משגר, תסתכל על /profiles.

מוֹרֶשֶׁת תיבת סימון התנהגות לִשְׁלוֹט
בעבר, ההתנהגות של צ'קבוקס נשלטה על ידי שלושה מנגנונים.

ראשית, ניתן להגדיל את הפונקציות של תיבת הסימון על ידי הוספת תוספים. לדוגמה, ה
היכולת להגיש לאתר הסמכה נוספה על ידי חבילת תיבת האישורים
באמצעות תוסף. התוספים הכלולים על ידי אישור תיבת סימון ואשר מוסיפים התנהגות חדשה
תיבת הסימון לבסיס היו:

/usr/share/checkbox-certification/plugins/certify_message.py
/usr/share/checkbox-certification/plugins/submission_info.py
/usr/share/checkbox-certification/plugins/backup.py
/usr/share/checkbox-certification/plugins/certify_prompt.py
/usr/share/checkbox-certification/plugins/certify_report.py
/usr/share/checkbox-certification/plugins/certify_schemas.py

אלה הוסיפו את הדרך לבקש מהמשתמש נתונים ספציפיים להגשה, ליצור את ה-xml
דוח ופונקציות אחרות.

לאחר מכן, ניתן להגדיר או לשלוט על התנהגויות התוספים באמצעות תצורה
קבצים, שהם "מדורגים". קובץ תצורה יכול לכלול אחרים ואלו יכולים בתורם
לכלול אחרים.

זוהי דוגמה לקובץ התצורה הראשי של project-qt.ini ספציפי לפרויקט. זה הראשון
קריאת קובץ כאשר הלקוח הספציפי לפרויקט מופעל. חלק מההגדרות מקוצרות:

[בְּרִירַת מֶחדָל]
כולל = %(checkbox_oem_share)s/configs/checkbox-project-base-qt.ini %(checkbox_project_share)s/configs/checkbox-project-base.ini

[checkbox/plugins/environment_info]
מאגרים = deb http://.*\(ארכיון\|אבטחה\).ubuntu.com/ubuntu precise-security
נתבים = מרובים
server_iperf = 10.20.30.40
sources_list = /etc/apt/sources.list
wpa_n_psk = סיסמה
wpa_n_ssid = נקודת גישה

[checkbox/plugins/user_interface]
title = הפרויקט שלי בדיקת מערכת

שימו לב לשורה כוללת, זו מורה לו לטעון את קובץ התצורה עבור
checkbox-project-base-qt ו-checkbox-project-base. Checkbox-project-base-qt טוען את
הגדרות עבור checkbox-certification ו-checkbox-project. ההגדרות מדורגות כך שה
אפשרויות התצורה שליד החלק העליון עוקפות את אלה ליד התחתון.

לבסוף, ה"בינארי" המשמש להפעלת תיבת הסימון היא סקריפט מעטפת המגדיר היכן למצוא
תיבת הסימון של הדברים צריכה לפעול: אתה יכול להגדיר ספריית שיתוף, נתונים ספציפיים
ספרייה, הצבע על קובץ תצורה והגדר כמה משתני סביבה שאתה
ייתכן שיהיה צורך במהלך הבדיקה. הנה דוגמה עבור checkbox-project-qt:

#!/ bin / bash
ייצוא CHECKBOX_DATA=${CHECKBOX_DATA:-~/. תיבת סימון}
ייצוא CHECKBOX_SHARE=${CHECKBOX_SHARE:-/usr/share/checkbox}
ייצוא CHECKBOX_OPTIONS=${CHECKBOX_OPTIONS:---log-level=debug --log=$CHECKBOX_DATA/checkbox-project.log}
ייצוא CHECKBOX_CERTIFICATION_SHARE=${CHECKBOX_CERTIFICATION_SHARE:-/usr/share/checkbox-certification}
ייצוא CHECKBOX_OEM_SHARE=${CHECKBOX_PROJECT_BASE_SHARE:-/usr/share/checkbox-project-base}
ייצוא CHECKBOX_PROJECT_SHARE=${CHECKBOX_PROJECT_SHARE:-/usr/share/checkbox-project}

# נוחות להגדרת ספריית PYTHONPATH.
if [ "$CHECKBOX_SHARE" != "/usr/share/checkbox" ]; לאחר מכן
ייצוא PYTHONPATH="$CHECKBOX_SHARE:$PYTHONPATH"
fi

python3 $CHECKBOX_SHARE/הפעל את "$@" $CHECKBOX_PROJECT_SHARE/configs/$(basename $0).ini

כאן אתה יכול לראות שהוא מגדיר כמה מיקומים וחלק חשוב הוא הפיתון הסופי3
שורה, שם הוא יאתר וישתמש בקובץ התצורה הדרוש .ini שראינו קודם לכן.

הארגון ההיררכי הזה היה חזק מאוד אבל גם היה קשה לטפל בו, ו
היו גם כמה מגבלות. חלק מהעבודה שעשינו עם תיבת הסימון הייתה לשלב את כל
תוספים ספציפיים לפרויקט לתוך מסגרת תיבת הסימון, כך כל קוד הליבה נמצא במקום אחד,
והגרסאות הספציפיות לפרויקט מספקות רק עבודות, רשימות היתרים, נתונים ותצורה,
מבלי להוסיף התנהגות חדשה.

חדש בוקס רגיל התנהגות לִשְׁלוֹט
שלא כמו תיבת סימון, הליבה של plainbox היא מונוליטית, ואין לה מושג של תוספים. זֶה
מקל על ההבנה והעבודה איתו. בליבת ה-plainbox יש יישומים לכולם
הפונקציות בחבילות הסימון הישנות, כך שאין צורך בתוספות כדי להשתמש בתכונות
כגון הגשה להסמכה או הפקת דוחות.

מה שאנו מכנים plainbox הוא הספרייה שמיישמת את כל הפונקציונליות, כפי שניתן לראות
כאן.

Plainbox מספקת כלים שיעזרו למפתחי בדיקות לכתוב ולחרוז בדיקות. אלו הם
נמסר ב"ספקים", שהם ישויות שנועדו לכלול תיאורי בדיקה,
סקריפטים מותאמים אישית לבדיקות, רשימות הלבנה ונתונים מגוונים. הם תוכננו כדי לאפשר
צוותים לכתוב ולהעביר את המבחנים המותאמים אישית שלהם מבלי לדאוג יותר מדי לגבי
קוד plainbox הבסיסי.

כדי לקבל מידע על איך לכתוב מבחנים וספקים, עיין במדריך הספק

עם זאת, כאשר למעשה השתמשנו בבדיקות אלה כדי לאמת מערכת אמיתית, רצינו לספק
משהו קל וקרוב יותר לחוויית המשתמש של תיבת הסימון. יצרנו שני לקוחות,
checkbox-gui ו-checkbox-cli, שהיו להם כמה התנהגויות מקודדות, וגם התחלנו
יצירת לקוחות אחרים שהתבססו על אלה אך היו ספציפיים למטרה. לדוגמה,
הייתה לנו גרסה של תיבת סימון לבדיקת SRU, גרסה אחרת לאישור שרת, וכן הלאה.

אבל אז הבנו שהרבה מהקוד היה משוכפל וההתנהגויות היו נפוצות
פרט לכמה שינויים. אז הגענו למושג "משגרים", שהם
דומה במקצת לקובצי התצורה של תיבת הסימון ולמפעילי הסקריפט של מעטפת.

הרעיון הוא של-checkbox-gui ו-checkbox-cli יש כמה התנהגויות בסיסיות מאוד, שכן הם
הם הלקוחות שנשלחים כברירת מחדל עם ubuntu. הם יכולים להראות את כל האפשרויות
רשימות הלבנים, הצג הודעת פתיחה מוגדרת מראש, ובסוף יאפשר למשתמש לראות את
html לדווח ולשלוח אותו ל- launchpad באמצעות כתובת הדואר האלקטרוני שלהם, בדומה לגרסה
של תיבת הסימון שנשלחה עם אובונטו.

במקום להשתמש בבוררי שורת פקודה מסובכים, משגרים מאפשרים לך להגדיר כמה
התנהגויות אופציונליות להתאמה אישית של חווית הבדיקה שלך. משגר מכיל הגדרות ו
דומה לסקריפט של מעטפת, אבל המתורגמן יהיה או checkbox-gui או
מפעיל תיבת סימון.

הנה כמה דוגמאות למה שניתן לעשות עם משגרים.

כהפתעה, checkbox-cli הוא עצמו משגר:

#!/usr/bin/env מפעיל תיבת סימון
[ברוך הבא]
text = ברוכים הבאים לבדיקת מערכת!
תיבת סימון מספקת בדיקות כדי לאשר שהמערכת שלך פועלת כהלכה.
לאחר שתסיים להפעיל את הבדיקות, תוכל לצפות בדוח סיכום עבור
המערכת שלך.
אזהרה: בדיקות מסוימות עלולות לגרום למערכת שלך לקפוא או להפוך
לא מגיב. נא לשמור את כל העבודה שלך ולסגור את כל שאר הריצה
יישומים לפני תחילת תהליך הבדיקה.

[לאחר]
whitelist_filter = ^default$
whitelist_selection = ^default$
skip_whitelist_selection = נכון

[תַחְבּוּרָה]
submit_to = משטח הפעלה

אתה יכול לראות כאן שאנחנו מתאימים אישית כמה אפשרויות: זה מציג הודעת פתיחה, באופן אוטומטי
בוחר ברשימת ההיתרים המוגדרת כברירת מחדל, וישלח ל-Launchpad כשתסיים.

דוגמה למפעיל גרפי היא canonical-certification-client.

#!/usr/bin/checkbox-gui

[ברוך הבא]
title = "אישור מערכת"
טקסט = " ברוכים הבאים להסמכת מערכת! יישום זה יהיה
לאסוף מידע מהמערכת שלך. לאחר מכן תתבקש לבצע בדיקות ידניות
לאשר שהמערכת פועלת כהלכה. לבסוף, תתבקשו
המזהה המאובטח של המחשב כדי לשלוח את המידע לאישור
מאגר מידע. כדי ללמוד כיצד ליצור או לאתר את המזהה המאובטח,
אנא ראה כאן: certification.canonical.com "

[לאחר]
whitelist_filter = "^client-(cert|selftest).*"

[כניעה]
input_type = "רגקס"
input_placeholder = "מזהה מאובטח (15 או 18 תווים)"
ok_btn_text = "שלח תוצאות"
submit_to_hexr = "true"

[יְצוּאָן]
xml_export_path = "/tmp/submission.xml"

[תַחְבּוּרָה]
submit_to = "אישור"

משגרים גרפיים הם קצת יותר מסובכים, אבל בעצם זה דומה, מה זה
מאפשר לך להגדיר כמה פרמטרים כדי להתאים אישית את חווית הבדיקה שלך.

משגר מצב טקסט פשוט מאוד הוא canonical-hw-collection שרק מריץ את הבסיס
בודק מידע חומרה ומעלה אותם למסד נתונים של חומרה:

[ברוך הבא]
title = איסוף מידע חומרה
טקסט = איסוף מידע חומרה. ייתכן שתתבקש להזין את הסיסמה שלך.
תהליך זה ייקח כ-30 שניות ותקבלו מידע
עם כתובת URL שדרכה תוכל לאשר ולרשום את החומרה שלך
הגשה.

[לאחר]
whitelist_filter = ^hwsubmit$
whitelist_selection = ^hwsubmit$
skip_whitelist_selection = נכון
skip_test_selection = נכון

[כניעה]
# מזהה בטוח_מזוייף מבטיח שלא נשאל אותו
# תמיד ניתן לעקוף אותו בקובץ .conf.
secure_id = 000

[תַחְבּוּרָה]
submit_to = אישור
submit_url = https://hardware-server.example.com/

לבסוף, canonical-driver-test-suite מספק גם משגר מצב גרפי וגם טקסט,
שהם מקבילים מבחינה תפקודית:

#!/usr/bin/checkbox-gui

[ברוך הבא]
title = "חבילת בדיקות נהג קנונית"
טקסט = " ברוכים הבאים לחבילת בדיקות הנהג הקנונית.

תוכנית זו מכילה בדיקות אוטומטיות וידניות כדי לעזור לך לגלות
בעיות שיתעוררו בעת הפעלת מנהלי ההתקן שלך על אובונטו.

אפליקציה זו תצעיד את המשתמש דרך הבדיקות הללו ב-a
סדר קבוע מראש ולאסוף אוטומטית גם מידע מערכת כמו
כמו גם תוצאות הבדיקה. זה גם יבקש מהמשתמש קלט כשהוא ידני
נדרשת בדיקה.

זמן הריצה של הבדיקות נקבע לפי הבדיקות שתחליט לעשות
לבצע. למשתמש תהיה הזדמנות להתאים אישית את ריצת הבדיקה
להתאים את הנהג ואת משך הזמן הפנוי לבדיקה.

כדי להתחיל, פשוט לחץ על הלחצן המשך למטה ופעל על המסך
הוראות. "

[לאחר]
whitelist_filter = "^ihv-.*"

[כניעה]
ok_btn_text = "שמור תוצאות"
input_type = "ללא"

[יְצוּאָן]
xml_export_path = ""

[תַחְבּוּרָה]
submit_to = "מקומי"

מצב טקסט:

#!/usr/bin/env מפעיל תיבת סימון
[ברוך הבא]
text = ברוכים הבאים לחבילת בדיקות הנהג של Canonical
תוכנית זו מכילה בדיקות אוטומטיות וידניות כדי לעזור לך לגלות
בעיות שיתעוררו בעת הפעלת מנהלי ההתקן שלך באובונטו.
אפליקציה זו תצעיד את המשתמש דרך הבדיקות הללו ב-a
סדר קבוע מראש ולאסוף אוטומטית גם מידע מערכת כמו
כמו גם תוצאות הבדיקה. זה גם יבקש מהמשתמש קלט כשהוא ידני
נדרשת בדיקה.
זמן הריצה של הבדיקות נקבע לפי הבדיקות שתחליט לעשות
לבצע. למשתמש תהיה הזדמנות להתאים אישית את ריצת הבדיקה
להתאים את הנהג ואת משך הזמן הפנוי לבדיקה.
כדי להתחיל, פשוט לחץ על הלחצן המשך למטה ופעל על המסך
הוראות.

[לאחר]
# רשימות הלבנים המוצגות במסך בחירת הסוויטות
whitelist_filter = ^ihv-.*
# Whitelist_selection הוא חובה ולכן הגדרנו אותו לערך מזויף כך
# אין רשימות היתרים שנבחרו מראש.
whitelist_selection = מזויף

תיבת ביקורת שחרור תהליך

דף זה מתאר את השלבים הדרושים לשחרור גרסאות של Checkbox ו-Checkbox
הסמכה ל-PPA היציב השייך לצוות הסמכת חומרה, באופן קבוע
בָּסִיס. בכל מסמך זה, המונח 'צ'קבוקס' משמש כמונח כולל לכיסוי
כל הגרסאות של Checkbox בבעלות צוות הסמכת החומרה, כרגע Checkbox
עצמו ותוספי אישור תיבת הסימון.

סקירה כללית
נכון לעכשיו, התהליך פועל בקצב דו-שבועי, עם מהדורה חדשה של Checkbox מדי פעם
שבועיים. זה מכסה עשרה ימי עבודה, ואת המשימות שבוצעו בכל יום או קבוצה של
ימים מתוארים להלן:

· ימים 1-4: הזמן המותר להכנסת שינויים חדשים לתא המטען.

· יום 5: השינויים מתמזגים מהתא המטען של lp:checkbox ו lp:checkbox-certification ל
סניפי השחרור שלהם. יומני השינוי של שניהם הם חבוטה בשלב זה ו
גרסאות מתויגות. בשלב זה ייתכן שיהיה צורך גם להעתיק את החבילה 'fwts'
מ FWTS יציב PPA <https://launchpad.net/~firmware-testing-team/+archive/ppa-
fwts-יציב> ל תיבת סימון לשחרר בדיקות PPA <https://launchpad.net/~checkbox-
dev/+archive/testing>.

· ימים 6-9: הבדיקה מתבצעת על ידי מנהל השחרור עבור הסמכת החומרה
צוות, ונציג של צוות CE QA (הלקוח הראשי של Checkbox בתוך
קנונית)

· יום 9: מתקיימת פגישת שחרור בין מנהל השחרור של החומרה
צוות הסמכה ונציג צוות CE QA. בעיות פוטנציאליות עם
שחרור מזוהים ומתכננים לטפל בהם.

· יום 10: הגרסה שנבדקה של Checkbox מועתקת ל-PPA היציב.

Launchpad סניפים
תהליך השחרור דורש סניפים נפרדים ב-Launchpad המכילים חצי קפוא
גרסה של הקוד שהייתה בתא המטען ביום החמישי של התהליך. זה כך ההתפתחות
יכול להמשיך על תא המטען מבלי לסכן את היציבות של הגרסה שעתיד לצאת
תיבת סימון. הקשר בין כל הענפים המעורבים בתהליך הוא כפי שמוצג להלן:

· lp:checkbox/release <- lp:checkbox

· lp:checkbox-certification/release <- lp:checkbox-certification

· lp:~checkbox-dev/checkbox/checkbox-packaging-release <-
lp:~checkbox-dev/checkbox/checkbox-packaging

ביקורת אבני דרך באגים
לפני יצירת המועמד לשחרור, מנהל השחרור צריך לעיין ברשימת הבאגים
אבן דרך עבור המהדורה הבאה של Checkbox. הם צריכים לבקר תיבת סימון אבני דרך
<https://launchpad.net/checkbox/+milestonesmilestones> ואתרו את אבן הדרך עם תאריך
תאריך השחרור.

· עבור באגים שמוגדרים ב-In Progress עם סניף משויך - צור קשר עם הסניף
הבעלים כדי לראות אם ניתן להשלים את המיזוג לפני המועד האחרון.

· עבור באגים שנמצאים בכל מצב אחר שאינו סגור (למעט לסדר מחויב) - אבן דרך מחדש
אותם לאבן הדרך הבאה.

גזירה מה היא לשחרר
על מנת לחתוך את השחרור, עלינו למזג את השינויים מ- trunk לתוך השחרור
סניף, שלח אותם בהודעה מתאימה ועדכן את ה-changelog ב-Trunk כך
שינויים עתידיים עוברים תחת הגרסה הנכונה. עבור כל שילוב של ענפים המוצגים למעלה,
בצע את הפעולות הבאות (הדוגמה משתמשת lp:checkbox ו lp:checkbox/release):

bzr branch lp:checkbox/release checkbox-release
bzr branch lp:checkbox checkbox-trunk
שחרור תיבת סימון CD
current_stable=`head -n1 $(find . -name 'changelog') | grep -oP '(?<=\().*(?=\))'`
bzr merge lp:checkbox

בשלב זה אם אין שינויים (מלבד אחד ל debian/changelog) להתמזג ואז נעשה זאת
לא לבצע שחרור של החבילה המדוברת. בפועל זה קורה לעתים קרובות עם
אישור תיבת סימון אבל אף פעם לא עם תיבת סימון:

bzr commit -m "מוזג בשינויים מ- rev$(bzr revno -r tag:$current_stable lp:checkbox) ל-rev$(bzr revno lp:checkbox) מ-lp:checkbox"
bzr push lp:checkbox/release
cd `מצא. -שם 'debian'`; תקליטור..
bzr tag `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
dch -r (שמור יומן שינויים שונה)
dch -i -U 'יומן שינויים מוגדל'
debcommit
bzr push lp:checkbox

השלב האחרון בתהליך הוא ביצוע בנייה של החבילות ב-
ppa:checkbox-dev/testing PPA. לשם כך עלינו לעבור לדפי המתכונים של
תיבת סימון ו / או אישור תיבת סימון לשחרר סניפים.

· בדיקת תיבת סימון מתכון <https://code.launchpad.net/~checkbox-dev/+recipe/checkbox-
בדיקות>

· תיבת סימון-אישור-בדיקות מתכון <https://code.launchpad.net/~checkbox-
dev/+recipe/checkbox-certification-testing>

אל האני לִבנוֹת עַכשָׁיו האפשרות צריכה להיות זמינה בדף. לחץ עליו כדי להתחיל לבנות.

הַעתָקָה הקושחה מִבְחָן סוויטה ל מה היא בדיקות PPA
כלי ה-Firmware Test Suite הוא כלי בדיקה עבור קושחת המערכת שמטבע הדברים היא כבדה
בשימוש על ידי Checkbox. כדי לוודא שהגרסה העדכנית ביותר המכילה תיקונים וחדשה
בדיקות/מאפיינים הדרושים ל-Checkbox זמינים וגם לא פורצים שום דבר
תיבת סימון, אנחנו צריכים לשחרר אותה לצד תיבת סימון. לאחר חיתוך השחרור אם ה
צוות בדיקת קושחה הודיע ​​שגרסה חדשה זמינה ושגרסה זו
צריך לשמש להסמכה, עלינו להעתיק אותו ל-Testing PPA. כדי לעשות זאת אנחנו
צריך ללכת ל העתק חבילות נוף of מה היא הקושחה מִבְחָן סוויטה (Stable) PPA
<https://launchpad.net/~firmware-testing-team/+archive/ppa-fwts-stable/+copy-packages> ו
בחר את החבילות 'fwts' עבור כל המהדורות חזרה ל-Precise. אנחנו צריכים להגדיר את
'Destination PPA' בתור 'Checkbox Release Testing [~checkbox-dev/testing]' וה-'Copy
בשדה אפשרויות' ל'העתק קבצים בינאריים קיימים', ולאחר מכן לחץ על 'העתק חבילות'. אז השלב הזה
יש לחזור על הפעולה אך הגדר את השדה 'יעד PPA' ל'PPA למפתחי תיבת סימון
[~checkbox-dev/ppa]'.

הַבָּא לשחרר of תיבת סימון דוא"ל
כך שלכל אחד תהיה הזדמנות לבצע את כל הבדיקות הנדרשות בזמן
באופן, לאחר השלמת בניית ה-PPA יש לשלוח אימייל לכתובת הבאה
רשימות תפוצה:

· [מוגן בדוא"ל] <חומרה-אישור-
[מוגן בדוא"ל]>

· [מוגן בדוא"ל] <[מוגן בדוא"ל]>

התוכן הוא בדרך כלל משהו כזה:

נושא: הגרסה הבאה של תיבת סימון (18/11/2013)

היי,

המהדורה הבאה של Checkbox זמינה ב-
https://code.launchpad.net/~checkbox-dev/+archive/testing PPA.
אנא בדוק את זה כשנוח לך. תיבת סימון מבוססת על גרסה 2484 של
lp:checkbox ו-Checkbox אישור מבוסס על גרסה 586 של
lp:checkbox-certification.

תודה,

אם זה או אחר של אישור תיבת סימון ותיבת סימון לא עודכנו אז
אין צורך להזכיר את החבילה הזו

בדיקות מה היא לשחרר
כעת, לאחר שהשחרור נחתך, יש לבצע בדיקות לפני פגישת השחרור.
מנקודת מבטו של צוות ההסמכה, מה שצריך לבדוק הוא
checkbox-certification-client ו checkbox-certification-server המהווים את הבסיס ל
CE QAS גרסאות OEM ספציפיות של Checkbox. שרת אישור תיבת סימון נבדק ב-
לקוח אישור לולאת CI צריך להיבדק באופן ידני.

לשחרר פְּגִישָׁה
ביום חמישי לפני ביצוע השחרור מתקיימת פגישה בין נציג מ
צוות ההסמכה ונציג של מסחרי הנדסה QA קְבוּצָה. ה
הפגישה מתקיימת בשעה 7:30 UTC כפי שמוצג כאן לוח שנה להזמין
<https://www.google.com/calendar/hosted/canonical.com/event?action=TEMPLATE&tmeid=Y3QxcWVla3ViMTRvMXByOHZlOTFvc283Y2NfMjAxMzA4MjlUMDczMDAwWiBicmVuZGFuLmRvbmVnYW5AY2Fub25pY2FsLmNvbQ&tmsrc=brendan.donegan%40canonical.com>.
סדר יום לפגישה כלול בהזמנה.

הוצאה לאור מה היא לשחרר
כדי לפרסם את המהדורה אנחנו פשוט צריכים להעתיק מספר חבילות מה- תיבת סימון
לשחרר בדיקות PPA <https://launchpad.net/~checkbox-dev/+archive/testing> ל חומרה
תעודה הציבור PPA <https://launchpad.net/~hardware-certification/+archive/public>.
לשם כך אנו הולכים ל- העתק חבילות נוף of מה היא תיבת סימון לשחרר בדיקות PPA
<https://launchpad.net/~checkbox-dev/+archive/testing/+copy-packages> ובחר הכל
גרסאות של רשימת החבילות הבאה: תיבת סימון, אישור תיבת סימון, fwts. עשה
ודא שהשדה 'יעד PPA' מוגדר ל'Public PPA עבור אישור חומרה
[~hardware-certification/public]' וכי השדה 'אפשרויות העתקה' מוגדר ל'העתק
קבצים בינאריים קיימים', ולאחר מכן לחץ על 'העתק חבילות'.

לאחר מכן יש לשלוח מייל הודעה אל
[מוגן בדוא"ל] <[מוגן בדוא"ל]>.
תבנית להכרזה הכלולה להלן:

היי,

מהדורה חדשה של תיבת סימון הועלתה לחומרה
אישור PPA ציבורי
(https://launchpad.net/~hardware-certification/+archive/public). ה
המהדורה מבוססת על גרסה 2294 של lp:checkbox

תודה,

אנא צרף את החלק העדכני ביותר של יומן השינויים כהערות שחרור

· Genindex

· modindex

· לחפש

השתמש ב-checkbox-cli באינטרנט באמצעות שירותי onworks.net