在群晖上安装Git客户端

什么是 Git ?

Git 是一个分布式版本控制系统,提供了命令行界面(CLI)以及图形用户界面(GUI)两种方式进行操作。与 CVSSubversion 一类的集中式版本控制工具不同,它采用了分布式版本库的作法,不需要服务器端软件,就可以运作版本控制,使得源代码的发布和交流极其方便。

有时候,我们会需要用到 git 拉取源码。之前是比较容易的一件事情,只要安装 Git 套件就可以了

DSM 6.2-25556 及以上版本

  • 套件中心设置 –> 套件来源 –> 新增

  • 名称:随意;
  • 位置:http://packages.synocommunity.com/
  • 套件中心 –> 社群,找到并安装套件 Git

老苏机器上的是早些年安装的

但是不知道从何时起,这个套件消失了,无论怎么搜都只能找到 Git Server

但实际上,如果你访问 https://synocommunity.com/package/git,会发现 Git 套件是存在的

手动下载对应平台的 spk 文件,然后上传安装,结果发现需要 6.2-25556 或更新版本的 DSM 才行

难怪一直搜不到呢,总不能为了一个软件就把系统升了吧?那 DSM 6.2-25556 以下的版本怎么办呢?

DSM 6.2-25556 以下版本

当然还是用 Docker 啦,老苏找到一个在 Alpine Linux 中运行的简单 git 容器,特别适用于没有包管理器的小型 Linux 发行版,例如 RancherOS

镜像下载

在群晖上以 Docker 方式安装。

在注册表中搜索 alpine/git ,选择第一个 alpine/git,版本选择 latest

本文写作时, latest 版本对应为 2.45.2 v2.45.2

你也可以使用命令行,用 SSH 客户端登录到群晖后,执行下面的命令拉取镜像

1
2
# 拉取镜像
docker pull alpine/git:latest

下载完成后,可以在 映像 中找到。一般来说,以 alpine 为基础镜像的应用,尺寸都比较小

运行

作为命令行工具,需要用在 SSH 客户端的命令行运行、

1
2
3
4
5
# 用法
docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git <git_command>

# 示例
docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git clone https://github.com/alpine-docker/git.git

其中:

  • -- rm:表示在容器退出时,会自动删除容器;
  • -ti:以交互式模式运行容器,并且可以在终端中查看命令输出和错误信息;

偶尔一次还好,每次输入这么长的命令,对老苏这种健忘症患者来说,实在是太难了。所以我们要想办法压缩命令行的长度,以便更快地执行常用操作或减少输入的工作量

别名模式

第一种方法,我们以前介绍过,就是通过使用 alias 命令,为长或复杂的命令创建简短且易记的别名

1
2
# 创建别名
alias git="docker run -ti --rm -v $(pwd):/git -v ${HOME}:/root alpine/git"

一个简单的示例

1
2
3
4
# 简单示例
cd /volume1/docker
alias git="docker run -ti --rm -v $(pwd):/git -v ${HOME}:/root alpine/git"
git clone https://github.com/fynnfluegge/rocketnotes.git

但是

  • 在不同的存储库之间切换时,您需要重新定义(重新运行)别名
  • 解决办法是需要在 git 存储库的根目录下运行上述别名命令

官方给的示例

1
2
3
4
5
6
7
8
9
10
$ cd application
$ alias git="docker run -ti --rm -v $(pwd):/git -v ${HOME}:/root alpine/git"
$ git clone git@github.com:YOUR_ACCOUNT/YOUR_REPO.git
$ cd YOUR_REPO
$ alias git="docker run -ti --rm -v $(pwd):/git -v ${HOME}:/root alpine/git"
# edit several files
$ git add .
$ git status
$ git commit -m "test"
$ git push -u origin master

如果要取消由 alias 设置的别名

1
2
# 取消别名
unalias git

脚本模式

第二种方法是将命令添加到 ~/.bashrc~/.profile

1
2
# 编辑 .profile
vi ~/.profile

在文件的最后加入下面的函数

1
2
3
function git () {
(docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git "$@")
}

保存之后,执行

1
2
# 应用生效
source ~/.profile

可以用方法一中的简单示例进行测试,效果是一样的

参考文档

SynoCommunity
地址:https://synocommunity.com/package/git

alpine-docker/git: A useful simple git container running in alpine linux, especially for tiny linux distro, such as RancherOS, which don’t have package manager.
地址:https://github.com/alpine-docker/git

alpine/git - Docker 镜像 | Docker Hub
地址:https://hub.docker.com/r/alpine/git