อัพเดต God submodule

ฉันไม่ชัดเจนเกี่ยวกับความหมายต่อไปนี้ (จากเอกสารอัปเดต submodule Git ):

... จะทำให้ส่วนหัวของ submodules ยกเว้น--rebaseหรือ--mergeระบุไว้ ...

อย่างไร--rebase/ --mergeสิ่งที่เปลี่ยนแปลง?

กรณีการใช้งานหลักของฉันคือการมีที่เก็บส่วนกลางจำนวนมากซึ่งฉันจะฝังผ่าน submodules ไปยังที่เก็บอื่น ๆ ฉันต้องการที่จะสามารถปรับปรุงที่เก็บข้อมูลส่วนกลางเหล่านี้ไม่ว่าจะอยู่ในตำแหน่งเดิมโดยตรงหรือจากภายในคลังเก็บของที่ฝังอยู่ (ที่เก็บที่ใช้ผ่านทาง submodule)

• จากภายใน submodules เหล่านี้ฉันสามารถสร้าง branch / modified และใช้ push / pull เหมือนกับที่ใช้ใน repositories ปกติหรือมีสิ่งที่ต้องระวังหรือไม่?
• ฉันจะก้าวหน้าไปถึงการส่งซับออเดอร์ที่อ้างอิงจากการพูด (ติดแท็ก) 1.0 ถึง 1.1 (แม้ว่าส่วนหัวของที่เก็บต้นฉบับนั้นมีอยู่ที่ 2.0) หรือเลือกการกระทำของสาขาที่ใช้เลย

นี้หน้า GitProไม่สรุปผลของการปรับปรุงการคอมไพล์ submodule อย่าง

เมื่อคุณเรียกใช้git submodule updateมันจะตรวจสอบโครงการเฉพาะรุ่น แต่ไม่อยู่ในสาขา สิ่งนี้เรียกว่าการมีเฮดเดอร์เดี่ยว - หมายถึงไฟล์ HEAD ชี้ไปที่การคอมมิทโดยตรงไม่ใช่การอ้างอิงสัญลักษณ์ ปัญหาก็คือคุณมักไม่ต้องการที่จะทำงานในสภาพแวดล้อมที่หัวเดี่ยวเพราะมันเป็นเรื่องง่ายที่จะสูญเสียการเปลี่ยนแปลง

หากคุณทำการอัปเดต submodule เริ่มต้นให้คอมมิตในไดเร็กทอรี่ submodule นั้นโดยไม่ต้องสร้างสาขาเพื่อทำงานจากนั้นรัน god submodule update อีกครั้งจาก superproject โดยไม่ต้องทำในเวลาเดียวกัน Git จะเขียนทับการเปลี่ยนแปลงของคุณโดยไม่บอกคุณ ในทางเทคนิคคุณจะไม่สูญเสียงาน แต่คุณจะไม่มีสาขาที่ชี้ไปที่มันดังนั้นมันจะค่อนข้างยากที่จะเรียกคืน

หมายเหตุมีนาคม 2013:

ดังที่กล่าวไว้ใน " การติดตาม submodule git ล่าสุด " ตอนนี้ submodule (git1.8.2) สามารถติดตามสาขาได้

# add submodule to track master branch
git submodule add -b master [URL to Git repo];

# update your submodule
git submodule update --remote 
# or (with rebase)
git submodule update --rebase --remote

ดู " git submodule update --remotevsgit pull "

คำตอบของMindToothแสดงให้เห็นถึงการอัพเดทด้วยตนเอง (โดยไม่มีการกำหนดค่าในเครื่อง):

git submodule -q foreach git pull -q origin master

ในทั้งสองกรณีที่จะเปลี่ยนการอ้างอิง submodules ( gitlink , รายการพิเศษในดัชนี repo หลัก ) และคุณจะต้องเพิ่มกระทำและผลักดันการอ้างอิงดังกล่าวจาก repo หลัก
ครั้งต่อไปที่คุณจะโคลนผู้ปกครอง repo มันจะเติมข้อมูลเพื่อสะท้อนการอ้างอิง SHA1 ใหม่เหล่านั้น

ส่วนที่เหลือของคำตอบนี้ให้รายละเอียดเกี่ยวกับคุณลักษณะ submodule แบบคลาสสิก (อ้างอิงถึงการกระทำที่คงที่ซึ่งเป็นจุดที่อยู่เบื้องหลังแนวคิดของ submodule)

เพื่อหลีกเลี่ยงปัญหานี้ให้สร้างสาขาเมื่อคุณทำงานในไดเรกทอรี submodule ด้วย git checkout -b งานหรือสิ่งที่เทียบเท่า เมื่อคุณทำ submodule อัปเดตเป็นครั้งที่สองมันจะยังคงกลับไปทำงานของคุณ แต่อย่างน้อยคุณก็มีตัวชี้เพื่อกลับไป

