WSL2-Ubuntu上安装搭建gitlab服务，并在本机运行

1. 开启WSL2

关于Windows如何开启wsl2，微软官网有详细介绍，这里不多赘述：Windows开启wsl2。

安装WSL之后，在Windows的软件商店中下载Ubuntu，可以是最新版。这里用UBUNTU_VERSION这个关键字来指代你的Ubuntu版本。

2. 安装gitlab-ce

安装这一步其实很简单。

1. Ubuntu换源
   清华镜像站-换源链接
   如何换源，网站上有。
   注意：这里要选择你的UBUNTU_VERSION来进行合适替换。
2. 添加gitlab镜像源
   如果只是换源之后，使用sudo apt install gitlab-ce是无法找到gitlab的安装包的，此时需要添加gitlab-ce的镜像源。
   如何添加？参考 清华镜像站-gitlab-ce安装流程
3. 更新

   sudo apt update
   sudo apt upgrade
   

4. 安装

   # 1. 安装postfix
   sudo apt install postfix
   # 2. 安装gitlab-ce
   sudo apt install gitlab-ce
   

3. 坑

3.1 与systemctl相关的错误。

可能会提示系统不是从init等启动之类的错误

此时需要安装systemctl

	sudo apt install systemctl

3.2 在reconfigure的时候卡住

reconfigure 卡在 ruby_block[wait for redis service socket] action run这一步

主要是参考这个：sudo gitlabctl reconfigure 卡在ruby_block

主要解决方式有以下两步：

1. 在终端中再开一个Ubuntu的终端；
2. 在新终端中运行sudo /opt/gitlab/embedded/bin/runsvdir-start
   注意：正在reconfigure的那个窗口别关

3.3 gitlab-ctl start时显示很多failed

出现如下情况：

xxx@DESKTOP-abcd:~$ sudo gitlab-ctl start
fail: alertmanager: runsv not running
fail: gitaly: runsv not running
fail: gitlab-exporter: runsv not running
fail: gitlab-kas: runsv not running
fail: gitlab-workhorse: runsv not running
fail: logrotate: runsv not running
fail: nginx: runsv not running
fail: node-exporter: runsv not running
fail: postgres-exporter: runsv not running
fail: postgresql: runsv not running
fail: prometheus: runsv not running
fail: puma: runsv not running
fail: redis: runsv not running
fail: redis-exporter: runsv not running
fail: sidekiq: runsv not running

解决方案如3.2。

4. 配置

4.1 登录网站

由于只是本机使用，运行以下命令打开gitlab-ce的配置文件：

sudo gedit /etc/gitlab/gitlab.rb

打开配置文件后找到external_url 'http://gitlab.example.com'，改成external_url 'http://127.0.0.1'，表示通过本地环回运行。

4.2 修改初始的root密码

gitlab刚安装好，root密码通过以下方式修改：

1. 运行以下命令，进入gitlab管理后台：

   sudo gitlab-ctl reconfigure
   sudo gitlab-ctl start				# 如果出现很多失败的提示，解决方法参考3.2小节
   sudo gitlab-rails console
   

   会出现类似以下的内容：

   xxx@DESKTOP-abcd:~$ sudo gitlab-rails console
   --------------------------------------------------------------------------------
   Ruby:         ruby 2.7.7p221 (2022-11-24 revision 168ec2b1e5) [x86_64-linux]
   GitLab:       15.8.2 (1ed809983af) FOSS
   GitLab Shell: 14.15.0
   PostgreSQL:   13.8
   ------------------------------------------------------------[ booted in 18.89s ]
   Loading production environment (Rails 6.1.6.1)
   irb(main):001:0>
   

2. 在这个终端中以此输入以下命令：

   # step1：查找root用户
   u=User.find_by(username='root')
   # 注意：在新版的gitlab（gitlab 16.6， PostgreSql为13.11版本）中，上面命令无法使用，可使用如下语法：
   # u=User.find_by(id=1)
   # Step2:设置自己的密码，gitlab有密码限制规则
   u.password='asdfqwer'
   # step3：确认密码
   u.password_confirmation='asdfqwer'
   # step4：保存设置
   u.save!			# 这一步如果没有输出true，则说明设置失败
   

   一个成功的示例如下：
   

4.3 登录Gitlab本机服务

在浏览器中输入以下地址：http://127.0.0.1，先以root用户登录，能够见到以下界面：