GitLab?服務器宕機時的項目代碼恢復方法
重要前提:GitLab 數(shù)據(jù)掛載盤必須能夠正常讀取,且
/var/opt/gitlab/git-data/repositories
目錄下的數(shù)據(jù)可以完整拷貝。
當 GitLab 服務器意外宕機且沒有備份時,項目代碼的恢復變得尤為關鍵。以下是經(jīng)過優(yōu)化的恢復流程,相比傳統(tǒng)方法更為簡潔高效。
一、數(shù)據(jù)拷貝與準備
掛載數(shù)據(jù)盤將宕機服務器的數(shù)據(jù)盤掛載到其他正常運行的主機或服務器上。確保
/var/opt/gitlab/git-data
目錄下的所有內(nèi)容能夠完整拷貝到新的主機或服務器中。sudo mount /dev/sdX /mnt/data # 示例掛載命令,需根據(jù)實際情況調(diào)整
拷貝數(shù)據(jù)將
/var/opt/gitlab/git-data
目錄下的所有內(nèi)容完整拷貝到新主機的指定目錄,例如/mnt/recovery
。sudo cp -r /mnt/data/var/opt/gitlab/git-data /mnt/recovery/
二、識別項目數(shù)據(jù)
GitLab 的項目數(shù)據(jù)存儲在 /var/opt/gitlab/git-data/repositories/@hashed
目錄下,文件夾名稱經(jīng)過哈希處理,無法直接識別項目信息。但每個項目文件夾(如 xxxxx.git
)下的 config
文件中存儲了項目相關的部分信息,可以提取倉庫所有者及倉庫名稱。
注意:
xxx.wiki.git
和xxx.design.git
文件夾通??梢院雎裕驗樗鼈儾话匾a數(shù)據(jù),且其config
文件中也不包含倉庫所有者及倉庫名稱。
三、簡化恢復方法
傳統(tǒng)的恢復方法通常需要搭建新的 GitLab 服務器并進行數(shù)據(jù)鏡像,但這種方法存在以下問題:
- 需要確保新舊服務器的 GitLab 版本完全一致,否則可能導致數(shù)據(jù)無法正確鏡像。
- 操作步驟繁瑣,耗時且容易出錯。
事實上,我們可以采用更簡單的方法直接恢復代碼,無需搭建新服務器。
以項目文件夾 73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git
為例,以下是具體步驟:
設置安全目錄由于 GitLab 的項目目錄可能被識別為不安全目錄,需要通過以下命令將其標記為安全目錄:
git config --global --add safe.directory /mnt/recovery/repositories/@hashed/73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git
克隆項目在上文中提到,
config
文件中存儲了完整的倉庫所有者和倉庫名稱(例如author/project_name
)。我們可以通過克隆操作將項目恢復到本地目錄。假設目標項目路徑是your_clone_dir/author/project_name
,那么可以執(zhí)行以下命令來完成克?。?/p>git clone /mnt/recovery/repositories/@hashed/73/47/73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049.git your_clone_dir/author/project_name
四、自動化恢復腳本
為了進一步簡化操作,以下是一個 Python 腳本,可以快速執(zhí)行上述操作,只需提供哈希化倉庫的源目錄和克隆倉庫的目標目錄。
#!/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: """ 處理所有哈?;腉it倉庫并將其克隆到輸出目錄 :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[str]) -> 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(): """ 解析命令行參數(shù) :return: 包含參數(shù)的命名空間 """ 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())
使用方法
運行以下命令即可啟動腳本:
python hashed_repo_cloner.py --source gitlab_hashed_dir --output project_out_dir
五、后續(xù)操作
驗證恢復結果進入克隆后的項目目錄,檢查代碼完整性,確保所有分支和提交記錄都已正確恢復。
cd project_out_dir/author/project_name git log # 查看提交記錄 git branch -a # 查看所有分支
重新托管到 GitLab 或其他平臺如果需要將恢復的代碼重新托管到 GitLab 或其他代碼托管平臺,可以按照以下步驟操作:
- 在目標平臺創(chuàng)建新的倉庫。
- 將本地克隆的項目推送到新倉庫:
git remote add origin <新倉庫的URL> git push -u origin --all git push -u origin --tags
通過上述方法,我們無需搭建新服務器,也無需擔心版本兼容問題,能夠快速高效地恢復 GitLab 項目代碼。
到此這篇關于GitLab 服務器宕機時的項目代碼恢復方法的文章就介紹到這了,更多相關GitLab 服務器宕機內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
服務器配置禁止IP直接訪問只允許域名訪問的實現(xiàn)步驟
聯(lián)網(wǎng)信息系統(tǒng)需設置只允許通過域名訪問,禁止使用IP地址直接訪問,建議同時采用云防護技術隱藏系統(tǒng)真實IP地址且只允許云防護節(jié)點IP訪問服務器,提升網(wǎng)絡安全防護能力,這篇文章主要介紹了服務器配置禁止IP直接訪問只允許域名訪問,需要的朋友可以參考下2024-03-03銀河麒麟V10服務器版安裝達夢DM8數(shù)據(jù)庫的詳細過程
這篇文章主要介紹了銀河麒麟V10服務器版安裝達夢DM8數(shù)據(jù)庫的詳細過程,本文通過圖文并茂的形式給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2024-03-03