一、GitLab介绍
1.1 GitLab简介
- GitLab 是一款基于 Git 的开源代码托管平台,集成了版本控制、代码审查、问题跟踪、持续集成与持续交付(CI/CD)等多种功能,旨在为团队提供一站式的项目管理解决方案。
- 借助 GitLab,开发团队可以高效协作,轻松管理代码版本,并通过内置的 DevOps 工具加速开发、测试和部署过程。
- GitLab 的独特优势在于其完整的容器化部署方案,官方支持与 Kubernetes 等容器编排平台的无缝集成,使平台更加易于管理、扩展,并支持现代化云原生架构。
1.2 GitLab特点
- 全面的功能支持:
- GitLab 不仅是一个代码仓库管理工具,还提供自动化构建、测试、部署等强大的 DevOps 功能,是现代化软件开发和团队协作的理想选择。
- Web 管理界面:
- 基于 Web 的操作界面,方便用户在浏览器中进行仓库管理、代码审查和 CI/CD 配置。
主要功能特点:
- 代码仓库管理:
- 支持分支管理、合并请求(Merge Requests)和代码审查等功能,为团队提供高效的协作环境。
- 代码托管:
- 无论是私有服务器还是公共云平台,GitLab 都支持全面的代码托管方案,满足不同规模团队的需求。
- 内置 CI/CD 工具:
- GitLab 提供持续集成和持续交付工具,支持自动化构建、测试和部署,并包含强大的可视化管道编辑器和测试报告功能。
- 安全管理:
- 支持多级用户权限、角色管理、双因素身份验证(2FA)、代码扫描和漏洞检测等功能,全面保障代码安全。
- DevOps 平台:
- GitLab 提供完整的 DevOps 生命周期管理,包括计划、创建、验证、发布、配置和监控,助力团队高效协作,加速软件交付。
二、本次实践介绍
2.1 本地环境规划
本次实践为个人测试环境,操作系统版本为centos7.9。
hostname | IP地址 | 操作系统版本 | Docker版本 |
---|---|---|---|
docker | 192.168.1.50 | centos 7.9 | 26.1.4 |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境,生产环境请谨慎使用;
2.在Docker环境下成功部署GitLab服务器。
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行,确保Docker正常运行。
[root@localhost /]# systemctl status docker
● docker.service - Docker Application Container EngineLoaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)Active: active (running) since 六 2024-12-21 23:07:14 CST; 3h 29min agoDocs: https://docs.docker.comMain PID: 34141 (dockerd)Tasks: 67Memory: 151.2MCGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
[root@localhost /]# docker version
Client: Docker Engine - CommunityVersion: 26.1.4API version: 1.45Go version: go1.21.11Git commit: 5650f9bBuilt: Wed Jun 5 11:32:04 2024OS/Arch: linux/amd64Context: defaultServer: Docker Engine - CommunityEngine:Version: 26.1.4API version: 1.45 (minimum version 1.24)Go version: go1.21.11Git commit: de5c9cfBuilt: Wed Jun 5 11:31:02 2024OS/Arch: linux/amd64Experimental: falsecontainerd:Version: 1.6.33GitCommit: d2d58213f83a351ca8f528a95fbd145f5654e957runc:Version: 1.1.12GitCommit: v1.1.12-0-g51d5e94docker-init:Version: 0.19.0GitCommit: de40ad0
docker_compose__105">3.3 检查docker compose 版本
检查Docker compose版本,确保2.0以上版本。
[root@localhost /]# docker compose version
Docker Compose version v2.27.1
三、Docker Compse版本升级(可选)
1. 从 GitHub 下载 Docker Compose
- 打开 GitHub Docker Compose 官方发布页面:
- 地址:https://github.com/docker/compose/releases
- 找到需要的版本,下载适合你的系统架构的二进制文件(如 Linux 的
docker-compose-linux-x86_64
)。
提示: 如果最新版没有提供二进制文件,可以选择较低版本,直到找到对应的文件。
2. 上传到 Linux
-
将下载的文件通过工具(如
scp
或WinSCP
)上传到/usr/local/bin
目录:scp docker-compose-linux-x86_64 root@<your-server-ip>:/usr/local/bin/
-
上传后,将文件重命名为
docker-compose
:mv /usr/local/bin/docker-compose-linux-x86_64 /usr/local/bin/docker-compose
3. 添加执行权限
为二进制文件添加可执行权限:
chmod +x /usr/local/bin/docker-compose
4. 验证安装
-
查看 Docker Compose 版本,验证是否安装成功:
docker-compose version
-
如果提示权限错误(如
Permission denied
),需要重新添加可执行权限:chmod +x /usr/local/bin/docker-compose
四、下载GitLab镜像
从docker hub下载GitLab镜像
[root@docker gitlab]# docker pull gitlab/gitlab-ce:latest
latest: Pulling from gitlab/gitlab-ce
7b1a6ab2e44d: Already exists
6c37b8f20a77: Pull complete
f50912690f18: Pull complete
bb6bfd78fa06: Pull complete
2c03ae575fcd: Pull complete
839c111a7d43: Pull complete
4989fee924bc: Pull complete
666a7fb30a46: Pull complete
Digest: sha256:5a0b03f09ab2f2634ecc6bfeb41521d19329cf4c9bbf330227117c048e7b5163
Status: Downloaded newer image for gitlab/gitlab-ce:latest
docker.io/gitlab/gitlab-ce:latest
五、部署GitLab服务器
5.1 创建目录
-
创建 GitLab 数据目录
为了确保容器内的 GitLab 数据持久化,需要在宿主机上创建专用目录。执行以下命令:mkdir -p /data/gitlab/{data,logs,config} && cd /data/gitlab/
dockercomposeyml__209">5.2 编辑 docker-compose.yml
文件
-
创建或编辑 Docker Compose 配置文件: 使用文本编辑器创建并编辑
docker-compose.yml
文件:vim /data/gitlab/docker-compose.yml
-
完整的
docker-compose.yml
示例:version: "3" services:gitlab:container_name: gitlab # 容器名称image: gitlab/gitlab-ce:latest # 使用 GitLab 社区版最新镜像hostname: '192.168.0.50' # 配置主机名(本地或虚拟机 IP)restart: always # 容器意外停止时自动重启ports:- 8088:80 # 映射 HTTP 端口- 8443:443 # 映射 HTTPS 端口- 2222:22/tcp # 映射 SSH 端口volumes:- /etc/localtime:/etc/localtime # 同步宿主机时间- /data/gitlab/data:/var/opt/gitlab # 数据存储路径- /data/gitlab/config:/etc/gitlab # 配置文件路径- /data/gitlab/logs:/var/log/gitlab # 日志文件路径environment:GITLAB_OMNIBUS_CONFIG: |external_url 'http://192.168.0.50:80' # 外部访问 URLgitlab_rails['gitlab_shell_ssh_port'] = 2222 # 配置 SSH 端口deploy:resources:limits: # 设置资源限制memory: 4G # 最大内存使用reservations: # 保留资源memory: 1G # 最低内存保留
注意事项:
external_url
中指定的端口号不仅是访问路径的一部分,它还会影响 GitLab 应用本身的监听端口。例如,如果设置为http://192.168.0.50:8088
,GitLab 会在 8088 端口上监听并提供服务(是对于gitlab内部而言的),而不是默认的 80(HTTP)端口, 我们的访问路径是ip+映射后的端口号,不是external_url里面提供的。
5.3 部署 GitLab
-
启动容器: 使用 Docker Compose 命令启动 GitLab 容器:
docker compose up -d
up
:启动容器。-d
:以守护进程模式运行容器(后台运行)。
-
运行结果:
gitlab_285">六、访问gitlab仓库
6.1 进入 GitLab 登录页
-
访问 GitLab Web 界面
在浏览器中输入以下地址访问 GitLab 登录页:http://192.168.0.50:80
-
注意:将
192.168.0.50
替换为您部署 GitLab 的服务器 IP 地址。 -
如果配置了 HTTPS,则访问地址为:
https://192.168.0.50:8443
-
6.2 获取初始密码
在 GitLab 容器的首次启动过程中,会生成默认的超级管理员账号 root
和随机密码。初始密码可以通过以下命令查看:
-
查看初始密码文件
在容器中查看初始密码:docker exec -it gitlab cat /etc/gitlab/initial_root_password
输出示例:
Password: KfK95J1yFzESkYkNjEkj
说明:
- 密码文件位于
/etc/gitlab/initial_root_password
。 - 该密码仅在首次启动时有效。
- 密码文件位于
-
删除初始密码文件(可选)
为了安全起见,可以在记下初始密码后删除该文件:docker exec -it gitlab rm /etc/gitlab/initial_root_password
6.3 重置登录密码(如有需要)
如果遗忘了超级管理员密码,可以通过以下步骤进行重置:
-
进入 GitLab 容器内部
使用 Docker 命令进入容器:docker exec -it gitlab /bin/bash
输出示例:
[root@docker gitlab]# docker exec -it gitlab /bin/bash root@192:/#
-
进入 Rails 控制台
启动 GitLab 的 Rails 控制台:gitlab-rails console -e production
-e production
:以生产环境模式启动控制台。
-
查询超级管理员用户
查询超级管理员用户信息(默认用户 ID 为1
):user = User.where(id: 1).first
示例图片:
-
修改密码
设置新的密码(以admin36987
为例):user.password = 'admin36987'
-
保存修改并退出
保存新密码并退出控制台:user.save! # 保存更改 exit # 退出控制台
示例图片:
6.4 访问 GitLab 首页
-
使用初始密码或修改后的账号密码登录 GitLab:
- 用户名:
root
- 密码:初始密码或修改后的密码(如
admin36987
)。
修改密码:
- 用户名:
-
首次登录时提示设置新密码
如果使用初始密码登录,GitLab 会提示您设置新密码。
6.5 设置中文语言
-
进入 Preferences 页面
登录后,点击右上角头像,进入Preferences
页面:Profile > Preferences
-
修改语言设置
在Preferences
页面找到Localization
区域,将Language
选项修改为简体中文
。示例图片:
-
修改前:
-
修改后:
-
-
保存设置
点击保存按钮,刷新界面后语言会立即切换为简体中文。