प्रौद्योगिकी पृष्ठभूमि
🔧 NOCOBASE IMPLEMENTATION GUIDE

कार्यक्रम कार्यान्वयनकर्ता की मार्गदर्शिका व्यावहारिक रूप से परिनियोजन और विन्यास

स्थिर सिस्टम संचालन सुनिश्चित करने के लिए NocoBase की तैनाती और कॉन्फ़िगरेशन को शीघ्रता से पूरा करें।

तैनाती से पूर्व तैयारीपर्यावरणीय निरीक्षण और योजना

तीन तैनाती विधियाँडॉकर कम्पोज, डॉकरफाइल, स्रोत कोड इंस्टॉलेशन

मूल विन्याससिस्टम सेटिंग्स और समस्या निवारण

📋 परिनियोजन तैयारी 🚀 परिनियोजन विधियाँ ⚙️ बुनियादी विन्यास 🔧 समस्या समाधान

📋 परिनियोजन से पूर्व तैयारी

सुचारू रूप से परिनियोजन सुनिश्चित करने के लिए पर्यावरणीय निरीक्षण और योजना

हार्डवेयर और नेटवर्क आवश्यकताएँ

न्यूनतम सिस्टम आवश्यकताएँ (परीक्षण वातावरण)

  • सीपीयू: डुअल-कोर
  • मेमोरी: 4GB
  • डिस्क स्थान: 50GB
  • नेटवर्क: एक स्थिर इंटरनेट कनेक्शन

अनुशंसित विन्यास (उत्पादन वातावरण)

  • सीपीयू: क्वाड-कोर या उससे अधिक
  • मेमोरी: 8GB और उससे अधिक
  • डिस्क: 100GB SSD या उससे अधिक
  • नेटवर्क: एक स्थिर इंटरनेट कनेक्शन आवश्यक है; एक समर्पित लाइन की अनुशंसा की जाती है।

सॉफ़्टवेयर वातावरण आवश्यकताएँ

डॉकर परिनियोजन विधियाँ

  • Docker:20.10.0+
  • Docker Compose:1.29.0+
  • ऑपरेटिंग सिस्टम: लिनक्स, विंडोज, मैकओएस

स्रोत कोड स्थापना विधि

  • Node.js: 16.14.0 या बाद का, या 18.0.0 या बाद का
  • डेटाबेस: पोस्टग्रेएसक्यूएल 14.0+
  • ऑपरेटिंग सिस्टम: लिनक्स, विंडोज, मैकओएस

तैनाती योजना

1 users पर्यावरण तैयारी

  • सर्वर हार्डवेयर कॉन्फ़िगरेशन की पुष्टि करें
  • आवश्यक सॉफ़्टवेयर निर्भरताएँ स्थापित करें
  • नेटवर्क और फ़ायरवॉल कॉन्फ़िगर करें

2 users तैनाती विधि चयन

  • परीक्षण वातावरण: डॉकर कम्पोज़
  • उत्पादन वातावरण: डॉकरफ़ाइल
  • गहन अनुकूलन: स्रोत कोड इंस्टॉलेशन

3 users पश्चात नियोजन

  • डेटा बैकअप रणनीति
  • निगरानी और अलार्म
  • नियमित अपडेट अनुसूची

🚀 परिनियोजन विधियाँ

विभिन्न परिदृश्य आवश्यकताओं को पूरा करने के लिए तीन परिनियोजन विधियों हेतु विस्तृत मार्गदर्शिकाएँ

विधि एक: डॉकर कम्पोज़ वन-क्लिक डिप्लॉयमेंट (परीक्षण वातावरण के लिए अनुशंसित)

तैनाती के चरण

1

डिप्लॉयमेंट निर्देशिका बनाएँ

mkdir -p nocobase && cd nocobase
2

एक docker-compose.yml फ़ाइल बनाएँ

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: nocobase/nocobase:latest ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:nocobase@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=nocobase volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
3

सेवा शुरू करें

docker-compose up -d
4

NocoBase पर जाएँ

अपना ब्राउज़र खोलें और विज़िट करें http:// सेवा करनाIP:8080

ध्यान देने योग्य बिंदु

  • यह दृष्टिकोण परीक्षण वातावरण के लिए उपयुक्त है; उत्पादन वातावरण के लिए Dockerfile विधि का उपयोग करने की अनुशंसा की जाती है।
  • डिफ़ॉल्ट रूप से नवीनतम संस्करण की छवि का उपयोग किया जाता है। किसी विशिष्ट संस्करण को निर्दिष्ट करने के लिए कृपया `image` टैग को संशोधित करें।
  • डिफ़ॉल्ट डेटाबेस पासवर्ड nocobase है। उत्पादन वातावरण में, कृपया इसे एक मजबूत पासवर्ड में बदलें।

