git-http-backend - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

git-http-backend - ການປະຕິບັດດ້ານເຊີຟເວີຂອງ Git ຜ່ານ HTTP

ສະຫຼຸບສັງລວມ

ໄປ http-backend

ລາຍລະອຽດ

ໂຄງການ CGI ງ່າຍໆເພື່ອຮັບໃຊ້ເນື້ອຫາຂອງບ່ອນເກັບມ້ຽນ Git ໃຫ້ກັບລູກຄ້າ Git ທີ່ເຂົ້າເຖິງ
repository ຜ່ານ http:// ແລະ https:// protocols. ໂຄງການສະຫນັບສະຫນູນລູກຄ້າດຶງຂໍ້ມູນ
ໃຊ້ທັງໂປໂຕຄອນ HTTP ອັດສະລິຍະ ແລະໂປຣໂຕຄໍ HTTP dumb ທີ່ເຂົ້າກັນໄດ້ກັບຫຼັງ, ເປັນ
ເຊັ່ນດຽວກັນກັບລູກຄ້າຊຸກຍູ້ການນໍາໃຊ້ໂປໂຕຄອນ HTTP smart.

ມັນກວດສອບວ່າໄດເລກະທໍລີມີໄຟລ໌ magic "git-daemon-export-ok", ແລະມັນຈະ.
ປະຕິເສດການສົ່ງອອກໄດເລກະທໍລີ Git ໃດໆທີ່ບໍ່ໄດ້ຖືກຫມາຍຢ່າງຊັດເຈນສໍາລັບການສົ່ງອອກດ້ວຍວິທີນີ້
(ເວັ້ນເສຍແຕ່ຈະຕັ້ງຕົວແປສະພາບແວດລ້ອມ GIT_HTTP_EXPORT_ALL).

ໂດຍຄ່າເລີ່ມຕົ້ນ, ມີພຽງແຕ່ບໍລິການ upload-pack ເທົ່ານັ້ນທີ່ຖືກເປີດໃຊ້, ເຊິ່ງໃຫ້ບໍລິການ ໄປ fetch-pack ແລະ ໄປ
ls-ໄລຍະໄກ ລູກ​ຄ້າ​, ທີ່​ຖືກ​ຮຽກ​ຮ້ອງ​ຈາກ​ ໄປ ດຶງ, ໄປ ດຶງ, ແລະ ໄປ cloneທີ່ຢູ່ ຖ້າຫາກວ່າ
ລູກ​ຄ້າ​ໄດ້​ຮັບ​ການ​ກວດ​ສອບ​, ການ​ບໍ​ລິ​ການ​ການ​ຮັບ​ຊອງ​ໄດ້​ຖືກ​ເປີດ​ໃຫ້​ໃຊ້​ງານ​, ທີ່​ເຮັດ​ໃຫ້​ບໍ​ລິ​ການ​ ໄປ ສົ່ງຊຸດ
ລູກ​ຄ້າ​, ເຊິ່ງ​ໄດ້​ຖືກ​ຮຽກ​ຮ້ອງ​ຈາກ​ ໄປ ການຊຸກຍູ້.

ບໍລິການ

ບໍລິການເຫຼົ່ານີ້ສາມາດຖືກເປີດໃຊ້ງານ / ປິດການໃຊ້ງານໂດຍໃຊ້ໄຟລ໌ການຕັ້ງຄ່າຕໍ່ບ່ອນເກັບມ້ຽນ:

http.getanyfile
ອັນນີ້ໃຫ້ບໍລິການລູກຄ້າ Git ທີ່ເກົ່າກວ່າເວີຊັນ 1.6.6 ທີ່ບໍ່ສາມາດໃຊ້ການອັບໂຫລດໄດ້
ບໍລິການຫຸ້ມຫໍ່. ເມື່ອເປີດໃຊ້, ລູກຄ້າສາມາດອ່ານໄຟລ໌ໃດໆພາຍໃນ repository,
ລວມທັງວັດຖຸທີ່ບໍ່ສາມາດເຂົ້າເຖິງໄດ້ຈາກສາຂາແຕ່ຍັງມີຢູ່. ມັນ
ຖືກເປີດໃຊ້ໂດຍຄ່າເລີ່ມຕົ້ນ, ແຕ່ບ່ອນເກັບມ້ຽນສາມາດປິດການໃຊ້ງານມັນໄດ້ໂດຍການຕັ້ງຄ່ານີ້
ລາຍການເປັນຜິດ.

