🧖🏽 🌅 📷 डॉकर कम्पोज़ के साथ नेटिव कमेंटो सर्वर 👩🏾‍🏫 🙈 🤾🏽

नोट: यह मेरी पोस्ट (अंग्रेजी) का अनुवाद है, जिसमें उसी साइट पर उपयोग किए गए टिप्पणी सर्वर के कार्यान्वयन का वर्णन किया गया है जहां मूल स्थित है।

TL; DR संस्करण: मैंने एक कमेंटो सर्वर कॉन्फ़िगरेशन विकसित किया है, जो आसानी से और बस अर्ध-स्वचालित मोड में तैनात है। इस रिपॉजिटरी को GitHub से खुद को कॉपी करें और README में निर्देशों का पालन करें।

कुछ समय पहले, मैं irresistibly Disqus को बदलना चाहता था - जो शायद पृष्ठों में टिप्पणियों को जोड़ने के लिए सबसे आम प्रणाली है - एक स्वतंत्र और खुली टिप्पणी के लिए।

टिप्पणी क्यों?

कई अन्य "मुफ्त" उत्पादों की तरह, डिस्कस के साथ समस्या यह है कि इस मामले में उत्पाद उपयोगकर्ता है - अर्थात, आप। इसके अलावा, डिस्कस हर पृष्ठ को "समृद्ध" करता है जहां इसका उपयोग मेगाबाइट की स्क्रिप्ट और सौ से अधिक अतिरिक्त HTTP अनुरोधों के साथ किया जाता है।

साथ ही, इसका नि: शुल्क संस्करण विज्ञापन दिखाता है जिसमें से आप $ 9 प्रति माह (केवल प्लान) के लिए "केवल" भुगतान कर सकते हैं। यह अकेला ही कुछ बेहतर खोजना चाहता है।

कुछ बिंदु पर, मैं इस पोस्ट पर ठोकर खाई और एक स्वतंत्र टिप्पणी सर्वर के अस्तित्व के बारे में पता किया जिसे टिप्पणी कहा जाता है। एक भाग्यशाली संयोग से, कमेंटो हाल ही में पूरी तरह से खुला हो गया - इससे पहले कि यह दो संस्करणों में उपलब्ध था, मुफ्त सामुदायिक और वाणिज्यिक उद्यम । इसके विकासक आदित्य चंद्रशेखर को धन्यवाद।

टिप्पणी, डिस्कस की तुलना में अधिक कुशल है, इसके साथ अतिरिक्त भार का विशिष्ट आकार लगभग 11 केबी है , साथ ही टिप्पणी खुद, निश्चित रूप से परिमाण के आदेश हैं । आवश्यक HTTP अनुरोधों के साथ लगभग यही स्थिति है।

कमेंटो सर्वर का एक और प्लस यह बहुत तेज है, जैसा कि गो में लिखा गया है।

खैर, केक पर एक चेरी के रूप में, वह डिस्कस से टिप्पणियों का आयात करता है, वह और क्या सपना देख सकता है?

टिप्पणी के लिए मामलों का उपयोग करें

गैर-उन्नत (तकनीकी रूप से) उपयोगकर्ताओं के लिए, Commento के पास commento.io पर एक उपयोग में आने वाली क्लाउड सेवा है। लेखक आपको स्वयं मासिक शुल्क चुनने की पेशकश करता है, लेकिन यह तकनीकी कारणों से $ 3 से कम नहीं हो सकता है।

श्री चंद्रशेखर ने उदारता से उत्पाद के लिए "गैर-तुच्छ पैच" के बदले में टिप्पणी .io पर एक मुफ्त खाता प्रदान करता है।

खैर, मैंने तीसरा विकल्प चुना: खुद कमेंटो सर्वर को बढ़ाने के लिए। इस मामले में, आप किसी पर (होस्टर के अलावा, निश्चित रूप से) निर्भर नहीं हैं, और मुझे स्वतंत्रता से प्यार है।

कठिनाइयों

मैं डॉकर कंटेनरों का बहुत बड़ा प्रशंसक हूं और अक्सर कई संबंधित कंटेनरों के समूहों के प्रबंधन के लिए एक उपकरण डॉकर कंपोज का भी उपयोग करता हूं। GitLab कंटेनर रजिस्ट्री में कमेंटो में रेडी-टू-यूज़ डॉकटर इमेज है।

इसलिए, कंटेनरों का उपयोग करने का निर्णय अपने आप से समाप्त हो गया - लेकिन पहले कुछ चीजें तय करनी थीं।

