docker-build - מקוון בענן

תָכְנִית:

שֵׁם

docker-build - בנה תמונה חדשה מקוד המקור ב-PATH

תַקצִיר

סַוָר לִבנוֹת [--build-arg[=[]]] [---cpu-shares[=0]] [--cgroup-הורה[=CGROUP-הורה]]
[- עזרה] [-f|--קוֹבֶץ[=PATH/Dockerfile]] [--force-rm] [--בידוד[=ברירת מחדל]] [--ללא מטמון]
[--מְשׁוֹך] [-q|--שֶׁקֶט] [--rm[=נָכוֹן]] [-t|--תָג[=[]]] [-m|--זיכרון[=זיכרון]]
[--החלפת זיכרון[=להגביל]] [--שמ-גודל[=SHM-SIZE]] [---cpu-period[=0]] [--מכסת מעבד[=0]]
[--cpuset-cpus[=CPUSET-CPUS]] [--cpuset-mems[=CPUSET-MEMS]] [--ulimit[=[]]] נתיב | כתובת אתר | -

תיאור

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

אזהרה, זה ישלח הרבה נתונים לדמון Docker בהתאם לתוכן של
הספרייה הנוכחית. ה-build מנוהל על ידי דמון Docker, לא על ידי CLI, אז כולו
יש להעביר את ההקשר לדמון. ה-Docker CLI מדווח "שליחת הקשר בנייה
to Docker daemon" כאשר ההקשר נשלח לדמון.

כאשר ניתנת כתובת האתר לארכיון tarball או ל-Dockerfile בודד, לא נשלח הקשר
מהלקוח לדמון Docker. במקרה זה, ה- Dockerfile בשורש ה-
ארכיון ושאר הארכיון יתרגלו כהקשר של הבנייה. כאשר Git
המאגר מוגדר כ- כתובת האתר, המאגר משובט מקומי ואז נשלח כ-
ההקשר.

אפשרויות

-f, --קוֹבֶץ=PATH/Dockerfile
נתיב אל Dockerfile לשימוש. אם השביל הוא נתיב יחסי ואתה כן
בנייה מספרייה מקומית, אז הנתיב חייב להיות יחסי לזה
מַדרִיך. אם אתה בונה מכתובת אתר מרוחקת המפנה אל א
tarball או מאגר Git, אז הנתיב חייב להיות ביחס לשורש של
ההקשר המרוחק. בכל המקרים, הקובץ חייב להיות בהקשר ה-build.
ברירת המחדל היא דוקרפיל.

--build-arg=משתנה
שם וערך של א buildarg.

לדוגמה, אם אתה רוצה להעביר ערך עבור http_proxy, להשתמש
--build-arg=http_proxy="http://some.proxy.url"

משתמשים מעבירים ערכים אלה בזמן הבנייה. Docker משתמש ב- buildargs כמו
הקשר סביבתי עבור פקודות המופעלות באמצעות ה- Dockerfile לָרוּץ הוראה
או להרחבה משתנה בהוראות Dockerfile אחרות. אין הכוונה לכך
על העברת ערכים סודיים. ⟨/reference/builder/#arg⟩

--force-rm=נָכוֹן|שקר
הסר תמיד מיכלי ביניים, גם לאחר בנייה לא מוצלחת. ברירת המחדל היא
שקר.

--בידוד="ברירת מחדל"
בידוד מציין את סוג טכנולוגיית הבידוד המשמשת מכולות.

--ללא מטמון=נָכוֹן|שקר
אל תשתמש במטמון בעת ​​בניית התמונה. ברירת המחדל היא שקר.

- עזרה
הדפס הצהרת שימוש

--מְשׁוֹך=נָכוֹן|שקר
נסה תמיד למשוך גרסה חדשה יותר של התמונה. ברירת המחדל היא שקר.

-q, --שֶׁקֶט=נָכוֹן|שקר
דחק את פלט הבנייה ומזהה תמונה להדפיס עם הצלחה. ברירת המחדל היא שקר.

--rm=נָכוֹן|שקר
הסר מיכלי ביניים לאחר בנייה מוצלחת. ברירת המחדל היא נָכוֹן.

-t, --תָג= ""
שמות מאגר (ואופציונלי עם תגים) ליישום על התמונה המתקבלת ב
מקרה של הצלחה.

-m, --זיכרון=זיכרון
מגבלת זיכרון

--החלפת זיכרון=להגביל
ערך גבול השווה לזיכרון בתוספת החלפה. חייב לשמש עם -m (--זיכרון) דגל. ה
להחליף להגביל תמיד צריך להיות גדול מ -m (--זיכרון) ערך.

