当前位置： 首页 > news >正文

部署Gitlab-CE with Docker私有云环境

news 来源：原创 2025/5/25 7:34:22

应用环境
Ubuntu 20.04.6 LTS (GNU/Linux 5.15.0-139-generic x86_64)
Docker version 28.1.1, build 4eba377

文章目录

    • 拉取容器镜像
    • 生成Run脚本
      • 参数解读
      • 实例脚本
      • 环境配置
      • 管理员密码遗忘
      • 服务邮箱配置
        • 邮件测试
    • 运维问题集锦
      • (1) 端口映射关系
      • (2) 服务日志
      • (3) 分支受保护
    • 项目操作
      • (1) 建立群组
      • (2) 创建项目
      • (3) 项目的版本控制

拉取容器镜像

sudo apt-get update## gitlab-ce:17.9.6-ce.0
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitlab/gitlab-ce:17.9.6-ce.0## gitlab-ce:17.10.4-ce.0
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitlab/gitlab-ce:17.10.4-ce.0
## 添加标签名Tag
docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitlab/gitlab-ce:17.10.4-ce.0 docker.io/gitlab/gitlab-ce:17.10.4-ce.0
## 移除标签名Tag
docker rmi swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitlab/gitlab-ce:17.10.4-ce.0

国内镜像参考：
渡渡鸟镜像
清华大学开源软件镜像

生成Run脚本

可参考：渡渡鸟-Run助手

参数解读

# 将镜像进实例化成容器并运行
docker run# 【i】保持STDIN（标准输入）开放，即使没有附加任何东西。这通常用于让容器的进程保持运行，即使没有附加到终端。例如，你可以在容器内部运行一个交互式shell
# 【t】分配一个伪终端（pseudo-TTY），这对于交互式shell非常重要，比如当你想要在容器中运行bash或sh时。
# 【d】后台运行，即所谓的“detached”模式。容器会在后台启动，并且你会得到容器的ID或名称
-itd# 容器命名
--name gitlab-ce# 重启策略
## no:不自动重启，缺省时默认
## always:始终重启
## unless-stopped:Docker 服务重启后自动启动容器，除非容器被手动停止。可指定最大重试次数，例如 --restart=on-failure:3（最多重启3次）。
## on-failure:仅在容器非正常退出（退出状态码非0）时重启。
--restart=always \# 【p】映射策略，<宿主端口>:<容器端口>
## 比如gitlab，22为ssh协议；80为http协议；443为https协议
-p 1022:22 \
-p 81:80 \
-p 10443:443 \# 使用本地时区
-e TimeZone='Asia/Shanghai' \
-e TZ='Asia/Shanghai' \
-v /etc/localtime:/etc/localtime \# Host域名映射
--add-host=gitlab.oh.com:172.10.3.200 \# 挂载卷映射(宿主:容器)
## /etc/gitlab:配置文件
## /var/log/gitlab:日志数据
## /var/opt/gitlab:应用数据
-v /gitlab-ce/config:/etc/gitlab  \
-v /gitlab-ce/logs:/var/log/gitlab \
-v /gitlab-ce/data:/var/opt/gitlab \# 让容器获取宿主机root权限
--privileged=true \# 最后一行所引用的docker镜像源

实例脚本

建议http服务，不要使用默认的80端口。很容易与其它docker容器服务或宿主机其它服务冲突，比如宿主机安装的nginx、apache服务。

docker run -itd \
--name gitlab-ce \
--restart=always \
-p 1022:22 \
-p 81:80 \
-p 10443:443 \
-e TimeZone='Asia/Shanghai' \
-e TZ='Asia/Shanghai' \
-v /etc/localtime:/etc/localtime \
-v /gitlab-ce/config:/etc/gitlab  \
-v /gitlab-ce/logs:/var/log/gitlab \
-v /gitlab-ce/data:/var/opt/gitlab \
--privileged=true \
docker.io/gitlab/gitlab-ce:17.10.4-ce.0

环境配置

# 打开配置文件
sudo vim /gitlab-ce/config/gitlab.rb

编辑内容如下

## GitLab URL
external_url 'http://192.168.1.50'## GitLab SSH
gitlab_rails['gitlab_ssh_host'] = '192.168.1.50'
gitlab_rails['time_zone'] = 'Asia/Shanghai'### GitLab Shell settings for GitLab
gitlab_rails['gitlab_shell_ssh_port'] = 1022
# gitlab_rails['gitlab_shell_git_timeout'] = 800

输入:wq保存退出后，进入Gitlab bash控制台

