gitolite 搭建 Android仓库(一）

gitolite – 搭建授权管理

平时在github上创建仓库、推拉代码、创建 Pull/Merge Request、发起 Issue 。
如果是本地代码 git 只能跟踪的代码信息，无法完成如上操作。本文介绍利用 gitolite 搭建本地git存档信息平台，可以实现类似功能。

---

提示：此文章仅为搭建gitolite，下一篇为 gitote 托管 Android 代码仓库repo。

---

Gitolite 实现目标

a) 搭建本地git 或 repo 仓库，拉去云仓，管理本地代码
b) 用最小的配置完成安全的权限管理；管控连接代码仓授权密钥
c) 用户密钥一对一，根据分配用户在各个代码仓不同权限

---

1. 创建gitolite 管理用户

如果使用当前用户可以跳过此步骤；如果新建用户的话，建议用户为 git，方便代码维护下载。此前因新未新建用户，搭建完成后使用 URL git@IP/xxx.git 始终无法同步代码，原因为ssh 连接用户并非 gitolite 管理用户名。

sudo useradd git

如果分配空间指定目录 给用户 git, 例如 /build 目录

sudo useradd -d /build -m -s /bin/bash git

设置用户密码,并切换用户

sudo passwd
su - git

2. 安装 gitolite

2.1 gitolite 管理服务端

安装ssh git keychain (私钥管理工具)

sudo apt-get install openssh-server git keychain

克隆gitolite安装包

cd ~
git clone git://github.com/sitaramc/gitolite

创建安装bin目录 并安装gitolite

mkdir -p ~/bin
./gitolite/install -to ~/bin

用户下重新生成一个密钥，生成密钥用作 gitolite 服务端管理员密钥

ssh-keygen -t rsa -f ~/.ssh/git

设置刚生成密钥为管理员密钥。如果使用公钥路径为~/.ssh/git.pub，如果使用私钥 ~/.ssh/git

~/bin/gitolite setup -pk ~/.ssh/git.pub
已初始化空的 Git 仓库于 /home/git/repositories/gitolite-admin.git/
已初始化空的 Git 仓库于 /home/git/repositories/testing.git/

此时gitolite 配置成功。此时用户目录生成projects.list(项目列表) repositories(代码仓库)。如果出现如下错误，说明你在使用和登录用的同一个key。

WARNING: keydir/git_key.pub duplicates a non-gitolite key, sshd will ignore it

a) 前面的设置一般情况下是通过ssh连接到服务器，故需要用户名（即git）和 key（通过ssh-keygen 命令生成），因为此key可直接登录服务器，不适合做git管理员。
b) ~/.ssh/authorized_keys 中，git授权的格式和ssh授权的格式不同，做了扩展，无法通用。
想回退上面的命令发现失效，按照文档说的去做（文档写的是直接重新执行，就会覆盖）也是失效的，删掉gitolite，重新操作一遍。
主要的配置在 $HOME/.gitolite 和 $HOME/.gitolite.rc 连同repositories 需要一并删掉，否则还是会出现上面的错误。

此时查看 .ssh/authorized_keys 授权文件。

$ cat /home/git/.ssh/authorized_keys
ssh-rsa ************************************** git@namenode
# gitolite start
command="/home/git/gitolite/src/gitolite-shell git_admin",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty ssh-rsa ***************************** git@namenode
# gitolite end

2.2 gitolite 管理客户端

客户端的key需要是git的管理员key，即上面的 git.pub。
clone时git仓库需要写相对于repository的相对路径。格式为 ssh://userName@IP:port/gitolite-admin.git。
以本机用户(git)获取管理终端为例

cd ~
git clone git@127.0.0.1:gitolite-admin.git

以testing仓库为例添加新 用户user。repo testing 用户被授权的代码仓，R为权限，W为写权限。
修改conf/gitolite.conf 文件，添加 user用户仓库读写权限。

diff --git a/conf/gitolite.conf b/conf/gitolite.conf
index ae1dc08..96517a3 100644
--- a/conf/gitolite.conf
+++ b/conf/gitolite.conf
@@ -1,2 +1,8 @@
repo xxx
-    RW+     =   git
+    RW+     =   git user

---

将用户密钥（user.pub）拷贝到 gitolite-admin/conf/，提交时需要一并提交。
修改提交到远程分支后，需等待gitolite遍历完成方可生效。

Tips 同步代码异常

首次使用密钥未验证无法同步

The authenticity of host '192.168.33.22 (192.168.33.22)' can't be established.
ECDSA key fingerprint is SHA256:Hp2H8uiwD1LAcFECVy/T94KwxZ6rsasrj+k5hwtmDWk.
Are you sure you want to continue connecting (yes/no)?

ssh -Tvv git@localhost #(localhost 为 repository 服务器 ip)

未配置 git 信息导致无法同步

Traceback (most recent call last):
  File "/home/pps/.repo/repo/main.py", line 531, in <module>
    _Main(sys.argv[1:])
  File "/home/pps/.repo/repo/main.py", line 507, in _Main
    result = repo._Run(argv) or 0
  File "/home/pps/.repo/repo/main.py", line 180, in _Run
    result = cmd.Execute(copts, cargs)
  File "/home/pps/.repo/repo/subcmds/init.py", line 404, in Execute
    self._ConfigureUser()
  File "/home/pps/.repo/repo/subcmds/init.py", line 298, in _ConfigureUser
    name  = self._Prompt('Your Name', mp.UserName)
  File "/home/pps/.repo/repo/project.py", line 784, in UserName
    self._LoadUserIdentity()
  File "/home/pps/.repo/repo/project.py", line 797, in _LoadUserIdentity
    u = self.bare_git.var('GIT_COMMITTER_IDENT')
  File "/home/pps/.repo/repo/project.py", line 2747, in runner
    (self._project.name, name, p.stderr))
error.GitError: manifests var: 
*** 请告诉我你是谁。

运行

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

来设置您账号的缺省身份标识。
如果仅在本仓库设置身份标识，则省略 --global 参数。

按照 log 提示配置 email 和 name 即可。

总结

以上为 gitolite 服务端和授权管理终端待建过程。