Gitolite

Gitolite

Hosting Git Repositories

Gitolite allows you to setup git hosting on a central server, with fine-grained access control and many more powerful features. Gitolite 允许你在中央服务器上搭建 Git 托管服务,并提供细粒度的访问控制以及更多强大的功能。

install/setup

If you’re installing via your package manager, make sure you get the right one; it’s often called gitolite3. Source code is at https://codeberg.org/sitaramc/gitolite. Note: Wherever the documentation mentions the above URL, you can also use the alternative URL https://github.com/sitaramc/gitolite. If that ever changes this section will be updated. If your Unix-fu and ssh-fu are good, take a look at the quick install page. Otherwise follow the documentation flow (using the “next”/“previous” buttons at the bottom of each page), skipping whatever you think you don’t need. 如果你通过包管理器进行安装,请确保获取正确的版本;它通常被称为 gitolite3。源代码位于 https://codeberg.org/sitaramc/gitolite。注意:文档中提到的上述 URL,你也可以使用备用地址 https://github.com/sitaramc/gitolite。如果未来有变动,本节将会更新。如果你具备良好的 Unix 和 SSH 操作功底,可以查看快速安装页面。否则,请按照文档流程(使用页面底部的“下一页”/“上一页”按钮)进行操作,并跳过你认为不需要的部分。

documentation

(April 2014): There’s a book on gitolite out. I’ve received some emails over the years asking where to donate for gitolite to show your appreciation, and I’ve always refused politely. Well, if you insist… buy the book :-) In general, the sections (see links in the navigation bar at the top) should be fairly self-explanatory, and reading through the documentation as it flows (i.e., using the “Next” link at the top right of each page) should work fine. There are some forward references here and there, but you can ignore those links on a first pass. In addition: There’s a fool proof setup guide with detailed help showing one fool-proof way to install, as long as you follow instructions faithfully! Once you’ve installed and setup, there’s the cookbook with recipes for common tasks. (2014 年 4 月):关于 Gitolite 的书已经出版了。多年来我收到过一些邮件,询问在哪里可以为 Gitolite 捐款以表达谢意,但我总是礼貌地拒绝了。好吧,如果你坚持的话……那就买这本书吧 :-) 总的来说,各个章节(见顶部导航栏链接)应该相当直观,按照文档流程阅读(即使用页面右上角的“Next”链接)即可。文中偶尔会有一些前向引用,但在初次阅读时可以忽略这些链接。此外,还有一个“傻瓜式”安装指南,提供了详细的帮助,只要你严格按照说明操作,就能确保安装成功!安装并设置完成后,还有一本包含常见任务操作指南的“食谱”(Cookbook)。

TROUBLESHOOTING

The emergencies page helps with all sorts of install/setup issues, recovering from lost keys and other self-inflicted wounds, lists some common (and some uncommon!) errors and non-standard configs that may trip you up. 紧急情况页面(emergencies page)有助于解决各种安装/设置问题,包括恢复丢失的密钥以及其他因操作失误导致的问题,并列出了一些可能让你困扰的常见(以及不常见!)错误和非标准配置。

contact/support

security issues

If you think you found a possible security issue, please email me (sitaramc@gmail.com) directly. 如果你认为发现了潜在的安全问题,请直接给我发送电子邮件(sitaramc@gmail.com)。

mailing list(s)

For all other communications, please use the mailing list. This has some advantages over sending direct to me (if I’m not available, someone else might respond; someone else may have additional info that I may not have thought of, or experiences to share; the issue becomes searchable for future reference; and finally, it keeps me honest!) NOTE: The first email from a new member is held until I can clear it; subsequent emails from the same email address do not get held up. Mailing list for support and general discussion: Subscribe: gitolite+subscribe@googlegroups.com Post: gitolite@googlegroups.com (If you’re unwilling to join the mailing list, you can still send me direct mail if it’s something simple, obvious, or quick. But if the issue needs multiple mails and/or some discussion, I prefer the mailing list.) There’s also a low traffic, one-way, mailing list for release and security announcements: Subscribe: gitolite-announce+subscribe@googlegroups.com If you wish to send me code, please see the file called CONTRIBUTING in the source distribution. 对于所有其他交流,请使用邮件列表。相比直接发邮件给我,这有一些优势(如果我没空,其他人可能会回复;其他人可能有我没想到的额外信息或经验分享;问题可以被搜索以供未来参考;最后,这也能监督我!)。注意:新成员的第一封邮件会被暂存,直到我审核通过;来自同一地址的后续邮件将不会被拦截。支持与一般讨论的邮件列表:订阅:gitolite+subscribe@googlegroups.com,发帖:gitolite@googlegroups.com(如果你不愿意加入邮件列表,对于简单、明显或快速的问题,你仍然可以直接给我发邮件。但如果问题需要多次往返邮件或讨论,我更倾向于使用邮件列表。)此外还有一个低流量、单向的邮件列表,用于发布版本和安全公告:订阅:gitolite-announce+subscribe@googlegroups.com。如果你希望提交代码,请参阅源码包中名为 CONTRIBUTING 的文件。

IRC

Our IRC channel is #gitolite on libera.chat. I live in India (UTC+0530 time zone), but there are a few regulars (thanks, guys, you know who you are!) from other timezones. That said, it’s not heavy traffic and you may have to wait a while for an answer, depending on the time of day and day of week. There are also many gitolite-knowledgeable people on the git channel #git. 我们的 IRC 频道是 libera.chat 上的 #gitolite。我住在印度(UTC+0530 时区),但也有一些来自其他时区的常客(谢谢你们,你们知道我在说谁!)。话虽如此,频道流量并不大,根据一天中的时间和星期几,你可能需要等待一段时间才能得到回复。在 Git 频道 #git 中也有许多精通 Gitolite 的人。

license

The gitolite software is copyright Sitaram Chamarty and is licensed under the GPL v2; please see the file called COPYING in the source distribution. This documentation, which is maintained separately from the main gitolite source code, is copyright Sitaram Chamarty and is provided under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. However, certain parts are contributed by others who may have chosen other licenses; their names and license will be mentioned in the respective files. Documentation for a software product will naturally contain code examples. I believe that the principle of fair use should cover use of those snippets; see especially factors 3 and 4 in the list of factors here. If you’re not convinced that it would be fair use, then you may consider those code snippets, as well as associated “comments” if any, to be under the GPLv2 license. Licensing is about intent, and the intent of these examples is that you use them wherever and however you can use gitolite itself. Note: GIT is a trademark of Software Freedom Conservancy and my use of “Gitolite” is under license. Gitolite 软件版权归 Sitaram Chamarty 所有,并采用 GPL v2 协议授权;请参阅源码包中名为 COPYING 的文件。本文档与 Gitolite 主源代码分开维护,版权归 Sitaram Chamarty 所有,并采用“知识共享 署名-非商业性使用-相同方式共享 3.0 未本地化版本”(CC BY-NC-SA 3.0)协议授权。然而,某些部分由他人贡献,他们可能选择了其他许可证;其姓名和许可证将在相应文件中注明。软件产品的文档自然会包含代码示例。我相信“合理使用”原则应涵盖这些片段的使用;请特别参阅此处因素列表中的第 3 和第 4 项。如果你不确定这是否属于合理使用,那么你可以将这些代码片段及其相关的“注释”(如有)视为采用 GPLv2 协议授权。许可的核心在于意图,而这些示例的意图是让你在任何可以使用 Gitolite 的地方以任何方式使用它们。注意:GIT 是 Software Freedom Conservancy 的商标,我使用“Gitolite”名称已获得授权。