Engee 文档

在个人电脑上使用 Git

本文提供在个人电脑上通过 Git 终端使用本地仓库的基本命令。要在终端上工作，需要使用 SSH 密钥或 HTTPS 密钥（需要登录/密码才能执行命令）下载远程仓库。远程存储库 中介绍了获取它们的过程。两种密钥各有利弊，但 SSH 密钥不需要密码验证，因此使用起来更方便。

如果没有使用过 Git 或其他版本控制系统，建议先阅读quick guide 了解基本命令。

从 GitLab 本地拷贝

  1. 进入*GitLab*。打开要本地复制的版本库。在点击 Clone 时打开的菜单中，使用 SSH 密钥复制链接：

    clone menu

  2. 打开终端。导航至存储版本库的目录（本例中为 /e/Project/Engee/）并运行命令：

    git clone <ссылка на репозиторий>

    上一步已复制了资源库的链接。

    clone rep1

通过终端连接

要创建一个空的本地版本库，请为版本库创建一个文件夹（例如：/e/Project/Engee/test-rep-1/）并运行`init`命令：

mkdir /e/Project/Engee/test-rep-1/
cd /e/Project/Engee/test-rep-1/
git init

命令行将返回类似的响应：

Initialized empty Git repository in /e/Project/Engee/test-rep-1/

这意味着新版本库已成功创建。

git init

要将本地版本库链接到 GitLab 上的版本库，请在终端运行以下命令：

git remote add origin <ссылка на репозиторий>

要从服务器上拉取版本库中的更改，请在终端运行 git pull origin 命令：

git pull origin <нужная ветка>

通过终端发送更改

  1. 在克隆版本库的根目录下打开控制台。

    open rep1

  2. 创建一个新的本地分支（本例中为 RTFM-28）。为此，请运行以下命令

    git checkout -b <название новой ветки>

    checkout1

  3. 对版本库文件进行必要的更改。

  4. 将修改后的文件添加到提交中。为此，请运行以下命令

    git add .

    add1

  5. 创建提交。为此，请执行命令

    git commit -m "краткое описание коммита"

    git commit1

  6. 将本地分支上传到版本库。为此，请运行以下命令

    git push origin <имя локальной ветки>

  7. 成功提交修改后的文件后，需要使用 git merge 命令将其嵌入或整合到主分支中。为此，请运行以下命令：

    git checkout master
git merge <имя локальной ветки>
git push origin master

  8. 此外，您还可以在图形模式下合并分支。为此，请访问 GitLab 网站。打开工作版本库，然后点击绿色 You pushed to …​*横幅上的 *Create merge request 按钮。

    create mr

    或者从屏幕左侧的菜单中选择*合并请求*，然后点击*新合并请求*按钮：

    create mr 2

    在第二种情况下，GitLab 会提示您首先选择要创建合并请求（MR）的分支：

    create mr 3

    选择分支，然后点击*比较分支并继续*。

  9. 在打开的表单中填写字段：

    • 在表单顶部，检查你的分支是否与正确的主分支死锁。如有必要，请单击*更改分支*链接并指定正确的分支。

    • 标题（必填） - 合并请求 (MR) 标题

    • 描述 - MR 的描述（可选）

    • Assignee - 点击 Assign to me 链接。

    • 审阅人 - 从下拉列表中选择审阅人或审阅人

      mr form1

      填写表格后，点击 创建合并请求。

实用链接

  1. Engee 远程仓库.

  2. Git 快速入门指南（英文）.

  3. 官方 Git 文档 (英文).