简介
很多公司都选择git作为代码版本控制工具,搭建私有的gitlab来管理代码。
我们在clone代码的时候可以选择http/https协议,也选择ssh协议来拉取代码。
Gitlab,Github都支持这种方式的连接,而且目前https://gitlab.com登录必须要配置ssh登录了。
网上介绍如何用git客户端生成ssh key的文章很多,不过讲解不细致,对于小白用户还是话还是需要费很多功夫,本文介绍如何用本地git客户端生成ssh key并配置在gitlab和github中,而后使用ssh协议进行提交和拉取git远程仓库的代码。
环境准备
- 系统:windows, 其他环境类似
- git Bash 下载,https://git-scm.com/, 直接点击安装即可,很简单。
第一步:生成密钥对
1、打开本地git bash(可以右键,选择Git Bash here), 如图:
- 使用如下命令生成ssh公钥和私钥对:
ssh-keygen -t rsa -C 'xxx@xxx.com'
然后一路回车(-C 参数是你的邮箱地址), 如图:
第二步:添加公钥
-
打开 ~/.ssh/id_rsa.pub文件(~表示用户目录,例如:windows下就是C:\Users\Administrator),复制其中的内容。
-
打开https://gitlab.com, 点击右上角头像,下拉菜单中选择 Setting, 然后在左边的菜单中找到SSH Keys,(或者直接打开https://gitlab.com/profile/keys)
并把上一步中复制的内容粘贴到Key所对应的文本框中,
在Title对应的文本框中给这个sshkey设置一个名字,
点击Add key按钮。 -
到此就完成了gitlab配置ssh key的所有步骤,可以自由地进行pull 和push 操作了
-
对于github 的用户, 打开https://github.com/settings/ssh/new,
粘贴刚才复制的id_rsa.pub中内容到key中 ,title随便起个名字即可。
第三步:验证
打开 git bash(或者其它git工具或者ide),
找到gitlab上的项目,执行命令
git clone https://gitlab.com/xxxxx/xxx(替换成你的项目地址)
没有输入密码,clone成功。
本地配置多个 SSH key
- 大多数时候,我们的机器上会有很多的git host,比如公司gitlab、github、oschina等,那我们就需要在本地配置多个ssh key,使得不同的host能使用不同的ssh key ,做法如下(以公司gitlab和github为例)
为github生成一对秘钥ssh key
ssh-keygen -t rsa -C 'yourEmail1@xx.com' -f ~/.ssh/github_id-rsa/zhangsan_github
为gitlab生成一对秘钥ssh key
ssh-keygen -t rsa -C 'yourEmail2@xx.com' -f ~/.ssh/gitlab_id-rsa/zhangsan_gitlab
为gitlab生成另一对秘钥ssh key
ssh-keygen -t rsa -C 'yourEmail3@xx.com' -f ~/.ssh/gitlab_id-rsa/lisi_gitlab
- 在~/.ssh目录下新建名称为config的文件(无后缀名)。用于配置多个不同的host使用不同的ssh key,内容如下:
# github zhangsan_github
Host github.com
HostName github.com
User zhangsan_github
PreferredAuthentications publickey
IdentityFile ~/.ssh/github_id-rsa/zhangsan_github
# gitlab zhangsan_gitlab
Host gitlab.com
HostName gitlab.com
User zhangsan_gitlab
PreferredAuthentications publickey
IdentityFile ~/.ssh/github_id-rsa/zhangsan_gitlab
# github lisi_gitlab
Host gitlab.com
HostName gitlab.com
User lisi_gitlab
PreferredAuthentications publickey
IdentityFile ~/.ssh/github_id-rsa/lisi_gitlab
# 配置文件参数
# Host : Host可以看作是一个你要识别的模式,对识别的模式,进行配置对应的的主机名和ssh文件
# HostName : 要登录主机的主机名
# User : 登录名
# IdentityFile : 指明上面User对应的identityFile路径
- 按照上面的步骤分别往gitlab和github上添加生成的公钥gitlab_id-rsa.pub和github_id-rsa.pub
- OK,大功告成,再次执行git命令验证是不是已经不需要再次验证权限了。
- 再次查看.ssh/gitlab_id-rsa目录下的文件,如下:
zhangsan_github
zhangsan_github.pub
zhangsan_gitlab
zhangsan_gitlab.pub
lisi_gitlab
lisi_gitlab.pub