कठिनाई नंबर 1: PostgreSQL

Commento को PostgreSQL सर्वर के हालिया संस्करण की आवश्यकता है, दुर्भाग्य से कोई अन्य SQL सर्वर समर्थित नहीं हैं।

खैर, हम अभी भी कंटेनरों में सब कुछ चलाते हैं, इसलिए यह बहुत सरल है।

# 2 कठिनाई: कोई HTTPS सहायता

कमेंटो स्वयं एक वेब सर्वर है, लेकिन यह केवल असुरक्षित HTTP प्रोटोकॉल का समर्थन करता है।

यह ध्यान दिया जाना चाहिए कि यह अभ्यास इन दिनों काफी सामान्य है: इस मामले में, सर्वर रिवर्स प्रॉक्सी के पीछे छिपा हुआ है, जो एसएसएल ऑफलोडिंग भी करता है। बात यह है कि इस मामले में एसएसएल / एचटीटीपीएस समर्थन बिल्कुल अनिवार्य है, आखिरकार, 2019 में यार्ड में और असुरक्षित इंटरनेट प्रोटोकॉल का उपयोग करके एक उपयोगकर्ता को अधिकृत करने के प्रयासों को देखते हुए बहुत तिरछा हो जाएगा।

मैंने नगनेक्स सर्वर का उपयोग करने का फैसला किया, सबसे पहले, मुझे इसके साथ काम करने का काफी अनुभव था, और दूसरी बात, यह बहुत तेज़, किफायती और स्थिर है। और डोकर छवियों के आधिकारिक बिल्ड प्रकाशित करता है।

HTTPS नुस्खा में दूसरा घटक डोमेन के लिए SSL प्रमाणपत्र है। लेट्स एनक्रिप्ट सर्टिफिकेट अथॉरिटी बनाने के लिए मैं ईएफएफ और मोजिला का सदा आभारी हूं, जो हर महीने लाखों फ्री सर्टिफिकेट जारी करता है।

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

# 3 कठिनाई: सर्टिफिकेट चिकन अंडे की समस्या

लेकिन यह तरकीब ज्यादा पेचीदा है।

हम Nginx पर हमारे रिवर्स प्रॉक्सी के कॉन्फ़िगरेशन में SSL प्रमाणपत्र का उल्लेख करना चाहते हैं, जिसका अर्थ है कि प्रमाण पत्र के बिना यह बस शुरू करने से इनकार करता है। उसी समय, किसी डोमेन के लिए एसएसएल प्रमाणपत्र प्राप्त करने के लिए , आपको एक कार्यशील HTTP सर्वर की आवश्यकता होती है, जो लेट एनक्रिप्ट इस डोमेन के आपके स्वामित्व को प्रमाणित करेगा।

मैं इस समस्या को हल करने में कामयाब रहा, और, यह मुझे लगता है, काफी शान से:

सबसे पहले, एक डमी, अमान्य प्रमाणपत्र उत्पन्न होता है, जिसका एकमात्र उद्देश्य Nginx को शुरू करना है।
नेगनेक्स और सर्टिफिकेट संयुक्त रूप से एक नया, अब वैध प्रमाण पत्र प्राप्त करते हैं।
जैसे ही प्रमाण पत्र प्राप्त होता है, सर्बोट "स्टैंडबाय मोड" में चला जाता है, हर 12 घंटे में यह जांचने के लिए कि क्या उसे अपडेट करने की आवश्यकता है - लेट्स एनक्रिप्ट की सिफारिशों के अनुसार।
जब पल आ गया है और प्रमाणपत्र को नवीनीकृत किया गया है, तो सर्टिफोट नेग्नेक्स को पुनरारंभ करने के लिए संकेत देगा।

कठिनाई नंबर 4: कुछ संरक्षित होना चाहिए

मुझे दृढ़ता से संदेह है कि आप चाहते हैं कि उपयोगकर्ता टिप्पणियां रिबूट या सिस्टम अपडेट के बाद बचाई जाएं।

इसके अलावा, ताकि लेट एनक्रिप्ट आपके बहुत अधिक अनुरोधों के कारण आपको प्रतिबंधित न करे, पूरी समाप्ति तिथि के लिए प्राप्त प्रमाणपत्रों को रखना अच्छा होगा।

दोनों बिंदुओं को प्रस्तावित विन्यास में हल किया गया था, डॉकर के संस्करणों का उपयोग करते हुए, सिस्टमो द्वारा स्वचालित रूप से बनाया गया था जब टिप्पणी पहली बार लॉन्च की गई थी। वॉल्यूम को external के रूप में चिह्नित किया external , इसलिए डॉकर docker-compose down -v का उपयोग करके कंटेनरों को हटाते समय डॉकर उन्हें छोड़ देता है।

