run-gemini-cli

अवलोकन

run-gemini-cli एक GitHub Action है जो Gemini CLI के माध्यम से Gemini को आपके डेवलपमेंट वर्कफ़्लो में एकीकृत करता है। यह महत्वपूर्ण नियमित कोडिंग कार्यों के लिए एक स्वायत्त एजेंट और एक ऑन-डिमांड सहयोगी दोनों के रूप में कार्य करता है, जिसे आप तुरंत काम सौंप सकते हैं।

इसका उपयोग GitHub पुल रिक्वेस्ट समीक्षा करने, इश्यू को ट्रायेज करने, कोड विश्लेषण और संशोधन करने और बहुत कुछ करने के लिए Gemini के साथ संवादात्मक रूप से (जैसे, @gemini-cli fix this issue) सीधे आपके GitHub रिपॉजिटरी के अंदर करें।

• run-gemini-cli
  • अवलोकन
  • विशेषताएं
  • त्वरित प्रारंभ
    • 1. Gemini API कुंजी प्राप्त करें
    • 2. इसे GitHub Secret के रूप में जोड़ें
    • 3. अपनी .gitignore अपडेट करें
    • 4. एक वर्कफ़्लो चुनें
    • 5. इसे आज़माएं!
  • वर्कफ़्लो
    • Gemini Dispatch
    • Issue Triage
    • Pull Request Review
    • Gemini CLI Assistant
  • कॉन्फ़िगरेशन
    • इनपुट
    • आउटपुट
    • रिपॉजिटरी वेरिएबल्स
    • सीक्रेट्स
  • प्रमाणीकरण
    • Google प्रमाणीकरण
    • GitHub प्रमाणीकरण
  • अवलोकनीयता
  • एक्सटेंशन
  • सर्वोत्तम अभ्यास
  • अनुकूलन
  • योगदान

विशेषताएं

• स्वचालन: ईवेंट (जैसे इश्यू खोलना) या शेड्यूल (जैसे रात्रिकालीन) के आधार पर वर्कफ़्लो को ट्रिगर करें।
• ऑन-डिमांड सहयोग: Gemini CLI का उल्लेख करके (जैसे, @gemini-cli /review) इश्यू और पुल रिक्वेस्ट टिप्पणियों में वर्कफ़्लो ट्रिगर करें।
• उपकरणों के साथ विस्तार योग्य: GitHub CLI (gh) जैसे अन्य CLI के साथ इंटरैक्ट करने के लिए Gemini मॉडल की टूल-कॉलिंग क्षमताओं का लाभ उठाएं।
• अनुकूलन योग्य: Gemini CLI को प्रोजेक्ट-विशिष्ट निर्देश और संदर्भ प्रदान करने के लिए अपने रिपॉजिटरी में GEMINI.md फ़ाइल का उपयोग करें।

त्वरित प्रारंभ

बस कुछ मिनटों में अपने रिपॉजिटरी में Gemini CLI के साथ शुरुआत करें:

1. Gemini API कुंजी प्राप्त करें

Google AI Studio से अपनी API कुंजी प्राप्त करें, जिसमें उदार निःशुल्क कोटा है।

2. इसे GitHub Secret के रूप में जोड़ें

अपनी API कुंजी को अपने रिपॉजिटरी में GEMINI_API_KEY नामक सीक्रेट के रूप में संग्रहित करें:

• अपने रिपॉजिटरी के Settings > Secrets and variables > Actions पर जाएं
• New repository secret पर क्लिक करें
• नाम: GEMINI_API_KEY, मान: आपकी API कुंजी

3. अपनी .gitignore अपडेट करें

अपनी .gitignore फ़ाइल में निम्नलिखित प्रविष्टियाँ जोड़ें:

# gemini-cli सेटिंग्स
.gemini/

# GitHub App क्रेडेंशियल्स
gha-creds-*.json

4. एक वर्कफ़्लो चुनें

वर्कफ़्लो सेट करने के लिए आपके पास दो विकल्प हैं:

