gbp-buildpackage - מקוון בענן

תָכְנִית:

שֵׁם

gbp-buildpackage - בניית חבילות דביאן ממאגר Git

תַקצִיר

ליש"ט חבילת build [ --git-[no-]ignore-new ] [ --git-tag ] [ --git-verbose ] [ --גיט-
צבע=[אוטומטי|מופעל|כבוי] ] [ --git-color-scheme=סכמת צבעים ] [ --git-notify=[אוטומטי|מופעל|כבוי] ] [
--git-upstream-branch=TREEISH ] [ --git-debian-branch=שם הסניף ] [ --git-ignore-branch
] [ --git-[no-]תת-מודולים ] [ --git-builder=BUILD_CMD ] [ --git-cleaner=CLEAN_CMD ] [
--git-[no-]pbuilder ] [ --git-[no-]qebuuilder ] [ --git-dist=DIST ] [ --git-arch=קשת ] [
--git-[no-]pbuilder-autoconf ] [ --git-pbuilder-options=PBUILDER_OPTIONS ] [
--git-[no-]sign-tags ] [ --git-keyid=GPG-KEYID ] [ --git-posttag=פקודה ] [ --גיט-
postbuild =פקודה ] [ --git-postexport=פקודה ] [ --git-prebuild=פקודה ] [
--git-[no-]הוקס ] [ --git-debian-tag=פורמט תג ] [ --git-upstream-tag=פורמט תג ] [
--git-debian-tag-msg=tag-msg-format ] [ --git-force-create ] [ --git-no-create-orig ] [
--git-upstream-tree=[TAG|BRANCH|TREEISH] ] [ --git-tarball-dir=DIRECTORY ] [ --גיט-
דחיסה=סוג ] [ --git-compression-level=רמה ] [ --git-export-dir=DIRECTORY ] [
--git-export=TREEISH ] [ --git-[no-]בתולי-טאר ] [ --git-[no-]prime-tar-commit ] [
--git-[no-]-טיהור ] [ --git-dont-purge ] [ --git-tag-only ] [ --git-retag ] [
OPTION_PASSED_TO_BUILD_CMD ... ]

תיאור

ליש"ט חבילת build משמש לבניית חבילות מקור של דביאן ו-.deb ממאגר Git.

ליש"ט חבילת build יהיה, לפי הסדר:

· ודא שהוא מבוצע מהמיקום המתאים.

· ודא שהמאגר אינו מכיל שינויים במקור לא מחויב.

· ודא שהוא מבוצע מהסניף הנכון.

· (אופציונלי) הפעל פקודה נקייה שצוינה עם --git-cleaner.

· (אופציונלי) ייצא את עץ המקור לאזור בנייה נפרד.

· בנו Tarball מקורי אם הוא לא קיים. אופציונלי באמצעות זפת בתולי.

· (אופציונלי) התקשר ל-pre build hook.

· התקשר לבנות(1) או Cowbuilder (דרך --git-pbuilder) או האפליקציה שצוינה באמצעות
--git-builder מעביר את כל הטיעונים שניתנו ל ליש"ט חבילת build בשורת הפקודה
שלא מתחילים ב--git-.

· (אופציונלי) תייג את העץ לאחר בנייה מוצלחת.

· (אופציונלי) קרא ל-post build hook - למשל כדי להפעיל lintian.

· (אופציונלי) התקשר ל-post tag hook - למשל כדי לדחוף את התוצאות למאגר מרוחק
לאחר יצירת התג.

אפשרויות

לכל האפשרויות יש קידומת גיט- להבחין בין אפשרויות עבור ליש"ט חבילת build החל מ-
אפשרויות שהועברו ל- BUILD_CMD:

--git-[no-]ignore-new
אל תבטל אם יש שינויים לא מחויבים בעץ המקור או בזרם
סניף לא תואם את DEBIAN-BRANCH.

--git-tag
הוסף תגית git לאחר בנייה מוצלחת. זוהי אפשרות שורת פקודה בלבד
לא ניתן לציין באמצעות gbp.conf.

--git-builder=BUILD_CMD
השתמש BUILD_CMD במקום לבנות -i -I.

--git-cleaner=CLEAN_CMD
השתמש CLEAN_CMD במקום לבנות לְנַקוֹת.

--git-pbuilder
בניית חבילה באמצעות git-pbuilder. שים לב שזה מחליף כל --git-builder ו
--git-cleaner אפשרויות.

--git-qemubuilder
בניית חבילה באמצעות git-pbuilder עם qemubuilder. שים לב שזה מחליף כל
--git-builder ו --git-cleaner אפשרויות.

