fix: Update S3 config and add Gitea URL settings

- Change MINIO_ENDPOINT from IP to Docker hostname (s3storage) - Add ROOT_URL and DOMAIN settings for proper Gitea configuration - Give anonymous users Admin permission for bucket creation - Document SeaweedFS bucket creation process
2026-07-16 00:00:32 +02:00 · 2026-02-16 20:33:21 +00:00
parent b9e307bcc8
commit d2c28a91e6
6 changed files with 735 additions and 4 deletions
@@ -0,0 +1,200 @@
+# Quick Setup: Repository Mirroring
+
+Your repository is now on **GitHub** and ready for mirroring!
+
+## Current Status
+
+✅ **GitHub Repository:** https://github.com/terraphim/gitea-infrastructure  
+❌ **Gitea Repository:** Not created yet
+
+## Setup Steps
+
+### Step 1: Create Repository on Gitea
+
+**Via Web Interface:**
+1. Go to https://git.terraphim.cloud
+2. Click **"+"** → **"New Repository"**
+3. **Owner:** `terraphim`
+4. **Repository Name:** `gitea-infrastructure`
+5. **Description:** `Gitea deployment configuration`
+6. **Visibility:** ☑️ Private
+7. ☐ **Uncheck** "Initialize Repository"
+8. Click **"Create Repository"**
+
+**Result:** Empty repository created
+
+### Step 2: Push to Gitea
+
+```bash
+cd /home/alex/infrastructure/gitea-config
+
+# Push to Gitea
+git push origin main
+```
+
+### Step 3: Configure GitHub Actions Secrets
+
+**On GitHub:**
+1. Go to: https://github.com/terraphim/gitea-infrastructure/settings/secrets/actions
+2. Click **"New repository secret"**
+3. Add:
+   - **Name:** `GITEA_TOKEN`
+   - **Secret:** Your Gitea API token
+
+**To create Gitea API token:**
+1. Go to https://git.terraphim.cloud/user/settings/applications
+2. Click **"Generate New Token"**
+3. **Token Name:** `GitHub Actions Sync`
+4. Select scopes: `repo`, `write:repo`
+5. Click **"Generate Token"**
+6. Copy the token
+
+### Step 4: Test Mirroring
+
+**Push to GitHub:**
+```bash
+# Make a change
+echo "# Mirroring test" >> README.md
+git add README.md
+git commit -m "test: Mirroring to Gitea"
+
+# Push to GitHub (triggers Actions)
+git push github main
+```
+
+**Check Gitea:**
+- Go to https://git.terraphim.cloud/terraphim/gitea-infrastructure
+- Verify the commit appears
+
+## Current Remote Configuration
+
+```bash
+# Check remotes
+git remote -v
+
+# Should show:
+# origin  https://git.terraphim.cloud/terraphim/gitea-infrastructure.git (fetch)
+# origin  https://git.terraphim.cloud/terraphim/gitea-infrastructure.git (push)
+# github  https://github.com/terraphim/gitea-infrastructure.git (fetch)
+# github  https://github.com/terraphim/gitea-infrastructure.git (push)
+```
+
+## Two-Way Sync Workflow
+
+### Option A: GitHub as Primary (Recommended)
+
+**How it works:**
+1. Developer pushes to GitHub
+2. GitHub Actions automatically pushes to Gitea
+3. Gitea stays in sync as mirror
+
+**Commands:**
+```bash
+# Work locally
+git push github main  # Primary push (triggers Actions)
+
+# Or push to both manually
+git push github main && git push origin main
+```
+
+### Option B: Push to Both
+
+**Set up alias:**
+```bash
+# Add to ~/.gitconfig
+git config --global alias.pushall '!git push github $(git branch --show-current) && git push origin $(git branch --show-current)'
+
+# Usage
+git pushall  # Pushes to both
+```
+
+### Option C: Gitea as Primary
+
+**Configure in Gitea:**
+1. Go to repository **Settings** → **Repository**
+2. Scroll to **Mirror Settings**
+3. Check **"Push Mirror"**
+4. **Git Remote URL:** `https://github.com/terraphim/gitea-infrastructure.git`
+5. **Authentication:**
+   - **Username:** Your GitHub username
+   - **Password:** GitHub Personal Access Token
+6. **Interval:** `1h` (or your preference)
+7. Click **"Add Push Mirror"**
+
+**To create GitHub token:**
+1. Go to https://github.com/settings/tokens
+2. Click **"Generate new token (classic)"**
+3. Select scope: `repo`
+4. Generate and copy token
+
+## Repository Structure
+
+After setup, both repositories will have:
+
+```
+gitea-infrastructure/
+├── .docs/                          # Documentation
+│   ├── RESEARCH-gitea-bigbox-deployment.md
+│   ├── IMPLEMENTATION-gitea-bigbox-deployment.md
+│   ├── DEPLOYMENT-SUMMARY.md
+│   └── summary-*.md
+├── .github/
+│   └── workflows/                  # GitHub Actions
+│       ├── sync-to-gitea.yml       # Sync GitHub → Gitea
+│       └── mirror-check.yml        # Check sync status
+├── .gitignore                      # Excludes secrets
+├── ARTICLE-gitea-deployment.md     # Main article
+├── Caddyfile                       # Caddy config
+├── MIRRORING-GUIDE.md              # This guide
+├── README.md                       # Project overview
+├── REPOSITORY-SETUP.md             # Setup guide
+├── deploy-to-bigbox.sh             # Deployment script
+├── docker-compose.yml.template     # Template with op://
+└── s3_config.json.template         # Template with op://
+```
+
+## Verification
+
+**Check sync status:**
+```bash
+# Manual check
+./check-mirror.sh
+
+# GitHub Actions will run every 6 hours automatically
+```
+
+**View on GitHub:**
+https://github.com/terraphim/gitea-infrastructure
+
+**View on Gitea:**
+https://git.terraphim.cloud/terraphim/gitea-infrastructure
+
+## Next Steps
+
+1. ✅ Create Gitea repository
+2. ✅ Add GitHub Actions secret (GITEA_TOKEN)
+3. ✅ Push to Gitea
+4. ✅ Test mirroring with a commit
+5. Document your mirroring strategy for team members
+
+## Troubleshooting
+
+**GitHub Actions failing?**
+- Check GITEA_TOKEN is set correctly
+- Verify Gitea repository exists
+- Check Actions logs for details
+
+**Gitea push mirror failing?**
+- Verify GitHub token has `repo` scope
+- Check repository URL is correct
+- Review Gitea logs for errors
+
+**Conflicts?**
+- Stop both mirrors
+- Resolve conflicts locally
+- Push to both repositories
+- Re-enable mirrors
+
+---
+
+**Your repository is ready for mirroring!** 🎉