विकल्प A: सेटअप कमांड का उपयोग करें (अनुशंसित)

1. अपने टर्मिनल में Gemini CLI शुरू करें:

   root@kitploit:~

   gemini
   

2. अपने टर्मिनल में Gemini CLI में टाइप करें:

   root@kitploit:~

   /setup-github
   

विकल्प B: मैन्युअल रूप से वर्कफ़्लो कॉपी करें

1. examples/workflows निर्देशिका से पूर्व-निर्मित वर्कफ़्लो को अपने रिपॉजिटरी की .github/workflows निर्देशिका में कॉपी करें। ध्यान दें: gemini-dispatch.yml वर्कफ़्लो को भी कॉपी किया जाना चाहिए, जो वर्कफ़्लो को चलाने के लिए ट्रिगर करता है।

5. इसे आज़माएं!

Pull Request समीक्षा:

• अपने रिपॉजिटरी में एक पुल रिक्वेस्ट खोलें और स्वचालित समीक्षा की प्रतीक्षा करें
• मैन्युअल रूप से समीक्षा ट्रिगर करने के लिए किसी मौजूदा पुल रिक्वेस्ट पर @gemini-cli /review टिप्पणी करें

Issue Triage:

• एक इश्यू खोलें और स्वचालित ट्रायेज की प्रतीक्षा करें
• मैन्युअल रूप से ट्रायेजिंग ट्रिगर करने के लिए मौजूदा इश्यू पर @gemini-cli /triage टिप्पणी करें

सामान्य AI सहायता:

• किसी भी इश्यू या पुल रिक्वेस्ट में, अपने अनुरोध के बाद @gemini-cli का उल्लेख करें
• उदाहरण:
  • @gemini-cli explain this code change
  • @gemini-cli suggest improvements for this function
  • @gemini-cli help me debug this error
  • @gemini-cli write unit tests for this component

वर्कफ़्लो

यह क्रिया विभिन्न उपयोग मामलों के लिए कई पूर्व-निर्मित वर्कफ़्लो प्रदान करती है। प्रत्येक वर्कफ़्लो को आपके रिपॉजिटरी की .github/workflows निर्देशिका में कॉपी करने और आवश्यकतानुसार अनुकूलित करने के लिए डिज़ाइन किया गया है।

Gemini Dispatch

यह वर्कफ़्लो Gemini CLI के लिए एक केंद्रीय डिस्पैचर के रूप में कार्य करता है, ट्रिगरिंग ईवेंट और टिप्पणी में प्रदान किए गए कमांड के आधार पर अनुरोधों को उपयुक्त वर्कफ़्लो पर रूट करता है। डिस्पैच वर्कफ़्लो सेट करने के विस्तृत गाइड के लिए, Gemini Dispatch वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Issue Triage

इस क्रिया का उपयोग GitHub इश्यू को स्वचालित रूप से या एक शेड्यूल पर ट्रायेज करने के लिए किया जा सकता है। इश्यू ट्रायेज सिस्टम सेट करने के विस्तृत गाइड के लिए, GitHub Issue Triage वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Pull Request Review

इस क्रिया का उपयोग पुल रिक्वेस्ट खोले जाने पर स्वचालित रूप से समीक्षा करने के लिए किया जा सकता है। पुल रिक्वेस्ट समीक्षा प्रणाली सेट करने के विस्तृत गाइड के लिए, GitHub PR Review वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

Gemini CLI Assistant

इस प्रकार की क्रिया का उपयोग पुल रिक्वेस्ट और इश्यू के भीतर एक सामान्य-उद्देश्यीय, संवादात्मक Gemini AI सहायक को आमंत्रित करने के लिए किया जा सकता है ताकि विभिन्न प्रकार के कार्य किए जा सकें। सामान्य-उद्देश्यीय Gemini CLI वर्कफ़्लो सेट करने के विस्तृत गाइड के लिए, Gemini Assistant वर्कफ़्लो दस्तावेज़ीकरण पर जाएं।

कॉन्फ़िगरेशन

इनपुट

