操作指南

最佳实践

故障处理

API 文档

搭建 GitLab

最近更新时间:2020-08-18 11:31:29

操作场景

GitLab 是使用 Ruby 开发的开源版本管理系统,以 Git 作为代码管理工具并实现自托管的 Git 项目仓库,可通过 Web 界面访问公开或私人的项目。本文介绍如何在腾讯云云服务器上安装并使用 GitLab。

示例版本

本文使用的云服务器配置如下:

  • vCPU:2核
  • 内存:4GB
  • Linux 操作系统:本文以 CentOS 7.7 为例

前提条件

操作步骤

安装 GitLab

  1. 使用标准方式登录 Linux 实例(推荐)。您也可以根据实际操作习惯,选择其他不同的登录方式:
  2. 执行以下命令,安装依赖包。
    yum install -y curl policycoreutils-python openssh-server
  3. 依次执行以下命令,设置 SSH 开机自启动并启动 SSH 服务。
    systemctl enable sshd
    systemctl start sshd
  4. 执行以下命令,安装 Postfix。
    yum install -y postfix
  5. 执行以下命令,设置 Postfix 服务开机自启动。
    systemctl enable postfix
  6. 执行以下命令,打开 Postfix 的配置文件 main.cf。
    vim /etc/postfix/main.cf
  7. i 进入编辑模式,删除 inet_interfaces = all 前的 #,在 inet_interfaces = localhost 前加上 #。修改完成后如下图所示:
  8. Esc 并输入 :wq 保存修改并退出文件。
  9. 执行以下命令,启动 Postfix。
    systemctl start postfix
  10. 执行以下命令,添加 GitLab 软件包仓库。
    curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
  11. 执行以下命令,安装 GitLab。
    sudo EXTERNAL_URL="实例公网 IP 地址" yum install -y gitlab-ce
    如何获取实例公网 IP,请参见 获取公网 IP 地址
  12. 在本地浏览器中访问已获取的公网 IP,返回页面如下所示,则表示已成功安装 GitLab。
    注意:

    请在该页面配置登录 GitLab 帐户的密码。

创建项目

  1. 在本地浏览器中访问云服务器的公网 IP,进入 GitLab 登录界面。使用 root 帐户及已设置的登录密码进行登录。如下图所示:
  2. 根据页面指引创建私人项目,本文以 test 为例。如下图所示:
  3. 成功创建项目后,单击页面上方提示中的【Add SSH Key】。
  4. 进入 “SSH Keys” 页面,按照以下步骤添加 SSH Key:
    1. 通过 获取密钥 步骤,获取需纳入项目管理 PC 的密钥信息,粘贴在 “Key” 中。
    2. 在 “Title” 中自定义命名该密钥。
    3. 单击【Add key】即可添加密钥。如下图所示:

      如下图所示则表示密钥添加成功:
  5. 返回项目首页,单击【clone】记录项目地址。如下图所示:

克隆项目

  1. 在已纳入管理的 PC 上执行以下命令,配置使用 Git 仓库的人员姓名。
    git config --global user.name "username" 
  2. 执行以下命令,配置使用 Git 仓库的人员邮箱。
    git config --global user.email "xxx@example.com" 
  3. 执行以下命令,克隆项目。其中“项目地址”请替换为已在 步骤5 中获取的项目地址。
    git clone “项目地址”
    克隆项目成功后,会在本地生成同名目录且包含项目中所有文件。

上传文件

  1. 执行以下命令,进入项目目录。
    cd test/
  2. 执行以下命令,创建需上传至 GitLab 的目标文件。本文以 test.sh 为例。
    echo "test" > test.sh
  3. 执行以下命令,将 test.sh 文件加入索引中。
    git add test.sh
  4. 执行以下命令,将 test.sh 提交至本地仓库。
    git commit -m "test.sh"
  5. 执行以下命令,将 test.sh 同步至 GitLab 服务器。
    git push -u origin master
    返回 test 项目页面,即可查看文件已成功上传。如下图所示:

相关操作

获取密钥

  1. 在需要纳入项目管理的 PC 上执行以下命令,安装 Git。
    yum install -y git
  2. 执行以下命令,生成密钥文件 .ssh/id_rsa。生成密钥文件步骤中请按 Enter 保持默认设置。
    ssh-keygen
  3. 执行以下命令,查看并记录密钥信息。
    cat .ssh/id_rsa.pub
目录