Guía de Migración

Actualizar desde versiones anteriores a la última Gemini CLI

Resumen de Migración

Esta guía te ayuda a migrar desde versiones anteriores de Gemini CLI a la versión más reciente. Cubriremos cambios importantes, actualizaciones de configuración y proporcionaremos instrucciones paso a paso para una transición suave.

Versión Actual
2.0.0
Migraciones Soportadas
Esta guía cubre la migración desde versiones 1.x a 2.0.0

Matriz de Compatibilidad de Versiones

Verifica qué ruta de migración se aplica a tu versión actual

1.0.x - 1.2.x2.0.0
Mayor
30-60 minutos
Cambios Importantes: Alto
1.3.x - 1.5.x2.0.0
Moderado
15-30 minutos
Cambios Importantes: Medio
1.6.x - 1.9.x2.0.0
Menor
5-15 minutos
Cambios Importantes: Bajo

Cambios Importantes en v2.0.0

Cambios importantes que pueden afectar tu configuración existente

Configuración

Formato de Archivo de Configuración

El formato del archivo de configuración ha cambiado de JSON a YAML para mejor legibilidad y soporte de comentarios.

Nivel de Impacto
Alto
Migración
Usa la herramienta de migración integrada: gemini config migrate

Antes (v1.x)

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

Después (v2.0)

api_key: your-key
model: gemini-pro
# ¡Ahora se soportan comentarios!
Comandos

Cambios en la Estructura de Comandos

Algunos comandos han sido renombrados o reestructurados para consistencia.

Nivel de Impacto
Medio
Migración
Actualiza tus scripts y alias

Cambios de Comandos

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

Gestión de Claves API

Las claves API ahora se almacenan en un formato más seguro con encriptación.

Nivel de Impacto
Bajo
Migración
Vuelve a ejecutar: gemini config set api-key YOUR_KEY

Tu clave API existente será migrada automáticamente en la primera ejecución

Migración Paso a Paso

Sigue estos pasos para migrar a Gemini CLI v2.0.0

1

Respalda tu Configuración

Crea un respaldo de tu configuración actual antes de comenzar la migración.

Comandos:

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

Esto asegura que puedas restaurar tu configuración si es necesario.

2

Actualiza Gemini CLI

Instala la versión más reciente de Gemini CLI.

Comandos:

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

Verificación:

gemini --version
3

Ejecuta la Herramienta de Migración

Usa la herramienta de migración integrada para actualizar tu configuración.

Comandos:

gemini config migrate

Esto convertirá automáticamente tu configuración al nuevo formato.

4

Verifica la Configuración

Verifica que tu configuración haya sido migrada correctamente.

Comandos:

gemini config list
gemini ask "Hola, prueba de migración"

Asegúrate de que toda tu configuración se preserve y el CLI funcione como se espera.

5

Actualiza Scripts y Alias

Actualiza cualquier script o alias que use la sintaxis de comando antigua.

Consulta la sección de cambios de comandos arriba para las actualizaciones específicas necesarias.

Solución de Problemas de Migración

Problemas comunes y sus soluciones

Falló la migración de configuración

Síntomas:

  • Error: No se puede migrar la configuración
  • Archivo de configuración no encontrado

Soluciones:

  1. Asegúrate de tener permisos de escritura en el directorio ~/.gemini
  2. Verifica si existe el archivo de configuración anterior: ls ~/.gemini/
  3. Intenta migración manual: gemini config migrate --force

Los comandos no funcionan después de la migración

Síntomas:

  • Errores de comando no encontrado
  • Comportamiento inesperado

Soluciones:

  1. Limpia tu caché de shell: hash -r
  2. Reinicia tu sesión de terminal
  3. Verifica la nueva sintaxis de comandos en la documentación

La clave API no funciona

Síntomas:

  • Errores de autenticación
  • Mensajes de clave API inválida

Soluciones:

  1. Vuelve a configurar tu clave API: gemini config set api-key YOUR_KEY
  2. Verifica que la clave sea correcta: gemini config get api-key
  3. Verifica los permisos de la clave API en Google AI Studio

Instrucciones de Reversión

Cómo volver a la versión anterior si es necesario

⚠️ Solo usa la reversión si encuentras problemas críticos que impiden el funcionamiento normal.

  1. 1
    Desinstala la versión actual: npm uninstall -g @google/generative-ai-cli
  2. 2
    Instala la versión anterior: npm install -g @google/generative-ai-cli@1.9.0
  3. 3
    Restaura la configuración: cp ~/.gemini/config.json.backup ~/.gemini/config.json
  4. 4
    Verifica la reversión: gemini --version

Pasos Post-Migración

Acciones recomendadas después de una migración exitosa

Actualizar Documentación

Medio

Actualiza cualquier documentación interna o guías de equipo para reflejar la nueva sintaxis de comandos.

Probar Scripts de Automatización

Alto

Ejecuta tus scripts automatizados y pipelines CI/CD para asegurar que funcionen con la nueva versión.

Explorar Nuevas Características

Bajo

Revisa las nuevas características y mejoras en v2.0.0.

Aprender más

Limpiar Respaldos

Bajo

Después de confirmar que todo funciona, puedes eliminar los archivos de respaldo.

¿Necesitas Ayuda con la Migración?

Si encuentras algún problema durante la migración, nuestra comunidad está aquí para ayudar.

Obtener SoporteVer Guía de Solución de Problemas