GitLab 服务器下客户端TortoiseGit配置和使用教程

ienki

原文  http://segmentfault.com/a/1190000002877617

登陆
　　假设GitLab服务器的登陆地址为192.168.0.254
　　在GitLab创建用户时，会发送一个电子邮件到用户的邮箱，告知用户名和密码。初次登陆时，系统会要求你更改密码。如果已经忘记密码，则需要联系管理员，要求重置密码。

下载客户端
　　GitLab的正常使用，依赖于两个客户端软件： Git 和  TortoiseGit 。
　　其中Git是GitLab客户端的核心，TortoiseGit只是一个Windows的外壳程序。

安装客户端
　　安装客户端时，需要先安装Git，再安装TortoiseGit。
　　安装Git时，选项一路默认即可。
　　在安装TortoiseGit时，如遇到如下选项：

　　这里建议选择第二个。如果选择第一个，在安装后配置git的时候就需要注意一些东西，如果选择第二项则git的连接都是通过ssh完成，后续配置简单一些。

设置用户名和邮箱
　　安装完Git之后，桌面（或者开始菜单里面），选择Git Bash。如果未找到Git Bash，则按照如下方法来查找Git Bash：
　　电机开始菜单，在搜索程序和文件中（如下图中的输入框）输入Git

　　此时，将会在搜索结果中列出Git Bash，如下图所示：

　　选择即可。
　　此时，会弹出一个命令行，如下图所示：

　　输入以下内容（每行结束后，回车）：
　　

git config --global user.name “用户名”　　
git config --global user.email “邮箱地址”
　　

　　

　　以上命令中，用户名 为邮箱中的用户名(一般为姓名拼音首字母小写缩写)；邮箱地址 为你的邮箱。设置好后，可以输入 git config --list 命令，来显示设置结果：

设置SSH Key

生成SSH Key
　　在Git Bash中输入如下内容，用来生成SSH Key：
　　

ssh-keygen -t rsa -C "your_email"　　

　　

　　命令中，your_email为你的email地址。
　　输入该命令后，将会提示要求输入ssh key的存放路径， 建议直接回车 ，这时，存放路径将会放在用户目录下的.ssh文件夹中（一般为: C:\Users\用户名.ssh\id_rsa）。
　　随后将会要求输入密码，此时建议为空，即直接回车，提示重复输入时，也直接回车。该操作将生成id_rsa和id_rsa.pub两个文件。具体如下图所示：

生成ppk文件
　　如果在安装TortoiseGit的过程中，SSH选择了第一个选项（或者没有出现选择的地方），即：（TortoisePLink, coming from Putty, integrates with Windows better）那么就需要将生成的rsa文件进行转化，生成.ppk格式的文件。具体操作如下：

• 启动puttygen (在开始菜单的搜索框中输入puttygen，既可以搜索到该应用程序)启动后，界面如右图所示。
  
• 点击load按钮将刚才最先生成的ssh中的密钥id_rsa文件导入，然后弹出对话框提示导入成功，接着点击save private key来保存ppk文件，最后在gitclone的对话框中加载ppk文件即可，连接的时候会提示输入git用户的密码，输入一下即可git clone gitosis的配置文件。
  

将公钥添加到GitLab服务器中
　　登陆后，选择右上角的profile settings

　　然后选择SSH Keys，添加一个SSH Key

　　设置时，用记事本或者notepad++打开之前生成的id_rsa.pub，将其文件内容，全部复制到Key输入框中。Title建议为电子邮件地址（复制完Key后，会自动填充为Email地址）。电机Add Key。此时，你将拥有一个SSH Key，以后，在操作Git时，系统会自动使用私钥id_rsa来与服务器上的公钥进行认证匹配。

Clone
　　Clone是Git的常用操作，用于将服务器上的版本库复制到本地。右键点击需要复制的文件夹，选择Clone，按照下图中的操作即可：

　　点击OK后，如果顺利，你将可以将服务器上的版本库克隆到本地。

Commit
　　Commit是指将本地修改，应用到本地的版本库中。注意，和SVN不同，这里Commit不会上传到服务器。

Push
　　Push是将本地的版本库复制到服务器端。Commit成功后，在弹出的对话框左下角选择Push可以在本地Commit之后，直接Push到服务器中。