git-clone - מקוון בענן

תָכְנִית:

שֵׁם

git-clone - שיבוט מאגר לתוך ספרייה חדשה

תַקצִיר

סילון לשבט [--template= ]
[-l] [-s] [--ללא קישורים קשים] [-q] [-n] [--חשוף] [--מראה]
[-o ] [-ב ] [-u ] [--התייחסות ]
[--נתק] [--separate-git-dir ]
[--עוֹמֶק ] [--[לא-]סניף יחיד]
[--רקורסיבי | --recurse-submodules] [--]
[ ]

תיאור

משבט מאגר לתוך ספרייה חדשה שנוצרה, יוצר ענפי מעקב מרחוק עבור
כל ענף במאגר המשובט (גלוי באמצעות git branch -r), ויוצר ובודק
להוציא ענף ראשוני שמחולק מהענף הפעיל כרגע של המאגר המשובט.

לאחר השיבוט, אחזור git רגיל ללא ארגומנטים יעדכן את כל המעקב מרחוק
סניפים, ו-git pull ללא ארגומנטים ימזגו בנוסף את ענף המאסטר המרוחק
לתוך הענף הראשי הנוכחי, אם קיים (זה לא נכון כאשר ניתן "--סניף יחיד";
ראה למטה).

תצורת ברירת מחדל זו מושגת על ידי יצירת הפניות לראשי הסניף המרוחקים
תחת refs/remotes/origin ועל ידי אתחול של remote.origin.url ו-remote.origin.fetch
משתני תצורה.

אפשרויות

--מקומי, -ל
כאשר המאגר שממנו יש לשכפל נמצא במכונה מקומית, הדגל הזה עוקף את הרגיל
מנגנון הובלה "Git aware" ומשכפל את המאגר על ידי יצירת עותק של HEAD ו
הכל תחת אובייקטים וספריות refs. הקבצים תחת ספריית .git/objects/
מקושרים קשה כדי לחסוך מקום במידת האפשר.

אם המאגר מצוין כנתיב מקומי (למשל, /path/to/repo), זהו ה-
ברירת מחדל, ו---local הוא בעצם No-op. אם המאגר מצוין ככתובת URL,
אז מתעלמים מהדגל הזה (ולעולם איננו משתמשים באופטימיזציות המקומיות). מפרט
--no-local יעקוף את ברירת המחדל כאשר /path/to/repo ניתן, באמצעות הרגיל
Git הובלה במקום.

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

--משותף, -ס
כאשר המאגר לשכפול נמצא על המחשב המקומי, במקום להשתמש בקישורים קשיחים,
הגדר אוטומטית את .git/objects/info/alternates כדי לשתף את האובייקטים עם המקור
מאגר. המאגר שנוצר מתחיל ללא שום אובייקט משלו.

הערה: מדובר בפעולה שעלולה להיות מסוכנת; לַעֲשׂוֹת לֹא השתמש בו אלא אם כן אתה מבין מה
זה עושה. אם תשבט את המאגר שלך באמצעות אפשרות זו ולאחר מכן תמחק ענפים (או
השתמש בכל פקודת Git אחרת שהופכת כל commit קיים ללא הפניה) במקור
מאגר, אובייקטים מסוימים עשויים להפוך ללא הפניה (או להשתלשל). חפצים אלה עשויים להיות
הוסר על ידי פעולות Git רגילות (כגון git commit) שקוראות אוטומטית ל-git gc
--אוטומטי. (לִרְאוֹת git-gc(1).) אם האובייקטים הללו הוסרו והפנו אליהם את
מאגר משובט, אז המאגר המשובט יהפוך מושחת.

שימו לב שהפעלת git repack ללא אפשרות -l במאגר משובט עם -s will
העתק אובייקטים ממאגר המקור לתוך חבילה במאגר המשובט, הסרה
החיסכון בשטח הדיסק של clone -s. עם זאת, בטוח להפעיל git gc, המשתמש ב-
אפשרות -l כברירת מחדל.