sudo docker exec -it gitlab-ce bash
# 更新配置
gitlab-ctl reconfigure#修改gitlab.yml
vi /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml

内容如下
在这里插入图片描述

提示
如果不在Gitlab bash控制台中打开，则在宿主机/gitlab-ce/data/gitlab-rails/etc/gitlab.yml

打开编辑
sudo vim /gitlab-ce/data/gitlab-rails/etc/gitlab.yml

重启服务
sudo docker restart gitlab-ce

输入:wq!保存退出后，重启容器

gitlab-ctl restart

执行结果如下
在这里插入图片描述

当成功执行后，会生成容器ID（docker后端会直接开始运行该容器)。通过portainer-ce WEB端查看，就能看到当前运行状态
在这里插入图片描述
当运行状态呈现绿色时，就可以直接访问容器Web端了。在访问前，需要先查看Gitlab实例化时随机生成的root密码（注意密码仅24小时内有效）

# 先退出Gitlab控制台
exit
# 查看root初始化密码
sudo cat initial_root_password

内容如下
在这里插入图片描述
登录到Web端后，先修改显示语言：

  • 左侧导航栏右上角头像，进入【Preferences】偏好设置。
  • 拉到最下面【Localization】本地化，将【Language】语言，设置为【Chinese, Simplified】中文。
  • 再拉到底，直接【Save changes】保存。

保存成功后，直接刷新页面或直接按F5即可。之后再进入左侧导航栏【密码】，修改root密码即可。

提示
如果宿主机是虚拟机环境（比如Ubuntu Sublinux with WSL），那仍需将GitLab私有服做物理网络穿透。否则宿主机所在局域中其它计算机仍无法访问该Gitlab服务。

管理员密码遗忘

直接进入Gitlab bash控制台

