git-receive-pack - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

git-receive-pack - รับสิ่งที่ถูกผลักเข้าไปในที่เก็บ

เรื่องย่อ

git รับแพ็ค

DESCRIPTION

เรียกโดย คอมไพล์ ส่งแพ็ค และอัปเดตที่เก็บด้วยข้อมูลที่ป้อนจาก
ปลายระยะไกล

คำสั่งนี้มักจะไม่ถูกเรียกใช้โดยผู้ใช้ปลายทางโดยตรง UI สำหรับโปรโตคอลคือ
บน คอมไพล์ ส่งแพ็ค ด้านข้าง และโปรแกรมคู่มีไว้เพื่อใช้ผลักดันการอัปเดตไปยัง
ที่เก็บระยะไกล สำหรับการดึง โปรดดูที่ คอมไพล์ดึงแพ็ค(1)

คำสั่งอนุญาตให้สร้างและส่งต่ออย่างรวดเร็วของ sha1 refs (หัว/แท็ก) บน
ปลายทางระยะไกล (พูดอย่างเคร่งครัดมันคือปลายท้องถิ่น git รับแพ็ค ทำงาน แต่สำหรับผู้ใช้
ที่กำลังนั่งอยู่ที่ส่วนท้ายของ send-pack กำลังอัปเดตรีโมต สับสน?)

มีตัวอย่างการใช้งานจริงอื่น ๆ ของการใช้ hooks การอัปเดตและหลังการอัปเดตที่พบใน
ไดเร็กทอรีเอกสาร/Howto

git รับแพ็ค ให้เกียรติตัวเลือกการกำหนดค่า receive.denyNonFastForwards ซึ่งบอกว่าถ้า
การอัปเดตผู้อ้างอิงควรถูกปฏิเสธหากพวกเขาไม่กรอไปข้างหน้า

OPTIONS

ที่เก็บที่จะซิงค์เข้า

รับล่วงหน้า ตะขอ

ก่อนอัปเดตการอ้างอิงใดๆ หากมีไฟล์ $GIT_DIR/hooks/pre-receive และสามารถเรียกทำงานได้
จะถูกเรียกใช้หนึ่งครั้งโดยไม่มีพารามิเตอร์ อินพุตมาตรฐานของเบ็ดจะเป็นหนึ่งบรรทัด
ต่อผู้อ้างอิงที่จะอัปเดต:

sha1-เก่า SP sha1-SP ใหม่เปลี่ยนชื่อ LF

ค่าชื่ออ้างอิงสัมพันธ์กับ $GIT_DIR; เช่นสำหรับหัวหน้าหัวหน้านี่คือ
"กรรมการ/หัวหน้า/อาจารย์". ค่า sha1 สองค่าก่อนชื่อผู้อ้างอิงแต่ละชื่อคือชื่ออ็อบเจ็กต์สำหรับ
refname ก่อนและหลังการปรับปรุง การอ้างอิงที่จะสร้างจะมี sha1-old เท่ากับ 0{40}
ในขณะที่ผู้อ้างอิงที่จะถูกลบจะมี sha1-new เท่ากับ 0{40} มิฉะนั้น sha1-old และ
sha1-new ควรเป็นวัตถุที่ถูกต้องในที่เก็บ

เมื่อยอมรับการกดที่ลงนามแล้ว (ดู git-ผลักดัน(1)) ใบรับรองการพุชที่ลงนามแล้วจะถูกเก็บไว้ในa
blob และตัวแปรสภาพแวดล้อม GIT_PUSH_CERT สามารถดูชื่ออ็อบเจ็กต์ได้ ดู
ตัวอย่างคำอธิบายของตะขอหลังรับ นอกจากนี้ใบรับรองคือ
ตรวจสอบโดยใช้ GPG และผลลัพธ์จะถูกส่งออกด้วยตัวแปรสภาพแวดล้อมต่อไปนี้:

GIT_PUSH_CERT_SIGNER
ชื่อและที่อยู่อีเมลของเจ้าของกุญแจที่ลงนามในการพุช
ใบรับรอง

GIT_PUSH_CERT_KEY
รหัสคีย์ GPG ของคีย์ที่ลงนามในใบรับรองการพุช

GIT_PUSH_CERT_STATUS
สถานะของการตรวจสอบ GPG ของใบรับรองการพุชโดยใช้ตัวช่วยจำเหมือนกับ
ใช้ใน %G? รูปแบบของคำสั่งตระกูล git log (ดู คอมไพล์ล็อก(พ.ศ. 1)).

GIT_PUSH_CERT_NOCE
สตริง nonce ที่กระบวนการขอให้ผู้ลงนามรวมไว้ในใบรับรองการพุช ถ้า
ไม่ตรงกับค่าที่บันทึกไว้ในส่วนหัว "nonce" ในใบรับรองการพุช
อาจบ่งชี้ว่าใบรับรองเป็นใบรับรองที่ถูกต้องซึ่งกำลังเล่นซ้ำจากa
แยกเซสชัน "git push"

