当前位置:   article > 正文

【GitBlit】Windows搭建Git服务器详细教程_搭建gitblit服务

搭建gitblit服务

前言

如果公司或个人想在 Windows 环境下搭建私有的 Git 服务器,那么这个开源的 GitBlit 是一个不错的选择。 

  • Gitblit 是一个开源纯 Java 的用于管理、查看和服务 Git 存储库。它是一个小型的托管集中式存储库工具。
  • 支持 SSH、HTTP 和 GIT 协议,开箱即用。
  • Gitblit 融合了 GitHub、BitBucket 和 Gerrit 的元素,以提供基于主存储库中分支的简化协作工作流。 
  • 管理员可以从 Web UI 创建和管理所有存储库、用户帐户和团队。

一、安装 Java JDK 

GitBlit 是纯 Java 开发的,因此须确保电脑已安装了 Java 运行时环境 JRE 或者 JDK (要求版本 >= 1.7) 。

1.1 下载 Java 

官网下载地址: Download Java for Windows

1.2 安装 Java 

软件下载后直接双击运行:  

*注:大家根据自己的习惯选择安装路径(我默认安装在C盘)! 

1.3 配置 Java 环境变量 

打开环境变量配置:

右键 "此电脑(计算机)" => "属性" => "高级系统设置" => "高级" => "环境变量" => "系统变量"。 

  1. 新建:
  2. 变量名:JAVA_HOME
  3. 变量值:C:\Program Files\Java\jdk1.6.0_21【根据自己实际的安装路径填写】 

  1. 新建:
  2. 变量名:CLASSPATH
  3. 变量值:.;%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar

  1. 添加:
  2. 编辑 PATH 变量,在最后一行添加: %JAVA_HOME%/bin;%JAVA_HOME%/jre/bin

  

1.4 验证 Java 是否安装成功 

  • 打开命令窗口(win + r)=> 输入 cmd
  • 在命令窗口中,输入 java 命令并回车:java -version,有版本信息,说明安装成功。

二、安装 GitBlit 

2.1 下载 GitBlit 安装包 

官网下载地址:Download GitBlit

  

下载最新的安装包版本 gitblit-1.9.3.zip

2.2  创建 GitBlit 配置目录

2.2.1 在 D 盘创建一个 Git 配置目录【大家根据自己的习惯选择配置盘

2.2.2 在刚才创建的 Git 目录下新建一个存储资料文件夹:GitRepository

2.2.3 将【2.1】下载的 GitBit 安装包,也解压到 D:\Git 目录下【如上图所示】

2.3  配置 GitBlit 

以下所有操作均在 D:\Git\gitblit-1.9.3 安装包目录下完成。

2.3.1 配置 defaults.properties 文件 

打开 data/defaults.properties 文件,按照如下操作流程配置。

2.3.1.1 找到 git.repositoriesFolder,赋值为【2.2】的存储资料库路径

 

*注意: 这里的 D:/Git/GitRepository  中的 "\" 一定要用 "/" 

2.3.1.2 找到 server.httpPort,设定服务器的 http 协议端口号(不使用 https 可直接注释掉)   

  • 通过 netstat -ano 可以查看哪些端口已被占用,然后填写一个未被占用的端口作为  http 端口即可;
  • 一般来说,端口号的范围是 [0,  65535],其中 [0,  1023] 是被系统保留的一些知名端口,而 [1024,  65535] 是动态或私有端口;
  • HTTP 协议的标准端口是 80,而 [1024,  65535]  可作为 HTTP 的非标准端口。

2.3.1.3 找到 server.httpBindInterface,设定服务器的 IP 地址(Windows本地 IP 地址)

2.3.1.4  找到 server.httpsBindInterface,设定为 localhost

最后,记得保存修改的文件内容!!!

2.3.2 运行 gitblit.cmd 批处理文件

2.3.2.1 在 gitblit-1.9.3 目录下找到 gitblit.cmd 文件,双击运行 

 

2.3.2.2 打开浏览器,输入服务器地址与端口登录,就可以开始使用 GitBlit 了

2.3.3 设置 Windows Service 启动 GitBlit  

如果你不希望每次开机后都要手动双击运行 gitblit.cmd 文件才能访问服务器,那么设置以 Windows Service 方式启动 GitBlit 就非常有必要了。

2.3.3.1gitblit-1.9.3 目录下,找到并打开 installService.cmd 文件,修改内容如下

  1. 1. 修改 ARCH:
  2. 32位系统:SET ARCH=x86
  3. 64位系统:SET ARCH=amd64
  4. 2. 添加 CD 为 GitBlit 安装包路径:
  5. SET CD=SET CD=D:\Git\gitblit-1.9.3 (大家根据自己实际目录路径填写)
  6. 3. 修改 StartParams 里的启动参数,赋值为空即可:
  7. --StartParams="" ^

2.3.4 以 Windows Service 方式启动 GitBlit 

2.3.4.1 右键 => 以管理员身份运行,GitBlit 目录下的 installService.cmd 文件

2.3.4.2 (win+r => 输入services.msc)打开服务(本地),会发现 gitblit 服务已经存在了