הפורמט של להגביל is [ ]. יחידה יכולה להיות b (בתים), k (קילובייט), m
(מגה-בייט), או g (גיגה-בייט). אם לא תציין יחידה, b משמש. הגדר את LIMIT ל -1 ל
אפשר החלפה בלתי מוגבלת.

--שמ-גודל=SHM-SIZE
מידה של / dev / shm. הפורמט הוא . מספר חייב להיות גדול מ 0.
היחידה היא אופציונלית ויכולה להיות b (בתים), k (קילובייט), m (מגה-בייט), או g (גיגה-בייט).
אם תשמיט את היחידה, המערכת משתמשת בתים.
אם תשמיט את הגודל לחלוטין, המערכת משתמשת 64m.

---cpu-shares=0
מניות מעבד (משקל יחסי).

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

חתול /sys/fs/cgroup/cpu/cpu.shares
1024

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

כדי לשנות את הפרופורציה מברירת המחדל של 1024, השתמש ב- ---cpu-shares
דגל כדי להגדיר את השקלול ל-2 ומעלה.

דגל שיתוף מעבד מיכל
{C0} 60% מ-CPU --cpu-shares=614 (614 הם 60% מ-1024)
{C1} 40% מ-CPU --cpu-shares=410 (410 הם 40% מ-1024)

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

לדוגמה, שקול שלושה מכולות, כאשר לאחד יש --cpu-shares=1024 ו
לשניים אחרים יש --cpu-shares=512. כאשר תהליכים בשלושתם
קונטיינרים מנסים להשתמש ב-100% מהמעבד, הקונטיינר הראשון יקבל
50% מזמן המעבד הכולל. אם תוסיף מיכל רביעי עם --cpu-shares=1024,
המיכל הראשון מקבל רק 33% מהמעבד. המיכלים הנותרים
לקבל 16.5%, 16.5% ו-33% מהמעבד.

שיתוף מעבד מיכל סגל זמן מעבד
{C0} 100% --cpu-shares=1024 33%
{C1} 50% --cpu-shares=512 16.5%
{C2} 50% --cpu-shares=512 16.5%
{C4} 100% --cpu-shares=1024 33%

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

לדוגמה, שקול מערכת עם יותר משלוש ליבות. אם אתה מתחיל אחד
מכולה {C0} עם --cpu-shares=512 הפעלת תהליך אחד, ומיכל אחר
{C1} עם --cpu-shares=1024 הפעלת שני תהליכים, זה יכול לגרום לתוצאות הבאות
חלוקת מניות המעבד:

שיתוף מעבד של מיכל PID
100 {C0} 0 100% מ-CPU0
101 {C1} 1 100% מ-CPU1
102 {C1} 2 100% מ-CPU2

---cpu-period=0
הגבל את תקופת CPU CFS (תזמן הוגן לחלוטין).

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

--מכסת מעבד=0
הגבל את מכסת המעבד CFS (תזמן הוגן לחלוטין).

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

--cpuset-cpus=CPUSET-CPUS
מעבדים שבהם ניתן לאפשר ביצוע (0-3, 0,1).

--cpuset-mems=CPUSET-MEMS
צמתי זיכרון (MEMs) שבהם לאפשר ביצוע (0-3, 0,1). יעיל רק ב
מערכות NUMA.

לדוגמה, אם יש לך ארבעה צמתי זיכרון במערכת שלך (0-3), השתמש --cpuset-mems=0,1 ל
ודא שהתהליכים בקונטיינר Docker שלך משתמשים רק בזיכרון משני הזיכרון הראשונים
צמתים.

--cgroup-הורה=CGROUP-הורה
הדרך אל קבוצות שמתחתיו של המכולה cgroup נוצרו.

אם הנתיב אינו מוחלט, הנתיב נחשב ביחס ל- קבוצות נתיב של
להתחיל תהליך. קבוצות C נוצרות אם הן לא קיימות.

--ulimit=[]
אפשרויות Ulimit

לקבלת מידע נוסף על אולימיט לִרְאוֹת
⟨https://docs.docker.com/reference/commandline/run/#setting-ulimits-in-a-container⟩

דוגמאות

בִּניָן an תמונה באמצעות a דוקרפיל ממוקם בתוך מה היא נוֹכְחִי בספרייה

ניתן לבנות תמונות Docker באמצעות פקודת build ו-Dockerfile:

בניית docker .

במהלך תהליך הבנייה Docker יוצר תמונות ביניים. כדי לשמור עליהם, אתה
חייב להגדיר במפורש --rm=false.

