GitLab 服务器宕机时的项目代码恢复方法
<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">一、数据拷贝与准备</a></li><li><a href="#_label1">二、识别项目数据</a></li><li><a href="#_label2">三、简化恢复方法</a></li><li><a href="#_label3">四、自动化恢复脚本</a></li><ul class="second_class_ul"><li><a href="#_lab2_3_0">使用方法</a></li></ul><li><a href="#_label4">五、后续操作</a></li><ul class="second_class_ul"></ul></ul></div><blockquote><p><strong>重要前提</strong>：GitLab 数据挂载盘必须能够正常读取，且 <code>/var/opt/gitlab/git-data/repositories</code> 目录下的数据可以完整拷贝。</p></blockquote><p>当 GitLab 服务器意外宕机且没有备份时，项目代码的恢复变得尤为关键。以下是经过优化的恢复流程，相比传统方法更为简洁高效。</p>
<p class="maodian"><a name="_label0"></a></p><h2>一、数据拷贝与准备</h2>
<ul><li><p><strong>挂载数据盘</strong>将宕机服务器的数据盘挂载到其他正常运行的主机或服务器上。确保 <code>/var/opt/gitlab/git-data</code> 目录下的所有内容能够完整拷贝到新的主机或服务器中。</p>
<div class="jb51code"><pre class="brush:bash;">sudo mount /dev/sdX /mnt/data# 示例挂载命令，需根据实际情况调整</pre></div></li><li><p><strong>拷贝数据</strong>将 <code>/var/opt/gitlab/git-data</code> 目录下的所有内容完整拷贝到新主机的指定目录，例如 <code>/mnt/recovery</code>。</p>
<div class="jb51code"><pre class="brush:bash;">sudo cp -r /mnt/data/var/opt/gitlab/git-data /mnt/recovery/</pre></div></li></ul>
<p class="maodian"><a name="_label1"></a></p><h2>二、识别项目数据</h2>
<p>GitLab 的项目数据存储在 <code>/var/opt/gitlab/git-data/repositories/@hashed</code> 目录下，文件夹名称经过哈希处理，无法直接识别项目信息。但每个项目文件夹（如 <code>xxxxx.git</code>）下的 <code>config</code> 文件中存储了项目相关的部分信息，可以提取仓库所有者及仓库名称。</p>
<blockquote><p><strong>注意</strong>：<code>xxx.wiki.git</code> 和 <code>xxx.design.git</code> 文件夹通常可以忽略，因为它们不包含重要代码数据，且其 <code>config</code> 文件中也不包含仓库所有者及仓库名称。</p></blockquote>
<p class="maodian"><a name="_label2"></a></p><h2>三、简化恢复方法</h2>
<p>传统的恢复方法通常需要搭建新的 GitLab 服务器并进行数据镜像，但这种方法存在以下问题：</p>
<ul><li>需要确保新旧服务器的 GitLab 版本完全一致，否则可能导致数据无法正确镜像。</li><li>操作步骤繁琐，耗时且容易出错。</li></ul>
<p>事实上，我们可以采用更简单的方法直接恢复代码，无需搭建新服务器。</p>
<p>以项目文件夹 <code>73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git</code> 为例，以下是具体步骤：</p>
<ul><li><p><strong>设置安全目录</strong>由于 GitLab 的项目目录可能被识别为不安全目录，需要通过以下命令将其标记为安全目录：</p>
<div class="jb51code"><pre class="brush:bash;">git config --global --add safe.directory /mnt/recovery/repositories/@hashed/73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git</pre></div></li><li><p><strong>克隆项目</strong>在上文中提到，<code>config</code> 文件中存储了完整的仓库所有者和仓库名称（例如 <code>author/project_name</code>）。我们可以通过克隆操作将项目恢复到本地目录。假设目标项目路径是 <code>your_clone_dir/author/project_name</code>，那么可以执行以下命令来完成克隆：</p>
<div class="jb51code"><pre class="brush:bash;">git clone /mnt/recovery/repositories/@hashed/73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git your_clone_dir/author/project_name</pre></div></li></ul>
<p class="maodian"><a name="_label3"></a></p><h2>四、自动化恢复脚本</h2>
<p>为了进一步简化操作，以下是一个 Python 脚本，可以快速执行上述操作，只需提供哈希化仓库的源目录和克隆仓库的目标目录。</p>
<div class="jb51code"><pre class="brush:py;">#!/usr/bin/env python
# -*-coding:utf-8 -*-
# ==============================================================================
# Copyright (c) 2025 laugh12321 Authors. All Rights Reserved.
#
# Licensed under the GNU General Public License v3.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.gnu.org/licenses/gpl-3.0.html
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ==============================================================================
# File : hashed_repo_cloner.py
# Version : 1.0
# Author: laugh12321
# Contact : laugh12321@vip.qq.com
# Date : 2025/03/31 14:51:38
# Desc : None
# ==============================================================================
from pathlib import Path
import configparser
import subprocess
import argparse
from typing import Optional
from rich.progress import track
import sys
def extract_repo_name_from_config(config_path: Path) -> str:
"""
从Git配置文件中提取仓库完整路径
:param config_path: Git配置文件路径
:return: 仓库完整路径
:raises ValueError: 如果配置缺少gitlab段或fullpath键
:raises FileNotFoundError: 如果配置文件不存在
"""
if not config_path.is_file():
raise FileNotFoundError(f"Git config file not found: {config_path}")
config = configparser.ConfigParser()
config.read(config_path)
if 'gitlab' not in config or 'fullpath' not in config['gitlab']:
raise ValueError(f"Config file missing required gitlab section or fullpath key: {config_path}")
return config.get('gitlab', 'fullpath')
def add_safe_directory(git_dir: Path) -> None:
"""
将Git目录添加到安全目录列表
:param git_dir: Git仓库路径
"""
subprocess.run(
["git", "config", "--global", "--add", "safe.directory", str(git_dir)],
check=True,
stdout=subprocess.DEVNULL,# 将标准输出重定向到 /dev/null
stderr=subprocess.DEVNULL # 将标准错误重定向到 /dev/null
)
def clone_repository(source_dir: Path, target_dir: Path, repo_name: str) -> None:
"""
克隆仓库到目标目录
:param source_dir: 源Git仓库路径
:param target_dir: 目标目录路径
:param repo_name: 仓库名称
"""
target_path = target_dir / repo_name
subprocess.run(
["git", "clone", str(source_dir), str(target_path)],
check=True,
stdout=subprocess.DEVNULL,# 将标准输出重定向到 /dev/null
stderr=subprocess.DEVNULL # 将标准错误重定向到 /dev/null
)
def process_git_repositories(hashed_repos_dir: Path, output_dir: Path) -> None:
"""
处理所有哈希化的Git仓库并将其克隆到输出目录
:param hashed_repos_dir: 包含哈希化仓库的目录
:param output_dir: 输出目录
"""
# 预过滤.git目录，排除wiki和design仓库
git_folders = [
folder for folder in hashed_repos_dir.rglob("*.git")
if not folder.name.endswith((".wiki.git", ".design.git"))
]
if not git_folders:
print("No valid Git repositories found to process.")
return
for git_folder in track(git_folders, description="Processing repositories"):
config_path = git_folder / "config"
try:
repo_name = extract_repo_name_from_config(config_path)
add_safe_directory(git_folder)
clone_repository(git_folder, output_dir, repo_name)
except Exception as e:
print(f"Error processing {git_folder.name}: {e}")
sys.exit()# 终止程序
def validate_directory(path: Optional) -> Path:
"""
验证并将路径字符串转换为Path对象
:param path: 路径字符串
:return: Path对象
:raises ValueError: 如果路径不存在或不是目录
"""
if path is None:
raise ValueError("Path cannot be None")
path_obj = Path(path)
if not path_obj.exists():
raise ValueError(f"Path does not exist: {path}")
if not path_obj.is_dir():
raise ValueError(f"Path is not a directory: {path}")
return path_obj
def parse_arguments():
"""
解析命令行参数
:return: 包含参数的命名空间
"""
parser = argparse.ArgumentParser(
description="将GitLab哈希化仓库克隆到目标目录",
formatter_class=argparse.ArgumentDefaultsHelpFormatter
)
parser.add_argument(
"--source",
type=str,
required=True,
help="包含哈希化仓库的源目录（必须）"
)
parser.add_argument(
"--output",
type=str,
required=True,
help="克隆仓库的目标目录（必须）"
)
return parser.parse_args()
def main():
args = parse_arguments()
try:
source_dir = validate_directory(args.source)
output_dir = Path(args.output)
process_git_repositories(source_dir, output_dir)
except ValueError as e:
print(f"Argument error: {e}")
return 1
return 0
if __name__ == "__main__":
exit(main())</pre></div>
<p class="maodian"><a name="_lab2_3_0"></a></p><h3>使用方法</h3>
<p>运行以下命令即可启动脚本：</p>
<div class="jb51code"><pre class="brush:bash;">python hashed_repo_cloner.py --source gitlab_hashed_dir --output project_out_dir</pre></div>
<p class="maodian"><a name="_label4"></a></p><h2>五、后续操作</h2>
<ul><li><p><strong>验证恢复结果</strong>进入克隆后的项目目录，检查代码完整性，确保所有分支和提交记录都已正确恢复。</p>
<div class="jb51code"><pre class="brush:bash;">cd project_out_dir/author/project_name
git log# 查看提交记录
git branch -a# 查看所有分支</pre></div></li><li><p><strong>重新托管到 GitLab 或其他平台</strong>如果需要将恢复的代码重新托管到 GitLab 或其他代码托管平台，可以按照以下步骤操作：</p>
<ul><li>在目标平台创建新的仓库。</li><li>将本地克隆的项目推送到新仓库：<div class="jb51code"><pre class="brush:bash;">git remote add origin <新仓库的URL>
git push -u origin --all
git push -u origin --tags</pre></div></li></ul></li></ul>
<p>通过上述方法，我们无需搭建新服务器，也无需担心版本兼容问题，能够快速高效地恢复 GitLab 项目代码。</p>
<p>到此这篇关于GitLab 服务器宕机时的项目代码恢复方法的文章就介绍到这了,更多相关GitLab 服务器宕机内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
頁:
[1]