Github:02---Github的注册、设置SSH Key、新建仓库

一、Github的用户注册

• 注册页面为：https://github.com/join
• Username栏：用英文和数字输入要创建的ID，您的公开页面的URL（http://github.com/xx）会用到这个 ID
• 其他栏也请按照页面要求输入

二、设置头像

• 在 GitHub 上随处可见的头像（账户独有的标识）是通过 Gravatar（http://cn.gravatar.com/）服务显示的。使用过 WordPress 的读者可能对它有所了解
• 只要使用创建 GitHub 账户时注册的邮箱在 Gravatar 上设置头像， GitHub 的头像就会变成您设置好的样子
• 头像并不是使用 GitHub 时的硬性要求，但如果为代码配上编码者 的相貌或标识，会让人觉得安心，同时还可能让对方对您产生兴趣。毕 竟我们要使用的是能将关注点聚集在人身上的 GitHub，所以建议各位积极地设置头像

三、设置SSH Key

• GitHub上连接已有仓库时的认证时，可以使用的一种方法是通过使用了SSH的公开密钥认证方式进行的

创建SSH Key

• 现在让我们来创建公开密钥认证所需的SSH Key，并将其添加至 GitHub。已经创建过的读者，请用现有的密钥进行设置
• 运行下面的命令创建SSH Key，意义如下：
  • -t：指定密钥类型，默认是rsa ，可以省略
  • -C：设置注释文字。比如可以输入在创建账户时用的邮箱地址
  • -f：指定密钥文件存储文件名，该文件中存储生成的秘钥（此处我们忽略了这个参数）

ssh-keygen -t rsa -C "[email protected]"

• 上图输入命令之后，接着会让你：
  • 上面忽略了-f参数，回车之后会让你输入一个文件名，用于保存刚才生成的SSH key代码，此处我们直接回车(使用默认值)
  • 接着又会提示你输入两次密码，该密码是你push文件的时候要输入的密码，而不是github管理者的密码（当然，你也可以不输入密码，直接按回车。那么push的时候就不需要输入密码，直接提交到github上了），此处我们输入了自己的密码

• 上图中所有的信息都输入之后，你的SSH key已经创建成功，相关内容都保存在了文件中。在/home/dongshao/.ssh目录下生成两个文件：d_rsa文件是私有密钥，id_rsa.pub是公开密钥

四、添加公开密钥

• 在GitHub中添加公开密钥，今后就可以用私有密钥进行认证了

添加公开秘钥步骤

• 点击右上角的账户设定按钮（Settings）

• 选择SSH and GPG keys菜单，然后点击New SSH key

• 接着出现下面的输入框：
  • Title：用来输入适当的密钥名称。如果省略，那么默认会使用你的邮件名称。此处我们设置为“[email protected]”
  • Key：将在上面中创建的公开密钥id_rsa.pub文件内容复制进去

• 添加成功之后如下所示，并且创建账户时所用的邮箱会接到一封提示“公共密钥 添加完成”的邮件

验证SSH key

• 完成以上设置后，就可以用手中的私人密钥与GitHub进行认证和通信了
• 在git Bash中输入以下代码

ssh -T [email protected]

• 你输入上面的代码之后，会接着让你输入两次内容：
  • 先是一段警告代码，这是正常的，你输入yes回车既可
  • 接着会让你输入在上面创建SSH key时给的密码（如果没有设置，直接回车即可）

• 上图最后显示成功

五、建立仓库

• 第一步：点击主页右上角工具栏里的“New repository”图标，创建新的仓库

• 第二步：接着来到下面的界面，相关选项意义为：
  • Reposity name：仓库的名称，此处我们输入Hello-World
  • Description：仓库的说明描述。这一栏可以省略
  • Public、Private：
    • Public：意思为创建的仓库是公开的，仓库内的所有内容都会被公开
    • Private：创建非公开仓库，用户可以设置访问权限，但这项服务是收费的
  • Initialize this repository with a README：如果勾选这一项，随后Github会自动初始化仓库并设置README文件，让用户可以立即clone(克隆)这个仓库。如果想向GitHub添加手中已用的Git仓库，建议不要勾选，直接手动push
  • Add.gitignore：
    • 通过它可以在初始化时自动生成 .gitignore 文件（该文件用来描述Git仓库中不需管理的文件与目录）。这个设定会帮我们把不需要在Git仓库中进行版本管理的文件记录在.gitignore 文件中，省去了每次根据框架进行设置的麻烦
    • 下拉菜单中包含了主要的语言及框架，选择今后将要使用的即可，此处我们没有选择
  • Add a license：
    • 右侧的下拉菜单可以选择要添加的许可协议文件。如果这个仓库中 包含的代码已经确定了许可协议，那么请在这里进行选择
    • 随后将自动生成包含许可协议内容的LICENSE文件，用来表明该仓库内容的许可协议

• 第三步：上面创建仓库成功之后，成功创建的仓库如下所示
  • 仓库的URL为：https://github.com/dongyusheng/Hello-World
  • 并且其中有一个README.md文件：README.md 在初始化时已经生成好了。README.md 文件的内容会自动显示在仓库的首页当中。因此，人们一般会在这个文件中标明本 仓库所包含的软件的概要、使用流程、许可协议等信息。如果使用 Markdown 语法进行描述，还可以添加标记，提高可读性

• 备注：在GitHub上进行交流时用到的Issue、评论、Wiki，都可以用Markdown语法表述，从而进行标记。准确地说应该是GitHub Flavored Markdown（GFM）语法。该语法虽然是GitHub在Markdown语法基础上扩充而来的，但一般情况下只要按照原本的 Markdown语法进行描述就可以

六、操作仓库

• 下面会用到一些git的语法，git的语法在后面的文章才会介绍

clone已有仓库

• 我们可以使用git，将上面新建的仓库clone到自己的开发环境中
• 因为我们在上面建立了SSH key，因此clone已有仓库的方法有两种：
  • 一种为使用HTTPS克隆，不需要输入SSH秘钥
  • 一种为使用SSH克隆，需要输入上面我们的秘钥
• 在仓库的文件上方有个“Clone or download”按钮，点击之后可以获取当前仓库的URL，其中：
  • Use HTTPS的URL为：https://github.com/dongyusheng/Hello-World.git
  • Use SSH的URL为：[email protected]:dongyusheng/Hello-World.git

• 例如：下面是使用HTTPS clone的方法，不需要输入密码（这个就不演示了）

git clone https://github.com/dongyusheng/Hello-World.git

• 例如：下面是使用SSH clone的方法，回车之后需要输入密匙，输入密码之后可以在当前文件夹下看到仓库文件

git clone [email protected]:dongyusheng/Hello-World.git

 

提交

• 下面我们在本地新建文件，然后提交到github的仓库中
• 第一步：我们进入仓库目录，然后在目录下新建一个demo.cpp文件。然后使用“git status”查看当前仓库的状态，demo.cpp出现在“Untracked files”指示下

cd Hello-World
touch demo.cpp
git status

• 第二步：通过 git add命令将文件加入暂存区，再通过 git commit命令提交（-m选项为注释）

git add demo.cpp
git commit -m "Add demo.cpp"

• 第三步：添加成功后，可以通过 git log命令查看提交日志

git log

• 第四步：之后只要执行git push，GitHub 上的仓库就会被更新

git push

• 之后在github的仓库中可以看到提交的文件