You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
192 lines
5.2 KiB
192 lines
5.2 KiB
# 🚀 Gitea to GitHub Migration Tool
|
|
|
|
Ce projet fournit un outil pratique et modulable pour migrer vos repositories de Gitea vers GitHub automatiquement.
|
|
|
|
## ✨ Fonctionnalités
|
|
|
|
- **Migration automatique** : Migre tous vos repositories Gitea vers GitHub en une seule commande
|
|
- **Migration sélective** : Choisissez spécifiquement quels repositories migrer
|
|
- **Support multi-propriétaire** : Migrez des repositories d'autres utilisateurs/organisations auxquels vous avez accès
|
|
- **Interface en ligne de commande** : Interface colorée et intuitive
|
|
- **Logging complet** : Suivi détaillé des opérations avec fichier de log
|
|
- **Gestion des erreurs** : Robuste avec gestion gracieuse des erreurs
|
|
|
|
## 🛠 Installation
|
|
|
|
1. **Clonez le repository** :
|
|
```bash
|
|
git clone https://github.com/votre-username/GiteaToGithubMigrator.git
|
|
cd GiteaToGithubMigrator
|
|
```
|
|
|
|
2. **Configuration automatique** :
|
|
```bash
|
|
./run.sh --setup
|
|
```
|
|
|
|
Le script va automatiquement :
|
|
- Créer un environnement virtuel Python
|
|
- Installer toutes les dépendances
|
|
- Créer le fichier de configuration `.env`
|
|
|
|
Cela créera un fichier `.env` que vous devrez remplir avec vos informations :
|
|
|
|
```env
|
|
# Gitea Configuration
|
|
GITEA_URL=https://votre-instance-gitea.com
|
|
GITEA_TOKEN=votre_token_gitea
|
|
GITEA_USERNAME=votre_nom_utilisateur_gitea
|
|
|
|
# GitHub Configuration
|
|
GITHUB_TOKEN=votre_token_github
|
|
GITHUB_USERNAME=votre_nom_utilisateur_github
|
|
```
|
|
|
|
## 🔑 Configuration des tokens
|
|
|
|
### Token Gitea
|
|
1. Allez dans **Settings** → **Applications** → **Generate New Token**
|
|
2. Donnez un nom au token et sélectionnez les permissions :
|
|
- `repo` (accès complet aux repositories)
|
|
- `user` (accès aux informations utilisateur)
|
|
|
|
### Token GitHub
|
|
1. Allez dans **Settings** → **Developer settings** → **Personal access tokens** → **Tokens (classic)**
|
|
2. Cliquez sur **Generate new token (classic)**
|
|
3. Sélectionnez les permissions :
|
|
- `repo` (accès complet aux repositories privés)
|
|
- `public_repo` (accès aux repositories publics)
|
|
|
|
## 🚀 Utilisation
|
|
|
|
Après avoir configuré vos tokens dans le fichier `.env`, utilisez le script de lancement :
|
|
|
|
### Migration de tous vos repositories
|
|
```bash
|
|
./run.sh
|
|
```
|
|
|
|
### Migration de repositories spécifiques
|
|
```bash
|
|
./run.sh --repos mon-repo autre-repo
|
|
```
|
|
|
|
### Migration de repositories d'autres propriétaires
|
|
```bash
|
|
./run.sh --repos proprietaire/repo-name
|
|
```
|
|
|
|
### Lister les repositories disponibles
|
|
```bash
|
|
./run.sh --list
|
|
```
|
|
|
|
### Mode verbose (plus de détails)
|
|
```bash
|
|
./run.sh --verbose
|
|
```
|
|
|
|
> **💡 Alternative** : Vous pouvez aussi utiliser directement `python migrate.py` si vous avez activé l'environnement virtuel (`source venv/bin/activate`)
|
|
|
|
## 📋 Exemples d'utilisation
|
|
|
|
### Exemple 1 : Migration complète
|
|
```bash
|
|
# Migre tous vos repositories
|
|
./run.sh
|
|
```
|
|
|
|
### Exemple 2 : Migration sélective
|
|
```bash
|
|
# Migre seulement les repositories spécifiés
|
|
./run.sh --repos projet-web api-backend
|
|
```
|
|
|
|
### Exemple 3 : Migration depuis une organisation
|
|
```bash
|
|
# Migre un repository d'une organisation
|
|
./run.sh --repos mon-org/projet-important
|
|
```
|
|
|
|
### Exemple 4 : Premier lancement (configuration)
|
|
```bash
|
|
# 1. Setup initial
|
|
./run.sh --setup
|
|
|
|
# 2. Éditez le fichier .env avec vos credentials
|
|
nano .env
|
|
|
|
# 3. Listez vos repositories disponibles
|
|
./run.sh --list
|
|
|
|
# 4. Lancez la migration
|
|
./run.sh
|
|
```
|
|
|
|
## 📊 Résultats
|
|
|
|
L'outil affiche un résumé détaillé à la fin :
|
|
- ✅ Nombre de migrations réussies
|
|
- ❌ Nombre de migrations échouées
|
|
- 📝 Détail par repository
|
|
|
|
Tous les logs sont également sauvegardés dans `migration.log`.
|
|
|
|
## 🔧 Structure du projet
|
|
|
|
```
|
|
GiteaToGithubMigrator/
|
|
├── migrate.py # Script principal
|
|
├── config.py # Gestion de la configuration
|
|
├── gitea_client.py # Client API Gitea
|
|
├── github_client.py # Client API GitHub
|
|
├── migration_tool.py # Logique de migration
|
|
├── requirements.txt # Dépendances Python
|
|
├── .env # Configuration (à créer)
|
|
└── README.md # Documentation
|
|
```
|
|
|
|
## ⚠️ Prérequis
|
|
|
|
- Python 3.7+
|
|
- Git installé sur votre système
|
|
- Accès aux APIs Gitea et GitHub
|
|
- Tokens d'authentification valides
|
|
|
|
## 🛡 Sécurité
|
|
|
|
- Les tokens sont stockés dans un fichier `.env` (ajoutez-le à `.gitignore`)
|
|
- Les URLs d'authentification ne sont jamais loggées
|
|
- Nettoyage automatique des repositories temporaires
|
|
|
|
## 🐛 Résolution de problèmes
|
|
|
|
### Erreur d'authentification
|
|
- Vérifiez que vos tokens sont valides et ont les bonnes permissions
|
|
- Assurez-vous que les noms d'utilisateur correspondent
|
|
|
|
### Erreur de clonage
|
|
- Vérifiez votre connexion internet
|
|
- Assurez-vous que Git est installé et accessible
|
|
|
|
### Repository déjà existant
|
|
- L'outil vérifie automatiquement l'existence sur GitHub
|
|
- Les repositories existants sont ignorés avec un avertissement
|
|
|
|
## 📝 Logs
|
|
|
|
Tous les détails d'exécution sont sauvegardés dans `migration.log` :
|
|
- Timestamps des opérations
|
|
- Détails des erreurs
|
|
- Statistiques de migration
|
|
|
|
## 🤝 Contribution
|
|
|
|
Les contributions sont les bienvenues ! N'hésitez pas à :
|
|
- Signaler des bugs
|
|
- Proposer des améliorations
|
|
- Soumettre des pull requests
|
|
|
|
## 📄 Licence
|
|
|
|
Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails. |