mirror of
https://github.com/RayLabsHQ/gitea-mirror.git
synced 2025-12-06 19:46:44 +03:00
docs: improve vendor-lock-in-prevention article accuracy
Updated the vendor lock-in prevention article with more accurate UI navigation paths and technical details to match current application features. Changes: - Added missing title heading - Updated navigation instructions to reference actual UI paths (Configuration → Connections, Content & Data, Automation) - Improved technical accuracy of sync interval recommendations - Added FAQ section with practical questions about auto-discovery, sync intervals, and cutover scripting - Clarified activity log and API endpoint usage for monitoring These changes ensure the article reflects the current application UI and features.
This commit is contained in:
@@ -5,6 +5,8 @@ description: "Use Gitea Mirror to keep an always-current fallback so policy or p
|
|||||||
canonical: "https://gitea-mirror.com/use-cases/vendor-lock-in-prevention/"
|
canonical: "https://gitea-mirror.com/use-cases/vendor-lock-in-prevention/"
|
||||||
---
|
---
|
||||||
|
|
||||||
|
# Stay Ready to Leave GitHub
|
||||||
|
|
||||||
## Keep your exit hatch open
|
## Keep your exit hatch open
|
||||||
|
|
||||||
GitHub can change pricing, authentication rules, or terms without notice. With Gitea Mirror running, you always have a live copy of code and metadata inside infrastructure you control—so switching to self-hosted Gitea, Forgejo, or something else becomes a DNS change, not a fire drill.
|
GitHub can change pricing, authentication rules, or terms without notice. With Gitea Mirror running, you always have a live copy of code and metadata inside infrastructure you control—so switching to self-hosted Gitea, Forgejo, or something else becomes a DNS change, not a fire drill.
|
||||||
@@ -20,9 +22,9 @@ GitHub can change pricing, authentication rules, or terms without notice. With G
|
|||||||
|
|
||||||
### 1. Mirror everything continuously
|
### 1. Mirror everything continuously
|
||||||
|
|
||||||
- Add every GitHub organization you care about as an owner in Gitea Mirror.
|
- In **Configuration → Connections**, add every GitHub organization you care about as an owner. Auto-discovery pulls new repositories on the next scheduler run.
|
||||||
- Enable **Preserve structure** so Gitea’s org layout matches GitHub.
|
- Set the organization strategy to **Preserve structure** so Gitea mirrors the GitHub org layout.
|
||||||
- Turn on metadata + LFS mirroring to ensure issues, releases, and binaries are ready on day one.
|
- Open **Content & Data** to enable metadata, releases, and Git LFS, ensuring issues, pull requests, and binaries survive the switchover.
|
||||||
|
|
||||||
### 2. Simulate a cutover
|
### 2. Simulate a cutover
|
||||||
|
|
||||||
@@ -44,9 +46,9 @@ GitHub can change pricing, authentication rules, or terms without notice. With G
|
|||||||
|
|
||||||
### 5. Watch for drift
|
### 5. Watch for drift
|
||||||
|
|
||||||
- Review the Gitea mirror weekly for newly created repos, teams, or permissions.
|
- Review the repositories dashboard weekly for new projects, teams, or permission mismatches.
|
||||||
- Parse the `/api/owners` endpoint to ensure auto-discovery still works.
|
- Check the **Automation** tab—if the scheduler is enabled, auto-discovery keeps owners current.
|
||||||
- Set alerts on the mirror’s activity log so you catch sync failures quickly.
|
- Use the Activity Log and `/api/events` export to alert on failures before your recovery point objective is breached.
|
||||||
|
|
||||||
## Success criteria
|
## Success criteria
|
||||||
|
|
||||||
@@ -59,3 +61,17 @@ GitHub can change pricing, authentication rules, or terms without notice. With G
|
|||||||
|
|
||||||
- [Sync GitHub to Your Self-Hosted Gitea](../sync-github-to-self-hosted-gitea/)
|
- [Sync GitHub to Your Self-Hosted Gitea](../sync-github-to-self-hosted-gitea/)
|
||||||
- [Deploy Gitea Mirror with the Helm Chart](../deploy-with-helm-chart/)
|
- [Deploy Gitea Mirror with the Helm Chart](../deploy-with-helm-chart/)
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
### How do I confirm the mirror is still catching new repositories?
|
||||||
|
|
||||||
|
Check the **Configuration → Connections** screen for the `Last imported` timestamp and ensure the scheduler in **Automation** is enabled. Auto-discovery runs with each scheduled sync.
|
||||||
|
|
||||||
|
### What interval should I run before a potential cutover?
|
||||||
|
|
||||||
|
Keep `Automatic syncing` at 15–30 minutes for active organizations. That keeps the lag well under an hour if you have to pivot suddenly.
|
||||||
|
|
||||||
|
### Can I script the cutover?
|
||||||
|
|
||||||
|
Yes. Use the `/api/export` configuration JSON and the repositories CSV export to generate runbooks, then pair them with infrastructure-as-code (DNS, reverse proxy, CI) so flipping endpoints becomes repeatable.
|
||||||
|
|||||||
Reference in New Issue
Block a user