GitLab 是一个基于 Ruby on Rails 和 PostgreSQL 的 Git 仓库管理工具,适合企业或开发团队使用。在Debian上安装和配置 GitLab 可以通过以下步骤完成,以下是详细的安装和配置步骤。
一、安装 GitLab
1. 安装依赖
首先,确保你的 Debian 系统是最新的,并安装 GitLab 所需的依赖。
更新系统:
sudo apt update
sudo apt upgrade -y
安装必要的软件包:
sudo apt install -y curl openssh-server ca-certificates perl
2. 下载并安装 GitLab
GitLab 提供了一个官方的安装包,你可以通过它来安装 GitLab。
添加 GitLab 官方源:
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
安装 GitLab:
sudo apt install gitlab-ee
如果你只需要 GitLab 社区版,可以改为安装 gitlab-ce:
sudo apt install gitlab-ce
3. 配置并启动 GitLab
安装完成后,运行以下命令来配置和启动 GitLab:
配置 GitLab:
sudo gitlab-ctl reconfigure
启动 GitLab 服务:
sudo gitlab-ctl start
检查 GitLab 服务状态:
sudo gitlab-ctl status
二、配置 GitLab
1. 配置外部 URL
GitLab 安装完成后,你需要配置 GitLab 的外部 URL 地址。默认情况下,GitLab 会使用本地主机地址(localhost),但你可以根据需要修改为自己的域名或公网 IP 地址。
编辑 GitLab 配置文件:
sudo nano /etc/gitlab/gitlab.rb
查找并修改 external_url 配置项,将其设置为你的 GitLab 实例的 URL,例如:
external_url 'http://gitlab.example.com'
重新配置 GitLab:
sudo gitlab-ctl reconfigure
2. 配置防火墙
如果你的服务器启用了防火墙(如 UFW),确保允许 HTTP/HTTPS 流量通过 80 和 443 端口。
开启 80 和 443 端口:
sudo ufw allow 80.443/tcp
启用 UFW(如果尚未启用):
sudo ufw enable
查看防火墙状态:
sudo ufw status
三、访问 GitLab Web 界面
1. 打开浏览器,访问你在 external_url 配置中设置的地址(例如 http://gitlab.example.com)。
2. 在首次访问时,你会看到 GitLab 的初始设置页面,要求你设置管理员密码。
3. 设置管理员密码后,使用 root 用户和新设置的密码登录 GitLab Web 界面。
四、配置 GitLab 用户和项目
1. 创建新用户
登录到 GitLab 后,在 Web 界面右上角点击你的头像,选择 Settings。
在左侧导航栏选择 Users,点击 New user 创建新的 GitLab 用户。
2. 创建新项目
登录后,在左侧菜单栏选择 Projects > Create new project。
填写项目名称、描述等信息,选择项目的可见性(私有或公开)。
点击 Create project 完成创建。
如果你遇到任何安装问题或有其他问题,可以查看 /var/log/gitlab 目录中的日志文件,或者提供更多错误信息寻求专业技术人员帮助排查。