GitLab 安装指南

目录一、概述二、 安装方式三、系统要求四、 具体安装步骤1. Ubuntu 系统安装原生包方式1.1 安装依赖包1.2 添加 GitLab 官方仓库1.3 安装 GitLab1.4 配置防火墙如启用2. Docker 安装方式2.1 创建 docker-compose.yml 文件2.2 启动 GitLab 容器2.3 等待启动完成3. Mac 系统安装M1 芯片支持3.1 创建 docker-compose.yml3.2 进入容器修改配置五、安装后初始设置1. 访问 GitLab 并获取初始密码原生安装获取密码Docker 安装获取密码2. 基本配置修改2.1 修改管理员密码2.2 配置 SMTP 邮件服务器可选但推荐六、 GitLab 基本使用1. 管理区域设置2. 项目管理2.1 创建项目2.2 项目基本操作3. 用户和权限管理4. CI/CD 流水线配置4.1 在项目中创建 .gitlab-ci.yml 文件4.2 配置 GitLab Runner七、常用管理命令1. GitLab 服务管理2.备份和恢复八、 常见问题解决1. 502 错误2. 服务无法启动3. 邮件无法发送4. HTTPS 配置一、概述GitLab 是一个功能强大的开源 DevOps 平台集代码托管、CI/CD、项目管理和团队协作于一体。本文将为你梳理如何在主流操作系统上安装 GitLab以及安装后的基本使用和常见问题处理。二、 安装方式GitLab 主要有三种安装方式你可以根据自己的需求和环境选择合适的方法安装方式适用平台优点缺点原生包安装Ubuntu, CentOS, Debian 等 Linux 系统官方推荐性能最佳功能完整对系统资源要求较高Docker 安装所有支持 Docker 的平台Windows, Mac, Linux环境隔离快速部署易于维护配置稍复杂性能略有损耗Windows 安装Windows 系统适合 Windows 环境开发者官方不支持直接安装需通过 Docker 或虚拟机三、系统要求在开始安装前请确保你的系统满足以下最低要求内存至少 4GB推荐 8GB 或更多CPU至少 2 核心推荐 4 核或更多磁盘空间至少 10GB推荐 20GB 或更多网络固定的 IP 地址或域名开放 80 和 443 端口四、 具体安装步骤1. Ubuntu 系统安装原生包方式以下是官方推荐的 Omnibus 包安装方法1.1 安装依赖包sudoaptupdatesudoaptupgrade-ysudoaptinstall-ycurlopenssh-server ca-certificates postfix tzdata perl在 Postfix 安装过程中选择 “Internet Site” 并输入服务器主机名。1.2 添加 GitLab 官方仓库curl-sShttps://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh|sudobash1.3 安装 GitLabsudoEXTERNAL_URLhttp://你的域名或IPaptinstallgitlab-ce将EXTERNAL_URL替换为你实际的域名或 IP 地址。1.4 配置防火墙如启用sudoufw allow httpsudoufw allow httpssudoufw allow OpenSSH2. Docker 安装方式如果你更喜欢使用 Docker以下是安装步骤2.1 创建docker-compose.yml文件version:3.8services:gitlab:image:gitlab/gitlab-ce:latestcontainer_name:gitlab-dockerhostname:gitlab.example.comrestart:alwaysenvironment:GITLAB_OMNIBUS_CONFIG:|external_url http://192.168.11.111:8807 letsencrypt[enable] falsevolumes:-./config:/etc/gitlab-./logs:/var/log/gitlab-./data:/var/opt/gitlabports:-8807:8807-8808:22记得将external_url中的 IP 和端口改为你自己的。2.2 启动 GitLab 容器docker-composeup-d2.3 等待启动完成容器启动后需要几分钟时间 GitLab 才能完全就绪。3. Mac 系统安装M1 芯片支持对于 Mac 用户特别是 M1 芯片可以使用专门的 ARM 镜像3.1 创建docker-compose.ymlversion:3.8services:gitlab-ce:image:yrzr/gitlab-ce-arm64v8:latestcontainer_name:gitlab-ceprivileged:truerestart:alwaysports:-9922:22-9980:9980volumes:-/your/path/gitlab/etc:/etc/gitlab:z-/your/path/gitlab/log:/var/log/gitlab:z-/your/path/gitlab/opt:/var/opt/gitlab:zdeploy:resources:limits:memory:4096M3.2 进入容器修改配置dockerexec-itgitlab-ce /bin/bashvi/etc/gitlab/gitlab.rb添加以下配置external_urlhttp://127.0.0.1:9980gitlab_rails[gitlab_ssh_host]127.0.0.1gitlab_rails[gitlab_shell_ssh_port]9922五、安装后初始设置1. 访问 GitLab 并获取初始密码打开浏览器访问你配置的EXTERNAL_URL使用以下凭据登录用户名root密码从以下文件获取原生安装获取密码sudocat/etc/gitlab/initial_root_passwordDocker 安装获取密码dockerexec-itgitlab-dockergrepPassword:/etc/gitlab/initial_root_password⚠️ 注意此密码文件会在 24 小时后自动删除请及时修改密码。2. 基本配置修改登录后建议立即进行以下配置2.1 修改管理员密码点击右上角头像 →Settings→ 左侧菜单 “Password”2.2 配置 SMTP 邮件服务器可选但推荐编辑/etc/gitlab/gitlab.rbgitlab_rails[smtp_enable]truegitlab_rails[smtp_address]smtp.your-email.comgitlab_rails[smtp_port]587gitlab_rails[smtp_user_name]your-usernamegitlab_rails[smtp_password]your-passwordgitlab_rails[smtp_domain]your-domain.comgitlab_rails[smtp_authentication]logingitlab_rails[smtp_enable_starttls_auto]truegitlab_rails[gitlab_email_from]gitlabyour-domain.com然后重新配置sudogitlab-ctl reconfigure六、 GitLab 基本使用1. 管理区域设置以管理员身份登录后你可以通过点击顶部导航栏的 “Admin Area”扳手图标进入管理区域进行以下重要设置关闭 Gravatar国内访问不了Settings → Preferences → Gravatar关闭公开注册内部使用Settings → General → Sign-up restrictions配置外部认证如 LDAP、OAuth 等2. 项目管理2.1 创建项目点击导航栏 “” 号 → “New project”选择创建空白项目、从模板创建或导入项目2.2 项目基本操作文件管理在项目内创建、上传文件分支管理查看和管理代码分支合并请求创建和审查代码合并议题跟踪管理任务和 bug 报告3. 用户和权限管理创建用户Admin Area → Users → New user分配权限将用户添加到项目并设置相应角色GuestReporterDeveloperMaintainerOwner4. CI/CD 流水线配置GitLab 内置了强大的 CI/CD 功能4.1 在项目中创建.gitlab-ci.yml文件stages:-build-test-deploybuild_job:stage:buildscript:-echo Building the project...-go build-o myappartifacts:paths:-myapptest_job:stage:testscript:-echo Running tests...deploy_job:stage:deployscript:-echo Deploying application...only:-main4.2 配置 GitLab Runner进入项目 →Settings → CI/CD → Runners按照说明安装和注册 Runner七、常用管理命令1. GitLab 服务管理# 启动所有服务sudogitlab-ctl start# 停止所有服务sudogitlab-ctl stop# 重启所有服务sudogitlab-ctl restart# 查看服务状态sudogitlab-ctl status# 重新配置 GitLab修改配置后必须执行sudogitlab-ctl reconfigure2.备份和恢复# 创建备份sudogitlab-rake gitlab:backup:create# 恢复备份sudogitlab-rake gitlab:backup:restoreBACKUP备份文件名八、 常见问题解决1. 502 错误原因通常是内存不足导致解决方案建议增加系统内存至 4GB 以上检查端口冲突确保 80 和 443 端口未被占用2. 服务无法启动原因系统资源不足或配置错误解决方案检查系统资源是否充足查看日志文件sudo gitlab-ctl tail3. 邮件无法发送原因SMTP 配置错误或防火墙限制解决方案确认 SMTP 配置正确检查防火墙设置4. HTTPS 配置如需启用 HTTPS可配置自签名证书Let’s Encrypt 证书GitLab 功能丰富安装和配置过程可能会遇到各种问题但遵循以上步骤应该能帮助你顺利完成安装