การสลับสาขากับ submodules ในพวกเขายังสามารถหากิน หากคุณสร้างสาขาใหม่เพิ่ม submodule ที่นั่นแล้วเปลี่ยนกลับเป็นสาขาที่ไม่มี submodule นั้นคุณยังคงมีไดเรกทอรี submodule เป็นไดเรกทอรีที่ไม่ได้ติดตาม:

ดังนั้นเพื่อตอบคำถามของคุณ:

ฉันสามารถสร้างสาขา / การดัดแปลงและใช้การผลัก / ดึงเหมือนที่ฉันทำใน repos ปกติหรือมีสิ่งที่ต้องระวังหรือไม่

คุณสามารถสร้างสาขาและการปรับเปลี่ยนแบบพุช

คำเตือน (จากGit Submodule Tutorial ): เผยแพร่ (ดัน) การเปลี่ยนแปลง submodule ทุกครั้งก่อนที่จะเผยแพร่ (กด) การเปลี่ยนแปลงของ superproject ที่อ้างอิงถึงมัน หากคุณลืมที่จะเผยแพร่การเปลี่ยนแปลง submodule คนอื่นจะไม่สามารถโคลนที่เก็บ

ฉันจะเลื่อนระดับอนุเสาวรีย์ที่อ้างอิงจากการพูด (ติดแท็ก) 1.0 เป็น 1.1 ได้อย่างไร (แม้ว่าหัวหน้า repo ดั้งเดิมจะมีอยู่ที่ 2.0)

หน้า "การทำความเข้าใจกับโมดูลย่อย " สามารถช่วยได้

God submodules ถูกนำมาใช้โดยใช้สองส่วนที่เคลื่อนไหว:

• .gitmodulesไฟล์และ
• วัตถุต้นไม้ชนิดพิเศษ

เหล่านี้ร่วมกันเป็นรูปสามเหลี่ยมการแก้ไขเฉพาะของพื้นที่เก็บข้อมูลที่เฉพาะเจาะจงซึ่งมีการตรวจสอบลงในสถานที่เฉพาะในโครงการของคุณ

จากหน้า submodule git

คุณไม่สามารถแก้ไขเนื้อหาของ submodule จากภายในโครงการหลัก

ถูกต้อง 100%: คุณไม่สามารถแก้ไข submodule เพียงอ้างถึงข้อผูกพันข้อใดข้อหนึ่ง

นี่คือเหตุผลที่เมื่อคุณแก้ไข submodule จากภายในโครงการหลักคุณ:

• ต้องยอมรับและผลักดันภายใน submodule (ไปยังโมดูลอัปสตรีม) และ
• จากนั้นขึ้นไปในโครงการหลักของคุณและมอบหมายอีกครั้ง (เพื่อให้โครงการหลักนั้นอ้างถึง submodule ใหม่ที่คุณเพิ่งสร้างและผลักดัน)

submodule ช่วยให้คุณมี การพัฒนาวิธีการตามองค์ประกอบที่โครงการหลักหมายถึงการกระทำที่เฉพาะเจาะจงของส่วนประกอบอื่น ๆ (ที่นี่ "ที่เก็บ Git อื่น ๆ ประกาศเป็นโมดูลย่อย")

submodule เป็นเครื่องหมาย (กระทำ) ไปยังพื้นที่เก็บข้อมูล Git อื่นซึ่งไม่ได้ถูกผูกไว้โดยวงจรการพัฒนาโครงการหลัก: มัน ("อื่น ๆ " Git repo) สามารถวิวัฒนาการได้อย่างอิสระ
มันขึ้นอยู่กับโครงการหลักที่จะเลือกจาก repo อื่น ๆ ไม่ว่าจะเป็นการกระทำที่ต้องการ

อย่างไรก็ตามคุณควรต้องการที่จะออกจากความสะดวกสบาย , แก้ไขหนึ่ง submodules เหล่านั้นได้โดยตรงจากโครงการหลักของคุณ Git ช่วยให้คุณทำอย่างนั้นให้คุณแรกเผยแพร่การปรับเปลี่ยน submodule เหล่านั้นเพื่อ Git repo เดิมและจากนั้นกระทำโครงการหลักของคุณหมายถึงใหม่รุ่นของ submodule กล่าวว่า

แต่แนวคิดหลักยังคงอยู่: อ้างอิงองค์ประกอบเฉพาะซึ่ง:

• มีวงจรชีวิตของตัวเอง
• มีชุดแท็กของตนเอง
• มีการพัฒนาของตัวเอง

