GitLab是Ruby开发的自托管的Git项目仓库,可通过Web界面访问公开的或者私人的项目。本教程介绍如何安装和使用GitLab。

前提条件

使用本教程进行操作前,请确保您已经注册了阿里云账号。如还未注册,请先完成账号注册

您已创建部署GitLab的实例,要求如下:
  • 部署GitLab的实例要求至少使用2个vCPU和4GiB的内存,本示例中使用的相关资源版本如下。
    • 实例规格:ecs.c6.large
    • 操作系统:CentOS 7.2 64位
  • 已添加如下表所示的安全组规则。具体步骤,请参见添加安全组规则
    方向 协议/应用 端口/范围 源地址
    入方向 HTTP(80) 80 0.0.0.0/0

点我去体验

使用镜像部署GitLab环境

  1. 进入GitLab代码管理(Centos 64位 | GitLab)镜像详情页面,单击立即购买,然后按界面提示完成配置选型并购买ECS实例。实例配置详情,请参见使用向导创建实例
  2. 远程连接ECS实例。连接方式请参见连接方式概述
  3. 运行/alidata目录下的gitlab_opennet.sh脚本,开启远程访问。
    注意 GitLab镜像部署成功后默认禁止远程访问。您需要开启远程访问,才能通过ECS服务器的公网IP地址访问GitLab的登录界面。更多详情,请参见 镜像帮助文档
  4. 登录ECS管理控制台
  5. 在左侧导航栏,单击实例与镜像 > 实例
  6. 在顶部菜单栏左上角处,选择地域。
  7. 实例列表页面,找到所购ECS实例,并在IP 地址列获取该实例的公网IP地址。
  8. 在浏览器地址栏输入公网IP地址,访问GitLab主页。

手动部署GitLab环境

  1. 安装依赖包。
    sudo yum install -y curl policycoreutils-python openssh-server
    说明 本教程中示例场景的操作系统为CentOS 7.2 64位。如果您使用CentOS 8系统的ECS实例, 运行以上命令将出现找不到依赖包 policycoreutils-python的问题,原因是CentOS 8的软件源中没有包含该依赖包。该依赖包不影响部署GitLab,您可以忽略该问题继续运行下文中的命令。
  2. 设置SSH开机自启动并启动SSH服务。
    sudo systemctl enable sshd
    sudo systemctl start sshd
  3. 安装Postfix来发送通知邮件。
    sudo yum install postfix
  4. 设置Postfix开机自启动。
    sudo systemctl enable postfix
  5. 启动Postfix服务。
    1. 运行命令vim /etc/postfix/main.cf打开main.cf文件,找到下图内容:
      set_inet
    2. i进入编辑模式。
    3. 将这行代码改为inet_interfaces = all
    4. Esc退出编辑模式,然后输入:wq并回车以保存并关闭文件。
    5. 运行命令sudo systemctl start postfix启动Postfix服务。
  6. 添加GitLab软件包仓库。
     curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
  7. 安装GitLab。
    sudo EXTERNAL_URL="GitLab服务器的公网IP地址" yum install -y gitlab-ce
    说明 您可从ECS管理控制台的 实例列表页面找到GitLab服务器的公网IP地址。
  8. 使用浏览器访问GitLab服务器的公网IP地址。
    返回页面如下图所示,表示环境搭建成功,并且您需要设置新密码。 gitlab1

使用GitLab

  1. 登录GitLab。
    在浏览器的地址栏中,输入ECS服务器的公网IP即可进入GitLab的登录界面,首次登录使用用户名 root,密码为首次访问GitLab时设置的新密码。 gl2
    登录成功后界面如下。 gl3
  2. 创建Project。
    1. 使用Linux自带的软件源安装Git工具。
      yum install git
      install_git
    2. 生成密钥文件。
      使用如下命令生成密钥文件 .ssh/id_rsa
      ssh-keygen
      密钥使用如下命令查看公钥文件 id_rsa.pub中的内容。在下一步操作中,您需要粘贴该内容到GitLab服务器的SSH-key的配置文件中。
      cat .ssh/id_rsa.pub
      公钥
    3. 在GitLab的主页中新建一个Project。
      new_project new_project_2
    4. 添加ssh key,导入步骤2中生成的密钥文件内容。
      import-sshkey-1 import-sshkey-2
      ssh key添加完成后,如下图所示。 import-ssh-key-complete
    5. 保存项目地址,该地址在进行克隆操作时需要用到。
      项目地址
  3. 简单配置。
    1. 配置使用Git仓库的人员姓名。
      git config --global user.name "testname"
    2. 配置使用Git仓库的人员email,填写自己的公司邮箱。
      git config --global user.email "abc@example.com"
    3. 克隆项目,在本地生成同名目录,并且目录中会有所有的项目文件。
      git clone git@iZxxxxxxxxxxxxxxxxx3Z:root/test.git
      简单配置
  4. 上传文件。
    1. 进入到项目目录。
      cd test/
    2. 创建需要上传到GitLab中的目标文件。
      echo "test" > /root/test.sh
    3. 将目标文件或者目录复制到项目目录下。
      cp /root/test.sh ./
      上传文件
    4. test.sh文件加入到索引中。
      git add test.sh
    5. test.sh提交到本地仓库。
      git commit -m "test.sh"
    6. 将文件同步到GitLab服务器上。
      git push -u origin master
      文件同步命令
      在网页中查看上传的 test.sh文件已经同步到GitLab中。 文件同步结果