快速入门

最近更新时间:2021-03-08 16:07:08

操作场景

CODING 代码托管基于开源的版本控制系统 Git。借助 Git,您的本地电脑与 CODING 会各有一个完整的代码仓库,两者可以进行分布式的版本管理。为了在您的本地电脑上管理代码,您需要先配置好 Git,包括下载安装、设置等操作。如果您不需要在本地电脑上管理代码,CODING 支持在浏览器中实现大部分的代码仓库操作。本文档主要介绍如何快速使用 CODING 代码托管。

前提条件

使用 CODING 代码托管的前提是,您的腾讯云账号需要开通 CODING DevOps 服务,并按照页面弹框的提示前往【个人设置】完善服务密码、邮箱、手机,您在后续操作(克隆代码、推送代码等)会需要使用到上述信息。详情请参见 开通服务

配置 Git

下载安装最新版的 Git

请在 Git 官网 下载最新版的程序并进行安装。

在 Git 中设置用户名和邮箱

  1. 打开 Git Bash。
  2. 设置您的用户名。
    git config --global user.name "your_name" # 双引号内填入您的用户名
  3. 设置您的邮箱(您的 CODING 账号邮箱)。
    git config --global user.email "your_email@example.com" # 双引号内填入您的 CODING 账号邮箱

本地 Git 与 CODING 授权连接

将本地电脑上的 Git 与远程的 CODING 代码仓库连接到一起,您需要先给 CODING 授权。授权方式有 HTTPS 或者 SSH 两种协议可选。

使用 HTTPS 授权连接

如果您使用形如https://e.coding.net/xxx.git的项目地址来克隆代码仓库,那么命令行会提示您输入您的 CODING 邮箱或手机号和密码来授权连接,请先在“个人设置”中进行设置。

使用 SSH 授权连接

如果您使用形如 git@e.coding.net:xxx.git 的项目地址来克隆仓库,那么您需要先配置好 SSH 密钥对来授权连接。

  1. 打开 Git Bash。
  2. 基于您填入的邮箱生成密钥对。
    ssh-keygen -t rsa -b 4096 -C "your_email@example.com" # 双引号内填入您的 CODING 账号邮箱
    说明:

    若您需要使用多个 SSH 密钥对(您可能同时在多个代码托管平台工作),在执行上述命令后 Git Bash 会提示您 “Enter file in which to save the key” 时,输入一个新的文件名称就不会覆盖默认的密钥对。

  3. 显示公钥。
    cat ~/.ssh/id_rsa.pub # 默认存储在 ~/.ssh 目录下
  4. 复制公钥,登录 CODING,选择【个人设置】>【SSH公钥】>【新增公钥】,将公钥粘贴到“公钥内容”的框中,最后单击【添加】。

创建 CODING 代码仓库

在 CODING 中,一个项目对应一个代码仓库,所以需要创建代码仓库,需先创建项目并初始化代码仓库。

新建项目

鼠标移到右上角的,单击浮出来的【创建项目】,进入“创建项目”页面。

填写项目基本信息

  1. 依次填入项目名称、地址、描述信息,其中项目地址即是代码仓库的地址,勾选“启用 README.md 文件初始化项目” ,单击【完成创建】。
  2. 选择左侧菜单栏【代码】>【代码浏览】,就可看到刚建好的代码仓库,里面有一份刚才初始化生成的 README.md 文本文件。

保存您对代码的修改

CODING 代码仓库支持在浏览器里对文件直接进行编辑修改、保存提交等操作。

修改代码

  1. 单击【README.md】,进入文件内容页。
  2. 单击【编辑】,开始修改文件。

提交代码

  1. 填写提交说明,描述这次修改的内容。如果不填写,默认的提交说明是“更新文件 xxx”。
  2. 单击【提交到 master 分支】,将此次修改内容保存进代码仓库的 master 分支。
  3. 选择左侧菜单栏【代码】>【代码浏览】,即可查看提交的操作记录、更新后的内容。

克隆代码仓库到本地

通过 HTTPS 协议克隆

  1. 选择左侧菜单栏【代码】>【代码浏览】右上角,选择“HTTPS”,单击复制地址。
  2. 在 Git Bash 中输入克隆命令。
    git clone https://e.coding.net/xxx.git # 换成您复制的仓库地址
    终端将提示输入您的用户名与密码。其中,用户名为您在 CODING DevOps 【个人设置】中的手机号码或者邮箱,密码就是【个人设置】中的服务密码。

    通过 SSH 协议克隆

  3. 选择左侧菜单栏【代码】>【代码浏览】右上角,选择“SSH”,单击复制地址。
  4. 在 Git Bash 中输入克隆命令。
    git clone git@e.coding.net:xxx.git # 换成您复制的仓库地址
    终端将自动匹对您的本地私钥与之前存入 CODING 个人设置里的公钥,完成克隆。

本地代码推送至 CODING 仓库

  1. 告诉 Git 要追踪哪些文件。
    例如,我在本地的代码仓库新建了一个“hello.c”的文件,输入git add命令,告诉 Git 开始追踪这个文件的版本变化。
    git add hello.c
  2. 将文件保存进代码仓库。
    输入git commit命令将现在的文件版本保存进代码仓库里。
    git commit -m "add hello.c" # 双引号里填入保存说明
  3. 将本地的代码仓库推送至远程的 CODING 代码仓库。
    以推送到远程 CODING 代码仓库的 master 分支为例,输入命令:
    git push origin master
  4. 查看效果。
    选择左侧菜单栏【代码】>【代码浏览】,可以看到推送记录,以及与本地一样的代码仓库。

拉取 CODING 代码仓库至本地

如果您在 CODING 代码仓库里做了修改,可以通过git pull命令将远程的代码拉取(同步)到本地。
输入git pull命令更新本地仓库:

git pull
目录