GitHub Backup & Restore Runbook

מטרה

מדריך צעד‑אחר‑צעד לגיבוי ושחזור מאגר GitHub, כולל יצירת נקודת בדיקה (Checkpoint Tag) ושחזור בטוח.

דרישות מקדימות

gh מותקן ומחובר: gh auth login
הרשאות repo ו‑workflow לטוקן בשימוש

יצירת נקודת גיבוי (Checkpoint Tag)

# סימון נקודת גיבוי (SemVer + תאריך)
git tag -a v1.0-stable-$(date +%Y%m%d-%H%M) -m "Stable checkpoint"
git push origin --tags

יצירת ארכיון ZIP

# ארכיון של הענף הנוכחי
gh api -H "Accept: application/vnd.github+json" \
  repos/:owner/:repo/zipball -o backup.zip

# או ספציפית ל‑tag
gh api -H "Accept: application/vnd.github+json" \
  repos/:owner/:repo/zipball/v1.0-stable-YYYYMMDD-HHMM -o backup.zip

שחזור – בדיקה מקומית

# יצירת ענף זמני מהגיבוי לבדיקות
git fetch --all --tags
git checkout -b restore-from-backup <TAG_NAME>

שחזור מלא לפרודקשן (זהירות!)

# החלפת main בגרסת הגיבוי
git checkout main
git reset --hard <BACKUP_TAG_OR_BRANCH>
git push --force origin main

שחזור קבצים/תיקיות נקודתיים

# קובץ בודד
git checkout <BACKUP_TAG> -- path/to/file.py

# תיקייה שלמה
git checkout <BACKUP_TAG> -- path/to/dir/

טיפים ובטיחות

אמתו git status לפני פקודות הרסניות
גבו שינויים מקומיים ב‑stash או ענף זמני
הימנעו מ‑--force אלא אם נדרש ומאומת

קישורים