מר - אונליין בענן

תָכְנִית:

שֵׁם

mr - כלי לניהול כל מאגרי בקרת הגרסאות שלך

תַקצִיר

mr [אפשרויות] תשלום

mr עדכון [אפשרויות]

mr סטטוס [אפשרויות]

mr ניקוי [אפשרויות]

mr [אפשרויות] commit [-m "הודעה"]

mr רשומה [אפשרויות] [-m "הודעה"]

mr [אפשרויות] אחזור

mr דחיפה [אפשרויות]

mr [אפשרויות] הבדל

mr יומן [אפשרויות]

mr תבנית grep [אפשרויות]

mr [אפשרויות] הפעלה של הפקודה [פרמטר ...]

mr [אפשרויות] bootstrap src [ספרייה]

mr [אפשרויות] רישום [מאגר]

mr סעיף הגדרות [אפשרויות] ["הגדרה=[ערך]" ...]

mr [אפשרויות] פעולה [פרמטרים ...]

mr [אפשרויות] [מקוון|לא מקוון]

mr [אפשרויות] זכור פעולה [פרמטרים ...]

תיאור

mr הוא כלי לניהול כל מאגרי בקרת הגרסאות שלך. הוא יכול לבצע בדיקה, עדכון או ביצוע
פעולות אחרות על קבוצת מאגרים כאילו היו מאגר משולב אחד.
תומך בכל שילוב של subversion, git, cvs, mercurial, bzr, darcs, fossil ו-
ניתן להוסיף בקלות מאגרי veracity ותמיכה במערכות בקרת גרסאות אחרות.

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

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

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

קופה (או שיתוף)
בודק את כל המאגרים שעדיין לא הוצאו מהתיק.

עדכון
מעדכן כל מאגר מהמאגר המרוחק שתצורתו נקבעה.

אם מאגר עדיין לא הוצא מהמאגר, הוא יבדוק אותו תחילה.

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

לְנַקוֹת
הדפס קבצים שהוזנחו, קבצים שלא עוקבים אחריהם וזבל אחר בתיקיית העבודה.

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

commit (או ci)
מבצע שינויים בכל מאגר. (כברירת מחדל, שינויים נדחפים למאגר המרוחק)
גם מאגר, בעת שימוש במערכות מבוזרות כמו git. אם זה לא מוצא חן בעיניכם
ברירת מחדל, ניתן לשנות זאת בקובץ ‎.mrconfig‎, או להשתמש ב-record במקום זאת.)

הפרמטר האופציונלי -m מאפשר ציון הודעת commit.

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

הפרמטר האופציונלי -m מאפשר ציון הודעת commit.

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

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

הבדל
הצג הבדל של שינויים שלא בוצעו.

log הצג את יומן ה-commit.

תבנית grep
מחפש תבנית בכל מאגר באמצעות פקודת המשנה grep. משתמש ב- ack-grep ב
VCS שאין להם משלהם.

הפעל פקודה [פרמטר ...]
מפעיל את הפקודה שצוינה בכל מאגר.

פקודות אלו זמינות גם כן:

מדריך bootstrap src [ספרייה]
גורם ל-mr לאחזר את קובץ המקור "src" ולהשתמש בו כקובץ .mrconfig כדי לבדוק את ה-
המאגרים הרשומים בו, לתוך הספרייה שצוינה.

mr מבין מספר סוגים של מקורות:

כתובת URL עבור curl
"src" עשוי להיות כתובת URL המובנת על ידי תלתל.

העתק באמצעות ssh
להשתמש SCP כדי להוריד, קובץ ה-"src" יכול להיות בצורה של "ssh://[user@]host:file".

קובץ מקומי
ניתן לאחזר את קובץ ההגדרות באמצעים אחרים ולהעביר אותו נתיב בתור "מקור".

קלט סטנדרטי
אם המקור "src" מורכב ממקף יחיד "-", קובץ ההגדרות נקרא מהקובץ הסטנדרטי
קֶלֶט.

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

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