รายการของการคอมมิทเฉพาะที่คุณอ้างถึงในโครงการหลักของคุณกำหนดการกำหนดค่าของคุณ(นี่คือสิ่งที่การจัดการการกำหนดค่าเป็นเรื่องเกี่ยวกับการรวบรวมเพียงระบบควบคุมเวอร์ชัน )

หากองค์ประกอบสามารถพัฒนาได้ในเวลาเดียวกับโครงการหลักของคุณ (เพราะการดัดแปลงใด ๆ ในโครงการหลักจะเกี่ยวข้องกับการแก้ไขไดเรกทอรีย่อยและในทางกลับกัน) ก็จะเป็น "submodule" ไม่มากไปกว่า subtree merge (นำเสนอในคำถามการถ่ายโอนฐานรหัสดั้งเดิมจาก cvs ไปยังที่เก็บแบบกระจาย ) เชื่อมโยงประวัติของ repo Git ทั้งสองเข้าด้วยกัน

นั่นช่วยทำความเข้าใจธรรมชาติที่แท้จริงของ Submodules Git หรือไม่?

ในการอัพเดทแต่ละ submodule คุณสามารถเรียกใช้คำสั่งต่อไปนี้ (ที่รูทของที่เก็บ):

git submodule -q foreach git pull -q origin master

คุณสามารถลบตัวเลือก-qเพื่อทำตามกระบวนการทั้งหมด

เพื่อที่อยู่--rebaseกับ--mergeตัวเลือก :

สมมติว่าคุณมีพื้นที่เก็บข้อมูล super A และ submodule B และต้องการทำงานใน submodule B คุณทำการบ้านและรู้ว่าหลังจากโทร

git submodule update

คุณอยู่ในสถานะ HEAD-less ดังนั้นการกระทำใด ๆ ที่คุณทำ ณ จุดนี้ยากที่จะกลับไป ดังนั้นคุณได้เริ่มทำงานในสาขาใหม่ใน submodule B

cd B
git checkout -b bestIdeaForBEver
<do work>

ในขณะที่คนอื่นในโครงการ A ตัดสินใจว่ารุ่น B ที่ยอดเยี่ยมที่สุดคือสิ่งที่ A สมควรได้รับ คุณเลิกนิสัยรวมการเปลี่ยนแปลงล่าสุดและปรับปรุง submodules ของคุณ

<in A>
git merge develop
git submodule update

โอ้โห! คุณกลับมาอยู่ในสถานะที่ไม่มีหัวอีกครั้งอาจเป็นเพราะตอนนี้ B ชี้ไปที่ SHA ที่เกี่ยวข้องกับเคล็ดลับใหม่ของ B หรือการกระทำอื่น ๆ ถ้าเพียงคุณมี:

git merge develop
git submodule update --rebase

Fast-forwarded bestIdeaForBEver to b798edfdsf1191f8b140ea325685c4da19a9d437.
Submodule path 'B': rebased into 'b798ecsdf71191f8b140ea325685c4da19a9d437'

ตอนนี้ความคิดที่ดีที่สุดสำหรับ B ได้ถูกลดระดับลงบนความมุ่งมั่นใหม่และที่สำคัญกว่านั้นคุณยังคงอยู่ในสาขาการพัฒนาของคุณสำหรับ B ไม่ใช่ในสภาวะหัวขาด!

( --mergeจะรวมการเปลี่ยนแปลงจาก beforeUpdateSHA เป็น afterUpdateSHA ในสาขาที่ทำงานของคุณซึ่งต่างจากการรีบูตการเปลี่ยนแปลงของคุณไปยัง afterUpdateSHA)

Git 1.8.2 มีตัวเลือกใหม่--remoteซึ่งจะเปิดใช้งานลักษณะการทำงานนี้อย่างแน่นอน วิ่ง

git submodule update --rebase --remote

จะดึงการเปลี่ยนแปลงล่าสุดจากอัปสตรีมในแต่ละ submodule รีบูตและตรวจสอบการแก้ไขล่าสุดของ submodule เป็นเอกสารที่ทำให้มัน:

--remote

ตัวเลือกนี้ใช้ได้สำหรับคำสั่ง update เท่านั้น แทนที่จะใช้ SHA-1 ที่บันทึกไว้ของ superproject เพื่ออัปเดต submodule ให้ใช้สถานะของสาขาการติดตามระยะไกลของ submodule

สิ่งนี้เทียบเท่ากับการทำงานgit pullในแต่ละ submodule ซึ่งโดยทั่วไปคือสิ่งที่คุณต้องการ

(นี่ถูกคัดลอกมาจากคำตอบนี้)