unicorn_rails - מקוון בענן

תָכְנִית:

שֵׁם

unicorn_rails - פקודה דמוית סקריפט/שרת להפעלת שרת ה-HTTP של Unicorn

תַקצִיר

unicorn_rails [-c CONFIG_FILE] [-E RAILS_ENV] [-D] [RACKUP_FILE]

תיאור

A צייד(1) פקודה להפעלת יישומי Rails באמצעות Unicorn. זה צפוי להיות
התחיל בשורש יישום Rails שלך (RAILS_ROOT), אבל ההנחיה "working_directory".
ניתן להשתמש ב-CONFIG_FILE.

זה נועד לעזור למשתמשי Rails 1.x ו-2.y לעבור ל-Rack, אבל זה לא נחוץ
עבור יישומי Rails 3. מומלץ להשתמש ב-Rails 3 חדקרן(1) במקום
חד-קרן_מסילות(1). משתמשים של Rails 1.x/2.y עשויים גם להשתמש חדקרן(1) במקום
חד-קרן_מסילות(1).

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

בעוד Unicorn לוקח מספר עצום של אפשרויות שורת פקודה עבור תאימות עם אודם(1) ו
צייד(1), מומלץ להיצמד למספר אפשרויות שורת הפקודה המצוינות ב-
SYNOPSIS והשתמש ב-CONFIG_FILE ככל האפשר.

UNICORN אפשרויות

-ג, --config-file CONFIG_FILE
נתיב לקובץ התצורה הספציפי לחדי קרן. קובץ התצורה מיושם בתור Ruby
DSL, כך שקוד Ruby עשוי להתבצע. עיין ב-RDoc/ri עבור ה Unicorn::Configurator
מחלקה לרשימה המלאה של ההנחיות הזמינות מה-DSL. שימוש מוחלט
נתיב עבור עבור CONFIG_FILE מומלץ מכיוון שהוא יוצר מופעים מרובים של Unicorn
ניתן להבחין בקלות בעת צפייה ps(1) פלט.

-ד, -- לעשות דמוניזציה
הפעל דמוניזציה ברקע. התהליך מנותק מהשליטה
מסוף ו-stdin מופנים ל-"/dev/null". בניגוד לדמוני UNIX נפוצים רבים,
אנחנו לא מעבירים ל-"/" לאחר דמוניזציה כדי לאפשר שליטה רבה יותר על
תהליך הפעלה/שדרוג. אלא אם צוין ב-CONFIG_FILE, stderr ו-stdout
יופנה גם אל "/dev/null". דמוניזציה תהיה לדלג טעינה של
מסילות::Rack::LogTailer תווך תחת מסילות >= 2.3.x. כברירת מחדל,
חד-קרן_מסילות(1) תיצור קובץ PID ב "RAILS_ROOT/tmp/pids/unicorn.pid". אתה
עשוי לעקוף זאת על ידי ציון ההנחיה "pid" כדי לעקוף את תצורת Unicorn זו
קובץ.

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

-ל, --להקשיב כתובת
מאזין בכתובת נתונה. הכתובת עשויה להיות בצורת HOST:PORT או PATH,
HOST:PORT מתכוון לשקע TCP ו-PATH נועד להיות נתיב ל- UNIX
שקע דומיין. ברירת המחדל היא "0.0.0.0:8080" (כל הכתובות ביציאת TCP 8080). ל
פריסות ייצור, ציון ההנחיה "האזנה" ב-CONFIG_FILE הוא
מומלץ מכיוון שהוא מאפשר כוונון עדין של אפשרויות השקע.

RACKUP תְאִימוּת אפשרויות

-או, --מנחה HOST
האזן בשקע TCP השייך ל-HOST, ברירת המחדל היא "0.0.0.0" (כל הכתובות). אם
שצוין מספר פעמים בשורת הפקודה, רק הערך האחרון שצוין לוקח
השפעה. אפשרות זו קיימת רק עבור תאימות עם צייד(1) פקודה, השתמש
של מתג "-l"/"--האזן" מומלץ במקום זאת.

-פ, --נמל נמל
האזינו ביציאת TCP שצוינה, ברירת המחדל היא 8080. אם צוין מספר פעמים מופעל
שורת הפקודה, רק הערך האחרון שצוין נכנס לתוקף. אפשרות זו בלבד
קיים עבור תאימות עם צייד(1) פקודה, שימוש במתג "-l"/"--האזן".
מומלץ במקום.

