github工程的本地建立和远程仓库同步

如何生成SSH key

SSH key提供了一种与GitHub通信的方式，通过这种方式，能够在不输入密码的情况下，将GitHub作为自己的remote端服务器，进行版本控制

1. 检查SSH keys是否存在

2. 生成新的ssh key

3. 将ssh key添加到GitHub中

如何生成SSH KEY

1. 检查SSH keys是否存在

输入下面的命令，如果有文件id_rsa.pub 或 id_dsa.pub，则直接进入步骤3将SSH key添加到GitHub中，否则进入第二步生成SSH key

ls -al ~/.ssh

# Lists the files in your .ssh directory, if they exist

2. 生成新的ssh key

第一步：生成public/private rsa key pair

在命令行中输入ssh-keygen -t rsa -C "your_email@example.com"

默认会在相应路径下（/your_home_path）生成id_rsa和id_rsa.pub两个文件，如下面代码所示

ssh-keygen -t rsa -C "your_email@example.com"

# Creates a new ssh key using the provided email

Generating public/private rsa key pair.

Enter file in which to save the key (/your_home_path/.ssh/id_rsa):

第二步：输入passphrase（本步骤可以跳过）

设置passphrase后，进行版本控制时，每次与GitHub通信都会要求输入passphrase，以避免某些“失误”

Enter passphrase (empty for no passphrase): [Type a passphrase]

Enter same passphrase again: [Type passphrase again]

sample result:

Your identification has been saved in /your_home_path/.ssh/id_rsa.

Your public key has been saved in /your_home_path/.ssh/id_rsa.pub.

The key fingerprint is:

#01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

第三步：将新生成的key添加到ssh-agent中:

# start the ssh-agent in the background

eval "$(ssh-agent -s)"

Agent pid 59566

ssh-add ~/.ssh/id_rsa

3. 将ssh key添加到GitHub中

用自己喜欢的文本编辑器打开id_rsa.pub文件，里面的信息即为SSH key，将这些信息复制到GitHub的Add SSH key页面即可

不同的操作系统，均有一些命令，直接将SSH key从文件拷贝到粘贴板中，如下：（注意在粘贴的时候，需要在github对应项目下的setting中选择deploy key然后粘贴完成后勾选提供写权限的操作即可，否则后面使用key提交工程的时候会报权限错误，这点一定要记住）

mac

pbcopy < ~/.ssh/id_rsa.pub

# Copies the contents of the id_rsa.pub file to your clipboard

windows

clip < ~/.ssh/id_rsa.pub

# Copies the contents of the id_rsa.pub file to your clipboard

linux

sudo apt-get install xclip

# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)

xclip -sel clip < ~/.ssh/id_rsa.pub

# Copies the contents of the id_rsa.pub file to your clipboard

本地git版本仓库的创建

cd 本地代码仓库路径

git init

git add *

git commit -m "first commit"

远程仓库的链接和代码提交

git remote add origin git@github.com:username/xxx.git (注意这里是ssh类型的git仓库地址，不是选择的https类型的)

git push -u origin master

ssh key出现错误的解决办法

常见的问题例如： 

The key you are authenticating with has been marked as read only

解决办法：通常因为最初创建ssh key的时候没有勾选写权限的操作而导致的

key is already in use

解决办法： 多个仓库同时使用了ssh key，可以通过删除ssh key重新创建的方式来修改

ssh-add -D

rm -r ~/.ssh

删除你在github中的public-key

重新生成ssh密钥对

ssh-keygen -t rsa -C "xxx@xxx.com"

chmod 0700 ~/.ssh

chmod 0600 ~/.ssh/id_rsa*

接下来正常操作

在github上添加公钥public-key:

1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板

2、在github上添加公钥时，直接复制即可

3、保存

测试：

在终端 ssh -T git@github.com

在github上除了可以使用ssh key的形式外还可以使用https的形式。因为如果使用ssh需要单独为每一个代码仓库配置重新生成ssh key，比较繁琐，因此可以使用https的形式来直接进行网页的操作就可以了。

使用https地址来提交代码仓库

具体的步骤和上面的很相近，但是具体的区别在于创建远程仓库的实现上。(替换掉username 和 仓库名称就可以了)

git remote add origin https://github.com/username/xxx.git