如果openKylin 2.0 SP2主机的IPv4地址改变，如何让GitLab正常运行

作者沈传越明德融创工作室Minter Fusion Studio, MFS 出品本文介绍的所有步骤均经过测试复现。本文针对GitLab管理员使用。如果对于相关的专业词汇不太清楚。可以参考以下文章《如何在openKylin下安装并配置GitLabv0.1.1》《何谓磐石架构》《openKylin 2.0 SP桌面操作系统的mm-cli命令详解v01.0》如果公司运行GitLab的服务器因为某些原因变更了IPv4地址那么就需要重新配置GitLab本文介绍相关的操作步骤。一、术语【操作系统】计算机系统中的一种软件。是具有特定功能的程序模块的集合能有效管理软硬件资源合理组织工作流程向用户提供服务使用户方便地使用计算机使整个计算机系统能高效运行。【指令】用户通过终端Terminal直接输入用来操控操作系统的命令。【执行指令】用户在终端中输入指令然后按回车键运行指令对应的程序完成相应的功能。二、操作步骤1. CtrlAltT同时按下Ctrl、Alt、T三个键打开命令终端Terminal。2. 在命令终端中执行以下指令将openKylin 2.0 SP2桌面系统切换到维护模式Maintain Modesudo mm-cli -osudo reboot3. 在重新启动系统后按CtrlAltT同时按下Ctrl、Alt、T三个键打开命令终端。4. 在命令终端中执行以下指令ifconfig查询当前主机的IP地址。具体方法参考 《如何在Linux下查看当前主机的IP地址v0.1.0》。记录查询到的IPv4地址。5. 执行以下指令修改gitlab的配置文件gitlab.rbsudo vim /etc/gitlab/gitlab.rb该指令会打开gitlab的配置文件gitlab.rb。然后按下面步骤操作。1按Esc键输入/external_url。2使用↓键将光标向下移动到external_urlhttps://gitlab.example.com这一行。按“a”键进入新增编辑状态。将两个单引号之间的http://gitlab.example.com更换为第4步中刚刚查到的IPv4或者是GitLab服务器的IP地址如http://192.168.0.73按Esc键然后输入:wq完成存盘退出。6. 执行以下指令让配置生效sudo gitlab-ctl reconfigure这一步需要等待一段时间。当看到以下内容时配置成功。Running handlers:[2026-04-24T09:56:2908:00] INFO: Running report handlersRunning handlers complete[2026-04-24T09:56:2908:00] INFO: Report handlers completeInfra Phase complete, 6/892 resources updated in 46 secondsgitlab Reconfigured!7. 在浏览器地址栏中输入http://192.168.1.87/users/sign_in其中“192.168.1.87”是第5步在gitlab.rb文件中输入的那个IPv4地址。如果正常显示如图1所示的登录页面则说明GitLab正常运行。图1 GitLab登录页面8. 如果GitLab没有正常运行执行以下指令启动GitLabsudo gitlab-ctl start9. 执行以下指令将openKylin 2.0 SP2桌面系统切换回普通模式Normal Modesudo mm-cli -c -a$ sudo reboot三、可能遇到的问题及解决方案如果遇到以下问题Running handlers:[2026-04-23T20:35:0608:00] ERROR: Running exception handlersThere was an error running gitlab-ctl reconfigure:directory[/usr/lib/systemd/system] (package::runit_systemd line 22) had an error: Chef::Exceptions::InsufficientPermissions: Cannot create directory[/usr/lib/systemd/system] at /usr/lib/systemd/system due to insufficient permissionsRunning handlers complete[2026-04-23T20:35:0608:00] ERROR: Exception handlers completeInfra Phase failed. 4 resources updated in 01 minutes 30 seconds[2026-04-23T20:35:0608:00] FATAL: Stacktrace dumped to /opt/gitlab/embedded/cookbooks/cache/cinc-stacktrace.out[2026-04-23T20:35:0608:00] FATAL: ---------------------------------------------------------------------------------------[2026-04-23T20:35:0608:00] FATAL: PLEASE PROVIDE THE CONTENTS OF THE stacktrace.out FILE (above) IF YOU FILE A BUG REPORT[2026-04-23T20:35:0608:00] FATAL: ---------------------------------------------------------------------------------------[2026-04-23T20:35:0608:00] FATAL: Chef::Exceptions::InsufficientPermissions: directory[/usr/lib/systemd/system] (package::runit_systemd line 22) had an error: Chef::Exceptions::InsufficientPermissions: Cannot create directory[/usr/lib/systemd/system] at /usr/lib/systemd/system due to insufficient permissions原因是openKylin 2.0 SP2是因为系统处于正常模式Normal Mode磐石架构的保护开启无法写入系统核心区域。解决方案1. CtrlAltT同时按下Ctrl、Alt、T三个键打开命令终端。2. 在命令终端中执行下面两条指令将系统切换到维护模式Maintain Modesudo mm-cli -osudo reboot3. 在重新启动系统后按CtrlAltT同时按下Ctrl、Alt、T三个键打开命令终端。4. 在命令终端中执行以下指令sudo gitlab-ctl reconfigure重新配置GitLab。【创作团队】策 划沈传越文字创作沈传越技术支持樊瑞平图片采集沈传越制 图樊瑞平技术验证沈传越编 辑沈传越版式设计沈传越