http.uploadpack
ນີ້ໃຫ້ບໍລິການ ໄປ fetch-pack ແລະ ໄປ ls-ໄລຍະໄກ ລູກຄ້າ. ມັນຖືກເປີດໃຊ້ໂດຍຄ່າເລີ່ມຕົ້ນ, ແຕ່ a
repository ສາມາດປິດການໃຊ້ງານມັນໄດ້ໂດຍການຕັ້ງລາຍການການຕັ້ງຄ່ານີ້ເປັນຜິດ.

http.receivepack
ນີ້ໃຫ້ບໍລິການ ໄປ ສົ່ງຊຸດ ລູກຄ້າ, ອະນຸຍາດໃຫ້ຊຸກຍູ້. ມັນຖືກປິດໃຊ້ງານໂດຍຄ່າເລີ່ມຕົ້ນ
ຜູ້ໃຊ້ທີ່ບໍ່ເປີດເຜີຍຊື່, ແລະຖືກເປີດໃຊ້ໂດຍຄ່າເລີ່ມຕົ້ນສໍາລັບຜູ້ໃຊ້ທີ່ຖືກພິສູດຢືນຢັນໂດຍເຄື່ອງແມ່ຂ່າຍເວັບໄຊຕ໌. ມັນ
ສາມາດຖືກປິດໃຊ້ງານໄດ້ໂດຍການຕັ້ງລາຍການນີ້ເປັນຜິດ, ຫຼືເປີດໃຫ້ຜູ້ໃຊ້ທັງໝົດ, ລວມທັງ
ຜູ້ໃຊ້ທີ່ບໍ່ເປີດເຜີຍຊື່, ໂດຍການຕັ້ງຄ່າມັນເປັນຄວາມຈິງ.

URL ການແປພາສາ

ເພື່ອກໍານົດສະຖານທີ່ຂອງ repository ໃນແຜ່ນ, ໄປ http-backend concatenates ໄດ້
ຕົວແປສະພາບແວດລ້ອມ PATH_INFO, ເຊິ່ງຖືກຕັ້ງໂດຍອັດຕະໂນມັດໂດຍເວັບເຊີບເວີ, ແລະ
GIT_PROJECT_ROOT, ເຊິ່ງຕ້ອງຖືກຕັ້ງດ້ວຍຕົນເອງໃນການຕັ້ງຄ່າເຊີບເວີ. ຖ້າ
GIT_PROJECT_ROOT ບໍ່ໄດ້ຕັ້ງ, ໄປ http-backend ອ່ານ PATH_TRANSLATED, ເຊິ່ງຖືກຕັ້ງໄວ້
ອັດຕະໂນມັດໂດຍເຄື່ອງແມ່ຂ່າຍເວັບໄຊຕ໌.

ຕົວຢ່າງ

ຕົວຢ່າງທັງໝົດຕໍ່ໄປນີ້ແຜນທີ່ http://$hostname/git/foo/bar.git ຫາ
/var/www/git/foo/bar.git.

Apache 2.x
ໃຫ້ແນ່ໃຈວ່າ mod_cgi, mod_alias, ແລະ mod_env ຖືກເປີດໃຊ້, ຕັ້ງ GIT_PROJECT_ROOT (ຫຼື
DocumentRoot) ຢ່າງຖືກຕ້ອງ, ແລະສ້າງ ScriptAlias ​​ກັບ CGI:

SetEnv GIT_PROJECT_ROOT /var/www/git
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias ​​/git/ /usr/libexec/git-core/git-http-backend/

ເພື່ອເປີດໃຊ້ການເຂົ້າເຖິງການອ່ານແບບບໍ່ເປີດເຜີຍຊື່ແຕ່ມີການເຂົ້າເຖິງການຂຽນທີ່ຖືກຕ້ອງ, ຮຽກຮ້ອງໃຫ້ມີການອະນຸຍາດ
ສໍາລັບທັງການໂຄສະນາອ້າງອີງເບື້ອງຕົ້ນ (ທີ່ພວກເຮົາກວດພົບວ່າເປັນການຊຸກຍູ້ຜ່ານການບໍລິການ
ພາລາມິເຕີໃນ query string), ແລະການເອີ້ນຮັບຊອງຕົວມັນເອງ:

RewriteCond %{QUERY_STRING} service=git-receive-pack [OR]
RewriteCond %{REQUEST_URI} /git-receive-pack$
RewriteRule ^/git/ - [E=AUTHREQUIRED:yes]


ຄໍາ​ສັ່ງ​ປະ​ຕິ​ເສດ​, ອະ​ນຸ​ຍາດ​ໃຫ້​
ປະຕິເສດຈາກ env=AUTHREQUIRED

AuthType Basic
ຊື່ "Git Access"
ຮຽກ​ຮ້ອງ​ໃຫ້​ມີ​ຄະ​ນະ​ກໍາ​ມະ​ກຸ່ມ​
ພໍໃຈຢ່າງໃດກໍ່ຕາມ
...


ຖ້າທ່ານບໍ່ມີ mod_rewrite ທີ່ຈະກົງກັບ string query, ມັນແມ່ນ
ພຽງພໍທີ່ຈະປົກປ້ອງ git-receive-pack ຕົວຂອງມັນເອງ, ເຊັ່ນ:


AuthType Basic
ຊື່ "Git Access"
ຮຽກ​ຮ້ອງ​ໃຫ້​ມີ​ຄະ​ນະ​ກໍາ​ມະ​ກຸ່ມ​
...


ໃນໂຫມດນີ້, ເຄື່ອງແມ່ຂ່າຍຈະບໍ່ຮ້ອງຂໍໃຫ້ມີການກວດສອບຄວາມຖືກຕ້ອງຈົນກ່ວາລູກຄ້າຕົວຈິງ
ເລີ່ມຕົ້ນໄລຍະການເຈລະຈາຈຸດປະສົງຂອງການຊຸກຍູ້, ແທນທີ່ຈະໃນໄລຍະເບື້ອງຕົ້ນ
ຕິດຕໍ່. ສໍາລັບເຫດຜົນນີ້, ທ່ານຍັງຕ້ອງເປີດໃຊ້ຕົວເລືອກການຕັ້ງຄ່າ http.receivepack ໃນ
repositories ໃດທີ່ຄວນຈະຍອມຮັບການຊຸກຍູ້. ພຶດຕິກໍາເລີ່ມຕົ້ນ, ຖ້າ http.receivepack
ບໍ່ໄດ້ຖືກຕັ້ງ, ແມ່ນເພື່ອປະຕິເສດການຊຸກຍູ້ໃດໆໂດຍຜູ້ໃຊ້ທີ່ບໍ່ໄດ້ຮັບການຢືນຢັນ; ການຮ້ອງຂໍເບື້ອງຕົ້ນຈະ
ດັ່ງນັ້ນ, ລາຍງານ 403 Forbidden ກັບລູກຄ້າ, ໂດຍບໍ່ມີການເຖິງແມ່ນວ່າໂອກາດສໍາລັບການ
ການກວດສອບຄວາມຖືກຕ້ອງ.

ເພື່ອຮຽກຮ້ອງໃຫ້ມີການກວດສອບຄວາມຖືກຕ້ອງສໍາລັບທັງການອ່ານແລະການຂຽນ, ໃຫ້ໃຊ້ຄໍາສັ່ງສະຖານທີ່ອ້ອມຮອບ
ຄັງເກັບມ້ຽນ, ຫຼືຫນຶ່ງໃນໄດເລກະທໍລີຫຼັກຂອງມັນ:


AuthType Basic
AuthName "ການເຂົ້າເຖິງ Git ສ່ວນຕົວ"
ຮຽກ​ຮ້ອງ​ໃຫ້​ມີ​ຄະ​ນະ​ກໍາ​ມະ​ກຸ່ມ​
...


ເພື່ອຮັບໃຊ້ gitweb ຢູ່ໃນ url ດຽວກັນ, ໃຊ້ ScriptAliasMatch ໃຫ້ກັບ URL ເຫຼົ່ານັ້ນເທົ່ານັ້ນ ໄປ
http-backend ສາມາດຈັດການ, ແລະສົ່ງສ່ວນທີ່ເຫຼືອໄປຫາ gitweb:

