Git客户端部署使用-生成ssh密钥-平台windows

一、git 客户端安装 +TortoiseGit安装

1、官网下载 Git、TortoiseGit、TortoiseGit-LanguagePack

2、安装基本都是下一步下一步，安装顺序注意一下：

2.1 Git-2.37.2.2-64-bit.exe

2.2 TortoiseGit-2.13.0.1-64bit.msi

2.3 TortoiseGit-LanguagePack-2.13.0.0-64bit-zh_CN.msi

全部安装完后，在桌面空白处右击鼠标会出现：Git GUI Here、Git Bash Here、Git克隆、Git在这里创建版本库、TortoiseGit 几项。

二、git bash 生成SSH密钥并且添加到服务器

1、在电脑桌面，鼠标右键，选择"Git Bash Here"，打开Git命令窗口；

2、在Git命令窗口中设置用户名和邮箱：

2.1 设置用户名，在git窗口中输入命令行：

git config --global user.name “XXX”

其中双引号中的 XXX 是用户名，记得替换成自己的用户名，需要注意的是这里的用户名是git服务器所使用的名称，一般公司用的都是员工名称的全拼。

2.2 设置邮箱，在git窗口中输入命令行：

git config --global user.email “[email protected]”

其中双引号中的 [email protected] 替换成自己的邮箱，据测试这里可以随便填

注意： 操作完以上两步后，会在C:\Users\账号 下生成.gitconfig配置文件，特别注意此文件不能删除，此文件记录了账号和邮箱。

3、生成和查看公钥和私钥，git命令行：

3.1 生成公钥和私钥：ssh-keygen -t rsa -C “[email protected]”

这个双引号中的 [email protected] 是刚才设置邮箱时所有用的邮箱。

此时在 C:\Users\用户名.ssh目录下，查看生成的SSH密钥：

3.2 查看公钥的方法有很多种，比如notepad++，但用的更多的是直接从git命令窗口直接查看：

cat ~/.ssh/id_rsa.pub

4、在服务器处添加公钥

4.1 登陆Git服务器，这里需要注意的是权限问题，即这里登陆的账户必须有管理用户权限才可以，通是是管理员账号。

4.2 登陆后，单击页面右上角的倒三角-> 选择 用户中心

4.3 进入用户页面后，切换到 SSH Keys -> 将公钥复制到 添加 SSH Key 的 Key中 -> 确定， 确定完成后，刚才添加的 SSH Keys 会出现在上面，至此服务器操作已完成。

5、Git 命令下载项目

5.1 Gitblit 登陆 账户 ->切换到 版本库 -> 单击所在下载的项目 -> 复制项目的 SSH 的 URL

5.2 从服务器下载项目：在 git 命令窗口中输入

git clone 刚刚复制的URL粘贴到这里 回车 正常即可成功，也有可能出现以下错误：

5.2.1 报错：

Unable to negotiate with 192.168.2.98 port 29418: no matching host key type found. Their offer: ssh-rsa,ssh-dss
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

5.2.2 报错原因：新的ssh客户端不支持ssh-ras算法，需要修自以为本地配置重新使用ssh-rsa算法。具体操作：在C:\Users\用户名\ .ssh同一目录下创建一个文件 config，打开文件写入以下内容，再重新下载即可成功。

Host *
HostkeyAlgorithms +ssh-rsa
PubkeyAcceptedKeyTypes +ssh-rsa

6、Git 命令行上传项目

6.1 进入项目目录下，git status查看有无新文件或修改的文件，如果有，可以使用保命令上传推送到远程服务器。

常用git bash命令：

1. git clone URL -> 克隆远程服务器上的项目

2. git pull URL -> 更新本地代码

3. git add 修改／新文件(夹) -> 更新/添加文件或文件夹

4. git commit -m ‘提交注释’ -> 提交并注释

5. git push -> 将新添加的文件推送到远程服务器

6. git status -> 查看项目有无变化即状态

7. git diff -> 查看修改内容

8. git log -> 查看日志

9. git checkout -b 远程目录/文件名 -> 将远程feature-01拉取到本地

10. git rm 文件名 -> 删除本地分支上的文件

11. git rm -r 文件夹 -> 删除本地分支上的文件夹

11. git update-index --assume-unchanged 要忽略的文件夹/文件夹下文件名

三、Tortoisegit 配置、生成 SSHKey 及上传下载项目

:::info
TortoiseGit 使用扩展名为ppk的密钥，而不是ssh-keygen生成的rsa密钥，因此使用命令ssh-keygen -C “邮箱地址” 产生的密钥在TortoiseGit中不能使用。
基于git的开发必须又要用到rsa密钥，因此需要用到TortoiseGit的putty key generator工具来生成既适用于git的rsa密钥也适用于TortoiseGit的ppk密钥 。
:::

１. putty key generator工具 生成Key

1.1 putty key generator 工具是 windows 自带的，左下角搜索框中输入：putty key generator，即可找到。

1.2 生成公钥：

打开 putty key generator -> 点击“Generate”按钮，鼠标在上图的空白地方来回移动直到进度条完毕，就会自动生一个随机的key，这便是适用于git的公钥 。

如有需要，可以为密钥设置对应的访问密码，就是修改上图中“Key passphrase”和“Confirm passphrase”的值。此处暂未设置访问密码，为空。

１.3 将公钥添加到服务器：

将生成的key复制，粘贴到git账户中的SSH keys中，

生成私钥：

点击putty key generator窗口中的“Save private key”按钮，将生成的key保存为适用于TortoiseGit的私钥即扩展名为.ppk的文件

2. Pageant 添加管理 key

电脑左下角搜索框中输入： Pageant，即可找到， Pageant 为 windows 自带。

打开 Pageant -> Add Key -> 选择刚刚保存的为.ppk 的私钥，添加完成后，关闭窗口即可。

3. Tortoisegit 配置

1.1 空白处右击 -> Tortoisegit -> 设置(Settings)

1.2 填入 申请 生成 key 时所用的 名称和邮箱

4. 使用git客户端下载 Gitblit 上的文件

4.1 Gitblit 登陆 账户 ->切换到 版本库 -> 单击所在下载的项目

4.2 复制ssh 的 URL -> 在本地将要下载的目录的空白处 右击选择 Git克隆

4.3 刚复制到剪切板的 URL 一般会自动出现在 URL中，如果没有出现，可以自己手动粘贴过去 -> 确定

4.4 输入gitblit 登陆密码 -> ok

5、TortoiseGit 向 Gitblit 上传项目：

5.1 在将要上传的项目上右击 -> 选择 Git 提交

5.2 设置此提交的重点信息 并且选中将要提交的文档 -> 提交

5.3 提交成功后，一定要记得推送，不推送即只提交到本地了，推送完成后才真正上传到 gitblit 服务器上。推送时依然要填入 gitblit 登出密码。

这里有可能会出现：

直接点确定，就会出现这下面这个弹窗，输入密码，即可上传成功。


文中部署时所用的git和TortoiseGit在这里下载