רשימה (או ls)
רשום את המאגרים שמר יפעל עליהם.

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

קובץ ה-mrconfig שמשתנה נבחר על ידי האפשרות -c, או על ידי חיפוש
עבור הספרייה הידועה ביותר, הנמצאת או נמצאת בתוך ספריית אב של הספרייה הנוכחית.

config
מוסיף, משנה, מסיר או מדפיס ערך מקובץ mrconfig. הפרמטר הבא הוא
שם המקטע שבו נמצא הערך. כדי להוסיף או לשנות ערכים, השתמש באחד או יותר
מופעים של "setting=value". השתמש ב-"setting=" כדי להסיר הגדרה. השתמש רק ב-"setting"
כדי לקבל את הערך של הגדרה זו.

לדוגמה, כדי להוסיף (או לערוך) מאגר ב-src/foo:

mr config src/foo checkout="svn co svn://example.com/foo/trunk foo"

כדי להציג את הפקודה ש-mr משתמש בה כדי לעדכן את המאגר ב-src/foo:

עדכון src/foo של mr config

כדי לראות את הספרייה המובנית של פונקציות מעטפת הכלולות ב-mr:

mr config ספריית ברירת מחדל

קובץ ה-mrconfig בו נעשה שימוש נבחר על ידי האפשרות -c, או על ידי חיפוש אחר
הקרוב ביותר הידוע בספרייה הנוכחית או בהורה שלה.

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

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

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

לעזור
מציג עזרה זו.

ניתן לקצר פעולות לכל תת-מחרוזת חד-משמעית, כך ש-"mr st" שווה ערך ל-"mr
"סטטוס", ו-"mr up" שווה ערך ל-"mr update"

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

אפשרויות

ספריית -d
--ספרייה ספרייה
מציין את הספרייה העליונה ביותר ש mr אמור לעבוד ב. ברירת המחדל היא הנוכחית
ספריית עבודה.

-c mrconfig
--config mrconfig
השתמש בקובץ mrconfig שצוין. ברירת המחדל היא להשתמש בשניהם. ~/.mrconfig כמו גם
מחפש .mrconfig קובץ בתיקייה הנוכחית, או באחת מתיקיות האב שלה
ספריות.

-f
--כּוֹחַ
לאלץ את mr לפעול על מאגרים שבדרך כלל היו מדלגים עליהם עקב
תצורה.

--force-env
אילוץ את mr לבצע את הפעולה למרות שמוגדרים משתני סביבה שעלולים להיות מסוכנים.

-v
--מִלוּלִי
היו מילוליים.

-m
--מִינִימָלִי
מזער את הפלט. אם פקודה נכשלת או שיש פלט כלשהו, ​​הפלט הרגיל יפעל
יוצגו.

-q
--שֶׁקֶט
שקט. פעולה זו מדכאת את הפלט הרגיל של mr, כמו גם כל פלט מפקודות ש...
מופעלים (כולל פלט stderr). אם פקודה נכשלת, הפלט יוצג.

-k
--לֹא בָּטוּחַ
קבל תעודות SSL לא מהימנות בעת אתחול.

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

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

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

אם צוין מספר, יבוצע חזרה למאגרים לכל היותר מספר זה
עומק של תת-ספריות. לדוגמה, עם -n 2 זה יחזור על עצמו לתוך ./src/foo, אבל לא
./src/packages/bar.

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

שים לב שהפעלת יותר מ-10 משימות בו זמנית עלולה להפריע לחיבור ה-SSH.
מגבלות. הפעלת בין 3 ל-5 משימות בו זמנית תניב שיפור משמעותי בעדכונים.
בלי להעמיס יותר מדי על המכונה.

-t
--אמון-בכולם
תן אמון בכל קבצי mrconfig גם אם הם אינם רשומים ב ~/.mrtrustיש להשתמש בזהירות.

-p
--נָתִיב
דגל מיושן זה אינו מטופל.

