plainbox-run - מקוון בענן

תָכְנִית:

שֵׁם

plainbox-run - הפעל עבודת בדיקה

תַקצִיר

הפעלה רגילה [-h] [--לא אינטראקטיבית] [-n] [--אל תדכא פלט]
[-F FORMAT] [-p OPTIONS] [-o FILE] [-t TRANSPORT]
[--תחבורה-היכן לאן] [--אפשרויות תחבורה-אפשרויות]
[-T TEST-PLAN-ID] [-i PATTERN] [-x PATTERN] [-w WHITELlist]

תיאור

הפעל עבודת מבחן

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

1. נתח ארגומנטים של שורת הפקודה ובדוק אם יש הפעלה שניתן לחדש (ראה
המשך לְהַלָן). אם כן, הצע למשתמש אפשרות לחדש את אותה הפעלה. אם קורות החיים
הפעולה נכשלה לעבור למפגש המוקדמות הבא. לבסוף הצע ליצור חדש
מוֹשָׁב.

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

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

אם ההפעלה לא מתחדשת (נוצרה הפעלה חדשה), הגדר את לא שלם
דגל.

3. השתמש בבחירת העבודה (ראה בחירה משרות להלן) כדי לגזור את רשימת הריצה. השלב הזה
כולל פתרון תלות בעבודה וסידור מחדש של עבודות במידת הצורך.

4. עקוב אחר רשימת הריצה, בצע כל עבודה ברצף במידת האפשר. ניתן לעכב משרות
מביצוע על ידי תלות כושלת או נכשל (הערכה לתוצאה לא אמיתית)
ביטויי משאבים.

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

לפני ואחרי ביצוע עבודה כלשהי, מצב ההפעלה נשמר בדיסק כדי לאפשר חידוש
מעבודה שאיכשהו קורסת את המערכת או קורסת את Plainbox עצמה.

5. הסר את לא שלם דגל.

6. ייצא את מצב ההפעלה לפורמט הרצוי (ראה יצוא תוצאות) ולהשתמש
התחבורה הרצויה לשליחת התוצאות (ראה הובלה תוצאות).

7. הגדר את הוגש דגל.

בחירה משרות
Plainbox מציעה שני מנגנונים לבחירת משרות. ניתן להשתמש בשניהם בו זמנית, בשניהם
ניתן להשתמש מספר פעמים.

בחירה משרות עם דפוסי
המנגנון הראשון נחשף דרך ה --include-pattern תַבְנִית אפשרות שורת פקודה.
הוא מורה ל- Plainbox לעשות זאת בחר כל עבודה שהמזהה המלא שלה תואם את
הבעה רגילה תַבְנִית.

משרות שייבחרו כך יסודרו, במידת האפשר, לפי סדר הפיקוד
טיעוני קו. לדוגמה, הפעלת שורת הפקודה הבאה תפעיל את העבודה Foo
לפני הפעלת העבודה בָּר:
plainbox run -i '.*::foo' -i '.*::bar'

בחירה משרות עם רשימת לבן
המנגנון השני הוא ה --רשימה הלבנה רשימת הלבנים אפשרות שורת הפקודה. רשימות הלבנות (או
תוכניות בדיקה, שקצת יותר קל להתייחס אליהן). רשימות הלבנות הן קבצי טקסט פשוטים
מורכבת מרשימה של ביטויים רגולריים, זהים לאלו שניתן להעביר עם ה
-i אוֹפְּצִיָה.

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

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

2013.com.canonical.plainbox::stub/.*

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

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

לדוגמה, ניתן לקצר את אותו דפוס "stub/.*" ל:

בָּדָל/.*

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

נוצר משרות
Plainbox מציעה דרך ליצור משרות בזמן ריצה. יש לכך שני מניעים
תכונה.

מיידי בדיקות ל מְרוּבֶּה התקנים
הדוגמה הקלאסית היא בדיקה של החומרה (לדוגמה, כדי למנות את כל האחסון
מכשירים) ולאחר מכן שכפל כל אחת מהבדיקות הספציפיות לחנות כך שכל המכשירים יהיו
נבדק בנפרד.

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

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

יוצרים הורה-ילד עמותה
נישה יחסית ותכונה מדור קודם של עבודות שנוצרו היא להדפיס עותק מילולי של
הגדרות תפקיד קיימות מא מקומי הגדרת תפקיד על שם נושא בדיקה גנרי או
קטגוריה. למשל הגדרת התפקיד של Checkbox __אַלחוּט__ הדפסים, בעזרת
חתול (1), כל הגדרות התפקיד המוגדרות בקובץ wireless.txt.

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

