git-accept-pack - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-accept-pack - Nhận những gì được đẩy vào kho lưu trữ

SYNOPSIS

git-nhận-gói

MÔ TẢ

Được mời bởi git gói gửi và cập nhật kho lưu trữ với thông tin được cung cấp từ
đầu từ xa.

Lệnh này thường không được gọi trực tiếp bởi người dùng cuối. Giao diện người dùng cho giao thức là
trên git gói gửi và cặp chương trình được sử dụng để đẩy các bản cập nhật lên
kho lưu trữ từ xa. Đối với các hoạt động kéo, hãy xem gói git-fetch(1).

Lệnh cho phép tạo và chuyển tiếp nhanh các refs sha1 (đầu / thẻ) trên
kết thúc từ xa (nói một cách chính xác, nó là kết thúc cục bộ git-nhận-gói chạy, nhưng với người dùng
đang ngồi ở cuối gói gửi, nó đang cập nhật điều khiển từ xa. Bối rối?)

Có các ví dụ thực tế khác về việc sử dụng các móc cập nhật và sau cập nhật được tìm thấy trong
Thư mục Documentation / howto.

git-nhận-gói tôn vinh tùy chọn cấu hình get.denyNonFastForwards, cho biết nếu
cập nhật cho một giới thiệu nên bị từ chối nếu chúng không được chuyển tiếp nhanh chóng.

LỰA CHỌN

Kho lưu trữ để đồng bộ hóa vào.

NHẬN TRƯỚC HOOK

Trước khi bất kỳ bản tham chiếu nào được cập nhật, nếu tệp $ GIT_DIR / hooks / pre-accept tồn tại và có thể thực thi được, nó
sẽ được gọi một lần mà không có tham số. Đầu vào tiêu chuẩn của hook sẽ là một dòng
mỗi lượt giới thiệu được cập nhật:

sha1-cũ SP sha1-mới SP đổi tên LF

Giá trị đổi tên có liên quan đến $ GIT_DIR; ví dụ: đối với người đứng đầu cái này là
"refs / heads / master". Hai giá trị sha1 trước mỗi lần đổi tên là tên đối tượng cho
đổi tên trước và sau khi cập nhật. Refs được tạo sẽ có sha1-old bằng 0 {40},
trong khi các tham chiếu bị xóa sẽ có sha1-new bằng 0 {40}, ngược lại sha1-old và
sha1-new phải là các đối tượng hợp lệ trong kho lưu trữ.

Khi chấp nhận một lần đẩy có chữ ký (xem git-đẩy(1)), chứng chỉ đẩy đã ký được lưu trữ trong
blob và một biến môi trường GIT_PUSH_CERT có thể được tham khảo cho tên đối tượng của nó. Nhìn thấy
mô tả của móc sau nhận để làm ví dụ. Ngoài ra, chứng chỉ là
được xác minh bằng GPG và kết quả được xuất với các biến môi trường sau:

GIT_PUSH_CERT_SIGNER
Tên và địa chỉ e-mail của chủ nhân của khóa đã ký tên đẩy
chứng chỉ.

GIT_PUSH_CERT_KEY
ID khóa GPG của khóa đã ký chứng chỉ đẩy.

GIT_PUSH_CERT_STATUS
Trạng thái xác minh GPG của chứng chỉ đẩy, sử dụng cùng một cách ghi nhớ như
được sử dụng trong% G? định dạng của họ lệnh git log (xem nhật ký git(1)).

GIT_PUSH_CERT_NONCE
Chuỗi nonce mà quy trình yêu cầu người ký đưa vào chứng chỉ đẩy. Nếu như
điều này không khớp với giá trị được ghi trên tiêu đề "nonce" trong chứng chỉ đẩy,
nó có thể chỉ ra rằng chứng chỉ là chứng chỉ hợp lệ đang được phát lại từ
phiên "git push" riêng biệt.

GIT_PUSH_CERT_NONCE_STATUS

KHÔNG ĐƯỢC HỢP ĐỒNG
"git push --signed" đã gửi một nonce khi chúng tôi không yêu cầu nó gửi một nonce.

MISSING
"git push --signed" không gửi bất kỳ tiêu đề nonce nào.

BAD
"git push --signed" đã gửi một thông báo không có thật.

OK
"git push --signed" đã gửi khi chúng tôi yêu cầu nó gửi.

TRƯỢT
"git push --signed" đã gửi khác với những gì chúng tôi yêu cầu nó gửi bây giờ, nhưng
trong một phiên trước đó. Xem biến môi trường GIT_PUSH_CERT_NONCE_SLOP.

GIT_PUSH_CERT_NONCE_SLOP
"git push --signed" đã gửi khác với những gì chúng tôi yêu cầu nó gửi bây giờ, nhưng trong một
phiên khác có thời gian bắt đầu khác nhiều giây so với
phiên hiện tại. Chỉ có ý nghĩa khi GIT_PUSH_CERT_NONCE_STATUS cho biết SLOP. Cũng đọc
về biến nhận.certNonceSlop trong git-config(1).

Móc này được gọi trước khi bất kỳ đổi tên nào được cập nhật và trước khi có bất kỳ kiểm tra tua đi nhanh nào
đã thực hiện.

Nếu móc nối nhận trước thoát ra với trạng thái thoát khác XNUMX, sẽ không có cập nhật nào được thực hiện,
và các móc cập nhật, sau nhận và sau cập nhật cũng sẽ không được gọi. Điều này có thể là
hữu ích để nhanh chóng cứu trợ nếu bản cập nhật không được hỗ trợ.

CẬP NHẬT HOOK

