移行ガイド

古いバージョンから最新の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. Google AI StudioでAPIキーの権限を確認

ロールバック手順

必要に応じて以前のバージョンに戻す方法

⚠️ 通常の動作を妨げる重大な問題が発生した場合のみロールバックを使用してください。

  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の新機能と改善点をチェックしてください。

詳細を見る

バックアップのクリーンアップ

低

すべてが正常に動作することを確認した後、バックアップファイルを削除できます。

移行でお困りですか？

移行中に問題が発生した場合、コミュニティがサポートします。

サポートを受けるトラブルシューティングガイドを見る