在群晖上安装Git客户端

发表于 更新于 分类于 Waline： 阅读次数： 本文字数： 2.5k 阅读时长 ≈ 2 分钟
docker-git-alpine 是一个在 Alpine Linux 中运行的有用的简单 git 容器。

什么是 Git ？

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

有时候，我们会需要用到 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