• gcp_location: (वैकल्पिक) Google Cloud स्थान।

• gcp_project_id: (वैकल्पिक) Google Cloud प्रोजेक्ट ID।

• gcp_service_account: (वैकल्पिक) Google Cloud सेवा खाता ईमेल।

• gcp_workload_identity_provider: (वैकल्पिक) Google Cloud Workload Identity प्रदाता।

• gcp_token_format: (वैकल्पिक, डिफ़ॉल्ट: access_token) प्रमाणीकरण के लिए टोकन प्रारूप। एक्सेस टोकन उत्पन्न करने के लिए "access_token" पर सेट करें (सेवा खाता आवश्यक है), या प्रत्यक्ष WIF के लिए खाली स्ट्रिंग पर सेट करें। "access_token" या "id_token" हो सकता है।

• gcp_access_token_scopes: (वैकल्पिक, डिफ़ॉल्ट: https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile) token_format "access_token" का उपयोग करते समय एक्सेस टोकन स्कोप। OAuth 2.0 स्कोप की अल्पविराम से अलग की गई सूची।

आउटपुट

• summary: Gemini CLI निष्पादन से सारांशित आउटपुट।

• error: Gemini CLI निष्पादन से त्रुटि आउटपुट, यदि कोई हो।

रिपॉजिटरी वेरिएबल्स

हम निम्नलिखित मानों को रिपॉजिटरी वेरिएबल्स के रूप में सेट करने की अनुशंसा करते हैं ताकि उन्हें सभी वर्कफ़्लो में पुन: उपयोग किया जा सके। वैकल्पिक रूप से, आप उन्हें अलग-अलग वर्कफ़्लो में या रिपॉजिटरी-स्तरीय मानों को ओवरराइड करने के लिए एक्शन इनपुट के रूप में इनलाइन सेट कर सकते हैं।

[!चेतावनी] DEBUG पर्यावरण चर का उपयोग न करें क्योंकि यह Gemini CLI को नोड डीबगर के अटैच होने की प्रतीक्षा में लटका देता है।

रिपॉजिटरी वेरिएबल जोड़ने के लिए:

1. अपने रिपॉजिटरी के Settings > Secrets and variables > Actions > New variable पर जाएं।
2. वेरिएबल का नाम और मान दर्ज करें।
3. सहेजें।

रिपॉजिटरी वेरिएबल्स के विवरण के लिए, वेरिएबल्स पर GitHub दस्तावेज़ीकरण देखें।

सीक्रेट्स

आप अपने रिपॉजिटरी में निम्नलिखित सीक्रेट सेट कर सकते हैं:

सीक्रेट जोड़ने के लिए:

1. अपने रिपॉजिटरी के Settings > Secrets and variables >Actions > New repository secret पर जाएं।
2. सीक्रेट का नाम और मान दर्ज करें।
3. सहेजें।

अधिक जानकारी के लिए, एन्क्रिप्टेड सीक्रेट बनाने और उपयोग करने पर आधिकारिक GitHub दस्तावेज़ीकरण देखें।

प्रमाणीकरण

इस क्रिया के लिए Google सेवाओं (Gemini AI के लिए) और GitHub API दोनों में प्रमाणीकरण की आवश्यकता है।

Google प्रमाणीकरण

अपने उपयोग के मामले में सबसे उपयुक्त प्रमाणीकरण विधि चुनें:

1. Gemini API कुंजी: उन परियोजनाओं के लिए सबसे सरल विधि जिन्हें Google Cloud एकीकरण की आवश्यकता नहीं है
2. Workload Identity Federation: Google Cloud सेवाओं में प्रमाणीकरण के लिए सबसे सुरक्षित विधि

GitHub प्रमाणीकरण

आप GitHub में दो तरीकों से प्रमाणित कर सकते हैं:

1. डिफ़ॉल्ट GITHUB_TOKEN: सरल उपयोग मामलों के लिए, क्रिया वर्कफ़्लो द्वारा प्रदान किए गए डिफ़ॉल्ट GITHUB_TOKEN का उपयोग कर सकती है।
2. कस्टम GitHub App (अनुशंसित): सबसे सुरक्षित और लचीले प्रमाणीकरण के लिए, हम एक कस्टम GitHub App बनाने की अनुशंसा करते हैं।