विधि दो: अनुकूलित डॉकरफ़ाइल बिल्ड (उत्पादन वातावरण के लिए अनुशंसित)

तैनाती के चरण

1

एक Dockerfile बनाएँ

cat > Dockerfile << 'EOF' FROM nocobase/nocobase:latest # यदि आपको अतिरिक्त निर्भरताएँ स्थापित करनी हों,यहाँ जोड़ें # RUN npm install some-package # यदि कॉपी करना होCustom Configuration,यहाँ जोड़ें # COPY config.yml /app/config/ EOF
2

छवि बनाएं

docker build -t my-nocobase .
3

एक docker-compose.yml फ़ाइल बनाएँ

cat > docker-compose.yml << 'EOF' version: '3' services: nocobase: image: my-nocobase ports: - "8080:8080" environment: - DATABASE_URL=postgresql://nocobase:your_strong_password@postgres:5432/nocobase depends_on: - postgres postgres: image: postgres:14-alpine environment: - POSTGRES_DB=nocobase - POSTGRES_USER=nocobase - POSTGRES_PASSWORD=your_strong_password volumes: - postgres-data:/var/lib/postgresql/data volumes: postgres-data: EOF
4

सेवा शुरू करें

docker-compose up -d

ध्यान देने योग्य बिंदु

  • उत्पादन वातावरण में यह अनिवार्य है कि डेटाबेस का पासवर्ड एक मजबूत पासवर्ड में बदल दिया जाए।
  • नवीनतम टैग के बजाय एक निश्चित-संस्करण वाली छवि का उपयोग करने की अनुशंसा की जाती है।
  • आवश्यकतानुसार कस्टम कॉन्फ़िगरेशन और निर्भरताएँ Dockerfile में जोड़ी जा सकती हैं।

विधि तीन: `create-nocobase-app` के माध्यम से स्रोत कोड इंस्टॉलेशन (गहन अनुकूलन के लिए उपयुक्त)

तैनाती के चरण

1

Node.js इंस्टॉल करें

सुनिश्चित करें कि Node.js का संस्करण 16.14.0 या बाद का, या 18.0.0 या बाद का स्थापित हो।

2

परियोजना बनाएँ

npm create nocobase-app@latest my-nocobase-app
3

डेटाबेस कॉन्फ़िगर करें

प्रदर्शन किए अनुसार डेटाबेस कनेक्शन विवरण कॉन्फ़िगर करें।

4

सेवा शुरू करें

cd my-nocobase-app && npm run dev
5

उत्पादन पर्यावरण सेटअप

npm run build && npm run start

ध्यान देने योग्य बिंदु

  • यह दृष्टिकोण उन परिदृश्यों के लिए उपयुक्त है जिनमें गहन अनुकूलन या द्वितीयक विकास की आवश्यकता होती है।
  • अतिरिक्त सिस्टम संसाधनों और Node.js-संबंधी ज्ञान की आवश्यकता है।
  • उत्पादन वातावरण के लिए, PM2 जैसे प्रक्रिया प्रबंधन उपकरणों का उपयोग करने की अनुशंसा की जाती है।

⚙️ बुनियादी विन्यास

उचित सिस्टम संचालन सुनिश्चित करने के लिए सिस्टम सेटअप और आरंभिक विन्यास।

प्रारंभिक विन्यास

1. एक प्रशासक खाता बनाएँ

जब आप पहली बार NocoBase पर आएँगे, तो सिस्टम आपको एक प्रशासक खाता बनाने में मार्गदर्शन करेगा। कृपया एक मजबूत पासवर्ड सेट करें और इसे सुरक्षित रखें।

2. सिस्टम जानकारी कॉन्फ़िगर करें

सिस्टम का नाम, लोगो, कॉपीराइट जानकारी और अन्य विवरण कॉन्फ़िगर करने के लिए 'सेटिंग्स' -> 'सिस्टम सेटिंग्स' पर जाएँ।

3. ईमेल सेवाओं को कॉन्फ़िगर करें

पहचान कोड, सूचनाएं और इसी तरह के संचार भेजने के लिए SMTP सेवा को कॉन्फ़िगर करने हेतु 'सेटिंग्स' -> 'ईमेल सेटिंग्स' पर जाएँ।

4. आवश्यक प्लगइन्स इंस्टॉल करें

प्लगइन मार्केटप्लेस में प्रवेश करें और AI एकीकरण तथा चार्ट विश्लेषण जैसे आवश्यक प्लगइन्स इंस्टॉल करें।

सुरक्षा विन्यास