--git-dist=DIST
בנה להפצה DIST בעת שימוש --git-pbuilder. אם לא מוגדר לבנות עבור
הפצה לא יציבה. הערך המיוחד DEP14 יקבע את ההפצה לבנות
עבור משם הסניף. כלומר אם אתה מתחיל את הבנייה מענף בשם
debian/wheezy-backports ההתפלגות מוגדרת ל צפצופים-גב. אם הסניף
נקרא במורד/צד ההפצה תוגדר ל downstream_sid.

--git-arch=קשת
בנה לאדריכלות קשת בעת שימוש --git-pbuilder. אם לא מוגדר, אין ארכיטקטורה
עבר ל git-pbuilder.

--git-pbuilder-autoconf
האם לנסות להגדיר אוטומטית git-pbuilder או להסתמך על ההגדרות ב
.pbuilderrc. ראה את git-pbuilder עמוד אדם לפרטים.

--git-pbuilder-options
אפשרויות להעביר ל-pbuilder

--git-verbose
ביצוע מילולי

--git-color=[אוטומטי|מופעל|כבוי]
האם להשתמש בפלט צבעוני.

--git-notify=[אוטומטי|מופעל|כבוי]
האם לשלוח הודעה על שולחן העבודה לאחר הבנייה.

--git-color-scheme=סכמת צבעים
צבעים לשימוש בפלט (כאשר צבע מופעל). הפורמט של COLOR_SCHEME הוא
' : : : '. ערכים מספריים ושמות צבעים מתקבלים,
שדות ריקים מרמזים על צבע ברירת המחדל. לדוגמה --git-color-scheme='cyan:34::'
יציג הודעות ניפוי באגים בציאן, הודעות מידע בכחול והודעות אחרות ב
ברירת מחדל (כלומר הודעות אזהרה ושגיאה באדום).

--git-upstream-branch=שם הסניף
ענף לבניית ה-Tarball המקורי מ- if --git-upstream-tree מוגדר סניף.
ברירת המחדל היא בְּמַעֲלֶה הַזֶרֶם.

--git-debian-branch=שם הסניף
אם אינך נמצא בסניף הזה בעת הפנייה ליש"ט חבילת build זה ייכשל. בְּרִירַת מֶחדָל
is אב. זה נעשה כדי לוודא שלא תשתחרר בטעות מנושא
ענף. אי-הימצאות בסניף זה יתעלם בעת השימוש --git-ignore-new.

--git-ignore-branch
אל תבדוק אם הסניף הנוכחי תואם DEBIAN-BRANCH.

--git-[no-]sign-tags
GPG חתום על כל התגים שנוצרו.

--git-[no-]תת-מודולים
כלול תת-מודולי git ב-Orig Tarball.

--git-keyid=GPG-KEYID
השתמש במפתח מפתח זה עבור תגי חתימת gpg.

--git-posttag=פקודה
לבצע פקודה לאחר תיוג גרסה חדשה.

משתני הסביבה המיוצאים הם: GBP_TAG (שם התג שנוצר),
GBP_BRANCH (הענף ממנו נבנתה החבילה) ו GBP_SHA1 (הsha1 של ה
commit התג נוצר ב).

--git-postbuild=פקודה
לבצע פקודה לאחר בנייה מוצלחת.

משתני הסביבה המיוצאים הם: GBP_CHANGES_FILE (שם המיוצר
קובץ שינויים), GBP_BUILD_DIR (בינוי הדירקטור).

--git-postexport=פקודה
לבצע פקודה לאחר ייצוא עץ המקור - תקף רק אם --git-export-dir
צוין.

משתני הסביבה המיוצאים הם: GBP_GIT_DIR (המאגר שהחבילה היא
נבנה מ), GBP_TMP_DIR (הספרייה הזמנית שבה היו המקורות
מיוצא בתחילה).

--git-prebuild=פקודה
לבצע פקודה מספריית ה-build לפני ההתקשרות לבנות או האפליקציה
שצוין באמצעות --git-builder.

משתני הסביבה המיוצאים הם: GBP_GIT_DIR (המאגר שהחבילה היא
נבנה מ), GBP_BUILD_DIR (בינוי הדירקטור).

--git-[no-]הוקס
אפשר להפעיל את כל ה-hooks (נקי יותר, postexport, prebuild, postbuild ו-posttag).
הערה: --git-builder הפקודה אינה מושפעת מאפשרות זו.

--git-debian-tag=TAG-FORMAT
השתמש בפורמט תג זה בעת תיוג גרסאות Debian, ברירת המחדל היא debian/%(version)s.

--git-upstream-tag=TAG-FORMAT
השתמש בפורמט תג זה כאשר אתה מחפש תגים של גרסאות במעלה הזרם, ברירת המחדל היא
במעלה הזרם/%(גרסה)s.