GIT_PUSH_CERT_NONCE_STATUS

ไม่ได้ร้องขอ
"git push --signed" ส่ง nonce เมื่อเราไม่ได้ขอให้ส่ง

หายไป
"git push --signed" ไม่ได้ส่งส่วนหัว nonce ใด ๆ

BAD
"git push --signed" ส่ง nonce ปลอม

OK
"git push --signed" ส่ง nonce ที่เราขอให้ส่ง

สโลป
"git push --signed" ส่ง nonce ที่แตกต่างจากที่เราขอให้ส่งตอนนี้ แต่
ในเซสชั่นก่อนหน้า ดู GIT_PUSH_CERT_NONCE_SLOP ตัวแปรสภาพแวดล้อม

GIT_PUSH_CERT_NOCE_SLOP
"git push --signed" ส่ง nonce ที่แตกต่างจากที่เราขอให้ส่งตอนนี้ แต่ใน a
เซสชันต่าง ๆ ซึ่งเวลาเริ่มต้นแตกต่างกันหลายวินาทีจาก
เซสชั่นปัจจุบัน มีความหมายเฉพาะเมื่อ GIT_PUSH_CERT_NONCE_STATUS พูดว่า SLOP อ่านยัง
เกี่ยวกับตัวแปรรับ.certNonceSlop ใน git-config.php(1)

เบ็ดนี้ถูกเรียกก่อนที่จะมีการอัปเดตชื่อผู้อ้างอิงและก่อนที่จะมีการตรวจสอบการส่งต่ออย่างรวดเร็ว
ดำเนินการ

หาก hook การรับล่วงหน้าออกด้วยสถานะการออกที่ไม่ใช่ศูนย์ จะไม่มีการอัปเดตใดๆ
และ hooks การอัปเดต หลังรับ และหลังการอัปเดตจะไม่ถูกเรียกใช้เช่นกัน นี้สามารถ
มีประโยชน์ในการประกันตัวอย่างรวดเร็วหากไม่รองรับการอัพเดท

อัพเดท ตะขอ

ก่อนการอัพเดตแต่ละครั้ง หากมีไฟล์ $GIT_DIR/hooks/update และสามารถเรียกทำงานได้
เรียกใช้หนึ่งครั้งต่อผู้อ้างอิง โดยมีสามพารามิเตอร์:

$GIT_DIR/hooks/update refname sha1-เก่า sha1-ใหม่

พารามิเตอร์ refname สัมพันธ์กับ $GIT_DIR; เช่นสำหรับหัวหน้าหัวหน้านี่คือ
"กรรมการ/หัวหน้า/อาจารย์". อาร์กิวเมนต์ sha1 สองอันเป็นชื่ออ็อบเจ็กต์สำหรับชื่อผู้อ้างอิงก่อนหน้า
และหลังการอัพเดท โปรดทราบว่า hook ถูกเรียกก่อนที่จะอัปเดตชื่อผู้อ้างอิง ดังนั้น
sha1-old คือ 0{40} (หมายความว่ายังไม่มีผู้อ้างอิงดังกล่าว) หรือควรตรงกับสิ่งที่เป็น
บันทึกไว้ในชื่ออ้างอิง

เบ็ดควรออกด้วยสถานะที่ไม่ใช่ศูนย์หากต้องการไม่อนุญาตให้อัปเดตการอ้างอิงที่มีชื่อ
มิฉะนั้นควรออกด้วยศูนย์

การดำเนินการที่ประสบความสำเร็จ (สถานะการออกเป็นศูนย์) ของ hook นี้ไม่ได้รับประกันว่าผู้อ้างอิงจะ
ปรับปรุงจริง ๆ เป็นเพียงข้อกำหนดเบื้องต้นเท่านั้น ดังนั้นจึงไม่ควรส่ง
ประกาศ (เช่น อีเมล) จากเบ็ดนี้ ลองใช้เบ็ดหลังรับแทน

หลังรับ ตะขอ

หลังจากอัปเดตผู้อ้างอิงทั้งหมดแล้ว (หรือพยายามอัปเดต) หากการอัปเดตผู้อ้างอิงเป็น
สำเร็จ และหากมีไฟล์ $GIT_DIR/hooks/post-receive และสามารถเรียกทำงานได้ ก็จะเป็น
เรียกใช้ครั้งเดียวโดยไม่มีพารามิเตอร์ อินพุตมาตรฐานของเบ็ดจะเป็นหนึ่งบรรทัดสำหรับแต่ละอัน
อัปเดตเรียบร้อยแล้ว อ้างอิง:

sha1-เก่า SP sha1-SP ใหม่เปลี่ยนชื่อ LF