Google और GitHub दोनों प्रमाणीकरण के लिए विस्तृत सेटअप निर्देशों के लिए, प्रमाणीकरण दस्तावेज़ीकरण पर जाएं।

अवलोकनीयता

इस क्रिया को आपके अपने Google Cloud प्रोजेक्ट में टेलीमेट्री डेटा (ट्रेस, मीट्रिक और लॉग) भेजने के लिए कॉन्फ़िगर किया जा सकता है। यह आपको अपने वर्कफ़्लो में Gemini CLI के प्रदर्शन और व्यवहार की निगरानी करने की अनुमति देता है, जो डीबगिंग और ऑप्टिमाइज़ेशन के लिए मूल्यवान अंतर्दृष्टि प्रदान करता है।

अवलोकनीयता सेट करने और कॉन्फ़िगर करने के विस्तृत निर्देशों के लिए, अवलोकनीयता दस्तावेज़ीकरण पर जाएं।

एक्सटेंशन

Gemini CLI को एक्सटेंशन के माध्यम से अतिरिक्त कार्यक्षमता के साथ बढ़ाया जा सकता है। ये एक्सटेंशन उनके GitHub रिपॉजिटरी से स्रोत से स्थापित किए जाते हैं।

एक्सटेंशन सेट करने और कॉन्फ़िगर करने के विस्तृत निर्देशों के लिए, एक्सटेंशन दस्तावेज़ीकरण पर जाएं।

सर्वोत्तम अभ्यास

अपने स्वचालित वर्कफ़्लो की सुरक्षा, विश्वसनीयता और दक्षता सुनिश्चित करने के लिए, हम दृढ़ता से हमारे सर्वोत्तम अभ्यासों का पालन करने की अनुशंसा करते हैं। ये दिशानिर्देश रिपॉजिटरी सुरक्षा, वर्कफ़्लो कॉन्फ़िगरेशन और निगरानी जैसे प्रमुख क्षेत्रों को कवर करते हैं।

मुख्य अनुशंसाओं में शामिल हैं:

• अपने रिपॉजिटरी को सुरक्षित करना: ब्रांच और टैग सुरक्षा लागू करना, और पुल रिक्वेस्ट स्वीकर्ताओं को प्रतिबंधित करना।
• वर्कफ़्लो कॉन्फ़िगरेशन: Google Cloud में सुरक्षित प्रमाणीकरण के लिए Workload Identity Federation का उपयोग करना, सीक्रेट को प्रभावी ढंग से प्रबंधित करना, और अप्रत्याशित परिवर्तनों को रोकने के लिए एक्शन संस्करणों को पिन करना।
• निगरानी और ऑडिटिंग: नियमित रूप से एक्शन लॉग की समीक्षा करना और प्रदर्शन और व्यवहार में गहरी अंतर्दृष्टि के लिए OpenTelemetry को सक्षम करना।

अपने रिपॉजिटरी और वर्कफ़्लो को सुरक्षित करने के व्यापक गाइड के लिए, कृपया हमारा सर्वोत्तम अभ्यास दस्तावेज़ीकरण देखें।

अनुकूलन

Gemini CLI को प्रोजेक्ट-विशिष्ट संदर्भ और निर्देश प्रदान करने के लिए अपने रिपॉजिटरी की रूट में एक GEMINI.md फ़ाइल बनाएं। यह कोडिंग कन्वेंशन, आर्किटेक्चरल पैटर्न, या अन्य दिशानिर्देशों को परिभाषित करने के लिए उपयोगी है जिनका मॉडल को किसी दिए गए रिपॉजिटरी के लिए पालन करना चाहिए।

योगदान

योगदान का स्वागत है! शुरुआत करने के तरीके के बारे में अधिक जानकारी के लिए Gemini CLI योगदान गाइड देखें।