gitosis 技术文档

1. 安装指南

要安装 gitosis，请首先通过 git 获取代码：

git clone git://github.com/res0nat0r/gitosis.git

然后通过以下命令安装：

python setup.py install

您可能需要使用 --prefix= 选项。对于 Debian/Ubuntu 用户，源代码已经为 debian 格式化。

2. 项目的使用说明

gitosis 用于托管 git 仓库，通过 SSH 提供对仓库的访问，并具有严格的访问控制，而无需 shell 账户。

• 创建一个用户来拥有仓库，通常称为 git。
• 将 git 仓库存储在 /srv/example.com/git 目录下。
• 使用 SSH 公钥来识别用户。
• 新用户需要添加公钥到 keys/USER.pub 文件，并授权读写仓库。
• 创建新的仓库，只需授权写入并推送。

3. 项目 API 使用文档

gitosis 的配置和管理主要是通过修改 gitosis.conf 文件来实现的。以下是一些基本配置示例：

[group myteam]
members = jdoe
writable = myproject

上述配置定义了一个名为 myteam 的组，成员为 jdoe，可以读写 myproject 仓库。

4. 项目安装方式

安装 gitosis 的步骤如下：

1. 克隆 gitosis 仓库：

   git clone git://github.com/res0nat0r/gitosis.git
   

2. 创建一个用于拥有仓库的用户（以下命令适用于 Debian/Ubuntu）：

   sudo adduser \
       --system \
       --shell /bin/sh \
       --gecos 'git version control' \
       --group \
       --disabled-password \
       --home /srv/example.com/git \
       git
   

3. 使用 SSH 公钥进行身份验证。

4. 初始化 gitosis：

   sudo -iu git -c gitosis-init <FILENAME.pub
   

5. 克隆 gitosis-admin.git 仓库并配置权限：

   git clone git@SERVER:gitosis-admin.git
   

   在克隆的仓库中编辑 gitosis.conf 文件，添加或修改组和仓库的配置。

6. 提交并推送更改：

   git push
   

以上就是 gitosis 的安装和使用说明，希望对您有所帮助。