אם אתה רוצה לשבור את התלות של מאגר המשובט עם -s במקור שלו
מאגר, אתה יכול פשוט להפעיל את git repack -a כדי להעתיק את כל האובייקטים מהמקור
מאגר לתוך חבילה במאגר המשובט.

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

הערה: עיין בהערה עבור האפשרות --shared, וגם את האפשרות --dissociate.

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

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

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

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

--ללא תשלום, -נ
לא מתבצעת תשלום של HEAD לאחר השלמת השיבוט.

--חָשׂוּף
לעשות חשוף מאגר Git. כלומר, במקום ליצור והצבת
קבצים מנהליים ב /.git, הפוך את עצמו ה-$GIT_DIR.
זה כמובן מרמז על -n כי אין איפה לבדוק את עץ העבודה.
כמו כן, ראשי הסניפים בשלט מועתקים ישירות לסניף המקומי המתאים
ראשים, מבלי למפות אותם ל-refs/remotes/origin/. כאשר משתמשים באפשרות זו, גם לא
נוצרים ענפי מעקב מרחוק ולא משתני התצורה הקשורים.

--מַרְאָה
הגדר מראה של מאגר המקור. זה מרמז על - חשוף. בהשוואה ל--bare,
--mirror לא רק ממפה סניפים מקומיים של המקור לסניפים מקומיים של היעד,
הוא ממפה את כל השומרים (כולל ענפי מעקב מרחוק, הערות וכו') ומגדיר
תצורת refspec כך שכל ה-Refs הללו יוחלפו על ידי עדכון Git מרחוק
במאגר היעד.

--מָקוֹר , -o
במקום להשתמש במקור השם המרוחק כדי לעקוב אחר המאגר במעלה הזרם, השתמש
.

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

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

--תבנית=
ציין את הספרייה שממנה ישמשו תבניות; (ראה את "ספריית התבניות"
קטע של git-init(1).)

--config = , -ג =
הגדר משתנה תצורה במאגר החדש שנוצר; זה נכנס לתוקף
מיד לאחר אתחול המאגר, אך לפני ההיסטוריה המרוחקת
אוחזר או כל קובץ נמחק. המפתח הוא באותו פורמט כפי שמצופה על ידי גיט-
config(1) (למשל, core.eol=true). אם ניתנים מספר ערכים עבור אותו מפתח, כל אחד מהם
הערך ייכתב לקובץ התצורה. זה עושה את זה בטוח, למשל, להוסיף
מפרט אחזור נוסף לשלט המקור.

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

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

--רקורסיבי, --תת-מודולים חוזרים
לאחר יצירת השיבוט, אתחל את כל תת-המודולים בתוך, תוך שימוש בברירת המחדל שלהם
הגדרות. זה שווה ערך להפעלת git submodule update --init --recursive
מיד לאחר סיום השיבוט. אפשרות זו מתעלמת אם משובטים
למאגר אין עץ עבודה/קופה (כלומר, אם אחד מבין --no-checkout/-n, --bare,
או -- מראה נתון)

--separate-git-dir=
במקום למקם את המאגר המשובט היכן שהוא אמור להיות, מקם את המשובט
מאגר בספרייה שצוינה, ולאחר מכן הפוך Git לאגנוסטית למערכת קבצים לסמלית
קישור לשם. התוצאה היא שניתן להפריד את מאגר Git מעץ העבודה.


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


שם ספרייה חדשה שיש לשכפל אליה. החלק ה"אנושי" של המקור
נעשה שימוש במאגר אם לא ניתנת ספריה במפורש (repo עבור /path/to/repo.git ו-
foo עבור host.xz:foo/.git). שיבוט לתוך ספרייה קיימת מותר רק אם
הספרייה ריקה.

GIT כתובות אתרים

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

Git תומך בפרוטוקולי ssh, git, http ו-https (בנוסף, ניתן להשתמש ב-ftp ו-ftps
עבור אחזור ו-rsync ניתן להשתמש עבור אחזור ודחיפה, אבל אלה אינם יעילים ו
הוצא משימוש; אל תשתמש בהם).

התחבורה המקורית (כלומר git:// URL) אינה מבצעת אימות ויש להשתמש בה עם
זהירות ברשתות לא מאובטחות.

ניתן להשתמש בתחבירים הבאים איתם:

· ssh://[user@]host.xz[:port]/path/to/repo.git/

· git://host.xz[:port]/path/to/repo.git/

· http[s]://host.xz[:port]/path/to/repo.git/

· ftp[s]://host.xz[:port]/path/to/repo.git/

· rsync://host.xz/path/to/repo.git/

ניתן להשתמש בתחביר אלטרנטיבי דמוי scp גם עם פרוטוקול ssh:

· [user@]host.xz:path/to/repo.git/

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

פרוטוקולי ssh ו-git תומכים בנוסף בהרחבת ~ שם משתמש:

· ssh://[user@]host.xz[:port]/~[משתמש]/path/to/repo.git/

· git://host.xz[:port]/~[משתמש]/path/to/repo.git/

· [user@]host.xz:/~[משתמש]/path/to/repo.git/

עבור מאגרים מקומיים, הנתמכים גם על ידי Git באופן מקורי, התחבירים הבאים עשויים להיות
מְשׁוּמָשׁ:

· /path/to/repo.git/

· file:///path/to/repo.git/

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

כאשר Git לא יודע איך לטפל בפרוטוקול הובלה מסוים, הוא מנסה להשתמש ב-
מְרוּחָק- עוזר מרחוק, אם קיים. כדי לבקש במפורש עוזר מרחוק,
ניתן להשתמש בתחביר הבא:

· ::

איפה יכול להיות נתיב, שרת ונתיב, או מחרוזת דמוית URL שרירותית
מזוהה על ידי העוזר המרוחק הספציפי שמופעל. לִרְאוֹת gitremote-עוזרים(1) עבור
פרטים.

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

[כתובת אתר " "]
במקום =

לדוגמה, עם זה:

[כתובת אתר "git://git.host.xz/"]
ynsteeOf = host.xz:/path/to/
במקום = עבודה:

כתובת URL כמו "work:repo.git" או כמו "host.xz:/path/to/repo.git" תיכתב מחדש בכל
הקשר שלוקח כתובת אתר להיות "git://git.host.xz/repo.git".

אם ברצונך לשכתב כתובות URL עבור דחיפה בלבד, תוכל ליצור קטע תצורה של ה-
טופס:

[כתובת אתר " "]
pushInsteadOf =

לדוגמה, עם זה:

[כתובת אתר "ssh://example.org/"]
pushInsteadOf = git://example.org/

כתובת אתר כמו "git://example.org/path/to/repo.git" תיכתב מחדש ל
"ssh://example.org/path/to/repo.git" עבור דחיפות, אך משיכות עדיין ישתמשו במקור
כתובת אתר.

דוגמאות

· שיבוט ממעלה הזרם:

$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux
$ cd my-linux
make $

· צור שיבוט מקומי שואל מהספרייה הנוכחית, מבלי לבדוק דברים
מתוך:

$ git clone -l -s -n . ../עותק
$ cd ../copy
$ git show-branch

· שיבוט ממעלה הזרם תוך שאילה ממדריך מקומי קיים:

$ git clone --reference /git/linux.git \
git://git.kernel.org/pub/scm/.../linux.git \
my-linux
$ cd my-linux

· צור מאגר חשוף כדי לפרסם את השינויים שלך לציבור:

$ git clone --bare -l /home/proj/.git /pub/scm/proj.git

GIT

חלק מ סילון(1) סוויטה

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