ScriptAliasMatch \
"(?x)^/git/.*/(HEAD | \
ຂໍ້ມູນ/ອ້າງອີງ | \
ວັດຖຸ/(ຂໍ້ມູນ/[^/]+ | \
[0-9a-f]{2}/[0-9a-f]{38} | \
pack/pack-[0-9a-f]{40}\.(pack|idx)) | \
git-(upload|receive)-pack))$" \
/usr/libexec/git-core/git-http-backend/$1

ScriptAlias ​​/git/ /var/www/cgi-bin/gitweb.cgi/

ເພື່ອຮັບໃຊ້ບ່ອນເກັບມ້ຽນຫຼາຍບ່ອນຈາກທີ່ແຕກຕ່າງກັນ gitnamespaces(7​) ໃນ repository ດຽວ​:

SetEnvIf Request_URI "^/git/([^/]*)" GIT_NAMESPACE=$1
ScriptAliasMatch ^/git/[^/]*(.*) /usr/libexec/git-core/git-http-backend/storage.git$1

Accelerated static Apache 2.x
ຄ້າຍຄືກັນກັບຂ້າງເທິງ, ແຕ່ Apache ສາມາດຖືກນໍາໃຊ້ເພື່ອກັບຄືນໄຟລ໌ static ທີ່ເກັບໄວ້ໃນ
ແຜ່ນ. ໃນຫຼາຍໆລະບົບນີ້ອາດຈະມີປະສິດທິພາບຫຼາຍຂຶ້ນຍ້ອນວ່າ Apache ສາມາດຂໍໃຫ້ kernel ຄັດລອກ
ເນື້ອໃນໄຟລ໌ຈາກລະບົບໄຟລ໌ໂດຍກົງກັບເຄືອຂ່າຍ:

SetEnv GIT_PROJECT_ROOT /var/www/git

AliasMatch ^/git/(.*/objects/[0-9a-f]{2}/[0-9a-f]{38})$ /var/www/git/$1
AliasMatch ^/git/.*/objects/pack/pack-[0-9a-f]{40}.(pack|idx))$ /var/www/git/$1
ScriptAlias ​​/git/ /usr/libexec/git-core/git-http-backend/

ນີ້ສາມາດຖືກລວມເຂົ້າກັບການຕັ້ງຄ່າ gitweb:

SetEnv GIT_PROJECT_ROOT /var/www/git

AliasMatch ^/git/(.*/objects/[0-9a-f]{2}/[0-9a-f]{38})$ /var/www/git/$1
AliasMatch ^/git/.*/objects/pack/pack-[0-9a-f]{40}.(pack|idx))$ /var/www/git/$1
ScriptAliasMatch \
"(?x)^/git/.*/(HEAD | \
ຂໍ້ມູນ/ອ້າງອີງ | \
objects/info/[^/]+ | \
git-(upload|receive)-pack))$" \
/usr/libexec/git-core/git-http-backend/$1
ScriptAlias ​​/git/ /var/www/cgi-bin/gitweb.cgi/

ສະຫວ່າງ
ໃຫ້ແນ່ໃຈວ່າ mod_cgi, mod_alias, mod_auth, mod_setenv ຖືກໂຫລດ, ຈາກນັ້ນຕັ້ງ
GIT_PROJECT_ROOT ຢ່າງເໝາະສົມ ແລະປ່ຽນເສັ້ນທາງການຮ້ອງຂໍທັງໝົດໄປຫາ CGI:

alias.url += ( "/git" => "/usr/lib/git-core/git-http-backend")
$HTTP["url"] =~ "^/git" {
cgi.assign = ("" => "")
setenv.add-environment = (
"GIT_PROJECT_ROOT" => "/var/www/git",
"GIT_HTTP_EXPORT_ALL" => ""
)
}

ເພື່ອເປີດໃຊ້ການເຂົ້າເຖິງການອ່ານແບບບໍ່ເປີດເຜີຍຊື່ແຕ່ມີການເຂົ້າເຖິງການຂຽນທີ່ຖືກຕ້ອງ:

$HTTP["querystring"] =~ "service=git-receive-pack" {
ປະກອບມີ "git-auth.conf"
}
$HTTP["url"] =~ "^/git/.*/git-receive-pack$" {
ປະກອບມີ "git-auth.conf"
}