2.3.4.3 此时如果 gitblit.cmd 文件也已经关闭了(并且不重启电脑),在网页访问 GitBlit 服务器会发现被拒绝,原因是服务(本地)存在的 gitblit 服务还没正式启动,需要手动设置一下

*注:刷新网页,服务器访问成功!

三、使用 GitBlit 服务器管理用户与项目

1. 首次访问 GitBlit 服务器,默认管理员的用户名和密码都是 admin,出于安全考虑可更改登录密码。

2. 一般来说,管理员都是管理用户和项目的,基本不作为 Git 项目的实际操作者(如,拉取、推送代码等)。

3. (admin)管理员的作用:创建新用户或团队,创建新项目或项目分支,编辑项目用户或团队权限,删除项目版本库等。

3.1 创建新的版本库 

以创建一个 test.git 版本库为例,操作流程如下。

  • 先点击图中的 "1.版本库",然后再点击 "2.创建版本库"

  • 填写项目名称和描述(注意:名称最后要加 .git,如果不加服务器会默认添加)
  • 选择限制查看、克隆和推送
  • 勾选 "加入README" 和 "加入.gitignore文件"
  • 然后选择构建版本库需要忽略的文件,如 VisualStudio
  • 最后,点击 "创建"

  • 创建成功后,进入对应的新版本库,显示如下 

  • 点击 "目录",可以看到版本库的初始文件 

3.2 用户管理  

3.2.1 以管理员身份登录服务器

  • 在网址输入框输入 GitBlit 服务器的地址和端口号,然后以(admin)管理员身份登录

3.2.2 创建新用户

以创建一个 test 用户为例,操作流程如下:

  • 点击图中红色框中的 "用户"

  • 点击 "添加用户" 

  • 填写用户的信息,红色框中的选项视情况勾选(可使用默认配置)
  • 点击保存

  • 添加成功后,会在列表中显示对应的用户信息 

  • (注销admin) 以新用户身份登录服务器,可以看到页面是没有任何版本库信息的,这是因为当前新用户还没有任何版本库的权限

3.2.3 授予用户版本库的读写权限 

  • 切换到管理员账号,并进入想要授权的版本库
  • 点击 "编辑"

  • 再点击"权限(permissions)",选择你想要授权的用户与权限
  • 比如,用户选择 test,权限选择 "RW(推送)"
  • 最后点击 "添加" (添加成功后,点击 "保存")

  • 此时,切换到相应已授权的用户 (例如 test 用户),可以看到他的页面已有版本库的信息

四、安装配置本地 Git 客户端工具 

4.1 下载 Git 客户端工具 

官网下载地址:Download Git 

4.2  安装 Git 客户端工具

一路默认安装即可(如果安装在非C盘,则需要自定义安装路径),如下

4.3 将 SSH 公钥配置到 GitBlit 服务器 

  • 查看 SSH 公钥的方法:在任意文件夹下点击右键,选择 Git GUI here。弹出的界面如下

  • 点击主菜单的【Help】→【Show SSH Key】 

*注:如果电脑还没有 SSH 密钥,此时显示的内容是空白的,需要生成一对 SSH 密钥(其中密码可以为空,根据自己实际需要是否填写)!

  • 点击 "Copy To Clibboard",把 SSH 的公钥粘贴 GitBlit 服务器对应用户的后台配置中 

4.4 通过 Git 客户端拉取 GitBlit 服务器版本库代码

  • 使用新创建的用户名和密码登录 GitBlit 服务器
  • 复制红色框中的版本库URL

  • 本地创建一个 Test 目录并进入,右键选择 "Git Bash here"
  • 此时通过 Git 客户端拉取代码,提示错误(没有权限)
  1. $ git clone ssh://test@172.168.3.126:29418/test.git
  2. 20:23 Update failed
  3. Unable to negotiate with 172.168.3.126 port 29418: no matching host key type found. Their offer: ssh-rsa
  4. Could not read from remote repository.
  • 解决方法:进入 C 盘用户(账户)下的 .ssh 目录创建一个 config 文件,内容如下
  1. Host *
  2. HostkeyAlgorithms +ssh-rsa
  3. PubkeyAcceptedKeyTypes +ssh-rsa

  • 重新通过 Git 客户端拉取 GitBlit 服务器版本库代码,成功!!! 
git clone ssh://test@172.168.3.126:29418/test.git 

 

五、TortoiseGit 安装使用教程

  • TortoiseGit 是基于 TortoiseSVN 的 Git 版本的 Windows Shell 界面。它是开源的,可以完全使用免费软件构建。
  • TortoiseGit 支持你执行常规任务,例如 commit、显示日志、区分两个版本、创建分支和标签、创建补丁等。
  • 如果你希望使用带有 UI 操作界面的 Git 客户端工具,而不是 Shell 命令行的方式,那么  TortoiseGit (小乌龟) 就非常适合你。详细教程请查阅《TortoiseGit安装使用详细教程
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/繁依Fanyi0/article/detail/613702
推荐阅读
相关标签
  

闽ICP备14008679号