echo_supervisord_conf - מקוון בענן

תָכְנִית:

שֵׁם

echo_supervisord_conf - תיעוד תצורת מפקח

Supervisor היא מערכת לקוח/שרת המאפשרת למשתמשיה לנטר ולשלוט במספר
של תהליכים במערכות הפעלה דמויות UNIX.

זה חולק כמה מאותן מטרות של תוכניות כמו launchd, daemontools ו-runit. בניגוד
לחלק מהתוכניות הללו היא לא נועדה להיות כתחליף להן init בתור "מזהה תהליך
1". במקום זאת הוא נועד לשמש לשליטה בתהליכים הקשורים לפרויקט או א
לקוח, והוא אמור להתחיל כמו כל תוכנית אחרת בזמן האתחול.

תיעוד

יוצרים a תְצוּרָה שלח
לאחר השלמת התקנת ה-Supervisor, הפעל echo_supervisord_conf. זה יהיה
הדפס קובץ תצורה של Supervisor "לדוגמה" ל-stdout של המסוף שלך.

ברגע שתראה את הקובץ מהדהד למסוף שלך, הפעל מחדש את הפקודה as
echo_supervisord_conf > /etc/supervisord.conf. זה לא יעבוד אם אין לך שורש
גישה אליו.

אם אין לך גישת שורש, או שאתה מעדיף לא לשים את supervisord.conf קובץ ב
/etc/supervisord.conf`, אתה יכול למקם אותו בספרייה הנוכחית (echo_supervisord_conf >
supervisord.conf) והתחל מְפַקֵחַ עם -c דגל כדי לציין את
מיקום קובץ התצורה.

לדוגמה, מְפַקֵחַ -c supervisord.conf. משתמש ב -c הדגל למעשה מיותר ב
המקרה הזה, כי מְפַקֵחַ מחפש בספרייה הנוכחית עבור א supervisord.conf
לפני שהוא מחפש את הקובץ במיקומים אחרים, אבל זה יעבוד.

ברגע שיש לך קובץ תצורה במערכת הקבצים שלך, אתה יכול להתחיל לשנות אותו לקובץ שלך
טַעַם.

תְצוּרָה שלח
קובץ התצורה של המפקח נקרא בדרך כלל supervisord.conf. הוא משמש על ידי
שניהם מְפַקֵחַ ו מפקח. אם אחד מהאפליקציות מופעל ללא -c
option (האפשרות המשמשת כדי לומר לאפליקציה את שם קובץ התצורה
באופן מפורש), האפליקציה תחפש קובץ בשם supervisord.conf בתוך
המיקומים הבאים, בסדר שצוין. זה ישתמש בקובץ הראשון שהוא מוצא.

1. $CWD/supervisord.conf

2. $CWD/etc/supervisord.conf

3. /etc/supervisord.conf

4. ../etc/supervisord.conf (ביחס לקובץ ההפעלה)

5. ../supervisord.conf (ביחס לקובץ ההפעלה)

הערה:
חלק מההפצות כוללות את Supervisor עם התאמות אישיות משלהן. אלה
גרסאות ששונו של Supervisor עשויות לטעון את קובץ התצורה ממקומות אחרים
מאלה המתוארים כאן. יש לציין כי חבילות אובונטו נמצאו בשימוש
/etc/supervisor/supervisord.conf.

שלח פוּרמָט
supervisord.conf הוא קובץ בסגנון Windows-INI (Python ConfigParser). יש לו קטעים (כל אחד
מסומן על ידי א [כותרת]) וצמדי מפתח/ערך בתוך הקטעים. הסעיפים ושלהם
ערכים מותרים מתוארים להלן.

סביבה משתנים
משתני סביבה שקיימים בסביבה באותו זמן מְפַקֵחַ is
ניתן להשתמש ב-start בקובץ התצורה באמצעות תחביר ביטוי מחרוזת Python
%(ENV_X)s:

[תוכנית:דוגמה]
command=/usr/bin/example --loglevel=%(ENV_LOGLEVEL)s

בדוגמה למעלה, הביטוי %(ENV_LOGLEVEL)s יורחב לערך של
משתנה הסביבה LOGLEVEL.

הערה:
ב-Supervisor 3.2 ואילך, %(ENV_X)s ביטויים נתמכים בכל האפשרויות. ב
גרסאות קודמות, חלק מהאפשרויות תומכות בהן, אך רובן לא. עיין בתיעוד עבור
כל אפשרות למטה.

[unix_http_server] סעיף הגדרות
אל האני supervisord.conf הקובץ מכיל קטע בשם [unix_http_server] תחת אשר
פרמטרי תצורה עבור שרת HTTP שמאזין בשקע תחום UNIX צריכים להיות
מוּכנָס. אם לקובץ התצורה אין [unix_http_server] סעיף, תחום UNIX
שרת HTTP socket לא יופעל. ערכי התצורה המותרים הם כ
הבא.

[unix_http_server] סעיף ערכים
פילה
נתיב לשקע תחום UNIX (למשל /tmp/supervisord.sock) על איזה מפקח יהיה
האזן לבקשות HTTP/XML-RPC. מפקח משתמש ב-XML-RPC כדי לתקשר איתו
מְפַקֵחַ מעל הנמל הזה. אפשרות זו יכולה לכלול את הערך %(כאן)s, שמתרחב
לספרייה שבה מְפַקֵחַ נמצא קובץ תצורה.

בְּרִירַת מֶחדָל: אף אחד.

דרוש: לא.

הציג: 3.0

chmod
שנה את סיביות מצב הרשאת UNIX של שקע תחום UNIX לערך זה ב
אתחול

בְּרִירַת מֶחדָל: 0700

דרוש: לא.

הציג: 3.0

chown
שנה את המשתמש והקבוצה של קובץ ה-socket לערך זה. יכול להיות שם משתמש UNIX
(לְמָשָׁל כריזמה) או שם משתמש וקבוצה UNIX מופרדים באמצעות נקודתיים (למשל כריסם: גלגל).

בְּרִירַת מֶחדָל: השתמש בשם המשתמש ובקבוצה של המשתמש שמתחיל Supervisord.

דרוש: לא.

הציג: 3.0

שם משתמש
שם המשתמש הנדרש לאימות לשרת HTTP זה.

בְּרִירַת מֶחדָל: אין צורך בשם משתמש.

דרוש: לא.

הציג: 3.0

סיסמא
הסיסמה הדרושה לאימות לשרת HTTP זה. זה יכול להיות טקסט ברור
סיסמה, או שניתן לציין כ-hash SHA-1 אם הקידומת של המחרוזת {SHA}. פורום
דוגמא, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d היא הגרסה המאוחסנת ב-SHA של
סיסמא "הסיסמה".

שים לב שסיסמה מגובבת חייבת להיות בפורמט hex.

בְּרִירַת מֶחדָל: אין צורך בסיסמה.

דרוש: לא.

הציג: 3.0

[unix_http_server] סעיף דוגמה
[unix_http_server]
file = /tmp/supervisor.sock
chmod = 0777
chown= אף אחד:nogroup
שם משתמש = משתמש
סיסמא = 123

[inet_http_server] סעיף הגדרות
אל האני supervisord.conf הקובץ מכיל קטע בשם [inet_http_server] תחת אשר
פרמטרי תצורה עבור שרת HTTP שמאזין לשקע TCP (אינטרנט) צריכים
להיות מוכנס. אם לקובץ התצורה אין [inet_http_server] סעיף, HTTP של inet
השרת לא יופעל. ערכי התצורה המותרים הם כדלקמן.

[inet_http_server] סעיף ערכים
נמל
ערך TCP host:port או (למשל 127.0.0.1:9001) שעליו יקשיב המפקח
בקשות HTTP/XML-RPC. מפקח ישתמש ב-XML-RPC כדי לתקשר איתו מְפַקֵחַ
מעל הנמל הזה. כדי להאזין בכל הממשקים במכונה, השתמש : 9001 or *: 9001.

בְּרִירַת מֶחדָל: אין ברירת מחדל.

דרוש: כן.

הציג: 3.0

שם משתמש
שם המשתמש הנדרש לאימות לשרת HTTP זה.

בְּרִירַת מֶחדָל: אין צורך בשם משתמש.

דרוש: לא.

הציג: 3.0

סיסמא
הסיסמה הדרושה לאימות לשרת HTTP זה. זה יכול להיות טקסט ברור
סיסמה, או שניתן לציין כ-hash SHA-1 אם הקידומת של המחרוזת {SHA}. פורום
דוגמא, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d היא הגרסה המאוחסנת ב-SHA של
סיסמא "הסיסמה".

שים לב שסיסמה מגובבת חייבת להיות בפורמט hex.

בְּרִירַת מֶחדָל: אין צורך בסיסמה.

דרוש: לא.

הציג: 3.0

[inet_http_server] סעיף דוגמה
[inet_http_server]
יציאה = 127.0.0.1:9001
שם משתמש = משתמש
סיסמא = 123

[מפקח] סעיף הגדרות
אל האני supervisord.conf הקובץ מכיל קטע בשם [מפקח] באילו הגדרות גלובליות
מקושר ל מְפַקֵחַ יש להכניס תהליך. אלה הם כדלקמן.

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

בְּרִירַת מֶחדָל: $CWD/supervisord.log

דרוש: לא.

הציג: 3.0

logfile_maxbytes
המספר המרבי של בתים שקובץ יומן הפעילות עשוי לצרוך לפני כן
מסובב (ניתן להשתמש במכפילי סיומת כמו "KB", "MB" ו-"GB" בערך). מַעֲרֶכֶת
ערך זה ל-0 כדי לציין גודל יומן בלתי מוגבל.

בְּרִירַת מֶחדָל: 50MB

דרוש: לא.

הציג: 3.0

logfile_backups
מספר הגיבויים שיש לשמור בסביבה כתוצאה מסיבוב קובצי יומן פעילות. אם מוגדר
ל-0, לא יישמרו גיבויים.

בְּרִירַת מֶחדָל: 10

דרוש: לא.

הציג: 3.0

רמת יומן
רמת הרישום, מכתיבה מה כתוב ליומן הפעילות של המפקח. אחד מ
קריטי, שגיאה, להזהיר, מידע, באגים, להתחקות, או לְפַטְפֵט. שימו לב שברמת היומן באגים,
קובץ יומן ה-Supervisord יתעד את פלט stderr/stdout של תהליכי הצאצא שלו
ומידע מורחב על שינויים במצב התהליך, שהוא שימושי לניפוי באגים א
תהליך שלא מתחיל כמו שצריך. ראה גם: activity_log_levels.

בְּרִירַת מֶחדָל: מידע

דרוש: לא.

הציג: 3.0

pidfile
המיקום שבו המפקח שומר את קובץ ה-Pid שלו. אפשרות זו יכולה לכלול את
ערך %(כאן)s, שמתרחב לספרייה שבה תצורת המפקח
הקובץ נמצא.

בְּרִירַת מֶחדָל: $CWD/supervisord.pid

דרוש: לא.

הציג: 3.0

אומסק
האומסק של תהליך המפקח.

בְּרִירַת מֶחדָל: 022

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0

minfds
המספר המינימלי של מתארי קבצים שחייבים להיות זמינים לפני שהמפקח יעשה זאת
להתחיל בהצלחה. קריאה ל-setrlimit תתבצע כדי לנסות להעלות את ה-soft and
גבולות קשים של תהליך המפקח שיש לעמוד בהם minfds. הגבול הקשה עשוי להיות רק
מועלה אם ה-Supervisord פועל כשורש. supervisord משתמש בתיאורי קבצים באופן נרחב, ו
יכנס למצב כשל כאשר לא ניתן להשיג אותו ממערכת ההפעלה, אז זה שימושי להיות
מסוגלים לציין ערך מינימלי כדי להבטיח שהוא לא ייגמר מהם במהלך הביצוע.
אפשרות זו שימושית במיוחד ב-Solaris, שיש לה מגבלה נמוכה של FD לכל תהליך ב-
ברירת המחדל.

בְּרִירַת מֶחדָל: 1024

דרוש: לא.

הציג: 3.0

minprocs
המספר המינימלי של מתארי תהליך שחייבים להיות זמינים לפני המפקח
יתחיל בהצלחה. קריאה ל-setrlimit תתבצע כדי לנסות להעלות את ה-soft
ומגבלות קשות של תהליך המפקח לסיפוק minprocs. הגבול הקשה עשוי
יועלה רק אם ה-Supervisord מופעלת כשורש. המפקח יכנס למצב כשל
כאשר מתארי התהליך נגמרים למערכת ההפעלה, אז כדאי להבטיח את זה מספיק
מתארי תהליך זמינים על מְפַקֵחַ אתחול

בְּרִירַת מֶחדָל: 200

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0

childlogdir
הספרייה המשמשת עבור AUTO קבצי יומן ילדים. אפשרות זו יכולה לכלול את הערך
%(כאן)s, שמתרחב לספרייה שבה מְפַקֵחַ קובץ תצורה
נמצא.

בְּרִירַת מֶחדָל: הערך של פייתון tempfile.get_tempdir()

דרוש: לא.

הציג: 3.0

המשתמש
לְהוֹרוֹת מְפַקֵחַ כדי להעביר משתמשים לחשבון משתמש זה ב-UNIX לפני ביצוע פעולה כלשהי
עיבוד משמעותי. ניתן להחליף את המשתמש רק אם מְפַקֵחַ מתחיל בתור ה
משתמש שורש. אם מְפַקֵחַ לא יכול להחליף משתמשים, זה עדיין ימשיך אבל יכתוב א
הודעת יומן ב- קריטי רמה שאומר שזה לא יכול להוריד הרשאות.

בְּרִירַת מֶחדָל: אל תחליף משתמשים

דרוש: לא.

הציג: 3.0

בספרייה
מתי מְפַקֵחַ דמוניזז, עבור לספרייה זו. אפשרות זו יכולה לכלול את
ערך %(כאן)s, שמתרחב לספרייה שבה מְפַקֵחַ תצורה
הקובץ נמצא.

בְּרִירַת מֶחדָל: אל תקליטו

דרוש: לא.

הציג: 3.0

סטריפ_אנסי
הסר את כל רצפי הבריחה של ANSI מקובצי יומן ילדים.

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0

סביבה
רשימה של זוגות מפתח/ערך בטופס KEY="val",KEY2="val2" שיוצב ב
מְפַקֵחַ סביבת התהליך (וכתוצאה מכך בכל תהליך הילד שלו"
סביבות). אפשרות זו יכולה לכלול את הערך %(כאן)s, שמתרחב ל-
ספרייה שבה נמצא קובץ התצורה של המפקח. ערכים המכילים
יש לצטט תווים שאינם אלפאנומריים (למשל KEY="val:123",KEY2="val,456").
אחרת, ציטוט הערכים הוא אופציונלי אך מומלץ. לברוח אחוז
תווים, פשוט השתמש בשניים. (לְמָשָׁל URI="/first%%20name") הערות שתתי-תהליכים יהיו
יורש את משתני הסביבה של המעטפת ששימשה להתחלה מְפַקֵחַ חוץ מ ה
אלה שנדרוסים כאן ובתוך התוכנית סביבה אוֹפְּצִיָה. לִרְאוֹת
subprocess_environment.

בְּרִירַת מֶחדָל: אין ערכים

דרוש: לא.

הציג: 3.0

מזהה
מחרוזת המזהה עבור תהליך מפקח זה, המשמשת את ממשק ה-RPC.

בְּרִירַת מֶחדָל: מפקח

דרוש: לא.

הציג: 3.0

[מפקח] סעיף דוגמה
[מפקח]
logfile = /tmp/supervisord.log
logfile_maxbytes = 50MB
logfile_backups=10
loglevel = מידע
pidfile = /tmp/supervisord.pid
nodaemon = שקר
minfds = 1024
minprocs = 200
umask = 022
משתמש = כריסמס
מזהה = מפקח
ספרייה = / Tmp
nocleanup = נכון
childlogdir = / Tmp
strip_ansi = false
סביבה = KEY1="value1",KEY2="value2"

[סופרvisorctl] סעיף הגדרות
קובץ התצורה עשוי להכיל הגדרות עבור מפקח קליפה אינטראקטיבית
תכנית. אפשרויות אלה מפורטות להלן.

[סופרvisorctl] סעיף ערכים
serverurl
כתובת ה-URL שבה יש להשתמש כדי לגשת לשרת המפקח, למשל
http://localhost: 9001. עבור שקעי תחום UNIX, השתמש
unix:///absolute/path/to/file.sock.

בְּרִירַת מֶחדָל: http://localhost: 9001

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: אין שם משתמש

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: אין סיסמא

דרוש: לא.

הציג: 3.0

הפקודה
מחרוזת המשמשת כהנחיה supervisorctl.

בְּרִירַת מֶחדָל: מפקח

דרוש: לא.

הציג: 3.0

קובץ_היסטוריה
נתיב לשימוש בתור קריאת שורה קובץ היסטוריה מתמשך. אם תפעיל תכונה זו על ידי
בחירת נתיב, פקודות supervisorctl שלך יישמרו בקובץ, ותוכל להשתמש
readline (למשל חץ למעלה) כדי להפעיל פקודות שביצעת ב- supervisorctl האחרון שלך
מוֹשָׁב.

בְּרִירַת מֶחדָל: אין קובץ

דרוש: לא.

הציג: 3.0a5

[סופרvisorctl] סעיף דוגמה
[סופרvisorctl]
serverurl = unix:///tmp/supervisor.sock
שם משתמש = כריס
סיסמא = 123
הנחיה = המפקח שלי

[תוכנית:x] סעיף הגדרות
קובץ התצורה חייב להכיל אחד או יותר התוכנית סעיפים על מנת לפקח
כדי לדעת באילו תוכניות הוא צריך להתחיל ולשלוט. ערך הכותרת הוא ערך מורכב.
זוהי המילה "תוכנית", ולאחריה ישירות נקודתיים, ולאחר מכן שם התוכנית. כותרת עליונה
ערך של [program:foo] מתאר תוכנית עם השם "פו". נעשה שימוש בשם
בתוך יישומי לקוח השולטים בתהליכים שנוצרים כתוצאה מכך
תְצוּרָה. זו שגיאה ליצור א התוכנית סעיף שאין לו שם. ה
השם אינו יכול לכלול תו נקודתיים או תו סוגריים. ערכו של השם הוא
משמש כערך עבור ה %(program_name)s הרחבת ביטוי מחרוזת בתוך ערכים אחרים
היכן שצוין.

הערה:
A [תוכנית:x] סעיף מייצג למעשה "קבוצת תהליך הומוגנית" למפקח
(נכון ל-3.0). חברי הקבוצה מוגדרים על ידי השילוב של ה numprocs
ו שם התהליך פרמטרים בתצורה. כברירת מחדל, אם numprocs ו
process_name נותרו ללא שינוי מברירות המחדל שלהם, הקבוצה המיוצגת על ידי
[תוכנית:x] ייקרא שם x ויהיה שם תהליך יחיד x בּוֹ. זֶה
מספק מעט תאימות לאחור עם מהדורות ישנות יותר של Supervisor, מה שכן
לא להתייחס לקטעי תוכנית כאל הגדרות קבוצות תהליך הומוגניות.

אבל למשל, אם יש לך א [program:foo] קטע עם א numprocs של 3 וא
שם התהליך ביטוי ל %(program_name)s_%(process_num)02d, קבוצת "פו" תעשה זאת
מכילים שלושה תהליכים, בשם foo_00, foo_01, ו foo_02. זה מאפשר
להתחיל מספר תהליכים דומים מאוד באמצעות יחיד [תוכנית:x] סָעִיף. את כל
שמות קבצי log, כל מחרוזות הסביבה והפקודה של תוכניות יכולים להכיל גם
ביטויי מחרוזת Python דומים, כדי להעביר פרמטרים מעט שונים לכל אחד
התהליך.

[תוכנית:x] סעיף ערכים
הפקודה
הפקודה שתופעל כאשר תוכנית זו תופעל. הפקודה יכולה להיות או
מוחלט (למשל /נתיב/אל/שם תוכנית) או קרוב משפחה (למשל שם התוכנית). אם זה
קרוב משפחה, סביבת המפקח $ PATH יחפש את קובץ ההפעלה.
תוכניות יכולות לקבל טיעונים, למשל /path/to/program Foo בָּר. שורת הפקודה יכולה להשתמש
מרכאות כפולות לקבוצה של ארגומנטים עם רווחים בהם כדי להעביר לתוכנית, למשל
/path/to/program/name -p "פו בָּר". שימו לב שהערך של הפקודה עשוי לכלול Python
ביטויי מחרוזת, למשל /נתיב/אל/שם תוכנית --port=80%(process_num)02d עשוי להתרחב
ל /נתיב/אל/שם תוכנית --port=8000 בזמן ריצה. ביטויי מחרוזת מוערכים
נגד מילון המכיל את המפתחות שם קבוצה, host_node_name, process_num,
תוכנית_שם, כאן (הספרייה של קובץ התצורה של supervisord), והכל
משתני הסביבה של supervisord עם קידומת ENV_. תוכניות מבוקרות צריכות
עצמם אינם דמונים, מכיוון שהמפקח מניח שהוא אחראי לדמוניזציה שלו
תהליכי משנה (ראה אי-דמוניזציה_של_תתי-תהליכים).

בְּרִירַת מֶחדָל: אין ברירת מחדל.

דרוש: כן.

הציג: 3.0

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

בְּרִירַת מֶחדָל: %(program_name)s

דרוש: לא.

הציג: 3.0

numprocs
המפקח יתחיל כמה שיותר מופעים של תוכנית זו כפי שנקראו על ידי numprocs. הערה
שאם numprocs > 1, ה שם התהליך הביטוי חייב לכלול %(process_num)s (או כל
ביטוי מחרוזת Python חוקי אחר הכולל process_num) בתוך זה.

בְּרִירַת מֶחדָל: 1

דרוש: לא.

הציג: 3.0

numprocs_start
היסט מספר שלם המשמש לחישוב המספר שבו numprocs מתחיל.

בְּרִירַת מֶחדָל: 0

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: 999

דרוש: לא.

הציג: 3.0

התחלה אוטומטית
אם זה נכון, תוכנית זו תופעל אוטומטית עם הפעלת Supervisord.

בְּרִירַת מֶחדָל: נכון

דרוש: לא.

הציג: 3.0

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

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

בְּרִירַת מֶחדָל: 1

דרוש: לא.

הציג: 3.0

נסיונות התחלה
מספר ניסיונות כשל סדרתי זה מְפַקֵחַ יאפשר כאשר מנסים
התחל את התוכנית לפני הוויתור והכנסת התהליך לתוך קָטלָנִי מדינה. לִרְאוֹת
process_states להסבר של קָטלָנִי מדינה.

בְּרִירַת מֶחדָל: 3

דרוש: לא.

הציג: 3.0

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

הערה:
הפעלה אוטומטית שולט אם מְפַקֵחַ יפעיל מחדש תוכנית אוטומטית אם היא יוצאת
לאחר הפעלתו בהצלחה (התהליך נמצא ב- רץ מדינה).

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

בְּרִירַת מֶחדָל: בלתי צפוי

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: 0,2

דרוש: לא.

הציג: 3.0

אות עצור
האות המשמש להרוג את התוכנית כאשר מתבקשת עצירה. זה יכול להיות כל אחד מ-TERM,
HUP, INT, QUIT, KILL, USR1 או USR2.

בְּרִירַת מֶחדָל: טווח

דרוש: לא.

הציג: 3.0

stopwaitsecs
מספר השניות לחכות למערכת ההפעלה שתחזיר אליה SIGCHILD מְפַקֵחַ לאחר
לתוכנית נשלח אות עצור. אם מספר השניות הזה חולף לפני כן
מְפַקֵחַ מקבל SIGCHILD מהתהליך, מְפַקֵחַ ינסה להרוג אותו
עם SIGKILL אחרון.

בְּרִירַת מֶחדָל: 10

דרוש: לא.

הציג: 3.0

קבוצת stopas
אם זה נכון, הדגל גורם למנהל לשלוח את אות העצירה לכל קבוצת התהליך
ומרמז killasgroup נכון. זה שימושי עבור תוכניות, כגון Flask ב-debug
מצב, שאינם מפיצים אותות עצירה לילדיהם, ומשאירים אותם יתומים.

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0b1

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

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0a11

המשתמש
לְהוֹרוֹת מְפַקֵחַ להשתמש בחשבון משתמש זה ב-UNIX בתור החשבון שמפעיל את
תכנית. ניתן להחליף את המשתמש רק אם מְפַקֵחַ מופעל כמשתמש השורש. אם
מְפַקֵחַ לא יכול לעבור למשתמש שצוין, התוכנית לא תופעל.

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

בְּרִירַת מֶחדָל: אל תחליף משתמשים

דרוש: לא.

הציג: 3.0

redirect_stderr
אם זה נכון, גורם לפלט stderr של התהליך להישלח בחזרה מְפַקֵחַ על הסטדאוט שלו
מתאר קובץ (במונחי מעטפת UNIX, זה שווה ערך לביצוע /התכנית
2> & 1).

הערה:
לא להגדיר redirect_stderr=true בתוך [מאזין אירועים:x] סָעִיף. מאזיני אירועים
להשתמש stdout ו סטדין לתקשר איתו מְפַקֵחַ. אם סטדרר מופנה מחדש,
פלט מ סטדרר יפריע לפרוטוקול המאזין לאירועים.

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0, מחליף 2.0 log_stdout ו log_stderr

stdout_logfile
שים פלט process stdout בקובץ הזה (ואם redirect_stderr נכון, גם מקם
פלט stderr בקובץ זה). אם stdout_logfile לא מוגדר או מוגדר ל AUTO, מפקח
יבחר אוטומטית מיקום קובץ. אם זה מוגדר ל אף לא אחד, המפקח יהיה
לא ליצור קובץ יומן. AUTO קובצי יומן והגיבויים שלהם יימחקו מתי מְפַקֵחַ
מופעל מחדש. ה stdout_logfile ערך יכול להכיל ביטויי מחרוזת Python שיעשו זאת
מוערך מול מילון המכיל את המפתחות שם קבוצה, host_node_name,
process_num, תוכנית_שם, ו כאן (הספרייה של קובץ התצורה של supervisord).

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

בְּרִירַת מֶחדָל: AUTO

דרוש: לא.

הציג: 3.0, מחליף 2.0 קובץ לוג

stdout_logfile_maxbytes
המספר המרבי של בתים שניתן לצרוך על ידי stdout_logfile לפני שהוא מסובב
(ניתן להשתמש במכפילי סיומת כמו "KB", "MB" ו-"GB" בערך). הגדר את זה
ערך עד 0 כדי לציין גודל יומן בלתי מוגבל.

בְּרִירַת מֶחדָל: 50MB

דרוש: לא.

הציג: 3.0, מחליף 2.0 logfile_maxbytes

stdout_logfile_backups
מספר stdout_logfile גיבויים כדי לשמור בסביבה הנובעים מיומן סטדout של תהליך
סיבוב קבצים. אם מוגדר ל-0, לא יישמרו גיבויים.

בְּרִירַת מֶחדָל: 10

דרוש: לא.

הציג: 3.0, מחליף 2.0 logfile_backups

stdout_capture_maxbytes
המספר המקסימלי של בתים שנכתב ללכידת FIFO כאשר התהליך נמצא במצב "לכידת stdout"
(ראה capture_mode). צריך להיות מספר שלם (מכפילי סיומת כמו "KB", "MB" ו-"GB"
יכול להשתמש בערך). אם ערך זה הוא 0, מצב לכידת התהליך יהיה כבוי.

בְּרִירַת מֶחדָל: 0

דרוש: לא.

הציג: 3.0, מחליף 2.0 logfile_backups

stdout_events_enabled
אם זה נכון, אירועי PROCESS_LOG_STDOUT ייפלטו כאשר התהליך יכתוב אליו
מתאר קובץ stdout. האירועים ייפלטו רק אם מתאר הקובץ אינו
במצב לכידה בזמן קבלת הנתונים (ראה capture_mode).

בְּרִירַת מֶחדָל: 0

דרוש: לא.

הציג: 3.0a7

stderr_logfile
שים פלט process stderr בקובץ זה אלא אם כן redirect_stderr נכון. מקבל את
אותם סוגי ערכים כמו stdout_logfile ועשויים להכיל את אותם ביטויי מחרוזת Python.

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

בְּרִירַת מֶחדָל: AUTO

דרוש: לא.

הציג: 3.0

stderr_logfile_maxbytes
המספר המרבי של בתים לפני סיבוב קובץ יומן עבור stderr_logfile. מקבל את
אותם סוגי ערכים כמו stdout_logfile_maxbytes.

בְּרִירַת מֶחדָל: 50MB

דרוש: לא.

הציג: 3.0

stderr_logfile_backups
מספר הגיבויים שיש לשמור בסביבה הנובעים מסיבוב קובץ יומן תהליך stderr.
אם מוגדר ל-0, לא יישמרו גיבויים.

בְּרִירַת מֶחדָל: 10

דרוש: לא.

הציג: 3.0

stderr_capture_maxbytes
המספר המרבי של בתים שנכתב ללכידת FIFO כאשר התהליך נמצא במצב "לכידת stderr"
(ראה capture_mode). צריך להיות מספר שלם (מכפילי סיומת כמו "KB", "MB" ו-"GB"
יכול להשתמש בערך). אם ערך זה הוא 0, מצב לכידת התהליך יהיה כבוי.

בְּרִירַת מֶחדָל: 0

דרוש: לא.

הציג: 3.0

stderr_events_enabled
אם זה נכון, אירועי PROCESS_LOG_STDERR ייפלטו כאשר התהליך יכתוב אליו
מתאר קובץ stderr. האירועים ייפלטו רק אם מתאר הקובץ אינו
במצב לכידה בזמן קבלת הנתונים (ראה capture_mode).

בְּרִירַת מֶחדָל: שקר

דרוש: לא.

הציג: 3.0a7

סביבה
רשימה של זוגות מפתח/ערך בטופס KEY="val",KEY2="val2" שיוצב ב
סביבת תהליך הילד. מחרוזת הסביבה עשויה להכיל מחרוזת Python
ביטויים שיובחנו מול מילון המכיל שם קבוצה,
host_node_name, process_num, תוכנית_שם, ו כאן (הספרייה של המפקח
קובץ התצורה). יש לצטט ערכים המכילים תווים שאינם אלפאנומריים (למשל
KEY="val:123",KEY2="val,456"). אחרת, ציטוט הערכים הוא אופציונלי אבל
מומלץ. הערות שתהליך המשנה יירש את משתני הסביבה של ה
shell נהגה להתחיל "מפקח" פרט לאלה שנדחקו כאן. לִרְאוֹת
subprocess_environment.

בְּרִירַת מֶחדָל: אין סביבה נוספת

דרוש: לא.

הציג: 3.0

בספרייה
נתיב קובץ המייצג ספרייה שאליה מְפַקֵחַ צריך chdir באופן זמני
לפני ההוצאה לפועל של הילד.

בְּרִירַת מֶחדָל: אין chdir (יורש את המפקח)

דרוש: לא.

הציג: 3.0

אומסק
מספר אוקטלי (למשל 002, 022) המייצג את ה-umask של התהליך.

בְּרִירַת מֶחדָל: אין umask מיוחד (מפקח בירושה)

דרוש: לא.

הציג: 3.0

serverurl
כתובת האתר הועברה בסביבה לתהליך המשנה כ SUPERVISOR_SERVER_URL
(ראה supervisor.childutils) כדי לאפשר לתהליך המשנה לתקשר בקלות עם
שרת HTTP פנימי. אם מסופק, זה צריך להיות בעל אותו תחביר ומבנה כמו של
[סופרvisorctl] אפשרות סעיף באותו שם. אם זה מוגדר ל-AUTO, או אינו מוגדר,
supervisor יבנה באופן אוטומטי כתובת URL של שרת, תוך מתן עדיפות לשרת
שמאזין בשקעי תחום UNIX על פני אחד שמאזין בשקע אינטרנט.

בְּרִירַת מֶחדָל: אוטומטי

דרוש: לא.

הציג: 3.0

[תוכנית:x] סעיף דוגמה
[תוכנית:חתול]
פקודה =/bin/cat
process_name=%(program_name)s
numprocs=1
ספרייה=/ Tmp
umask=022
עדיפות = 999
התחלה אוטומטית = נכון
autorestart=לא צפוי
startsecs=10
נסיונות התחלה=3
exitcodes=0,2
stopsignal=TERM
stopwaitsecs=10
stopasgroup=false
killasgroup=false
משתמש=כריס
redirect_stderr=false
stdout_logfile=/a/path
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
stdout_events_enabled=false
stderr_logfile=/a/path
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stderr_events_enabled=false
environment=A="1",B="2"
serverurl=AUTO

[לִכלוֹל] סעיף הגדרות
אל האני supervisord.conf הקובץ עשוי להכיל קטע בשם [לִכלוֹל]. אם התצורה
הקובץ מכיל [לִכלוֹל] סעיף, עליו להכיל מפתח יחיד בשם "קבצים". ה
ערכים במפתח זה מציינים קובצי תצורה אחרים שייכללו בתוך ה-
תצורה.

[לִכלוֹל] סעיף ערכים
קבצים
רצף מופרד מרווחים של גלובס של קבצים. כל גלוב קובץ יכול להיות מוחלט או יחסי.
אם גלוב הקובץ הוא יחסי, הוא נחשב כיחסי למיקום ה-
קובץ תצורה הכולל אותו. "גלוב" הוא תבנית קובץ שתואמת את א
דפוס שצוין בהתאם לכללים המשמשים את מעטפת יוניקס. אין הרחבת טילדה
נעשה, אבל *, ?, וטווחי תווים המובעים עם [] יהיה מותאם בצורה נכונה.
כולל רקורסיבי מקבצים כלולים אינם נתמכים.

בְּרִירַת מֶחדָל: אין ברירת מחדל (חובה)

דרוש: כן.

הציג: 3.0

[לִכלוֹל] סעיף דוגמה
[לִכלוֹל]
files = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config??.conf

[קבוצה:x] סעיף הגדרות
לעתים קרובות שימושי לקבץ קבוצות תהליכים "הומוגניות" (הידוע גם בשם "תוכניות") לכדי א
קבוצת תהליכים "הטרוגניים" כך שניתן לשלוט עליהם כיחידה מבית הממונה
ממשקי בקר שונים.

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

עבור [קבוצה:x], חייב להיות אחד או יותר [תוכנית:x] קטעים במקומות אחרים שלך
קובץ התצורה, והקבוצה חייבת להתייחס אליהם לפי השם ב- תוכניות ערך.

אם קבוצות תהליך "הומוגניות" (מיוצגות על ידי קטעי תוכנית) ממוקמות לתוך a
קבוצה "הטרוגנית" דרך [קבוצה:x] מקטעים תוכניות קו, הקבוצות ההומוגניות ש
משתמעים מסעיף התוכנית לא יתקיימו בזמן הריצה ב-Supervisor. במקום זאת, הכל
תהליכים השייכים לכל אחת מהקבוצות ההומוגניות יוכנסו ל-
קבוצה הטרוגנית. לדוגמה, בהינתן תצורת הקבוצה הבאה:

[קבוצה:פו]
תוכניות=בר,באז
עדיפות = 999

בהתחשב באמור לעיל, בהפעלת Supervisord, ה בָּר ו באז קבוצות הומוגניות לא
קיימים, והתהליכים שהיו תחתיהם יועברו כעת ל- Foo
קבוצה.

[קבוצה:x] סעיף ערכים
תוכניות
רשימה מופרדת בפסיקים של שמות תוכניות. התוכניות המפורטות הופכות לחברים
של הקבוצה.

בְּרִירַת מֶחדָל: אין ברירת מחדל (חובה)

דרוש: כן.

הציג: 3.0

עדיפות
מספר עדיפות בדומה ל-a [תוכנית:x] ערך עדיפות שהוקצה לקבוצה.

בְּרִירַת מֶחדָל: 999

דרוש: לא.

הציג: 3.0

[קבוצה:x] סעיף דוגמה
[קבוצה:פו]
תוכניות=בר,באז
עדיפות = 999

[fcgi-program:x] סעיף הגדרות
מפקח יכול לנהל קבוצות של FastCGI תהליכים שכולם מאזינים באותו שקע.
עד כה, גמישות הפריסה של FastCGI הייתה מוגבלת. כדי לקבל תהליך מלא
ניהול, אתה יכול להשתמש ב-mod_fastcgi תחת Apache אבל אז היית תקוע עם זה של Apache
מודל מקביליות לא יעיל של תהליך או חוט אחד לכל חיבור. בנוסף ל
דורש יותר משאבי מעבד וזיכרון, התהליך/חוט לכל מודל חיבור יכול להיות
רווי במהירות על ידי משאב איטי, ומונע את הגשת משאבים אחרים. ב
כדי לנצל שרתי אינטרנט חדשים יותר מונעי אירועים כגון lighttpd או nginx which
אל תכלול מנהל תהליכים מובנה, היית צריך להשתמש בסקריפטים כמו cgi-fcgi או
spawn-fcgi. ניתן להשתמש בהם בשילוב עם מנהל תהליכים כגון מפקח
או daemontools אך דורשים שכל תהליך צאצא של FastCGI ייקשר לשקע משלו. ה
החסרונות של זה הם: תצורת שרת אינטרנט מסובכת שלא לצורך, לא חיננית
הפעלה מחדש, וסובלנות תקלות מופחתת. עם פחות שקעים להגדרה, שרת אינטרנט
התצורות קטנות בהרבה אם קבוצות של תהליכי FastCGI יכולות לחלוק שקעים. מְשׁוּתָף
שקעים מאפשרים הפעלה מחדש חיננית מכיוון שהשקע נשאר קשור לתהליך האב
בזמן שכל אחד מתהליכי הצאצא מופעל מחדש. לבסוף, שקעים משותפים הם יותר
עמיד בפני תקלות מכיוון שאם תהליך נתון נכשל, תהליכים אחרים יכולים להמשיך לשרת
חיבורים נכנסים.

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

הערה:
מנהל השקעים ב-Supervisor פותח במקור כדי לתמוך בתהליכי FastCGI
אבל זה לא מוגבל ל-FastCGI. ניתן להשתמש גם בפרוטוקולים אחרים ללא מיוחד
תְצוּרָה. כל תוכנית שיכולה לגשת לשקע פתוח מתאר קובץ (למשל
עם socket.fromfd ב-Python) יכול להשתמש ב-socket manager. המפקח יהיה
ליצור אוטומטית את השקע, לאגד ולהאזין לפני שמזלגים את הילד הראשון ב-a
קְבוּצָה. השקע יועבר לכל ילד במספר מתאר הקובץ 0 (אפס).
כאשר הילד האחרון בקבוצה יוצא, המפקח יסגור את השקע.

כל האפשרויות העומדות לרשות [תוכנית:x] סעיפים מכובדים גם על ידי תוכנית fcgi
סעיפים.

[fcgi-program:x] סעיף ערכים
[fcgi-program:x] לחלקים יש מפתח יחיד אשר [תוכנית:x] לקטעים אין.

שקע
שקע FastCGI עבור תוכנית זו, שקע תחום TCP או UNIX. עבור שקעי TCP,
השתמש בפורמט הזה: tcp://localhost:9002. עבור שקעי תחום UNIX, השתמש
unix:///absolute/path/to/file.sock. ביטויי מחרוזת מוערכים מול א
מילון המכיל את המפתחות "שם_תוכנית" ו"כאן" (הספרייה של
קובץ התצורה של supervisord).

בְּרִירַת מֶחדָל: אין ברירת מחדל.

דרוש: כן.

הציג: 3.0

socket_owner
עבור שקעי תחום UNIX, ניתן להשתמש בפרמטר זה כדי לציין את המשתמש והקבוצה עבורם
שקע FastCGI. יכול להיות שם משתמש UNIX (למשל chrism) או שם משתמש וקבוצה של UNIX
מופרדים על ידי נקודתיים (למשל chrism:wheel).

בְּרִירַת מֶחדָל: משתמש בערכת המשתמש והקבוצה עבור תוכנית fcgi

דרוש: לא.

הציג: 3.0

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

בְּרִירַת מֶחדָל: 0700

דרוש: לא.

הציג: 3.0

התייעץ [תוכנית:x] סעיף הגדרות עבור מפתחות מותרים אחרים, דלתא את האילוצים לעיל
ותוספות.

[fcgi-program:x] סעיף דוגמה
[fcgi-program:fcgiprogramname]
command=/usr/bin/example.fcgi
socket=unix:///var/run/supervisor/%(program_name)s.sock
socket_owner=chrism
socket_mode=0700
process_name=%(program_name)s_%(process_num)02d
numprocs=5
ספרייה=/ Tmp
umask=022
עדיפות = 999
התחלה אוטומטית = נכון
autorestart=לא צפוי
startsecs=1
נסיונות התחלה=3
exitcodes=0,2
stopsignal=QUIT
stopasgroup=false
killasgroup=false
stopwaitsecs=10
משתמש=כריס
redirect_stderr=true
stdout_logfile=/a/path
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stdout_events_enabled=false
stderr_logfile=/a/path
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_events_enabled=false
environment=A="1",B="2"
serverurl=AUTO

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

שימו לב שכל האפשרויות העומדות לרשות [תוכנית:x] קטעים מכובדים על ידי eventlistener
סעיפים אלא ל stdout_capture_maxbytes ו stderr_capture_maxbytes (מאזיני אירועים
לא יכול לפלוט אירועי תקשורת תהליך, ראה capture_mode).

[מאזין אירועים:x] סעיף ערכים
[מאזין אירועים:x] לחלקים יש כמה מפתחות אשר [תוכנית:x] לקטעים אין.

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

אירועים
רשימה מופרדת בפסיקים של שמות סוגי אירועים שהמאזין הזה "מתעניין" בהם
קבלת התראות עבור (ראה event_types עבור רשימה של שמות סוגי אירועים חוקיים).

result_handler
A pkg_resources כניסה נקודה מחרוזת זה נפתר לפייתון הניתן להתקשרות. ברירת המחדל
הערך הוא supervisor.dispatchers:default_handler. ציון תוצאה חלופית
מטפל הוא דבר מאוד נדיר שצריך לעשות, וכתוצאה מכך, איך ליצור אחד הוא
לא מתועד.

התייעץ [תוכנית:x] סעיף הגדרות עבור מפתחות מותרים אחרים, דלתא את האילוצים לעיל
ותוספות.

[מאזין אירועים:x] סעיף דוגמה
[eventlistener:theeventlistenername]
command=/bin/eventlistener
process_name=%(program_name)s_%(process_num)02d
numprocs=5
events=PROCESS_STATE
buffer_size=10
ספרייה=/ Tmp
umask=022
עדיפות=-1
התחלה אוטומטית = נכון
autorestart=לא צפוי
startsecs=1
נסיונות התחלה=3
exitcodes=0,2
stopsignal=QUIT
stopwaitsecs=10
stopasgroup=false
killasgroup=false
משתמש=כריס
redirect_stderr=false
stdout_logfile=/a/path
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stdout_events_enabled=false
stderr_logfile=/a/path
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_events_enabled=false
environment=A="1",B="2"
serverurl=AUTO

[rpcinterface:x] סעיף הגדרות
מוסיף rpcinterface:x ההגדרות בקובץ התצורה שימושיות רק לאנשים אשר
רוצה להרחיב את המפקח עם התנהגות מותאמת אישית נוספת.

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

[rpcinterface:סופרvisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

אל האני [rpcinterface:סופרvisor] סעיף צריך להישאר בתצורה של התקן
הגדרת המפקח לעבוד כמו שצריך. אם אתה לא רוצה שהמפקח יעשה משהו
עדיין לא עושה מחוץ לקופסה, זה כל מה שאתה צריך לדעת על סוג זה של
סָעִיף.

עם זאת, אם ברצונך להוסיף מרחבי שמות של ממשק rpc כדי להתאים אישית את המפקח, אתה
עשוי להוסיף עוד [rpcinterface:foo] קטעים, שבהם "foo" מייצג את מרחב השמות של
הממשק (משורש האינטרנט), והערך שנקרא על ידי supervisor.rpcinterface_factory
הוא מפעל הניתן להתקשרות שצריכה להיות חתימת פונקציה שמקבלת סינגל
טיעון פוזיציונלי מְפַקֵחַ וכמה ארגומנטים של מילת מפתח הנדרשים לביצועים
תְצוּרָה. כל צמדי מפתח/ערך נוספים שהוגדרו בתוך [rpcinterface:x] סעיף יהיה
יועבר כטיעוני מילת מפתח למפעל.

הנה דוגמה לפונקציית מפעל, שנוצרה ב- __init__.py קובץ של Python
חבילה החבילה שלי.

מ-my.package.rpcinterface ייבוא ​​AnotherRPCInterface

def make_another_rpcinterface(סופרvisord, **config):
retries = int(config.get('retries', 0))
another_rpc_interface = AnotherRPCInterface(מפקח, מנסה שוב)
החזר another_rpc_interface

וקטע בקובץ התצורה נועד להגדיר אותו.

[rpcinterface:אחר]
supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
ניסיונות חוזרים = 1

[rpcinterface:x] סעיף ערכים
supervisor.rpcinterface_factory
pkg_resources שם מנוקד "נקודת כניסה" לפונקציית היצרן של ממשק ה-RPC שלך.

בְּרִירַת מֶחדָל: N /

דרוש: לא.

הציג: 3.0

[rpcinterface:x] סעיף דוגמה
[rpcinterface:אחר]
supervisor.rpcinterface_factory = my.package:make_another_rpcinterface
ניסיונות חוזרים = 1

מילון מונחים
daemontools
A תהליך לִשְׁלוֹט מערכת by DJ ברנשטיין.

השיקה
A תהליך לִשְׁלוֹט מערכת מְשׁוּמָשׁ by תפוח עץ כתהליך 1 תחת Mac OS X.

תריץ את זה A תהליך לִשְׁלוֹט מערכת.

סופרלנס
חבילה המספקת מימושים שונים של מאזינים לאירועים שמתחברים
מפקח שיכול לעזור לנטר את השימוש בזיכרון התהליך ומצב הקריסה:
http://pypi.python.org/pypi/superlance.

אומסק קיצור של המשתמש מסכה: מגדיר את מסכת יצירת מצב הקובץ של התהליך הנוכחי.
לִרְאוֹת http://en.wikipedia.org/wiki/Umask.

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