आपके नेटवर्क में एक कंटेनर और एक PostgreSQL डेटाबेस, और आप Unico से जुड़ जाते हैं।
आवश्यकताएँ
| आवश्यकता | विवरण |
|---|---|
| कंटेनर रनटाइम | Docker, Docker Compose या Kubernetes। इमेज linux/amd64 और linux/arm64 के लिए बनी है और non-root के रूप में चलती है |
| PostgreSQL | संस्करण 16 या बाद का। केवल Human Plugin द्वारा उपयोग किया जाने वाला डेटाबेस, जो यूज़र और पासवर्ड से पहुँच योग्य हो। SSL डिफ़ॉल्ट रूप से आवश्यक है |
| आउटबाउंड HTTPS | Unico तक। देखें नेटवर्किंग और सुरक्षा |
| इनबाउंड | पोर्ट 8080, सादा HTTP, केवल आपके बैक-एंड से |
| सीक्रेट | आपकी access key और डेटाबेस पासवर्ड |
हार्डवेयर आवश्यकताएँ
800 KB तक की सेल्फ़ी के साथ, प्रति मिनट 1,500 ट्रांज़ैक्शन तक Human Plugin चलाने के लिए न्यूनतम।
Human Plugin
| संसाधन | न्यूनतम |
|---|---|
| CPU | प्रति रेप्लिका 1 vCPU |
| मेमोरी | प्रति रेप्लिका 1 GB |
अधिक वॉल्यूम के लिए, हर 1,500 ट्रांज़ैक्शन प्रति मिनट पर एक रेप्लिका जोड़ें। हम एक से अधिक रेप्लिका चलाने का भी सुझाव देते हैं, ताकि एक के रीस्टार्ट होने पर भी Human Plugin उपलब्ध रहे।
PostgreSQL
| संसाधन | न्यूनतम |
|---|---|
| संस्करण | 16 |
| CPU | 2 vCPU |
| मेमोरी | 4 GB |
| डिस्क | SSD |
डिस्क स्पेस का अनुमान लगाने के लिए, प्रति प्रोसेस लगभग 1.7 KB × प्रतिदिन प्रोसेस × रखे जाने वाले दिन गिनें, और उसमें 30% जोड़ें।
नेटवर्क
Unico तक आउटबाउंड HTTPS (पोर्ट 443)। देखें नेटवर्किंग और सुरक्षा।
इमेज
Human Plugin pkg.unico.run/human-plugin-api:latest के रूप में प्रकाशित है। हमेशा latest टैग चलाएँ, जो वर्तमान रिलीज़ है। इसे उन रजिस्ट्री क्रेडेंशियल (यूज़रनेम और टोकन) से pull करें जो Unico आ पको देता है। देखें पूर्वापेक्षाएँ और एक्सेस।
डिप्लॉयमेंट का क्रम
- समर्पित डेटाबेस और Human Plugin के लिए एक रोल बनाएँ।
- अपने सीक्रेट स्टोर के सीक्रेट के साथ कॉन्फ़िगरेशन सेट करें।
- कम से कम 60 सेकंड के स्टॉप टाइमआउट के साथ Docker Compose या Kubernetes से कंटेनर शुरू करें।
- ट्रैफ़िक रूट करने से पहले
GET /health/readyके200देने की प्रतीक्षा करें। देखें हेल्थ और मॉनिटरिंग। - एक्सेस को अपने बैक-एंड तक सीमित करें। देखें नेटवर्किंग और सुरक्षा।
- इसके विरुद ्ध क्विकस्टार्ट का create अनुरोध चलाएँ।
स्टार्टअप पर क्या होता है
Human Plugin एट्रिब्यूट कैटलॉग डाउनलोड करता है, PostgreSQL से जुड़ता है और अपनी टेबल तैयार करता है, फिर पोर्ट खोलता है। सुनने से पहले ही यह त्रुटि के साथ रुक जाता है, जब:
- कोई आवश्यक सेटिंग गायब या अमान्य हो;
- एट्रिब्यूट कैटलॉग डाउनलोड न हो सके;
- PostgreSQL तक पहुँचा न जा सके, या रोल टेबल न बना सके।
लॉग में कारण बताया जाता है। देखें समस्या निवारण।
कई इंस्टेंस
Human Plugin मेमोरी में कोई अनुरोध स्थिति नहीं रखता, इसलिए कई कंटेनर एक डेटाबेस साझा कर सकते हैं। जो कंटेनर एक ही समय पर शुरू होते हैं वे डेटाबेस के ज़रिए समन्वय करते हैं, इसलिए आप रेप्लिका को एक साथ रोलआउट कर सकते हैं।
प्रोडक्शन में जाना
- स्टॉप टाइमआउट 60 सेकंड या उससे अधिक रखें।
- ट्रैफ़िक किसी कंटेनर को तभी रूट करें जब
/health/ready200दे। - Human Plugin को अपने निजी नेटवर्क के बाहर कभी उजागर न करें।
- डेटाबेस का बैकअप लें: इसमें आपकी intelligence है। देखें संचालन।