ບ່ອນທີ່ git-auth.conf ມີລັກສະນະຄ້າຍຄື:

auth.require = (
"/" => (
"ວິທີການ" => "ພື້ນຖານ",
"realm" => "Git Access",
"require" => "ຜູ້ໃຊ້ທີ່ຖືກຕ້ອງ"
)
)
# ...ແລະຕັ້ງຄ່າ auth.backend ທີ່ນີ້

ເພື່ອຮຽກຮ້ອງໃຫ້ມີການກວດສອບຄວາມຖືກຕ້ອງຂອງທັງການອ່ານແລະການຂຽນ:

$HTTP["url"] =~ "^/git/private" {
ປະກອບມີ "git-auth.conf"
}

ENVIRONMENT

ໄປ http-backend ອີງໃສ່ຕົວແປສະພາບແວດລ້ອມ CGI ທີ່ກໍານົດໄວ້ໂດຍເຄື່ອງແມ່ຂ່າຍເວັບທີ່ເອີ້ນ,
ລວມທັງ:

· PATH_INFO (ຖ້າ GIT_PROJECT_ROOT ຖືກຕັ້ງ, ຖ້າບໍ່ດັ່ງນັ້ນ PATH_TRANSLATED)

· REMOTE_USER

· REMOTE_ADDR

· CONTENT_TYPE

· QUERY_STRING

· REQUEST_METHOD

ຕົວແປສະພາບແວດລ້ອມ GIT_HTTP_EXPORT_ALL ອາດຈະຖືກສົ່ງກັບ git-http-backend ເພື່ອ bypass
ການກວດສອບໄຟລ໌ "git-daemon-export-ok" ໃນແຕ່ລະ repository ກ່ອນທີ່ຈະອະນຸຍາດໃຫ້ສົ່ງອອກ.
ບ່ອນເກັບມ້ຽນນັ້ນ.

ຕົວແປສະພາບແວດລ້ອມ GIT_HTTP_MAX_REQUEST_BUFFER (ຫຼື http.maxRequestBuffer config
variable) ອາດຈະຖືກຕັ້ງໃຫ້ປ່ຽນຄໍາຮ້ອງຂໍການເຈລະຈາ ref ທີ່ໃຫຍ່ທີ່ສຸດທີ່ git ຈະຈັດການ
ໃນລະຫວ່າງການ fetch; ການດຶງຂໍ້ມູນໃດໆກໍຕາມທີ່ຕ້ອງການ buffer ໃຫຍ່ກວ່າຈະບໍ່ສໍາເລັດ. ມູນຄ່ານີ້ຄວນ
ປົກກະຕິແລ້ວບໍ່ຈໍາເປັນຕ້ອງມີການປ່ຽນແປງ, ແຕ່ອາດຈະເປັນປະໂຫຍດຖ້າຫາກວ່າທ່ານກໍາລັງດຶງຂໍ້ມູນຈາກ repository
ກັບຈໍານວນການອ້າງອີງຫຼາຍ. ມູນຄ່າສາມາດຖືກກໍານົດດ້ວຍຫນ່ວຍງານ (ຕົວຢ່າງ: 100M
ສໍາລັບ 100 megabytes). ຄ່າເລີ່ມຕົ້ນແມ່ນ 10 megabytes.

ຂະບວນການ backend ກໍານົດ GIT_COMMITTER_NAME ເປັນ $REMOTE_USER ແລະ GIT_COMMITTER_EMAIL ກັບ
${REMOTE_USER}@http.${REMOTE_ADDR}, ຮັບປະກັນວ່າ reflogs ໃດໆທີ່ສ້າງຂຶ້ນໂດຍ git-receive-pack
ມີຂໍ້ມູນການລະບຸຕົວຕົນບາງຢ່າງຂອງຜູ້ໃຊ້ຫ່າງໄກສອກຫຼີກທີ່ປະຕິບັດການຊຸກຍູ້.

ຕົວແປສະພາບແວດລ້ອມ CGI ທັງໝົດແມ່ນມີຢູ່ໃນແຕ່ລະ hooks ທີ່ຖືກຮຽກຮ້ອງໂດຍ
git-receive-pack.

GIT

ສ່ວນຫນຶ່ງຂອງ ໄປ(1) ຊຸດ

ໃຊ້ git-http-backend ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net