ค่าชื่ออ้างอิงสัมพันธ์กับ $GIT_DIR; เช่นสำหรับหัวหน้าหัวหน้านี่คือ
"กรรมการ/หัวหน้า/อาจารย์". ค่า sha1 สองค่าก่อนชื่อผู้อ้างอิงแต่ละชื่อคือชื่ออ็อบเจ็กต์สำหรับ
refname ก่อนและหลังการปรับปรุง การอ้างอิงที่สร้างขึ้นจะมี sha1-old เท่ากับ
0{40} ในขณะที่ผู้อ้างอิงที่ถูกลบจะมี sha1-new เท่ากับ 0{40} มิฉะนั้น sha1-old
และ sha1-new ควรเป็นวัตถุที่ถูกต้องในที่เก็บ

ตัวแปรสภาพแวดล้อม GIT_PUSH_CERT* สามารถตรวจสอบได้ เช่นเดียวกับในตะขอรับล่วงหน้า
หลังจากยอมรับการผลักดันที่ลงนามแล้ว

การใช้ hook นี้ทำให้ง่ายต่อการสร้างอีเมลที่อธิบายการอัปเดตที่เก็บข้อมูล
สคริปต์ตัวอย่างนี้ส่งข้อความเมลหนึ่งข้อความต่อผู้อ้างอิงที่แสดงรายการคอมมิตที่ส่งไปยัง
ที่เก็บและบันทึกพุชใบรับรองของการพุชที่เซ็นชื่อพร้อมลายเซ็นที่ดีไปที่a
บริการคนตัดไม้:

#!bin / sh /
# ส่งข้อมูลการอัพเดทการส่งจดหมาย
ขณะอ่าน oval nval ref
do
ถ้า expr "$oval" : '0*$' >/dev/null
แล้วก็
echo "สร้างผู้อ้างอิงใหม่โดยมีข้อผูกพันดังต่อไปนี้:"
git rev-list --สวย "$nval"
อื่น
echo "คอมมิตใหม่:"
git rev-list --pretty "$nval" "^$oval"
ไฟ |
mail -s "เปลี่ยนเป็น ref $ref" commit-list@mydomain
ทำ
# บันทึกใบรับรองพุชที่ลงนามแล้วถ้ามี
ถ้า test -n "${GIT_PUSH_CERT-}" && ทดสอบ ${GIT_PUSH_CERT_STATUS} = G
แล้วก็
(
เสียงสะท้อนที่คาดหวัง nonce คือ ${GIT_PUSH_NONCE}
git cat-file blob ${GIT_Push_CERT}
) | mail -s "พุชใบรับรองจาก $GIT_PUSH_CERT_SIGNER" push-log@mydomain
fi
ทางออก 0

รหัสออกจากการเรียกใช้ hook นี้จะถูกละเว้น อย่างไรก็ตาม รหัสการออกที่ไม่ใช่ศูนย์จะ
สร้างข้อความแสดงข้อผิดพลาด

โปรดทราบว่าเป็นไปได้ที่ชื่อ refname ไม่มี sha1-new เมื่อ hook นี้ทำงาน นี้สามารถ
เกิดขึ้นได้ง่ายหากผู้ใช้รายอื่นแก้ไขการอ้างอิงหลังจากอัปเดตโดย git รับแพ็ค,
แต่ก่อนที่เบ็ดจะประเมินได้ ขอแนะนำว่าขอพึ่งพา sha1-new
แทนที่จะเป็นค่าปัจจุบันของชื่อผู้อ้างอิง

โพสต์-อัปเดต ตะขอ

หลังจากการประมวลผลอื่นๆ ทั้งหมด หากมีการอัปเดตผู้อ้างอิงอย่างน้อยหนึ่งคน และ if
มีไฟล์ $GIT_DIR/hooks/post-update และสามารถเรียกใช้งานได้ จากนั้นระบบจะเรียกไฟล์หลังการอัปเดต
พร้อมรายชื่อผู้อ้างอิงที่ได้รับการปรับปรุง สามารถใช้เพื่อใช้งานที่เก็บใด ๆ
งานทำความสะอาดกว้าง

รหัสออกจากการเรียกใช้ hook นี้จะถูกละเว้น สิ่งเดียวที่เหลืออยู่สำหรับ
git รับแพ็ค การทำในจุดนั้นก็คือการออกจากตัวเองอยู่ดี

เบ็ดนี้สามารถใช้ตัวอย่างเช่นเพื่อเรียกใช้ git update-server-info หากที่เก็บเป็น
บรรจุและให้บริการผ่านการขนส่งใบ้

#!bin / sh /
exec git อัปเดตข้อมูลเซิร์ฟเวอร์

ใช้ git-receive-pack ออนไลน์โดยใช้บริการ onworks.net