git ssh Permission denied (publickey)

背景

今天临下班前忽然想到最近须要重构一个很是重要的项目，新项目使用的技术栈是 Vue。因为需求可能会不少和很杂，为了方便项目的迭代和维护，咱们合计着引入一个文档系统，针对每一个需求和每次的改动编写对应的文档以便进行需求的梳理与项目的维护。

晚上就回家捣鼓了一下 vuepress ，这个是基于 Vue + Vue Router + Webpack 的技术栈形式进行实现的，和咱们主项目的技术架构同样的，并且 vuepress 支持很完善的配置和高可定制化处理，因而就用来搭建了一个我的的博客系统，并实现了命令式一键部署！

就是这个一键式部署功能引出了本篇文档！

问题

先把自动部署 github 的 shell 脚本抛出来吧！

#!/usr/bin/env sh
 # 确保脚本抛出遇到的错误
set -e
 # 生成静态文件
npm run docs:build
 # 进入最终生成静态的目录
cd docs/.vuepress/dist

// 在最终生成的静态目录初始化 git 配置
git init
git add -A
git commit -m 'deploy'
 # 推到你仓库的的 gh-page 分支
# 将 <USERNAME>/<REPO> 替换为你的信息
git push -f git@github.com:<USERNAME>/<REPO>.git master:gh-pages

cd -
复制代码

自动部署 github 的脚本很简单，基本的流程就是：执行 npm run docs:build 生成最终的网站静态资源，因为生成的静态资源存放在 docs/.vuepress/dist 目录下，而后将当前目录转到最终静态的目录，再初始化 git 配置，提交全部的变动，最后将全部的变动 push 到远程的 github 仓库对应的分支。

这个自动化部署的过程是没什么问题的。可是就是在执行自动化部署时，在最后一步 —— push 代码的时候报错了

这个报错信息向咱们展现了：当 shell 经过 ssh 方式向 github 仓库推送代码的时候，没有权限（publickey）。

静下心来想一想，发现这个报错是情理之中的：由于 github 是一个公共的代码管理平台，只要是公共的管理平台，就确定会有安全问题，针对这些安全问题，平台开发者确定会实施一些措施进行规避，好比浏览器实现了同源策略。关于 github 这样的平台确定是实现了公钥、私钥的处理。

既然问题都已经清除了，且问题的缘由也找到一二了，那就动手解决问题吧！

解决

经过 git@github.com: Permission denied (publickey) 关键字在网上搜索了一通，发现关于这类问题的条目还蛮多的，内容都是大同小异：

• 一、运行 ssh-keygen 命令生成 ssh 密钥文件**（这里建议回到 ~ 目录）**
• 二、生成 ssh 密钥时，会提示你输入文件的 key 和 passphrase，我建议这里一直按回车过掉

随后就会 User/<userName>/.ssh 下生成这三个文件。

• 三、在 github setting 主页添加 ssh 相关值

将上图中经过命令生成的 SSH 密钥文件 id_rsa.pub 里面的内容复制到 SSH key，而后 title 设置 id_rsa，最后点击 Add SSH key 保存 SSH 密钥值便可。

• 四、回到终端执行 ssh -T git@github.com 检查 SSH 密钥是否生效

若是出现上图显示的内容就证实 SSH 配置完成。

• 五、从新执行部署命令就发现 push 代码已经 OK 了！

总结

这个问题是关于 git ssh 的问题。问题看上去有点可怕，由于跟权限挂钩了，可是这类问题网上就不少参考的文档，因此也就没什么好怕的了。这里主要介绍了 Mac 的解决方案，关于 Windows 的解决方案，我这里就不方便出了，由于手上也没有 Windows 电脑。若是你们遇到问题，仍是去网上搜搜吧！