以下是整理好的Markdown格式文档,详细描述了从下载镜像、启动镜像、修改external_url以及设置或重置root密码的步骤。
GitLab 安装与配置指南
本文档将指导您完成GitLab的安装和基本配置过程,包括下载镜像、启动容器、修改外部访问URL(external_url
)及设置或重置管理员(root)密码。
一、下载GitLab镜像
首先需要确保您的系统中已经安装了Docker。然后执行以下命令来下载GitLab官方镜像:
docker pull gitlab/gitlab-ce:latest
**
二、启动GitLab容器
**
使用如下命令启动GitLab容器,并根据实际需求调整参数(如端口映射等):
docker run --detach \
--hostname 192.168.0.3 \
--publish 443:443 --publish 80:80 --publish 2222:22 \ # 注意这里SSH端口被映射到了2222,避免与主机上默认SSH服务冲突
--name gitlab \
--restart always \
--volume /srv/gitlab/config:/etc/gitlab \
--volume /srv/gitlab/logs:/var/log/gitlab \
--volume /srv/gitlab/data:/var/opt/gitlab \
gitlab/gitlab-ce:latest
处理端口冲突
如果遇到端口已被占用的情况,请修改对应的端口号(例如将–publish 22:22改为–publish 2222:22),以避免冲突。
三、修改external_url
首次启动后,可能需要根据实际情况修改GitLab实例的访问地址。编辑/etc/gitlab/gitlab.rb文件中的external_url字段:
docker exec -it gitlab vi /etc/gitlab/gitlab.rb
找到并修改如下行:
external_url 'http://192.168.0.3'
保存退出后,重新配置GitLab使更改生效:
docker exec -it gitlab gitlab-ctl reconfigure
四、设置或重置管理员(root)密码
设置初始密码
首次访问GitLab时,系统会提示你为root用户设置一个新密码。请按照页面指示操作完成设置。
重置忘记的密码
若已设置过但忘记了密码,可以通过以下命令进入GitLab Rails控制台重置密码:
docker exec -it gitlab gitlab-rails console
在控制台中执行:
user = User.find_by(username: 'root')
user.password = 'new_password' # 替换为您想要的新密码
user.password_confirmation = 'new_password'
user.save!
完成后输入exit退出控制台。
通过以上步骤,您可以成功部署GitLab实例,并根据自己的需求进行相应的配置。