Guide de Migration

Mise à niveau des anciennes versions vers la dernière version de Gemini CLI

Aperçu de la Migration

Ce guide vous aide à migrer des anciennes versions de Gemini CLI vers la dernière version. Nous couvrirons les changements de rupture, les mises à jour de configuration et fournirons des instructions étape par étape pour une transition en douceur.

Version Actuelle
2.0.0
Migrations Supportées
Ce guide couvre la migration des versions 1.x vers 2.0.0

Matrice de Compatibilité des Versions

Vérifiez quel chemin de migration s'applique à votre version actuelle

1.0.x - 1.2.x2.0.0
Majeur
30-60 minutes
Changements de Rupture: Élevé
1.3.x - 1.5.x2.0.0
Modéré
15-30 minutes
Changements de Rupture: Moyen
1.6.x - 1.9.x2.0.0
Mineur
5-15 minutes
Changements de Rupture: Faible

Changements de Rupture dans v2.0.0

Changements importants qui peuvent affecter votre configuration existante

Configuration

Format du Fichier de Configuration

Le format du fichier de configuration a changé de JSON vers YAML pour une meilleure lisibilité et le support des commentaires.

Niveau d'Impact
Élevé
Migration
Utilisez l'outil de migration intégré : gemini config migrate

Avant (v1.x)

{
  "api_key": "your-key",
  "model": "gemini-pro"
}

Après (v2.0)

api_key: your-key
model: gemini-pro
# Les commentaires sont maintenant supportés !
Commandes

Changements de Structure des Commandes

Certaines commandes ont été renommées ou restructurées pour la cohérence.

Niveau d'Impact
Moyen
Migration
Mettez à jour vos scripts et alias

Changements de Commandes

gemini chatgemini ask
gemini generategemini create
gemini config showgemini config list
API

Gestion des Clés API

Les clés API sont maintenant stockées dans un format plus sécurisé avec chiffrement.

Niveau d'Impact
Faible
Migration
Relancez : gemini config set api-key YOUR_KEY

Votre clé API existante sera automatiquement migrée lors de la première exécution

Migration Étape par Étape

Suivez ces étapes pour migrer vers Gemini CLI v2.0.0

1

Sauvegardez Votre Configuration

Créez une sauvegarde de votre configuration actuelle avant de commencer la migration.

Commandes :

gemini config list > gemini-config-backup.txt
cp ~/.gemini/config.json ~/.gemini/config.json.backup

Cela garantit que vous pouvez restaurer vos paramètres si nécessaire.

2

Mettez à Jour Gemini CLI

Installez la dernière version de Gemini CLI.

Commandes :

npm update -g @google/generative-ai-cli

Vérification :

gemini --version
3

Exécutez l'Outil de Migration

Utilisez l'outil de migration intégré pour mettre à jour votre configuration.

Commandes :

gemini config migrate

Cela convertira automatiquement votre configuration au nouveau format.

4

Vérifiez la Configuration

Vérifiez que votre configuration a été migrée correctement.

Commandes :

gemini config list
gemini ask "Bonjour, test de migration"

Assurez-vous que tous vos paramètres sont préservés et que le CLI fonctionne comme prévu.

5

Mettez à Jour les Scripts et Alias

Mettez à jour tous les scripts ou alias qui utilisent l'ancienne syntaxe de commande.

Référez-vous à la section des changements de commandes ci-dessus pour les mises à jour spécifiques nécessaires.

Dépannage de Migration

Problèmes courants et leurs solutions

Échec de la migration de configuration

Symptômes :

  • Erreur : Impossible de migrer la configuration
  • Fichier de configuration introuvable

Solutions :

  1. Assurez-vous d'avoir les permissions d'écriture sur le répertoire ~/.gemini
  2. Vérifiez si l'ancien fichier de configuration existe : ls ~/.gemini/
  3. Essayez la migration manuelle : gemini config migrate --force

Les commandes ne fonctionnent pas après la migration

Symptômes :

  • Erreurs de commande introuvable
  • Comportement inattendu

Solutions :

  1. Videz votre cache shell : hash -r
  2. Redémarrez votre session de terminal
  3. Vérifiez la nouvelle syntaxe de commande dans la documentation

La clé API ne fonctionne pas

Symptômes :

  • Erreurs d'authentification
  • Messages de clé API invalide

Solutions :

  1. Redéfinissez votre clé API : gemini config set api-key YOUR_KEY
  2. Vérifiez que la clé est correcte : gemini config get api-key
  3. Vérifiez les permissions de la clé API dans Google AI Studio

Instructions de Retour en Arrière

Comment revenir à la version précédente si nécessaire

⚠️ N'utilisez le retour en arrière que si vous rencontrez des problèmes critiques qui empêchent le fonctionnement normal.

  1. 1
    Désinstallez la version actuelle : npm uninstall -g @google/generative-ai-cli
  2. 2
    Installez la version précédente : npm install -g @google/generative-ai-cli@1.9.0
  3. 3
    Restaurez la configuration : cp ~/.gemini/config.json.backup ~/.gemini/config.json
  4. 4
    Vérifiez le retour en arrière : gemini --version

Étapes Post-Migration

Actions recommandées après une migration réussie

Mettre à Jour la Documentation

Moyen

Mettez à jour toute documentation interne ou guides d'équipe pour refléter la nouvelle syntaxe de commande.

Tester les Scripts d'Automatisation

Élevé

Exécutez vos scripts automatisés et pipelines CI/CD pour vous assurer qu'ils fonctionnent avec la nouvelle version.

Explorer les Nouvelles Fonctionnalités

Faible

Découvrez les nouvelles fonctionnalités et améliorations dans v2.0.0.

En savoir plus

Nettoyer les Sauvegardes

Faible

Après avoir confirmé que tout fonctionne, vous pouvez supprimer les fichiers de sauvegarde.

Besoin d'Aide pour la Migration ?

Si vous rencontrez des problèmes pendant la migration, notre communauté est là pour vous aider.

Obtenir de l'AideVoir le Guide de Dépannage