jedarden/pdftract
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
pdftract/notes/bf-1o0la-mirror-config.md

3.3 KiB
Raw Blame History

Forgejo Push Mirror Configuration (bf-1o0la)

Date: 2026-07-05
Purpose: Configure and verify Forgejo push mirror to GitHub

Current Mirror Configuration

Mirror Entry Details

{
  "repo_name": "pdftract",
  "remote_name": "remote_mirror_nfF0JdlNzC",
  "remote_address": "https://github.com/jedarden/pdftract.git",
  "created": "2026-05-16T19:51:17Z",
  "last_update": "2026-07-05T21:59:42Z",
  "interval": "10m0s",
  "sync_on_commit": true,
  "last_error": "PushRejected Error: large files detected"
}

Configuration Status

Setting Value Status
Remote Address https://github.com/jedarden/pdftract.git ✓ PASS
Sync on Commit true ✓ PASS
Sync Interval 10m0s ✓ PASS
Mirror Active Yes ✓ PASS
Last Sync 2026-07-05 21:59:42 UTC ✓ PASS (today)

Current Issue: Large File Blockage

The mirror is configured correctly but failing to sync due to large files that exceed GitHub's limits:

Blocking Files

  1. test_parse_simple - 60.74 MB (exceeds GitHub's recommended 50 MB limit)
  2. --1.ppm - 235.13 MB (exceeds GitHub's 100 MB hard limit)

Error Message

PushRejected Error: remote: error: File --1.ppm is 235.13 MB; 
this exceeds GitHub's file size limit of 100.00 MB
GH001: Large files detected. You may want to try Git Large File Storage.

Resolution Options

Option 1: Use Git LFS (Recommended)

  • Migrate large files to Git LFS
  • Configure LFS on both Forgejo and GitHub
  • Files stored in LFS don't count toward size limits

Option 2: Remove Large Files from History

  • Use git filter-repo or BFG to remove large files from git history
  • Rewrite history to exclude test fixtures and large assets
  • Force push to both repositories

Option 3: Exclude Test Fixtures from Repository

  • Move test fixtures to external storage (S3, dedicated fixtures repo)
  • Add to .gitignore and remove from git history
  • Reference fixtures via download scripts

API Response Summary

✅ Mirror Configuration: PASS

  • Mirror entry exists for GitHub
  • sync_on_commit is enabled
  • API endpoint accessible and responding

⚠️ Mirror Sync Status: WARN

  • Mirror exists and is configured correctly
  • Sync is failing due to large files in repository history
  • Configuration is correct but blocked by content size limits

Verification Commands

# Check mirror status via API
curl -H "Authorization: token <TOKEN>" \
  https://git.ardenone.com/api/v1/repos/jedarden/pdftract/push_mirrors

# Find large files in repository
git rev-list --objects --all |
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' |
  awk '/^blob/ {print substr($0,6)}' |
  sort -n -k2 |
  tail -20

Acceptance Criteria Status

  • ✅ PASS: Forgejo push_mirrors API shows active github-mirror entry for jedarden/pdftract
  • ✅ PASS: sync_on_commit is set to true
  • ✅ PASS: API response confirms mirror is configured correctly
  • ⚠️ WARN: Mirror exists but sync is blocked by large files (configuration issue, not mirror config)

References