MRCONFIG קבצים

הנה דוגמה .mrconfig קובץ:

[מקור]
קופה = svn קופה svn://svn.example.com/src/trunk src
שרשרת = אמת

[מקור/לינוקס-2.6]
קופה = שיבוט גיט git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git &&
cd לינוקס-2.6 ו-
git checkout -b mybranch מקור/מאסטר

השמיים .mrconfig הקובץ משתמש בגרסה של פורמט קובץ INI. שורות המתחילות ב-"#" הן
הערות. ניתן להמשיך ערכים לשורה הבאה על ידי הזחת השורה עם
רווח לבן.

הסעיף "ברירת מחדל" מאפשר הגדרת ערכי ברירת מחדל עבור הסעיפים הבאים אחריו.

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

כל שאר הסעיפים מוסיפים מאגרים. כותרת הסעיף מציינת את הספרייה שבה
המאגר ממוקם. זה יחסית לספרייה שמכילה את קובץ mrconfig,
אבל ניתן גם לבחור להשתמש בנתיבים מוחלטים. (שימו לב שניתן להשתמש בסביבה
משתנים בשמות מקטעים; הם יועברו דרך המעטפת לצורך הרחבה. עבור
לדוגמה, "[$HOSTNAME]", או "[${HOSTNAME}foo]").

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

בדרך כלל צריך לציין רק מה לעשות עבור "קופה". כאן מציין את הפקודה
להפעיל על מנת ליצור תהליך בדיקה של המאגר. הפקודה תבוצע ב-
ספריית האב, וחייבים ליצור את ספריית המאגר. לכן השתמשו ב-"git clone", "svn"
"קופה", "סניף bzr" או "קופה bzr" (לסניף קשור) וכו'.

שימו לב שפקודות מעטפת אלו מופעלות בסביבת מעטפת "set -e", שבה כל
פרמטרים נוספים שתעביר זמינים ב-$@. כל הפקודות מלבד "checkout" הן
לרוץ בתוך המאגר, אם כי לא בהכרח בחלקו העליון.

משתנה הסביבה "MR_REPO" מוגדר לנתיב לראש המאגר. (עבור
פעולת ה"רישום", "MR_REPO" מוגדרת במקום זאת לשם הבסיס של הספרייה ש
יש ליצור בעת בדיקת המאגר.)

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

