Engee 文档

远程存储库

GitLab、GitHub 和 Bitbucket 等版本库托管平台上的远程版本库是所有用户都能通过互联网访问的版本库。这些平台以 Git 版本控制系统为基础，为存储和管理项目提供了一个集中的场所。

*Engee*拥有自己的远程仓库，由GitLab托管，网址是链接。所有在*Engee*注册的用户都可以通过*Engee*账户的登录名/密码访问远程仓库。

界面示例取自 GitLab。如果您使用其他主机进行版本控制，请参阅相应主机的官方文档。

你可以在相应主机的网站上使用 Git，但它们通常被用作项目仓库，所有工作都在开发者的本地电脑上完成。要访问远程仓库，需要获得该仓库的链接。该链接允许本地仓库与远程仓库进行通信，并使用 Git 在本地仓库和远程仓库之间同步和交换变更。请阅读下文获取链接的更多信息。

远程仓库 git.engee

使用*Engee*账户的登录名/密码登录远程仓库 Engee。如果您从未使用过 git.engee，则会进入开始菜单，创建自己的项目或加入现有项目：

gitlab main menu

考虑创建自己的项目：

  • 选择 创建项目。这将打开项目创建菜单。将提供三个选项中的一个：

    • 创建空白项目 - 创建一个空白项目，用于文件存储、工作规划、代码协作和/或其他目的。

    • 从模板创建 - 创建一个预填充了必要文件的项目，以便快速启动。有许多针对特定编程语言和外壳的内置模板可供选择。

    • 导入项目 - 从 GitHub、Bitbucket 或其他 GitLab 实例（托管）等外部来源传输数据。

  • 创建一个空白项目，指定名称、可见性（对其他用户的访问权限）、配置（创建 README 文件），必要时还可指定标题：

    gitlab blank project

    创建的项目如下所示

    file browser clone 4

  • 现在，你可以克隆自己的远程仓库，在本地运行：

    gitlab main menu 1 1

    如果你已经拥有自己的项目，它们将显示在主页上：

    exp user git engee

    选择所需的项目并复制，如前所述。

    注册 Engee 账户时会自动生成 SSH 密钥。要使用其他远程仓库（GitLab *Engee*之外），必须自己创建密钥。
    要使用远程 Engee 仓库，请使用 SSH 链接。

考虑连接到其他人的项目。

  • 如果尚未创建自己的项目，请从 GitLab 主菜单中选择*探索公共项目*：

    explore projects 1

    或从已创建项目菜单中选择探索项目：

    explore projects

    这两个选项都将打开项目搜索部分：

    project search 1

  • 点击其中一个选项卡：全部（所有项目）、最受欢迎（最受欢迎）或使用名称筛选器（名称筛选器）。然后选择所需的标有 Public 的项目gitlab public button 。

    您可以克隆所有标有 *Public*gitlab public button （公开）的版本库。标有 *Internal*gitlab internal button （内部）的版本库默认不对其他用户开放。您可以使用版本库页面上的 "请求访问 "命令申请访问此类版本库。

  • 在选定的项目页面上，使用 SSH 密钥克隆该版本库。也可以使用 HTTPS 克隆版本库，但每次与版本库交互时都需要登录/密码（除非已缓存）：

    gitlab main menu 1

在 Engee 中使用远程软件源

要在 Engee 中使用远程软件源，您需要自己添加 SSH 密钥。添加密钥的命令可在 shell 模式下输入command line of *Engee*img 41 1 2 。

要将命令行切换为 shell 模式，请使用分号; - 命令行将从 engee> 变为 shell> 并支持所有Git 命令。

按以下说明添加 SSH 密钥（以 GitLab 托管为例）：

  1. 在 shell 模式下的命令提示符下输入 ssh-keygen 命令生成密钥：

    ssh-keygen -C "comment"

  2. 命令行会提示你保存生成的密钥。你不必更改保存密钥的目录。然后在所有命令行提示下按回车键，直到出现 "randomart"--SSH 密钥的可视化表示：

    randomart ssh

    收到图像表示密钥已成功创建。默认情况下，密钥将保存在 /home/engee/.ssh/id_rsa 目录中。.ssh 文件夹将隐藏在 Engee 文件浏览器中。

  3. 使用命令获取 SSH 密钥的内容：

    cat /home/engee/.ssh/id_rsa.pub

    randomart ssh 1

  4. 复制 SSH 密钥的内容并返回主机站点。点击用户头像，从上下文菜单中选择 编辑配置文件。

    edit profile1

  5. 打开 SSH-keys 部分，将先前复制的密钥粘贴到指定字段，然后单击 Add key 按钮：

    add key

  6. 接下来，转到所需项目的页面，用 SSH 密钥克隆其仓库：

    gitlab main menu 1

    输入克隆版本库的命令：

    git clone git@git.engee.com:имя пользователя/имя репозитория.git

  7. 有关克隆版本库的进一步操作，请参阅文章Engee 命令行中的 Git 。

密钥的有效期有限，可在*SSH-keys*部分延长。获得密钥后，就可以从 GitLab 克隆远程仓库，在 Engee 和本地计算机 上运行。

在 Engee 中使用 nano 编辑器修改配置文件

advanced users cn

更改 SSH 配置文件（~/.ssh/config）可简化连接远程软件源的过程，尤其是在为不同主机或软件源设置多个 SSH 密钥的情况下。你可以使用内置的命令行编辑器nano 来更改 SSH 配置。具体操作如下

  1. 使用分号; 将命令行切换到 shell shell 模式 - 命令行将从 engee> 变为 shell>。

  2. 使用 nano 文本编辑器输入命令打开 SSH 配置文件：

    nano ~/.ssh/config

  3. 在编辑器窗口中，指定主机地址（本例中为 git.engee.com）和生成的 Engee 密钥的路径，如示例所示：

    git nano 1

    Host git.engee.com
        User git
        IdentityFile /home/engee/.ssh./id_rsa
Host *
        StrictHostKeyChecking no

    其中

    • Host` - 主机地址。

    • User - 用户名。

    • IdentityFile - 生成密钥的路径（默认指定）。

    • StrictHostKeyChecking - 禁用主机密钥检查。设置为 "no "可自动添加新主机密钥，无需确认请求。

  4. 按Ctrl+X 保存更改（底行将显示*保存修改的缓冲区？）

    git nano x

  5. 按Y 保存更改，并按Enter 键确认保存到目录中。保存后，nano 编辑器将自动关闭。

    git nano 3

  6. 现在，你可以用通常的方法，使用多个密钥，从不同的主机克隆一个远程仓库到 Engee 中。

实用链接

  1. 使用 Git

  2. Git 官方文档（英文

  3. link:https://docs.gitlab.com/[GitLab 官方文档