माइग्रेशन गाइड
पुराने संस्करणों से नवीनतम Gemini CLI में अपग्रेड करें
माइग्रेशन अवलोकन
यह गाइड आपको Gemini CLI के पुराने संस्करणों से नवीनतम संस्करण में माइग्रेट करने में मदद करती है। हम ब्रेकिंग चेंज, कॉन्फ़िगरेशन अपडेट को कवर करेंगे और एक सुचारू संक्रमण के लिए चरणबद्ध निर्देश प्रदान करेंगे।
संस्करण संगतता मैट्रिक्स
जांचें कि कौन सा माइग्रेशन पथ आपके वर्तमान संस्करण पर लागू होता है
v2.0.0 में ब्रेकिंग चेंज
महत्वपूर्ण परिवर्तन जो आपके मौजूदा सेटअप को प्रभावित कर सकते हैं
कॉन्फ़िगरेशन फ़ाइल प्रारूप
बेहतर पठनीयता और टिप्पणी समर्थन के लिए कॉन्फ़िगरेशन फ़ाइल प्रारूप JSON से YAML में बदल गया है।
पहले (v1.x)
{
"api_key": "your-key",
"model": "gemini-pro"
}बाद में (v2.0)
api_key: your-key
model: gemini-pro
# अब टिप्पणियां समर्थित हैं!कमांड संरचना परिवर्तन
स्थिरता के लिए कुछ कमांड का नाम बदला गया है या पुनर्गठित किया गया है।
कमांड परिवर्तन
gemini chatgemini askgemini generategemini creategemini config showgemini config listAPI कुंजी प्रबंधन
API कुंजियां अब एन्क्रिप्शन के साथ अधिक सुरक्षित प्रारूप में संग्रहीत होती हैं।
आपकी मौजूदा API कुंजी पहली बार चलाने पर स्वचालित रूप से माइग्रेट हो जाएगी
चरणबद्ध माइग्रेशन
Gemini CLI v2.0.0 में माइग्रेट करने के लिए इन चरणों का पालन करें
अपनी कॉन्फ़िगरेशन का बैकअप लें
माइग्रेशन शुरू करने से पहले अपनी वर्तमान कॉन्फ़िगरेशन का बैकअप बनाएं।
कमांड:
gemini config list > gemini-config-backup.txtcp ~/.gemini/config.json ~/.gemini/config.json.backupयह सुनिश्चित करता है कि आप आवश्यकता पड़ने पर अपनी सेटिंग्स को पुनर्स्थापित कर सकें।
Gemini CLI अपडेट करें
Gemini CLI का नवीनतम संस्करण इंस्टॉल करें।
कमांड:
npm update -g @google/generative-ai-cliसत्यापन:
gemini --versionमाइग्रेशन टूल चलाएं
अपनी कॉन्फ़िगरेशन को अपडेट करने के लिए अंतर्निहित माइग्रेशन टूल का उपयोग करें।
कमांड:
gemini config migrateयह स्वचालित रूप से आपकी कॉन्फ़िगरेशन को नए प्रारूप में परिवर्तित कर देगा।
कॉन्फ़िगरेशन सत्यापित करें
जांचें कि आपकी कॉन्फ़िगरेशन सही तरीके से माइग्रेट हो गई है।
कमांड:
gemini config listgemini ask "नमस्ते, माइग्रेशन परीक्षण"सुनिश्चित करें कि आपकी सभी सेटिंग्स संरक्षित हैं और CLI अपेक्षित रूप से काम कर रहा है।
स्क्रिप्ट और उपनाम अपडेट करें
पुराने कमांड सिंटैक्स का उपयोग करने वाली किसी भी स्क्रिप्ट या उपनाम को अपडेट करें।
आवश्यक विशिष्ट अपडेट के लिए ऊपर कमांड परिवर्तन अनुभाग देखें।
माइग्रेशन समस्या निवारण
सामान्य समस्याएं और उनके समाधान
कॉन्फ़िगरेशन माइग्रेशन विफल
लक्षण:
- त्रुटि: कॉन्फ़िगरेशन माइग्रेट करने में असमर्थ
- कॉन्फ़िग फ़ाइल नहीं मिली
समाधान:
- सुनिश्चित करें कि आपके पास ~/.gemini डायरेक्टरी में लिखने की अनुमति है
- जांचें कि पुरानी कॉन्फ़िग फ़ाइल मौजूद है: ls ~/.gemini/
- मैन्युअल माइग्रेशन का प्रयास करें: gemini config migrate --force
माइग्रेशन के बाद कमांड काम नहीं कर रहे
लक्षण:
- कमांड नहीं मिला त्रुटियां
- अप्रत्याशित व्यवहार
समाधान:
- अपना shell कैश साफ़ करें: hash -r
- अपना टर्मिनल सेशन पुनः आरंभ करें
- दस्तावेज़ीकरण में नया कमांड सिंटैक्स जांचें
API कुंजी काम नहीं कर रही
लक्षण:
- प्रमाणीकरण त्रुटियां
- अमान्य API कुंजी संदेश
समाधान:
- अपनी API कुंजी पुनः सेट करें: gemini config set api-key YOUR_KEY
- सत्यापित करें कि कुंजी सही है: gemini config get api-key
- Google AI Studio में API कुंजी अनुमतियां जांचें
रोलबैक निर्देश
आवश्यकता पड़ने पर पिछले संस्करण पर वापस कैसे जाएं
⚠️ केवल तभी रोलबैक का उपयोग करें जब आपको गंभीर समस्याएं आएं जो सामान्य संचालन को रोकती हों।
- 1
वर्तमान संस्करण अनइंस्टॉल करें: npm uninstall -g @google/generative-ai-cli - 2
पिछला संस्करण इंस्टॉल करें: npm install -g @google/generative-ai-cli@1.9.0 - 3
कॉन्फ़िगरेशन पुनर्स्थापित करें: cp ~/.gemini/config.json.backup ~/.gemini/config.json - 4
रोलबैक सत्यापित करें: gemini --version
माइग्रेशन के बाद के चरण
सफल माइग्रेशन के बाद अनुशंसित कार्य
दस्तावेज़ीकरण अपडेट करें
मध्यमनए कमांड सिंटैक्स को दर्शाने के लिए किसी भी आंतरिक दस्तावेज़ीकरण या टीम गाइड को अपडेट करें।
स्वचालन स्क्रिप्ट परीक्षण करें
उच्चअपनी स्वचालित स्क्रिप्ट और CI/CD पाइपलाइन चलाएं यह सुनिश्चित करने के लिए कि वे नए संस्करण के साथ काम करती हैं।
बैकअप साफ़ करें
कमसब कुछ काम करने की पुष्टि के बाद, आप बैकअप फ़ाइलों को हटा सकते हैं।
माइग्रेशन में मदद चाहिए?
यदि आपको माइग्रेशन के दौरान कोई समस्या आती है, तो हमारा समुदाय मदद के लिए यहां है।