इसे सब साथ लाएं

अब आप देख सकते हैं कि यह सब एक साथ कैसे काम करता है।

नीचे दिया गया आंकड़ा चार कंटेनरों के बीच की बातचीत और यातायात को दर्शाता है:

मैंने यह सुनिश्चित करने के लिए depends_on विकल्प लागू किया कि कंटेनर सही क्रम में शुरू हों।

यदि आप केवल अपना स्वयं का Commento सर्वर शुरू करना चाहते हैं, तो आप शेष लेख को छोड़ सकते हैं और सीधे GitHub पर कोड पर जा सकते हैं ।

खैर, मैं इस कार्यान्वयन के बारे में अधिक विस्तार से बाद में बात करूंगा।

यह सब कैसे काम करता है

फ़ाइल लिखें

जैसा कि आप ऊपर चित्र में देख सकते हैं, मेरी "रचना" में चार सेवाएं शामिल हैं:

certbot - ईएफएफ से certbot उपयोगिता
nginx - एसएसएल ऑफलोडिंग को लागू करने वाला रिवर्स प्रॉक्सी
app - कमेंटो सर्वर
postgres - PostgreSQL डेटाबेस

Docker docker-compose.yml में अपने स्वयं के docker-compose.yml नेटवर्क की घोषणाएँ शामिल हैं, जिन्हें commento_network docker-compose.yml नेटवर्क कहा जाता है, और तीन खंड, जिनमें से दो बाहरी हैं (अर्थात, कंपोज़ के बाहर बनाया जाना चाहिए):

Commento_postgres_volume टिप्पणी के लिए PostgreSQL सर्वर डेटा संग्रहीत करता है: उपयोगकर्ता, मध्यस्थ, टिप्पणियां, आदि।
certbot_etc_volume में सर्टिफिकेट प्राप्त प्रमाणपत्र होते हैं।

nginx

Nginx कंटेनर अल्पाइन पर आधारित एक हल्की आधिकारिक छवि पर आधारित है और चलाने के लिए निम्न स्क्रिप्ट का उपयोग करता है:

 #!/bin/sh trap exit TERM # Wait for the certificate file to arrive wait_for_certs() { echo 'Waiting for config files from certbot...' i=0 while [[ ! -f /etc/letsencrypt/options-ssl-nginx.conf ]]; do sleep 0.5 [[ $((i++)) -gt 20 ]] && echo 'No files after 10 seconds, aborting' && exit 2 done } # Watches for a "reload flag" (planted by certbot container) file and reloads nginx config once it's there watch_restart_flag() { while :; do [[ -f /var/www/certbot/.nginx-reload ]] && rm -f /var/www/certbot/.nginx-reload && echo 'Reloading nginx' && nginx -s reload sleep 10 done } # Wait for certbot wait_for_certs # Start "reload flag" watcher watch_restart_flag & # Run nginx in the foreground echo 'Starting nginx' exec nginx -g 'daemon off;'

लाइन 3 ( ARRGHHH, Habr कोड में लाइन संख्या के प्रदर्शन का समर्थन नहीं करता है - लगभग। अनुवाद। ) एक बाधा हैंडलर पंजीकृत है ताकि कंटेनर बंद होने पर Nginx और पृष्ठभूमि निगरानी प्रक्रिया सफलतापूर्वक पूरा हो जाए।
लाइन 27 certbot फंक्शन को कॉल करता है, जो certbot कंटेनर द्वारा बनाई गई एसएसएल कॉन्फ़िगरेशन फाइलों के certbot आने तक certbot स्टार्टअप प्रक्रिया को रोक देता है। इसके बिना, नेग्नेक्स शुरू करने से इनकार कर देगा।
लाइन 30 एक पृष्ठभूमि प्रक्रिया बनाता है जो नियमित रूप से, हर दस सेकंड में, नाम के साथ एक फ्लैग फाइल की उपस्थिति की जाँच करता है। .nginx-reload , और जैसे ही यह पता लगाता है, .nginx-reload को कॉन्फ़िगरेशन को फिर से लोड करने का निर्देश देता है। सर्टिफिकेट अपडेट होने पर यह फाइल सर्टिफिकेट भी बनाती है।
लाइन 34 नगनेक्स को सामान्य मोड में शुरू करता है। इस मामले में, exec मतलब है कि वर्तमान शेल प्रक्रिया को नगीनेक्स प्रक्रिया द्वारा बदल दिया गया है।