docker build --rm=false.

תרגול טוב הוא ליצור ספריית משנה עם שם קשור וליצור את ה- Dockerfile
בספרייה ההיא. לדוגמה, ספרייה בשם mongo עשויה להכיל Dockerfile to
צור תמונת Docker MongoDB. כמו כן, ניתן להשתמש בספרייה אחרת בשם httpd
אחסן Dockerfiles עבור תמונות שרת האינטרנט של Apache.

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

הערה: אם אתה כולל קובץ tar (תרגול טוב), Docker יחלץ אוטומטית
התוכן של קובץ tar שצוין בתוך הוסף הוראה לתוך המפורט
יעד.

בִּניָן an תמונה ו שמות זֶה תמונה

תרגול טוב הוא לתת שם לתמונה שאתה בונה. שימו לב שרק a-z0-9-_.
יש להשתמש לשם עקביות. אין כאן כללים קשים אבל עדיף לתת את
שיקול שמות.

אל האני -t/--תָג הדגל משמש לשינוי שם של תמונה. הנה כמה דוגמאות:

למרות שזה לא נוהג טוב, שמות תמונות יכולים להיות שרירותיים:

docker build -t myimage .

גישה טובה יותר היא לספק מאגר, שם ותג מוסמך ומשמעותי
(כאשר התג בהקשר זה פירושו המוקדמות לאחר ה-":"). בדוגמה זו אנחנו
בנה תמונת JBoss עבור מאגר Fedora ותן לו את הגרסה 1.0:

docker build -t fedora/jboss:1.0 .

הדוגמה הבאה היא עבור מאגר המשתמשים "מתי" ומשתמשת בפדורה וב-JBoss ונותנת
זו הגרסה 2.1:

docker build -t whenry/fedora-jboss:v2.1 .

אם לא תספק תג גרסה, Docker יקצה האחרון:

docker build -t whenry/fedora-jboss .

כאשר אתה מפרט את התמונות, התמונה שלמעלה תכלול את התג האחרון.

אתה יכול להחיל תגים מרובים על תמונה. לדוגמה, אתה יכול ליישם את האחרון תג ל-a
תמונה חדשה שנבנתה ולהוסיף תג נוסף המפנה לגרסה ספציפית. למשל, כדי
תייגו תמונה גם בתור whenry/fedora-jboss:latest ו whenry/fedora-jboss:v2.1, להשתמש ב
הבא:

docker build -t whenry/fedora-jboss:האחרון -t whenry/fedora-jboss:v2.1 .

אז שינוי שם של תמונה הוא שרירותי אבל צריך לקחת בחשבון מוסכמה שימושית
זה הגיוני לצרכנים וצריך לקחת בחשבון גם את קהילת Docker
מוסכמות.

בִּניָן an תמונה באמצעות a כתובת האתר

זה ישכפל את מאגר GitHub שצוין מכתובת האתר וישתמש בו כהקשר. ה
Dockerfile בשורש המאגר משמש בתור Dockerfile. זה עובד רק אם
מאגר GitHub הוא מאגר ייעודי.

docker build github.com/scollier/purpletest

הערה: אתה יכול להגדיר מאגר Git שרירותי דרך git:// סכֵימָה.

בִּניָן an תמונה באמצעות a כתובת האתר ל a tarball'ed הקשר

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

docker build -f dev/Dockerfile https://10.10.10.1/docker/context.tar.gz

הערה: פורמטי הדחיסה הנתמכים הם 'xz', 'bzip2', 'gzip' ו-'identity' (לא
דְחִיסָה).

לפרט בדידות טֶכנוֹלוֹגִיָה ל מכולה (--בידוד)

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

· ברירת מחדל: השתמש בערך שצוין על ידי ה-Docker daemon --exec-opt . אם דמון עושה
לא לציין טכנולוגיית בידוד, משתמשת Microsoft Windows תהליך כברירת המחדל שלו
ערך.

· תהליך: בידוד מרחב שמות בלבד.

· hyperv: בידוד מבוסס מחיצות Hyper-V hypervisor.

ציון ה- --בידוד דגל ללא ערך זהה להגדרה
--isolation="default".

הִיסטוֹרִיָה

מרץ 2014, חובר במקור על ידי ויליאם הנרי (כאשר נכתב ב-redhat dot com) על סמך
חומר מקור של docker.com ועבודה פנימית. יוני 2014, עודכן על ידי Sven Dowideit
⟨[מוגן בדוא"ל]⟩ יוני 2015, עודכן על ידי סאלי אומאלי ⟨[מוגן בדוא"ל]⟩

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