המשך
Plainbox מציעה פונקציונליות של חידוש הפעלה ואילו הפעלה שהופסקה
(בין אם בכוונה או עקב תקלה) ניתן לחדש ולהמשיך למעשה
איפה זה הופסק.

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

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

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

יצוא תוצאות
Plainbox מציעה דרך לייצא את המצב הפנימי של הפגישה למצב שימושי יותר
פורמט לעיבוד נוסף.

בחירה יצואנים
ניתן לבחור את היצואן באמצעות ה --פורמט פלט פורמט אפשרות שורת הפקודה. רשימה
של יצואנים זמינים (שעשויים לכלול יצואנים של צד שלישי) ניתן להשיג על ידי מעבר
מה היא --פורמט פלט ? אוֹפְּצִיָה.

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

מהקופסה נתמכים היצואנים הבאים:

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

ג'סון
היצואן הזה יוצר מסמך JSON עם הייצוג הפנימי של ההפעלה
מדינה. זהו היצואן הרב-תכליתי ביותר והוא שימושי וקל לעיבוד נוסף.
זה לא קריא במיוחד עבור אדם אבל יכול להיות שימושי למדי עבור ניפוי באגים ברמה גבוהה
בלי צורך להשתמש ב-pdb ולהכיר את החלקים הפנימיים של Plainbox.

rfc822
יצואן זה יוצר מסמכים מעין-RFC822. זה די מוגבל ולא נעשה בו שימוש רב.
ובכל זאת, זה יכול להיות שימושי בנסיבות מסוימות.

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

xlsx
יצואן זה יוצר קובץ ‎.xlsx (פורמט XML עבור Microsoft Excel) עצמאי
מכיל דוח בדיקה הניתן לקריאה על ידי אדם. זה דומה לדוח HTML אבל זה כן
קל יותר לערוך. זה שימושי לתקשורת עם בני אדם אחרים ומכיוון שזה לגמרי
עצמאי ולא מקוון ניתן לשלוח אותו בדוא"ל או לארכיון.

זה תלוי בחבילת python3-xlsxwriter

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

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

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

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

אפשרויות היצואן הידועות מתועדות להלן:

ג'סון
with-io-log:
הנתונים המיוצאים יכללו את יומן הקלט/פלט המשויך לכל תוצאת עבודה.
הנתונים כלולים בצורת שלוש-טופל המקורית שלו, אלא אם כן אחד מה- סקווש-יו-לוג
or flatten-io-log נעשה שימוש גם באפשרויות.

יומני IO הם ייצוגים של הנתונים שנוצרו על ידי התהליך שנוצר מה-
פקודת מעטפת הקשורה לעבודות מסוימות.

squash-io-log:
בשימוש יחד עם עם-io-log אפשרות שהיא גורמת ל- Plainbox להשליך את הזרם
שם וחותמת זמן ופשוט לכלול רשימה של מחרוזות בינאריות מקודדות base64. זֶה
האפשרות שימושית יותר לשחזור "קובצי יומן" פשוטים

flatten-io-log:
בשימוש יחד עם עם-io-log אפשרות שהיא גורמת ל- Plainbox לשרשר את כולם
את הרשומות הנפרדות המקודדות base64 לתוך מחרוזת בינארית אחת גדולה מקודדת base64
מייצג את כל התקשורת שהתרחשה.

עם רשימת ריצה:
הנתונים המיוצאים יכללו את רשימת הריצה (רצף העבודות המחושבות מהרצוי
רשימת עבודה).

עם רשימת עבודה:
הנתונים המיוצאים יכללו את הרשימה המלאה של המשרות המוכרות למערכת

with-resource-map:
הנתונים המיוצאים יכללו את מפת המשאבים המלאה. משאבים הם תיעוד של
ערכות מפתח-ערך המשויכות לכל תוצאת עבודה עבור עבודות שיש בהן תוסף
סוג משאב. הם צפויים להיות מודפסים stdout על ידי כך משאב משרות ו
מנותחים ומאוחסנים על ידי Plainbox.

with-job-defs:
הנתונים המיוצאים יכללו חלק מהמאפיינים של כל הגדרת תפקיד. כַּיוֹם
קבוצה זו כוללת את השדות הבאים: חיבור, דורש, תלוי, הפקודה ו
תיאור.

עם קבצים מצורפים:
הנתונים המיוצאים יכללו קבצים מצורפים. קבצים מצורפים נוצרים מ stdout זרם
של כל עבודה עם סוג תוסף התקשרות. הקבצים המצורפים בפועל הם
מקודד base64.

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

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

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