इस चित्र में एक अन्य महत्वपूर्ण फ़ाइल है, कमेंटो वर्चुअल सर्वर कॉन्फ़िगरेशन, जो निग्नेक्स को commento कंटेनर में HTTPS अनुरोधों को अग्रेषित करने के लिए मजबूर करता है:

 server { listen [::]:443 ssl ipv6only=on; listen 443 ssl; server_tokens off; root /var/www/html; index index.html index.htm index.nginx-debian.html; server_name __DOMAIN__; location / { proxy_pass http://app:8080/; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } ssl_certificate /etc/letsencrypt/live/__DOMAIN__/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/__DOMAIN__/privkey.pem; include /etc/letsencrypt/options-ssl-nginx.conf; ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; } server { listen 80 default_server; listen [::]:80 default_server; server_tokens off; server_name __DOMAIN__; location /.well-known/acme-challenge/ { root /var/www/certbot; } # Redirect to HTTPS on port 80 location / { return 301 https://$host$request_uri; } }

पहला सर्वर ब्लॉक (लाइन 1-21 ) बताता है कि HTTPS और अग्रेषण नियम के साथ कैसे काम किया जाए। यह वह जगह है जहां चलो एनक्रिप्ट क्रिप्ट फ़ाइलों का उल्लेख किया जाता है (या इसके बजाय उपयोग किए गए स्टब्स)।

सर्वर द्वारा दी गई डोमेन को छवि बनाते समय एक तर्क के रूप में पारित किया जाता है; यह सर्वर कॉन्फ़िगरेशन में लाइन __DOMAIN__ को प्रतिस्थापित करता है।

दूसरा ब्लॉक (लाइनें 23-38 ) HTTP सर्वर का कॉन्फ़िगरेशन है, जो डोमेन स्वामित्व (तथाकथित "एसीएमई चुनौती") की पुष्टि करने के लिए सर्टिफिकेट द्वारा उपयोग किया जाता है। अन्य सभी अनुरोध HTTPS के माध्यम से संबंधित पते पर रीडायरेक्ट करते हैं।

certbot

हमारी सर्पोट छवि निम्न स्क्रिप्ट के साथ आधिकारिक बिल्ड पर आधारित है:

 #!/bin/sh trap exit TERM # Wait until nginx is up and running, up to 10 seconds wait_for_nginx() { echo 'Waiting for nginx...' i=0 while ! nc -z nginx 80 &>/dev/null; do sleep 0.5 [[ $((i++)) -gt 20 ]] && echo "nginx isn't online after 10 seconds, aborting" && exit 4 done echo 'nginx is up and running' } # Check vars [[ -z "$DOMAIN" ]] && echo "Environment variable 'DOMAIN' isn't defined" && exit 2 [[ -z "$EMAIL" ]] && echo "Environment variable 'EMAIL' isn't defined" && exit 2 TEST="${TEST:-false}" # Check external mounts data_dir='/etc/letsencrypt' www_dir='/var/www/certbot' [[ ! -d "$data_dir" ]] && echo "Directory $data_dir must be externally mounted" [[ ! -d "$www_dir" ]] && echo "Directory $www_dir must be externally mounted" # If the config/certificates haven't been initialised yet if [[ ! -e "$data_dir/options-ssl-nginx.conf" ]]; then # Copy config over from the initial location echo 'Initialising nginx config' cp /conf/options-ssl-nginx.conf /conf/ssl-dhparams.pem "$data_dir/" # Copy dummy certificates mkdir -p "$data_dir/live/$DOMAIN" cp /conf/privkey.pem /conf/fullchain.pem "$data_dir/live/$DOMAIN/" # Wait for nginx wait_for_nginx # Remove dummy certificates rm -rf "$data_dir/live/$DOMAIN/" # Run certbot to validate/renew certificate test_arg= $TEST && test_arg='--test-cert' certbot certonly --webroot -w /var/www/certbot -n -d "$DOMAIN" $test_arg -m "$EMAIL" --rsa-key-size 4096 --agree-tos --force-renewal # Reload nginx config touch /var/www/certbot/.nginx-reload # nginx config has been already initialised - just give nginx time to come up else wait_for_nginx fi # Run certbot in a loop for renewals while :; do certbot renew # Reload nginx config touch /var/www/certbot/.nginx-reload sleep 12h done

इसकी लाइनों का संक्षिप्त दौरा:

लाइन 3 , पिछले स्क्रिप्ट की तरह, कंटेनर के नियमित पूरा होने के लिए आवश्यक है।
लाइनें 17-19 आवश्यक चर की जाँच करें।
और 22-25 लाइनों में - कि सर्टिफिकेट को काम करने के लिए आवश्यक निर्देशिकाओं को सही ढंग से माउंट किया गया है।
कांटा इस प्रकार है:
- कंटेनर की पहली शुरुआत में लाइनों को 30-50 ही निष्पादित किया जाता है:
  - एक डमी प्रमाण पत्र की प्रतिलिपि बनाई गई है, जो नगीनेक्स को सामान्य रूप से शुरू करने की अनुमति देता है।
  - इस बीच, Nginx, इस प्रक्रिया के अंत की प्रतीक्षा कर रहा है, जिसके बाद यह डाउनलोड करना जारी रखता है।
  - एक बार Nginx शुरू हो जाने के बाद, सर्बोट लेट्स एनक्रिप्ट से एक वैध प्रमाण पत्र प्राप्त करने की प्रक्रिया शुरू करता है।
  - और अंत में, जैसे ही प्रमाणपत्र प्राप्त होता है, .nginx-reload फ़ाइल बनाई जाती है, Nginx को संकेत देते हुए कि यह कॉन्फ़िगरेशन को पुनरारंभ करने का समय है।
- लाइन 54 नेगनेक्स के शुरू होने की प्रतीक्षा करता है - उस स्थिति में जब एक पूर्ण प्रमाण पत्र पहले से ही उपलब्ध है।
इस सब के बाद ( 58-63 पंक्तियाँ), वह चक्र जारी रखता है, हर 12 घंटे में एक बार प्रमाणपत्र को नवीनीकृत करने और पुन: शुरू करने के लिए नग्नेक्स को संकेत देने की आवश्यकता होती है।

Commento और PostgreSQL

app और postgres कंटेनर बिना किसी बदलाव के डेवलपर्स द्वारा प्रदान की गई मूल छवियों का उपयोग करते हैं।

सिस्टमड सर्विस

इस पहेली का अंतिम टुकड़ा systemd commento.service यूनिट फ़ाइल है , जिस पर आपको /etc/systemd/system/commento.service में सिमलिंक बनाने की आवश्यकता है ताकि यह सिस्टम शुरू होने पर एक अच्छे समय पर शुरू हो:

 [Unit] Description=Commento server [Service] TimeoutStopSec=30 WorkingDirectory=/opt/commento ExecStartPre=-/usr/bin/docker volume create commento_postgres_volume ExecStartPre=-/usr/bin/docker volume create certbot_etc_volume ExecStartPre=-/usr/local/bin/docker-compose -p commento down -v ExecStart=/usr/local/bin/docker-compose -p commento up --abort-on-container-exit ExecStop=/usr/local/bin/docker-compose -p commento down -v [Install] WantedBy=multi-user.target

रेखा:

लाइन 6 का तात्पर्य है कि परियोजना कोड /opt/commento निर्देशिका में क्लोन किया गया है - यह बहुत सरल है।
यदि वे पहले से ही नहीं हैं, तो लाइनें 7-8 बाहरी वॉल्यूम बनाती हैं।
पंक्ति 9 में , पिछले कंटेनरों के संभावित अवशेष हटा दिए गए हैं। बाहरी मात्रा संरक्षित हैं।
लाइन 10 डोकर कंपोज के वास्तविक लॉन्च को चिह्नित करता है। - --abort-on-container-exit फ्लैग --abort-on-container-exit पूरे झुंड --abort-on-container-exit जब उनमें से किसी को भी --abort-on-container-exit । इसके लिए धन्यवाद, सिस्टमड कम से कम जागरूक होगा कि सेवा बंद हो गई है।
लाइन 11 कंटेनर, नेटवर्क और वॉल्यूम को फिर से साफ और हटा रहा है।

स्रोत कोड

पूरी तरह से काम करने वाला कार्यान्वयन, docker-compose.yml में केवल चर के कॉन्फ़िगरेशन की आवश्यकता होती है, जो GitHub पर उपलब्ध है । आपको केवल README में वर्णित चरणों का सावधानीपूर्वक पालन करने की आवश्यकता है।

कोड एमआईटी लाइसेंस के अधीन है।

इस जगह पर पढ़ने के लिए धन्यवाद, टिप्पणियों का स्वागत है!

डॉकर कम्पोज़ के साथ नेटिव कमेंटो सर्वर