--git-debian-tag-msg=tag-msg-format
השתמש בפורמט הודעת התג הזה בעת חתימה על גרסאות דביאן, ברירת המחדל היא %(pkg)s דביאן
לשחרר %(גרסה)s

--git-force-create
כוח יצירה של טארבול מקור (החלפת אחד קיים אם קיים).

--git-no-create-orig
אל תנסו ליצור שום טארבול מקורי.

--git-overlay
מחלץ טארבול מקורי tarball-dir בעת השימוש ב- export-dir אפשרות (באנלוגיה
למיזוגWithUpstream ב-svn-bp). הסר גם את debian/ אם כלול במעלה הזרם
tarball במקרה של פורמטי מקור 2.0 ו-3.0.

--git-export-dir=DIRECTORY
ייצא את ראש הענף הנוכחי (או האובייקט העצים שניתן באמצעות --git-export ל
DIRECTORY לפני הבנייה.

--git-export=TREEISH
במקום לייצא את ראש הענף הנוכחי, ייצא את האובייקט העץ TREEISH.
השם המיוחד מדד מייצא את האינדקס הנוכחי ואילו השם המיוחד WC
מייצא את עותק העבודה הנוכחי כפי שהוא.

--git-upstream-tree=[TAG|BRANCH|TREEISH]
כיצד למצוא את המקורות במעלה הזרם המשמשים ליצירת ה-tarball. תָג (ברירת המחדל)
מסתכל על תג המתאים לגרסה ביומן השינויים. סניף מסתכל על
סניף במעלה הזרם ניתן דרך --git-upstream-branch אוֹפְּצִיָה. ערכים אחרים הם
מתפרשים כעצים.

זה לא משפיע אם --git-בתולי-טאר נמצא בשימוש.

--git-tarball-dir=DIRECTORY
חפש ב-tarballs מקוריים DIRECTORY במקום לייצר אותם.

--git-compression=סוג
מציין את סוג הדחיסה של Tarball במעלה הזרם. זה ישמש לאיתור ו
בנה את ה-tarball במעלה הזרם במידת הצורך. ברירת המחדל היא המכונית אשר נובע את
סוג הדחיסה מענף הזפת הטהור אם זמין ונופל בחזרה ל-gzip
אחרת. אפשרויות אחרות הן מופעלת דחיסת, bzip2, lzma ו xz.

--git-compression-level=רמה
מציין את רמת הדחיסה של ה-tarball במעלה הזרם אם יש צורך ב-tarball במעלה הזרם
בנוי.

--git[-no]-טיהור
טהר (הסר) ספריית בנייה זמנית לאחר בנייה.

--git-dont-purge
הוצא משימוש, השתמש במקום זאת ב--git-no-purge. זוהי אפשרות שורת פקודה בלבד
לא ניתן לציין באמצעות gbp.conf.

--git-tag-only
אל תבנה, רק תייגו והפעילו hooke post-tag. זוהי אפשרות שורת פקודה בלבד
שלא ניתן לציין באמצעות gbp.conf.

--git-retag
אל תיכשל בפעולות תג אם כבר קיים תג עם אותה גרסה. זה
אפשרות שורת הפקודה בלבד שלא ניתן לציין באמצעות gbp.conf.

--git-בתולי-טאר
השתמש בזפת בתולי בעת יצירת ה-tarball במעלה הזרם אם הוא לא קיים.

--git-prime-tar-commit
תחייב את דלתא הזפת הבתולי לענף הזפת הבתולי אם היה טרבול חדש
נוצר ונתוני הזפת הבתוליים אינם כבר שם.

דוגמאות

בנה חבילת Debian באמצעות git-pbuilder שבתורו קורא בונה פרות. לְהוֹרוֹת
בונה פרות לבנות בתוך Wheezy chroot עבור i386.

ליש"ט חבילת build --git-pbuilder --git-arch=i386 --git-dist=wheezy

שימו לב כי האמור לעיל צריך א בונה פרות chroot כבר. ניתן ליצור זאת באמצעות:

DIST=wheezy ARCH=i386 git-pbuilder לִיצוֹר

תְצוּרָה קבצים

כמה gbp.conf קבצים מנותחים כדי להגדיר ברירת מחדל עבור הארגומנטים של שורת הפקודה לעיל.
ראה gbp.conf(5)> דף אדם לפרטים.

יש לציין את כל האפשרויות בקבצי התצורה ללא הקידומת 'git-'. אז למשל
--git-debian-branch=debian/sid הופך פנימה gbp.conf:

[חבילת בנייה]
debian-dir = debian/sid

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