Руководство по Миграции

Обновление со старых версий на последнюю версию Gemini CLI

Обзор Миграции

Это руководство поможет вам мигрировать со старых версий Gemini CLI на последнюю версию. Мы рассмотрим критические изменения, обновления конфигурации и предоставим пошаговые инструкции для плавного перехода.

Текущая Версия
2.0.0
Поддерживаемые Миграции
Это руководство покрывает миграцию с версий 1.x на 2.0.0

Матрица Совместимости Версий

Проверьте, какой путь миграции применим к вашей текущей версии

1.0.x - 1.2.x2.0.0
Крупные
30-60 минут
Критические Изменения: Высокие
1.3.x - 1.5.x2.0.0
Умеренные
15-30 минут
Критические Изменения: Средние
1.6.x - 1.9.x2.0.0
Незначительные
5-15 минут
Критические Изменения: Низкие

Критические Изменения в v2.0.0

Важные изменения, которые могут повлиять на вашу существующую настройку

Конфигурация

Формат Файла Конфигурации

Формат файла конфигурации изменился с JSON на YAML для лучшей читаемости и поддержки комментариев.

Уровень Воздействия
Высокое
Миграция
Используйте встроенный инструмент миграции: gemini config migrate

До (v1.x)

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

После (v2.0)

api_key: your-key
model: gemini-pro
# Теперь поддерживаются комментарии!
Команды

Изменения Структуры Команд

Некоторые команды были переименованы или реструктурированы для согласованности.

Уровень Воздействия
Среднее
Миграция
Обновите ваши скрипты и псевдонимы

Изменения Команд

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

Управление API Ключами

API ключи теперь хранятся в более безопасном формате с шифрованием.

Уровень Воздействия
Низкое
Миграция
Повторно выполните: gemini config set api-key YOUR_KEY

Ваш существующий API ключ будет автоматически мигрирован при первом запуске

Пошаговая Миграция

Следуйте этим шагам для миграции на Gemini CLI v2.0.0

1

Создайте Резервную Копию Конфигурации

Создайте резервную копию вашей текущей конфигурации перед началом миграции.

Команды:

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

Это гарантирует, что вы сможете восстановить настройки при необходимости.

2

Обновите Gemini CLI

Установите последнюю версию Gemini CLI.

Команды:

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

Проверка:

gemini --version
3

Запустите Инструмент Миграции

Используйте встроенный инструмент миграции для обновления конфигурации.

Команды:

gemini config migrate

Это автоматически преобразует вашу конфигурацию в новый формат.

4

Проверьте Конфигурацию

Убедитесь, что ваша конфигурация была правильно мигрирована.

Команды:

gemini config list
gemini ask "Привет, тест миграции"

Убедитесь, что все ваши настройки сохранены и CLI работает как ожидается.

5

Обновите Скрипты и Псевдонимы

Обновите любые скрипты или псевдонимы, использующие старый синтаксис команд.

Обратитесь к разделу изменений команд выше для конкретных необходимых обновлений.

Устранение Проблем Миграции

Распространенные проблемы и их решения

Миграция конфигурации не удалась

Симптомы:

  • Ошибка: Невозможно мигрировать конфигурацию
  • Файл конфигурации не найден

Решения:

  1. Убедитесь, что у вас есть права записи в директорию ~/.gemini
  2. Проверьте, существует ли старый файл конфигурации: ls ~/.gemini/
  3. Попробуйте ручную миграцию: gemini config migrate --force

Команды не работают после миграции

Симптомы:

  • Ошибки команда не найдена
  • Неожиданное поведение

Решения:

  1. Очистите кэш оболочки: hash -r
  2. Перезапустите сеанс терминала
  3. Проверьте новый синтаксис команд в документации

API ключ не работает

Симптомы:

  • Ошибки аутентификации
  • Сообщения о недействительном API ключе

Решения:

  1. Переустановите ваш API ключ: gemini config set api-key YOUR_KEY
  2. Проверьте правильность ключа: gemini config get api-key
  3. Проверьте разрешения API ключа в Google AI Studio

Инструкции по Откату

Как вернуться к предыдущей версии при необходимости

⚠️ Используйте откат только если вы столкнулись с критическими проблемами, препятствующими нормальной работе.

  1. 1
    Удалите текущую версию: npm uninstall -g @google/generative-ai-cli
  2. 2
    Установите предыдущую версию: npm install -g @google/generative-ai-cli@1.9.0
  3. 3
    Восстановите конфигурацию: cp ~/.gemini/config.json.backup ~/.gemini/config.json
  4. 4
    Проверьте откат: gemini --version

Шаги После Миграции

Рекомендуемые действия после успешной миграции

Обновить Документацию

Средний

Обновите любую внутреннюю документацию или руководства команды, чтобы отразить новый синтаксис команд.

Протестировать Скрипты Автоматизации

Высокий

Запустите ваши автоматизированные скрипты и CI/CD пайплайны, чтобы убедиться, что они работают с новой версией.

Изучить Новые Функции

Низкий

Ознакомьтесь с новыми функциями и улучшениями в v2.0.0.

Узнать больше

Очистить Резервные Копии

Низкий

После подтверждения, что все работает, вы можете удалить файлы резервных копий.

Нужна Помощь с Миграцией?

Если вы столкнулись с проблемами во время миграции, наше сообщество готово помочь.

Получить ПоддержкуПосмотреть Руководство по Устранению Проблем