Trước khi mỗi lượt giới thiệu được cập nhật, nếu tệp tin $ GIT_DIR / hooks / update tồn tại và có thể thực thi được, nó sẽ
được gọi một lần cho mỗi lần tham chiếu, với ba tham số:

$ GIT_DIR / hooks / update refname sha1-old sha1-new

Tham số đổi tên có liên quan đến $ GIT_DIR; ví dụ: đối với người đứng đầu cái này là
"refs / heads / master". Hai đối số sha1 là tên đối tượng cho lần đổi tên trước đó
và sau khi cập nhật. Lưu ý rằng hook được gọi trước khi cập nhật tên mới, vì vậy
hoặc sha1-old là 0 {40} (nghĩa là chưa có tham chiếu nào như vậy) hoặc nó phải khớp với những gì
được ghi lại trong đổi tên.

Hook sẽ thoát với trạng thái khác XNUMX nếu nó muốn không cho phép cập nhật ref đã đặt tên.
Nếu không, nó sẽ thoát ra với số không.

Việc thực thi thành công (trạng thái không thoát) của hook này không đảm bảo ref sẽ
thực sự được cập nhật, nó chỉ là một điều kiện tiên quyết. Vì vậy, nó không phải là một ý tưởng tốt để gửi
thông báo (ví dụ: email) từ móc này. Thay vào đó, hãy cân nhắc sử dụng hook post-nhận.

ĐĂNG-NHẬN HOOK

Sau khi tất cả các tham chiếu được cập nhật (hoặc cố gắng cập nhật), nếu có bất kỳ bản cập nhật tham chiếu nào
thành công và nếu tệp $ GIT_DIR / hooks / post-accept tồn tại và có thể thực thi được, nó sẽ
được gọi một lần mà không có tham số. Đầu vào tiêu chuẩn của móc sẽ là một dòng cho mỗi
đã cập nhật thành công bản giới thiệu:

sha1-cũ SP sha1-mới SP đổi tên LF

Giá trị đổi tên có liên quan đến $ GIT_DIR; ví dụ: đối với người đứng đầu cái này là
"refs / heads / master". Hai giá trị sha1 trước mỗi lần đổi tên là tên đối tượng cho
đổi tên trước và sau khi cập nhật. Refs đã được tạo sẽ có sha1-old bằng
0 {40}, trong khi các tham chiếu đã bị xóa sẽ có sha1-new bằng 0 {40}, nếu không thì sha1-old
và sha1-new phải là các đối tượng hợp lệ trong kho lưu trữ.

Các biến môi trường GIT_PUSH_CERT * có thể được kiểm tra, giống như trong hook nhận trước,
sau khi chấp nhận một sự thúc đẩy đã ký.

Sử dụng hook này, có thể dễ dàng tạo các thư mô tả các bản cập nhật cho kho lưu trữ.
Tập lệnh ví dụ này sẽ gửi một thư cho mỗi người tham khảo, liệt kê các cam kết được đẩy đến
kho lưu trữ và ghi nhật ký các chứng chỉ đẩy của các lần đẩy đã ký với chữ ký tốt vào một
dịch vụ ghi nhật ký:

#!/ Bin / sh
# gửi thông tin cập nhật cam kết qua thư.
trong khi đọc tham chiếu nval hình bầu dục
do
nếu expr "$ oval": '0 * $'> / dev / null
sau đó
echo "Đã tạo một giới thiệu mới, với các cam kết sau:"
git rev-list --pretty "$ nval"
khác
echo "Cam kết mới:"
git rev-list --pretty "$ nval" "^ $ oval"
không |
mail -s "Thay đổi đối với ref $ ref" commit-list @ mydomain
thực hiện
# log chứng chỉ đẩy đã ký, nếu có
nếu test -n "$ {GIT_PUSH_CERT-}" && test $ {GIT_PUSH_CERT_STATUS} = G
sau đó
(
echo dự kiến ​​nonce là $ {GIT_PUSH_NONCE}
git cat-file blob $ {GIT_PUSH_CERT}
) | mail -s "đẩy chứng chỉ từ $ GIT_PUSH_CERT_SIGNER" push-log @ mydomain
fi
thoát 0

Mã thoát từ lệnh gọi móc nối này bị bỏ qua, tuy nhiên, mã thoát khác XNUMX sẽ
tạo ra một thông báo lỗi.

Lưu ý rằng có thể refname không có sha1-new khi hook này chạy. Cái này có thể
dễ dàng xảy ra nếu người dùng khác sửa đổi bản tham chiếu sau khi nó được cập nhật bởi git-nhận-gói,
nhưng trước khi hook có thể đánh giá nó. Chúng tôi khuyến nghị rằng hook nên dựa vào sha1-new
chứ không phải là giá trị hiện tại của đổi tên.

ĐĂNG CẬP NHẬT HOOK

Sau tất cả các quá trình xử lý khác, nếu ít nhất một lượt giới thiệu được cập nhật và nếu
Tệp $ GIT_DIR / hooks / post-update tồn tại và có thể thực thi được, sau đó post-update sẽ được gọi
với danh sách các ref đã được cập nhật. Điều này có thể được sử dụng để triển khai bất kỳ kho lưu trữ nào
nhiệm vụ dọn dẹp rộng rãi.

Mã thoát từ lệnh gọi hook này bị bỏ qua; điều duy nhất còn lại cho
git-nhận-gói để làm tại thời điểm đó là thoát khỏi chính nó bằng mọi cách.

Ví dụ: hook này có thể được sử dụng để chạy git update-server-info nếu kho lưu trữ
đóng gói và được phục vụ thông qua một phương tiện vận chuyển ngu ngốc.

#!/ Bin / sh
thực thi git cập nhật-máy chủ-thông tin

Sử dụng git-get-pack trực tuyến bằng các dịch vụ onworks.net