machine-json:
מסמך ה-JSON שנוצר יהיה מינימלי (ללא כל רווח לבן אופציונלי).
עדיף להשתמש באפשרות זו אם התוצאה אינה מיועדת לקריאה על ידי בני אדם
מכיוון שהוא חוסך קצת מקום.

rfc822
לכל האפשרויות יש משמעות זהה ל- ג'סון יְצוּאָן: עם-io-log,
סקווש-יו-לוג, flatten-io-log, עם רשימת ריצה, עם-רשימת עבודה, עם-משאב-מפת,
עם-עבודה-defs, עם קבצים מצורפים, עם הערות, עם-עבודה-דרך, עם-עבודה-חשיש. היחיד
יוצא מן הכלל הוא machine-json אפשרות שאינה קיימת עבור היצואן הזה.

טֶקסט
אותו דבר כמו עם rfc822.

xlsx
with-sys-info:
הגיליון האלקטרוני המיוצא יכלול גליון עבודה המפרט את התקני החומרה המבוססים
על lspci, lsusb, udev וכו'.

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

עם תיאור-תפקיד:
הגיליון האלקטרוני המיוצא יכלול תיאורי עבודה בגיליון נפרד

עם קבצי טקסט:
הגיליון האלקטרוני המיוצא יכלול קבצי טקסט בגיליון נפרד

xml
שם הלקוח:
אפשרות זו מאפשרת ללקוחות לעקוף את שם היישום שמייצר את
מסמך XML. כברירת מחדל השם הזה הוא בוקס רגיל. כדי להשתמש באפשרות זו עברו
--אפשרויות פלט שם לקוח=שם אחר אפשרות שורת פקודה.

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

ניתן לבחור הובלה עם --תַחְבּוּרָה אוֹפְּצִיָה. שוב, כמו עם יצואנים, רשימה של
ניתן להשיג הובלות ידועות על ידי מעבר של --תַחְבּוּרָה ? אוֹפְּצִיָה. הובלות צריך א
כתובת אתר יעד שניתן לציין באמצעות ה- --תחבורה-לאן= אוֹפְּצִיָה. התחביר של
כתובת האתר משתנה לפי סוג התחבורה.

Plainbox מגיע מצויד בהובלות הבאות:

שיגור
תחבורה זו יכולה לשלוח את התוצאות המיוצאות באמצעות xml יצואן ל-Launchpad Hardware
מאגר מידע. זוהי תכונה מעט ידועה המוצעת על ידי https://launchpad.net/ אתר אינטרנט.

הסמכה
תחבורה זו יכולה לשלוח את התוצאות המיוצאות באמצעות xml יצואנית לקנוניקל
אתר הסמכה (https://certification.canonical.com).

הובלה זו אינה מועילה לאף אחד מלבד צוות הסמכת החומרה קנוניקל
ששומר גם על Plainbox ו-Checkbox אבל זה מוזכר כאן לשלמות.

אפשרויות

אופציונלי טיעונים:

--לא אינטראקטיבי
לדלג על מבחנים הדורשים אינטראקטיביות

-n, --ריצה יבשה
לא באמת מנהל את רוב העבודות

--אל תדחיק-פלט
אל תדחיק את הפלט של סוגים מסוימים של תוספי עבודה

-f, --פורמט פלט
שמור את תוצאות הבדיקה בפורמט שצוין (עבר ? לרשימת אפשרויות)

-p, --אפשרויות פלט
רשימה מופרדת בפסיקים של אפשרויות עבור מנגנון הייצוא (עבור ? לרשימה של
בחירות)

-o, --קובץ פלט
שמור את תוצאות הבדיקה ב-FILE שצוין (או ל-stdout אם FILE הוא -)

-t, --תַחְבּוּרָה
השתמש ב-TRANSPORT כדי לשלוח תוצאות לאנשהו (עבור ? לרשימה של אפשרויות)

אפשרויות אפשריות: ?

--תחבורה-לאן
לאן לשלוח נתונים באמצעות התחבורה שנבחרה

--אפשרויות תחבורה
רשימה מופרדת בפסיקים של אפשרויות מפתח-ערך (k=v) שיש להעביר לטרנספורט

-T, --תוכנית מבחן
טען את תוכנית הבדיקה שצוינה

-i, --include-pattern
כולל עבודות התואמות את הביטוי הרגולרי הנתון

-x, --exclude-pattern
אל תכלול עבודות התואמות את הביטוי הרגולרי הנתון

-w, --רשימה הלבנה
טען רשימת היתרים המכילה דפוסי ריצה

השתמש בהפעלה מקוונת ב-plainbox באמצעות שירותי onworks.net