GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。本文介绍如何在Linux实例上搭建并使用GitLab应用。 ## 前提条件 * 您已购买Linux实例。具体操作请参见[购买云服务器](https://www.volcengine.com/docs/6396/67743)。 > 若您的实例规格低于4 vCPU、8 GiB内存，可能会因配置过低导致安装时间过长或安装失败。建议您升级实例规格后再安装GitLab，[了解更多](https://www.volcengine.com/docs/6396/69798)。 * 您已为Linux实例绑定公网IP，使其具备访问公网的能力。如未绑定，请参见[绑定公网IP](https://www.volcengine.com/docs/6396/67793)。 * 实例关联安全组在入方向已放通TCP 80端口。 ## 第一步：安装Gitlab ### 社区版GitLab ```mixin-react return ( ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f086c37438d7d89a374dda837aeddce3.png =516x) 6. 执行如下命令，安装GitLab。 \`\`\`Plain Text sudo EXTERNAL_URL="" yum install -y gitlab-ce \`\`\` 回显如下，表示安装成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_edd05e8ed1423523c380cfb54d624994.png =516x) 8. 执行如下命令，查看并记录GitLab的默认登录密码。 \`\`\`Plain Text cat /etc/gitlab/initial_root_password \`\`\` :::warning 本文件将于24小时后自动删除。 ::: 回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7650f61976094356574e75a7fc9a8d52.png =965x) `}> ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f1e2dfa0f00dda177fb8ec94b6476f6d.png =651x) 6. 执行如下命令，安装GitLab。 \`\`\`Plain Text sudo EXTERNAL_URL="" apt-get install -y gitlab-ce \`\`\` 回显如下，表示安装成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e2f4cd3f50e88c538c5ff0f98df0f302.png =402x) 7. 执行如下命令，查看并记录GitLab的默认登录密码。 \`\`\`Plain Text cat /etc/gitlab/initial_root_password \`\`\` :::warning 本文件将于24小时后自动删除。 ::: 回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7650f61976094356574e75a7fc9a8d52.png =965x) `}>); ``` ### 极狐GitLab 本节以Ubutun 24.04为例，更多内容可查看极狐GitLab[支持的操作系统](https://gitlab.cn/docs/jh/administration/package_information/supported_os.html#%E6%94%AF%E6%8C%81%E7%9A%84%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F)。 1. [登录目标实例](https://www.volcengine.com/docs/6396/67747)。 2. 执行如下命令，安装和配置所需依赖。 ```Plain Text sudo apt-get update sudo apt-get install -y curl openssh-server ca-certificates tzdata perl ``` 3. 执行如下命令安装Postfix，用于发送邮件。 ```Plain Text sudo apt-get install -y postfix ``` :::tip 出现安装选项时请按需调整，按回车键确认即可。本文均保持默认配置。 ::: 4. 执行如下命令，启动Postfix并设置开机自启动。 ```Plain Text sudo systemctl enable postfix sudo systemctl start postfix ``` 5. 执行如下命令，下载并安装极狐GitLab。 ```Plain Text curl -L get.gitlab.cn | bash ``` 6. 执行如下命令，安装GitLab。 ```Plain Text sudo EXTERNAL_URL="" apt-get install -y gitlab-jh ``` 回显如下，表示安装成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8403765b345cf608be12fe2995f38a07.png =608x) 7. 执行如下命令，查看并记录GitLab的默认登录密码。 ```Plain Text cat /etc/gitlab/initial_root_password ``` :::warning 本文件将于24小时后自动删除。 ::: 回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7650f61976094356574e75a7fc9a8d52.png =965x) ## 第二步：登录GitLab管理页面本节以社区版GitLab为例（极狐GitLab相关操作与其类似），介绍如何登录GitLab管理页面并进行必要配置。 1. 在本地浏览器中输入`http:///`，使用root账户和默认登录密码登录Gitlab。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_aa86b45c168d950a58765084eb2a3626.png =553x) 2. 修改root账户登录密码。 1. 单击左侧导航栏底部的“Admin”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9c6fb63eb8facde4584b71053f5f466c.png =116x) 2. 在左侧导航栏选择“Overview \> Users”。 3. 选择“User”页签。 4. 单击Administer用户右侧的“Edit”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ebeaea7dd7cf656a485aae44dad10eb5.png =684x) 5. 请在“Password”模块中输入新的root账户登录密码。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6d4a0b1ecc3a95f17e420804f0dd35fe.png =680x) 3. 若存在新用户申请，您可以按如下步骤审批其申请。 1. 单击左侧导航栏底部的“Admin”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9c6fb63eb8facde4584b71053f5f466c.png =116x) 2. 在左侧导航栏选择“Overview \> Users”。 3. 选择“Users”页签，单击目标用户申请右侧的按钮，即可审批申请。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_babf3975ef3068b17262e78a75f0d6c2.png =504x) 5. 更多管理操作指引，可查看[admin_area](https://docs.gitlab.com/ee/administration/admin_area.html)。 ## 第三步：注册新用户并配置免密登录 1. 在本地浏览器中输入`http:///`。 2. 单击“Register now”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8aca3cf96ed02251bbd231630d725251.png =462x) 3. 填写新用户信息后，单击“继续”按钮提交申请。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8aa7981b7a86d60f0a89ffde20f3d0a9.png =455x) 4. 联系GitLab管理员通过您的新用户申请。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f2f41575bb872bc22fb5cbe593ca30a8.png =463x) 5. 通过申请后，即可使用新用户账号登录GitLab。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5136fefe963a017ef5a6e814dfd3d541.png =465x) 6. **（可选）**配置免密认证。若您需要频繁与GitLab进行交互，在本地开发环境中进行代码推送、拉取等操作时，使用SSH密钥免密登录可以提高效率，且安全性较高。 1. 在需要免密链接至GitLab的PC内执行如下命令，获取SSH Key。 :::warning 该配置仅针对当前PC生效，更换PC后需重新配置。 ::: ```Plain Text ssh-keygen -t rsa ``` 2. 根据指引，配置密钥保存的路径、密码短语。 :::tip 本文均保持默认配置，在每项配置处单击回车键即可。 ::: ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_376bcb748cd9905356b8bb2c016e8579.png =562x) 3. 执行如下命令，查看并记录SSH Key公钥。 ```Plain Text cat .ssh/id_rsa.pub ``` 回显示例： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a9d2aea99a2981c0bea15d137763ca9d.png =570x) 4. 使用目标账户登录GitLab。 5. 单击账户头像并选择“Edit profile”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d725ddc7015ad2fbd21b234b7f02cd03.png =262x) 6. 在左侧目录树选择“SSH Keys”并单击“Add new key”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dd9dfa96547c3c8caf9faed171d6c01c.png =614x) 7. 将上文获取的公钥内容粘贴入“密钥”模块，单击“添加密钥”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_77e39ec642a6cb1dfa562fb3924a7d2e.png =608x) ## 第四步：使用GitLab 本节以同一台本地PC为例，介绍较为常见的GitLab使用流程，更多操作说明可查看[Get started with GitLab](https://docs.gitlab.com/user/get_started/)。 ### 创建远程仓库 1. 在GitLab主页中，单击“Create a project”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1eaa0d6a1132472499382240d67357aa.png =468x) 2. 单击“Create blank project”按钮，创建项目。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4e855126bf65c05ac9686bc827a0810b.png =473x) 3. 配置Project后，单击“Create project”按钮，完成创建。更多远程仓库管理操作可查看[Organize work with projects](https://docs.gitlab.com/user/project/organize_work_with_projects/)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_16abc7bcb70a273aca386cf12cd93810.png =475x) ### 克隆远程仓库 1. 登录本地PC。 2. 执行如下命令，安装Git。 ```mixin-react return ( ); ``` 3. 执行以下命令，配置使用Git仓库的人员姓名。 ```Plain Text git config --global user.name "testname" ``` 3. 执行以下命令，配置使用Git仓库的人员邮箱。 ```Plain Text git config --global user.email "xxx@example.com" ``` 4. 进入GitLab目标Project首页，复制Project地址。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_df939bb50936915545eb8044f91f5dd9.png =460x) 5. 执行以下命令，克隆Project。 ```Plain Text git clone <远程仓库地址> <本地目录> ``` :::tip 若您未配置免密认证，请根据指引填写GitLab用户名及密码。 ::: 回显如下，表示克隆成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_283d72f0d7bd564099ac403e17b70d7c.png =627x) 6. 执行如下命令，进入项目目录。 ```Plain Text cd <项目目录> ``` 7. 执行如下命令，查看当前所处的项目分支。 ```Plain Text git branch ``` 回显如时，表示处于主分支`main`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_720c0b7110f4a62cbbaad60b8b9ab4d3.png =597x) ### 修改项目内容 1. 执行如下命令，进入项目目录。 ```Plain Text cd <项目目录> ``` 2. 执行如下命令，新建并切换至分支`test`，修改项目内容。 ```Plain Text git checkout -b test ``` 3. 执行如下命令，新建测试文件并写入内容。 ```Plain Text echo "test" > test.sh ``` ### 推送本地分支至远程仓库 1. 执行如下命令，进入项目目录。 ```Plain Text cd <项目目录> ``` 2. 执行如下命令，切换至分支`test`。 ```Plain Text git checkout test ``` 3. 执行如下命令，将修改添加到暂存区。 ```Plain Text git add test.sh ``` 4. 执行如下命令，将暂存区的修改提交至本地仓库。 ```Plain Text git commit -m "<备注>" ``` 回显如下，表示提交成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_547b5cfc4e8acd9859b65d4abb654724.png =578x) 6. 执行如下命令，推送本地分支至远程仓库。 ```Plain Text git push -u origin test ``` 回显如下，表示推送成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0bcdf0aa8c43ac0ffb661844f762f1c0.png =635x) 7. 推送成功后，拥有该项目权限的其他用户也可以在GitLab查看该分支内容。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2a59d86850b36fed667a0066bfefe0ed.png =632x) ### 合并更改并推送至远程仓库 1. 执行如下命令，进入项目目录。 ```Plain Text cd <项目目录> ``` 2. 执行如下命令，切换至主分支`main`。 ```Plain Text git checkout main ``` 3. 执行如下命令，拉取远程仓库主分支，确保本地主分支内容与其保持一致。 ```Plain Text git pull origin main ``` 4. 执行如下命令，将新建的分支`test`变更内容合并至主分支。 ```Plain Text git merge test ``` 回显如下，表示合并成功且无冲突。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6502e45bf8ae6c55ab4c6d298355fbe3.png =555x) 5. 执行如下命令，将本地分支推送至远程仓库。 ```Plain Text git push ``` 回显如下，表示推送成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_94361ef37696f4d0b1992926eb939a10.png =549x) 6. 推送成功后，本地主分支的变更就同步到了远程仓库的主分支中。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba5f540239c3e7bc7b528da97b618abd.png =612x)