1. HTTPS कॉन्फ़िगर करें

प्रोडक्शन वातावरणों में HTTPS कॉन्फ़िगर करने की अनुशंसा की जाती है, जिसे Nginx जैसे रिवर्स प्रॉक्सी के माध्यम से लागू किया जा सकता है।

2. फ़ायरवॉल कॉन्फ़िगर करें

केवल आवश्यक पोर्ट, जैसे 80 और 443, खोलें और सभी अनावश्यक पोर्ट बंद करें।

3. अनुमतियों का प्रबंधन कॉन्फ़िगर करें

न्यूनतम विशेषाधिकार के सिद्धांत का पालन करते हुए विभिन्न भूमिकाओं के लिए अनुमतियाँ कॉन्फ़िगर करने हेतु 'सेटिंग्स' -> 'भूमिका अनुमतियाँ' पर जाएँ।

4. डेटा बैकअप कॉन्फ़िगर करें

डेटाबेस का नियमित रूप से बैकअप लें; इसे क्रॉनटैब के माध्यम से बैकअप स्क्रिप्ट को स्वचालित रूप से चलाने के लिए शेड्यूल करके हासिल किया जा सकता है।

प्रदर्शन अनुकूलन

सर्वर अनुकूलन

  • सर्वर कर्नेल पैरामीटर समायोजित करें
  • उपयुक्त स्वैप स्पेस कॉन्फ़िगर करें
  • SSD स्टोरेज का उपयोग

डेटाबेस अनुकूलन

  • PostgreSQL कॉन्फ़िगरेशन पैरामीटर समायोजित करना
  • अनावश्यक डेटा को नियमित रूप से हटाएँ
  • उपयुक्त सूचकांक बनाएँ

आवेदन अनुकूलन

  • कैशिंग तंत्र को सक्षम करें
  • प्लगइन कॉन्फ़िगरेशन को अनुकूलित करें
  • छवियों और स्थिर संसाधनों का अनुकूलन करें

🔧 अक्सर पूछे जाने वाले प्रश्न और समाधान

परिनियोजन और उपयोग के दौरान सामान्य समस्याओं का निवारण

समस्या: डॉकर डिप्लॉयमेंट तक पहुँच नहीं हो पा रही है

संभावित कारण

  • पोर्ट खुला नहीं है।
  • फ़ायरवॉल द्वारा अवरुद्ध
  • कंटेनर सही ढंग से शुरू नहीं हुआ।

समाधान

  • यह सत्यापित करें कि पोर्ट मैपिंग सही है:docker-compose ps
  • फ़ायरवॉल सेटिंग्स की जाँच करें और संबंधित पोर्ट खोलें।
  • कंटेनर लॉग देखें:docker-compose logs

समस्या: डेटाबेस कनेक्शन विफल हो गया

संभावित कारण

  • डेटाबेस विन्यास त्रुटि
  • डेटाबेस सेवा शुरू नहीं की गई है।
  • नेटवर्क कनेक्टिविटी संबंधी समस्याएँ

समाधान

  • सत्यापित करें कि डेटाबेस कॉन्फ़िगरेशन सही है।
  • सुनिश्चित करें कि डेटाबेस सेवा सामान्य रूप से संचालित हो।
  • डेटाबेस कनेक्शन का परीक्षण:psql -h localhost -U nocobase -d nocobase

समस्या: प्लगइन इंस्टॉलेशन विफल हो गया

संभावित कारण

  • नेटवर्क कनेक्टिविटी संबंधी समस्याएँ
  • प्लगइन संस्करण सिस्टम के साथ असंगत है।
  • सर्वर संसाधनों की कमी

समाधान

  • जाँचें कि नेटवर्क कनेक्शन ठीक से काम कर रहा है या नहीं।
  • सुनिश्चित करें कि प्लगइन संस्करण सिस्टम संस्करण के साथ संगत है।
  • जाँचें कि सर्वर में पर्याप्त मेमोरी और डिस्क स्थान है।

समस्या: सिस्टम धीमी गति से चल रहा है

संभावित कारण

  • सर्वर संसाधनों की कमी
  • डेटाबेस का अनुकूलन नहीं किया गया है।
  • अत्यधिक प्लगइन्स या अनुचित कॉन्फ़िगरेशन

समाधान

  • सर्वर संसाधनों (CPU, मेमोरी) को बढ़ाएँ
  • डेटाबेस कॉन्फ़िगरेशन को अनुकूलित करें और उपयुक्त इंडेक्स बनाएँ।
  • अनावश्यक प्लगइन्स को अक्षम करें और सिस्टम कॉन्फ़िगरेशन को अनुकूलित करें।