GitHub असीमित सार्वजनिक रिपॉजिटरी और उदार निजी रिपॉजिटरी स्टोरेज प्रदान करता है, जो इसे आपके ट्रैकिंग डेटा के संस्करण-नियंत्रित बैकअप के लिए एक उत्कृष्ट विकल्प बनाता है। यह गाइड आपको स्क्रीनशॉट, HTML आर्काइव, और कार्य डेटा को पूर्ण संस्करण इतिहास के साथ संग्रहीत करने के लिए GitHub एकीकरण स्थापित करने में मदद करेगी।
🔧 डेवलपर-अनुकूल भंडारण
डेवलपर्स और तकनीकी उपयोगकर्ताओं के लिए एकदम सही है जो अपने ट्रैकिंग डेटा के साथ संस्करण-नियंत्रित बैकअप, इश्यू ट्रैकिंग इंटीग्रेशन, और शक्तिशाली सहयोग सुविधाएँ चाहते हैं।
पूर्वापेक्षाएँ
GitHub एकीकरण सेट अप करने से पहले, सुनिश्चित करें कि आपके पास है:
- GitHub खाता: मुफ़्त या सशुल्क GitHub खाता
- रिपॉजिटरी: ट्रैकिंग डेटा के लिए समर्पित रिपॉजिटरी
- पर्सनल एक्सेस टोकन: रिपो परमिशन के साथ फाइन-ग्रेन या क्लासिक टोकन
- रिपॉजिटरी एक्सेस: टारगेट रिपॉजिटरी में पुश परमिशन
चरण 1: एक समर्पित रिपॉजिटरी बनाएँ
रिपॉजिटरी सेटअप
- रिपॉजिटरी बनाएँ: github.com → नई रिपॉजिटरी पर जाएँ
- रिपॉजिटरी का नाम: trackr-bot-data (या आपका पसंदीदा नाम)
- दृश्यता: संवेदनशील डेटा के लिए निजी चुनें, खुली साझाकरण के लिए सार्वजनिक चुनें
- इनिशियलाइज़ करें: README.md और .gitignore जोड़ें
- लाइसेंस: यदि सार्वजनिक कर रहे हैं तो उपयुक्त लाइसेंस चुनें
रिपॉजिटरी संरचना
डेटा ट्रैकिंग के लिए अनुशंसित फ़ोल्डर संरचना:
trackr-bot-data/
├── README.md
├── .gitignore
├── screenshots/
│ └── YYYY/MM/DD/
├── html-archives/
│ └── YYYY/MM/DD/
├── task-data/
│ └── YYYY/MM/DD/
└── logs/
└── upload-history.md
चरण 2: पर्सनल एक्सेस टोकन बनाएँ
फाइन-ग्रेन टोकन जेनरेट करें (अनुशंसित)
- GitHub सेटिंग्स: सेटिंग्स → डेवलपर सेटिंग्स पर जाएँ
- पर्सनल एक्सेस टोकन: "फाइन-ग्रेन टोकन" पर क्लिक करें
- टोकन उत्पन्न करें: "Generate new token" पर क्लिक करें
- रिपॉजिटरी एक्सेस: अपना ट्रैकिंग डेटा रिपॉजिटरी चुनें
- अनुमति: "सामग्री" और "मेटाडेटा" के लिए पढ़ने/लिखने की अनुमति दें
- समाप्ति: उपयुक्त समाप्ति सेट करें (90 दिनों की अनुशंसा की जाती है)
- टोकन सहेजें: उत्पन्न किए गए टोकन को कॉपी करें और सुरक्षित रूप से संग्रहीत करें
🔐 टोकन सुरक्षा सर्वोत्तम प्रथाएँ
- क्लासिक टोकन के बजाय न्यूनतम दायरे वाले फाइन-ग्रेन टोकन का उपयोग करें
- उचित समाप्ति तिथियाँ निर्धारित करें और टोकन को नियमित रूप से घुमाएँ
- कोड, दस्तावेज़ीकरण, या सार्वजनिक चैनलों में टोकन कभी साझा न करें
- GitHub के ऑडिट लॉग में टोकन उपयोग की निगरानी करें
- यदि टोकन समझौता हो जाए तो उन्हें तुरंत रद्द करें
वैकल्पिक: क्लासिक पर्सनल एक्सेस टोकन
यदि आपके खाते के लिए फाइन-ग्रेन टोकन उपलब्ध नहीं हैं:
- क्लासिक टोकन: "Personal access tokens (classic)" पर जाएँ
- टोकन जेनरेट करें: "Generate new token (classic)" पर क्लिक करें
- स्कोप: पूरी रिपॉजिटरी एक्सेस के लिए "repo" चुनें
- नोट: एक वर्णनात्मक नोट जोड़ें (जैसे, "Trackr डेटा अपलोड")
चरण 3: GitHub अपलोड चैनल कॉन्फ़िगर करें
Trackr डैशबोर्ड में
- अपलोड चैनलों पर जाएँ: अपने अपलोड चैनलों पर जाएँ
- नया चैनल जोड़ें: "Add New Channel" पर क्लिक करें
- GitHub चुनें: प्रदाता विकल्पों में से "GitHub" चुनें
आवश्यक कॉन्फ़िगरेशन फ़ील्ड
रिपॉजिटरी सेटिंग्स
- चैनल का नाम: चैनल के लिए वर्णनात्मक नाम
- रिपॉजिटरी का मालिक: GitHub उपयोगकर्ता नाम या संगठन
- रिपॉजिटरी का नाम: आपकी डेटा रिपॉजिटरी का नाम
- शाखा: लक्ष्य शाखा (आमतौर पर "मुख्य" या "मास्टर")
प्रमाणीकरण
- पर्सनल एक्सेस टोकन: आपके द्वारा जेनरेट किया गया टोकन
- कमिटर का नाम: git कमिट के लिए नाम (वैकल्पिक)
- कमिटर ईमेल: git कमिट्स के लिए ईमेल (वैकल्पिक)
चरण 4: कॉन्फ़िगरेशन का परीक्षण और सत्यापन करें
- अपलोड परीक्षण: चैनल सेटअप में "कॉन्फ़िगरेशन परीक्षण करें" पर क्लिक करें
- रिपॉजिटरी जांचें: सत्यापित करें कि परीक्षण फ़ाइल आपकी GitHub रिपॉजिटरी में दिखाई दे रही है
- कमिट इतिहास: जांचें कि कमिट्स ठीक से श्रेयबद्ध हैं
- कॉन्फ़िगरेशन सहेजें: यदि परीक्षण सफल हो, तो चैनल सहेजें
उन्नत गिटहब सुविधाएँ
संस्करण नियंत्रण के लाभ
- पूर्ण इतिहास: प्रत्येक अपलोड एक git commit होता है जिसमें टाइमस्टैम्प होते हैं
- डिफ ट्रैकिंग: समय के साथ आपके डेटा में वास्तव में क्या बदलाव हुआ, देखें
- शाखाकरण: विभिन्न ट्रैकिंग वातावरणों के लिए शाखाएँ बनाएँ
- रोलबैक: अपने डेटा के पिछले संस्करणों पर आसानी से वापस जाएँ
सहयोग सुविधाएँ
- टीम एक्सेस: टीम के सदस्यों को रिपॉजिटरी एक्सेस प्रदान करें
- इश्यूज़: अपने डेटा से संबंधित समस्याओं या अनुरोधों को ट्रैक करें
- पुल रिक्वेस्ट: डेटा परिवर्तनों की समीक्षा करें और उन्हें अनुमोदित करें
- संगठन: संगठन के अंतर्गत कई रिपॉजिटरी प्रबंधित करें
स्वचालन एकीकरण
- GitHub Actions: अपलोड किए गए डेटा की प्रक्रिया को स्वचालित करें
- वेबहूक्स: डेटा अपलोड पर बाहरी सेवाओं को ट्रिगर करें
- एपीआई एकीकरण: GitHub की एपीआई का उपयोग करके कस्टम टूल बनाएं
- तृतीय-पक्ष ऐप्स: प्रोजेक्ट मैनेजमेंट टूल्स से कनेक्ट करें
🔄 स्वचालन विचार
- अपलोड किए गए स्क्रीनशॉट को प्रोसेस करने के लिए GitHub Actions सेट अप करें
- GitHub Pages का उपयोग करके ट्रैकिंग डेटा से स्वचालित रिपोर्ट बनाएं
- जब नया डेटा अपलोड हो तो सूचना भेजें
- वेबहूक्स के माध्यम से प्रोजेक्ट मैनेजमेंट टूल्स के साथ एकीकृत करें
- GitHub API का उपयोग करके कस्टम डैशबोर्ड बनाएं
फ़ाइल संगठन और कमिट्स
स्वचालित फ़ाइल संगठन
Trackr इस संरचना के साथ फ़ाइलों को व्यवस्थित करता है:
Repository Root/
├── screenshots/
│ └── 2025/01/25/task-123-screenshot-143022.png
├── html-archives/
│ └── 2025/01/25/task-123-archive-143022.html
├── task-data/
│ └── 2025/01/25/task-123-data-143022.json
└── logs/
└── 2025-01-25-uploads.md
कमिट संदेश
स्वचालित कमिट संदेशों में शामिल हैं:
- कार्य जानकारी: कार्य आईडी और नाम
- फ़ाइल का प्रकार: स्क्रीनशॉट, HTML आर्काइव, या डेटा फ़ाइल
- टाइमस्टैम्प: डेटा कब एकत्र किया गया था
- परिवर्तन सारांश: क्या अपलोड किया गया था इसका संक्षिप्त विवरण
भंडारण सीमाएँ और मूल्य निर्धारण
GitHub भंडारण सीमाएँ
- रिपॉजिटरी का आकार: 1GB की सॉफ़्ट सीमा, 100GB की हार्ड सीमा
- फ़ाइल का आकार: 100MB प्रति फ़ाइल (बड़ी फ़ाइलों के लिए Git LFS का उपयोग करें)
- सार्वजनिक रिपॉजिटरी: मुफ्त खातों के लिए असीमित
- निजी रिपॉजिटरी: उदार सीमाएँ, अधिक के लिए सशुल्क योजनाएँ
बड़ी फ़ाइलों के लिए गिट एलएफएस
कई बड़े स्क्रीनशॉट वाली रिपॉजिटरीज़ के लिए:
- LFS सक्षम करें: मुख्य रिपॉजिटरी के बाहर बड़ी फ़ाइलों को ट्रैक करें
- भंडारण कोटा: 1GB मुफ्त, अतिरिक्त भंडारण उपलब्ध
- बैंडविड्थ: 1GB मासिक ट्रांसफर सीमा
- फ़ाइल प्रकार: स्वचालित रूप से .png, .jpg, .html फ़ाइलों को ट्रैक करता है
सामान्य समस्याओं का निवारण
प्रमाणिकता विफलताएँ
- टोकन अनुमतियाँ: सुनिश्चित करें कि टोकन के पास "Contents" में लिखने की अनुमति हो
- रिपॉजिटरी एक्सेस: सत्यापित करें कि टोकन निर्दिष्ट रिपॉजिटरी तक पहुँच सकता है
- टोकन समाप्ति: जाँचें कि क्या टोकन समाप्त हो गया है
- संगठन नीतियाँ: कुछ संगठन टोकन उपयोग को प्रतिबंधित करते हैं
अपलोड विफलताएँ
- फ़ाइल का आकार: GitHub पर प्रति फ़ाइल 100MB की सीमा है
- रिपॉजिटरी सीमाएँ: जाँचें कि क्या रिपॉजिटरी आकार सीमाओं के करीब पहुँच रही है
- शाखा सुरक्षा: सत्यापित करें कि शाखा प्रत्यक्ष कमिट की अनुमति देती है
- नेटवर्क संबंधी समस्याएँ: अस्थायी कनेक्टिविटी समस्याएँ
कमिट संबंधी समस्याएँ
- कमिटर जानकारी: सुनिश्चित करें कि वैध नाम और ईमेल प्रदान किए गए हैं
- शाखा अनुमतियाँ: लक्ष्य शाखा में लिखने की अनुमति की जाँच करें
- मर्ज संघर्ष: एक साथ होने वाले अपलोड को उचित रूप से संभालें
⚠️ सुरक्षा संबंधी विचार
- व्यक्तिगत एक्सेस टोकन को सुरक्षित रखें और नियमित रूप से बदलें
- संवेदनशील ट्रैकिंग डेटा के लिए निजी रिपॉजिटरी का उपयोग करें
- रिपॉजिटरी एक्सेस अनुमतियों की नियमित रूप से समीक्षा करें
- उन्नत सुरक्षा सुविधाओं के लिए GitHub Enterprise का उपयोग करने पर विचार करें
- अप्रत्याशित कमिट्स के लिए रिपॉजिटरी गतिविधि की निगरानी करें
सर्वोत्तम प्रथाएँ
रिपॉजिटरी प्रबंधन
- नियमित सफ़ाई: पुराने डेटा को समय-समय पर संग्रहीत करें
- शाखा रणनीति: विभिन्न वातावरणों के लिए शाखाओं का उपयोग करें
- टैगिंग: अपने ट्रैकिंग डेटा में महत्वपूर्ण मील के पत्थर को टैग करें
- दस्तावेज़ीकरण: डेटा संरचना की जानकारी के साथ README बनाए रखें
सुरक्षा और पहुँच
- न्यूनतम अनुमतियाँ: केवल आवश्यक रिपॉजिटरी एक्सेस प्रदान करें
- टोकन रोटेशन: नियमित रूप से व्यक्तिगत एक्सेस टोकन अपडेट करें
- पहुँच समीक्षा: समय-समय पर समीक्षा करें कि किसके पास रिपॉजिटरी की पहुँच है
- ऑडिट लॉगिंग: रिपॉजिटरी गतिविधि लॉग्स की निगरानी करें
GitHub एकीकरण आपके ट्रैकिंग डेटा के लिए शक्तिशाली संस्करण नियंत्रण और सहयोग सुविधाएँ प्रदान करता है, जो इसे उन डेवलपर्स और टीमों के लिए आदर्श बनाता है जो व्यापक इतिहास ट्रैकिंग और उन्नत स्वचालन क्षमताओं की चाहत रखते हैं।
संस्करण-नियंत्रित डेटा भंडारण शुरू करें
अपने ट्रैकिंग डेटा को पूर्ण संस्करण इतिहास, सहयोग सुविधाओं, और शक्तिशाली स्वचालन क्षमताओं के साथ संग्रहीत करने के लिए GitHub एकीकरण सेट अप करें।
GitHub रिपॉजिटरी कनेक्ट करें