sudo docker exec -it gitlab-ce bash--连接gitlab数据库(#号前缀是控制台提示符状态)
gitlab-rails console -e production## 执行结果
--------------------------------------------------------------------------------Ruby:         ruby 3.2.5 (2024-07-26 revision 31d0f1a2e7) [x86_64-linux]GitLab:       17.6.1 (8a31863db02) FOSSPostgreSQL:   14.11
------------------------------------------------------------[ booted in 32.61s ]
Loading production environment (Rails 7.0.8.4)
irb(main):001:0>--修改root密码
# 查找并指向到root账号
irb(main):005:0> user = User.find_by(username: 'root')
=> #<User id:1 @root>
# 修改root密码(注意第2遍为确认密码)，user.save即为保存
irb(main):006:0> user.password = 'S87fdj@&yhkk'
irb(main):007:0> user.password_confirmation = 'S87fdj@&yhkk'
irb(main):008:0> user.save!
=> true
irb(main):009:0> exit# 退出Gitlab bash控制台
root@2a11f26e011d:/# exit

服务邮箱配置

# 打开配置文件
sudo vim /gitlab-ce/config/gitlab.rb

追加内容如下

### GitLab email server settings
###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
###! **Use smtp instead of sendmail/postfix.**
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "admin@smtp.com"
gitlab_rails['smtp_password'] = "S87fdj@&yhkk"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = false
gitlab_rails['smtp_tls'] = true
# gitlab_rails['smtp_pool'] = false###! **Can be: 'none', 'peer', 'client_once', 'fail_if_no_peer_cert'**
###! Docs: http://api.rubyonrails.org/classes/ActionMailer/Base.html
gitlab_rails['smtp_openssl_verify_mode'] = 'none'# gitlab_rails['smtp_ca_path'] = "/etc/ssl/certs"
# gitlab_rails['smtp_ca_file'] = "/etc/ssl/certs/ca-certificates.crt"### Email Settings
gitlab_rails['gitlab_email_enabled'] = true##! If your SMTP server does not like the default 'From: gitlab@gitlab.example.com'
##! can change the 'From' with this setting.
gitlab_rails['gitlab_email_from'] = 'master@gitlab.com'
gitlab_rails['gitlab_email_display_name'] = 'GitLab CE'
gitlab_rails['gitlab_email_reply_to'] = 'master@gitlab.com'
# gitlab_rails['gitlab_email_subject_suffix'] = ''
# gitlab_rails['gitlab_email_smime_enabled'] = false
# gitlab_rails['gitlab_email_smime_key_file'] = '/etc/gitlab/ssl/gitlab_smime.key'
# gitlab_rails['gitlab_email_smime_cert_file'] = '/etc/gitlab/ssl/gitlab_smime.crt'
# gitlab_rails['gitlab_email_smime_ca_certs_file'] = '/etc/gitlab/ssl/gitlab_smime_cas.crt'
邮件测试

输入:wq保存退出后，进入Gitlab bash控制台

sudo docker exec -it gitlab-ce bash
# 更新配置
gitlab-ctl reconfigure# 重启gitlab-ctl服务
gitlab-ctl restart# 邮件测试
gitlab-rails console -e production
Notify.test_email('admin@smtp.com', 'Subject', 'Body').deliver_now

邮箱有收到邮件，就表示配置成功！

运维问题集锦

(1) 端口映射关系

# 登录gitlab控制台
sudo docker exec -it gitlab-ce bash# 查看运行进程
netstat -ltwen# 查看宿主机运行进程
sudo netstat -tunlp
sudo netstat -aptn##查看指定端口占用情况
sudo ps aux | grep 'xrdp*'
sudo netstat -tunlp | grep 端口号

在这里插入图片描述

(2) 服务日志

# 宿主机docker跟踪
## 参数:--tail 10表示实时跟踪最新的10条记录
sudo docker logs -f gitlab-ce --tail 10# 直接进入如下路径，Gitlab容器内相关子服务进程日志都在这里，比如nginx、redis、reconfigure重载配置实例化记录等等
cd /gitlab-ce/logs/# 将地址解析添加到hosts列表
echo "192.168.1.50 gitlab.local" | sudo tee -a /etc/hosts# 查看配置内容, 仅输出有效的配置项
sudo cat gitlab.rb | grep -vE '^#|^$'

(3) 分支受保护

错误信息【IntelliJ Idea or WebStorm】
remote: GitLab: You are not allowed to push code to protected branches on this project.
不允许将代码推送到此项目的受保护分支。
在这里插入图片描述
错误信息【Visual Sutdio】
Git failed with a fatal error.Unencrypted HTTP is not recommended for Gitlab. Ensure the repository remote URL is using HTTPS.
Git失败并出现致命错误。不建议对Gitlab使用未加密的HTTP。确保存储库远程URL使用HTTPS。

该错误也是因为支分保护的问题，本身极狐官方不推荐在http协议下进行远程操作代码。推荐是采用https或SSH代码操作方案。

打开项目【设置】-【仓库】-【受保护分支】一栏
在这里插入图片描述
将允许推送和合并角色调整为如图（含开发角色），或者直接取消保护也可以（选项是立即生效的）。

项目操作

(1) 建立群组

在这里插入图片描述

(2) 创建项目

在这里插入图片描述

(3) 项目的版本控制

在解决方案中，经常会存在多个项目和项目目录，经常需要处理忽略对某个项目、项目里某个文件夹、文件的版本跟踪控制。

忽略某个项目版本控制，在解决方案根下的.gitignore文件，按下图添加该目录路径即可。
在这里插入图片描述
忽略文件夹版本控制(含子目录及文件)，编辑项目根下的.gitignore文件，按下图添加该目录路径即可。
在这里插入图片描述
忽略某个文件，在上图中# Editor directories and files一切直接放入文件名就可以了。当然主文件名或扩展名是支持通配符的。

-待续-

相关文章：

  • 清除 Ubuntu 磁盘空间
  • 电脑网络如何改ip地址？ip地址改不了怎么回事
  • 安全基础与协议分析
  • MybatisPlus入门
  • 行列式中某一行的元素与另一行对应元素的代数余子式乘积之和等于零
  • 一周学会Pandas2 Python数据处理与分析-Pandas2数据合并与对比-pd.merge()：数据库风格合并
  • C++编译/链接模型
  • 老牌协议再升级，Ethernet IP转Modbus TCP网关桥接精准灌装系统
  • DELL EMC PowerStore BBU更换手册
  • PyLink 使用指南
  • BLIP3-o：一系列完全开源的统一多模态模型——架构、训练与数据集
  • NFC学习【笔记】
  • C++ 输入输出流示例代码剖析
  • 计算机组成原理——浮点数以及IEEE754
  • ruoyi-erp 开源：功能全面灵活可定制
  • SpringCloud实战：使用Sentinel构建可靠的微服务熔断机制
  • 关于读取CH584单片机的IO电平出现到的乌龙
  • Go核心特性与并发编程
  • client.chat.completions.create方法参数详解
  • 链表-链表相交
  • 专门做电路图的网站/seo关键词优化外包公司
  • 制作网站付款方式/品牌推广的渠道有哪些
  • 做网站 挣广告联盟的佣金/搜索引擎优化自然排名的优点
  • 平度市网站建设/腾讯网网站网址
  • 做网站什么内容/宁波seo推广如何收费
  • 电脑租赁平台哪个好/台州网站seo