--נָתִיב נתיב
מעלה את אפליקציית Rails ב-PATH הנתון (במקום "/"). זה
שווה ערך להגדרת משתנה הסביבה RAILS_RELATIVE_URL_ROOT. זה
נתמך רק תחת Rails 2.3 ואילך כרגע.

אוֹדֶם אפשרויות

, --eval קו
הערך LINE של קוד Ruby. הערכה זו מתרחשת מיד כשהפקודה-
שורה בניתוח.

-ד, --לנפות
הפעל את מצב ניפוי באגים, המשתנה $DEBUG מוגדר כ-true. עבור Rails >= 2.3.x, זה
טוען את Rails::Rack::Debugger תווכה

-וו, --לְהַזהִיר
הפעל אזהרות מילוליות, המשתנה $VERBOSE מוגדר כ-true.

-אני, --לִכלוֹל נתיב
ציין $LOAD_PATH. PATH יוצמד ל-$LOAD_PATH. התו ':' עשוי
לשמש לתיחום מספר ספריות. ניתן להשתמש בהוראה זו יותר מ
פַּעַם. שינויים ב-$LOAD_PATH מתרחשים באופן מיידי ובסדר שהם
צוינו בשורת הפקודה.

-ר, --לִדרוֹשׁ סִפְרִיָה
דורשים ספרייה מוגדרת לפני הפעלת היישום. ה"דרוש"
ההצהרה תבוצע באופן מיידי ובסדר שהם צוינו ב-
שורת פקודה.

RACKUP קובץ

ברירת המחדל היא "config.ru" ב-RAILS_ROOT. זה צריך להיות אותו קובץ שבו השתמש צייד(1)
ומשגרי Rack אחרים, הוא משתמש ב- מתלה::בנאי DSL. שלא כמו Rack רבים אחרים
יישומים, RACKUP_FILE לגמרי אופציונלי עבור Rails, אך ניתן להשתמש בו כדי להשבית
חלק מתוכנות הביניים המוגדרות כברירת מחדל לביצועים.

אפשרויות שורת פקודה משובצות מנותחות לרוב לצורך תאימות עם צייד(1) אבל
מיואש מאוד.

הסביבה וריאציות

המשתנה RAILS_ENV נקבע על ידי המתג -E הנ"ל. ה
RAILS_RELATIVE_URL_ROOT מוגדר על ידי המתג --path שהוזכר לעיל. כל אחד מאלה
ניתן להגדיר משתנים גם במעטפת או ב- Unicorn CONFIG_FILE. כל היישום או
ניתן להגדיר תמיד משתני סביבה ספציפיים לספרייה (למשל TMPDIR, RAILS_ASSET_ID)
החד קרן CONFIG_FILE בנוסף למעטפת ההשרצה. בעת שדרוג שקוף
Unicorn, כל משתני הסביבה שנקבעו בתהליך המאסטר הישן עוברים בירושה לחדש
תהליך מאסטר. Unicorn משתמש רק (ויחליף) בסביבת UNICORN_FD
משתנה פנימי בעת ביצוע שדרוגים שקופים.

איתותים

האותות הבאים של UNIX עשויים להישלח לתהליך המאסטר:

· HUP - טען מחדש את קובץ התצורה, האפליקציה והפעל מחדש את כל העובדים

· INT/TERM - כיבוי מהיר, הורג את כל העובדים באופן מיידי

· QUIT - כיבוי חינני, ממתין לעובדים לסיים את בקשתם הנוכחית לפני כן
גימור.

· USR1 - פתח מחדש את כל היומנים שבבעלות המאסטר וכל העובדים ראה Unicorn::Util.reopen_logs
למה שנחשב בול עץ.

· USR2 - הפעל מחדש את הבינארי הפועל. יש לשלוח יציאה נפרדת למקור
תהליך לאחר אימות של הילד פעיל.

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

· TTIN - הגדל את מספר תהליכי העובד באחד

· TTOU - הפחתת מספר תהליכי עובד באחד

ראה את האותות (http://unicorn.bogomips.org/SIGNALS.html) מסמך לתיאור מלא
מכל האותות המשמשים את Unicorn.

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