משתנה הסביבה "MR_ACTION" מוגדר לפקודה המופעלת (עדכון, בדיקה,
וכו ').

לכמה הגדרות יש משמעויות מיוחדות:

לדלג
אם "skip" מוגדר והפקודה שלו מחזירה אמת, אז mr אדלג על הפעולה בנושא זה
מאגר. הפקודה מקבלת את שם הפעולה ב-$1.

הנה שתי דוגמאות. הראשונה מדלגת על המאגר אלא אם כן mr מנוהל על ידי ג'ואי. השנייה
משתמש בפונקציה hours_since (הכלולה בספרייה המובנית של mr) כדי לדלג על עדכון ה-
מאגר אלא אם כן עברו לפחות 12 שעות מאז העדכון האחרון.

[הדברים שלי]
קופה = ...
דלג = test `whoami` != ג'ואי

לינוקס
קופה = ...
דילוג = ["$1" = עדכון] && ! שעות_מאז "$1" 12

דרך נוספת להשתמש ב-skip היא לקופה עצלה. זה גורם ל-mr skip לפעול על מאגר.
אלא אם כן הוא כבר קיים. כדי להפעיל את המאגר, עליך לבדוק אותו במפורש
(באמצעות "mr --force -d foo checkout").

[פו]
קופה = ...
לדלג = עצלן

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

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

שרשרת
אם "chain" מוגדר והפקודה שלו מחזירה true, אז mr ינסה לטעון את .mrconfig
קובץ מהשורש של המאגר.

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

שלא כמו כל דבר אחר, "include" לא צריך להיות ממוקם בתוך מקטע.

mr מספק מספר ספריות שניתן לכלול כדי להוסיף תמיכה לגרסאות נוספות
דברים מסוג בקרה (unison, git-svn, git-fake-bare, git-subtree). כדי לכלול אותם
הכל, אתה יכול להשתמש ב:

include = cat /usr/share/mr/*

עיין בקבצים הבודדים לקבלת פרטים.

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

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

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

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

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

שים לב שהפעלת יותר מ-10 משימות בו זמנית עלולה להפריע לחיבור ה-SSH.
מגבלות. הפעלת בין 3 ל-5 משימות בו זמנית תניב שיפור משמעותי בעדכונים.
בלי להעמיס יותר מדי על המכונה.

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

באופן פנימי, ל-mr יש הגדרות עבור "git_update", "svn_update" וכו'. כדי לשנות את הפעולה
שמבוצע עבור מערכת בקרת גרסאות נתונה, ניתן לעקוף את ה-VCS הללו
פעולות ספציפיות. כדי להוסיף מערכת בקרת גרסאות חדשה, ניתן פשוט להוסיף VCS ספציפי
פעולות עבור זה.

לפני ואחרי
אם "pre_action" מוגדר, הפקודה שלו מופעלת לפני ש-mr מבצע את הפעולה שצוינה.
באופן דומה, פקודות "post_action" מופעלות לאחר ש-mr מבצע בהצלחה את הפעולה שצוינה.
פעולה. לדוגמה, "pre_commit" מופעל לפני ביצוע הפעולה; "post_update" מופעל לאחר מכן
עִדכּוּן.

_לְצַרֵף
ניתן להוסיף לסיומת "_append" לכל הגדרה, כדי להוסיף ערך נוסף לערך הקיים.
ערך הסביבה. בדרך זו, ניתן לבנות פעולות באופן מצטבר.

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

לא אמון MRCONFIG קבצים

מכיוון שקבצי mrconfig יכולים להכיל פקודות מעטפת שרירותיות, הם יכולים לעשות כל דבר. זה
גמישות היא טובה, אבל היא גם מאפשרת לקובץ mrconfig זדוני למחוק את כל שלך
ספריית הבית. קובץ כזה עשוי להיכלל בתוך מאגר שהספרייה הראשית שלך
~/.mrconfig בודק. כדי להימנע מדאגות לגבי פקודות זדוניות בקובץ mrconfig, mr
ברירת המחדל היא קריאת כל קבצי mrconfig מלבד ה-main ~/.mrconfig במצב לא אמין.
במצב לא מהימן, קבצי mrconfig מוגבלים להפעלת פקודות בטוחות ידועות בלבד (כגון
"שיבוט git") באופן שנבדק בקפידה.

כדי להגדיר את mr כך שיתן אמון בקבצי mrconfig אחרים, רשום אותם ב ~/.mrtrustקובץ mrconfig אחד
יש לרשום בכל שורה. יש לרשום את שם הנתיב המלא, או שניתן לרשום את שם הנתיב
להתחיל עם ~/ כדי לציין קובץ יחסי לתיקיית הבית שלך.

מנותק LOG קובץ

השמיים ~/.mrlog הקובץ מכיל פקודות שמר זכר להריץ מאוחר יותר, עקב היותו
לא מקוון. באפשרותך למחוק או לערוך קובץ זה כדי להסיר פקודות, או אפילו להוסיף אחרות
פקודות להפעלת 'mr online'. אם הקובץ קיים, mr מניח שהוא במצב לא מקוון.

הרחבות

ניתן להרחיב את mr כדי לתמוך בדברים כמו unison ו-git-svn. חלק מהקבצים המספקים כאלה
הרחבות זמינות ב /usr/share/mr/ראה את התיעוד בקבצים לקבלת פרטים.
לגבי השימוש בהם.

יְצִיאָה סטָטוּס

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

השתמש ב-mr online באמצעות שירותי onworks.net