Nginx के लिए गतिशील मॉड्यूल का निर्माण

हाल ही में, हमने Nginx के लिए एक गतिशील मॉड्यूल बनाया, और जब सब कुछ तैयार हो गया, तो यह पता चला कि हमारा मॉड्यूल Nginx के साथ संगत नहीं था, जो पहले से ही सर्वर पर स्थापित था। हम समस्या के लिए तैयार समाधान नहीं खोज पाए और हम इसे अपने दम पर लड़ने लगे। हमने बहुत समय बिताया, लेकिन एक नया अनुभव और, सबसे महत्वपूर्ण बात, एक काम करने वाला समाधान। जिसे मैं शेयर करना चाहूंगा।

आइए https://github.com/vozlt/nginx-module-tts उदाहरण का उपयोग करके डायनामिक मॉड्यूल असेंबली प्रक्रिया का वर्णन शुरू करें । और फिर हम दिखाएंगे कि क्या त्रुटि होती है और इसके साथ क्या करना है।

इनपुट डेटा:
डेबियन 9 ओएस
मानक डेबियन रिपॉजिटरी से नग्नेक्स v1.10.3। nginx -V आउटपुट:

 nginx version: nginx/1.10.3 built with OpenSSL 1.1.0k 28 May 2019 (running with OpenSSL 1.1.1c 28 May 2019) TLS SNI support enabled configure arguments: --with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-DhOtPd/nginx-1.10.3=. -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-z,relro -Wl,-z,now' --prefix=/usr/share/nginx --conf-path=/etc/ nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --modules-path=/usr/lib/nginx/modules --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path =/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-ipv6 --with-http_ssl_module - -with-http_stub_status_module --with-http_realip_mod ule --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_geoip_module=dynamic --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module= dynamic --with-http_sub_module --with-http_xslt_module=dynamic --with-stream=dynamic --with-stream_ssl_module --with-mail=dynamic --with-mail_ssl_module --add-dynamic-module=/build/nginx-DhOtPd/nginx-1.10.3/debian/modules/nginx-auth-pam --add-dynamic-module=/build/nginx-DhOtPd/nginx-1.10.3/debian/modules/nginx-dav-ext-module --add-dynamic-module=/build/nginx-DhOtPd/nginx-1.10.3/debian/modules/nginx-echo --add-dynamic-module=/build/nginx-DhOtPd/nginx-1.10.3/debian/modules/nginx-upstream-fair --add-dynamic-module=/build/nginx-DhOtPd/nginx -1.10.3/debian/modules/ngx_http_substitutions_filter_module 

इस कमांड के आउटपुट में ऐसी जानकारी होती है जो डायनामिक मॉड्यूल की असेंबली के लिए आवश्यक होती है, अर्थात्, सब कुछ जो configure arguments: बाद लिखा जाता है configure arguments: और पहले --add-dynamic-module , जो है:

 --with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-DhOtPd/nginx-1.10.3=. -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-z,relro -Wl,-z,now' --prefix=/usr/share/nginx --conf-path=/etc/ nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --modules-path=/usr/lib/nginx/modules --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path =/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-ipv6 --with-http_ssl_module --with-http_stub_status_module --with-http_realip_mod ule --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_geoip_module=dynamic --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module= dynamic --with-http_sub_module --with-http_xslt_module=dynamic --with-stream=dynamic --with-stream_ssl_module --with-mail=dynamic --with-mail_ssl_module 

इसलिए, हम मॉड्यूल की असेंबली के लिए आगे बढ़ते हैं:

• असेंबली के लिए, एक डॉक कंटेनर का उपयोग करना सुविधाजनक है ताकि मुख्य प्रणाली को अव्यवस्थित न करें, डेबियन ले जाएं: 9 छवि को आधार के रूप में, कंटेनर से तैयार मॉड्यूल की प्रतिलिपि बनाने की सुविधा के लिए, आप वॉल्यूम निर्दिष्ट कर सकते हैं। इस मामले में कंटेनर शुरू करने की कमांड इस तरह दिखाई देगी:

 docker run --rm -it -v /tmp/nginx_module:/nginx_module debian:9 bash 

• कंटेनर शुरू करने के बाद, आवश्यक पैकेज स्थापित करें। कृपया ध्यान दें कि पैकेज nginx -V कमांड के आउटपुट के अनुसार चुने गए हैं, इसलिए आपको कुछ पुस्तकालयों की आवश्यकता नहीं हो सकती है। किसी भी स्थिति में, कॉन्फ़िगर स्क्रिप्ट निर्भरता की अनुपस्थिति के बारे में आपको चेतावनी देगी:

 apt update apt install git make gcc autoconf wget libpcre3-dev libpcre++-dev zlib1g-dev libxml2-dev libxslt-dev libgd-dev libgeoip-dev 

इस सूची से libssl-dev पैकेज गायब है, क्योंकि सर्वर पर स्थापित nginx OpenSSL के संस्करण 1.1.0k के साथ बनाया गया है, और लेखन के समय, जब रिपॉजिटरी से libssl-dev पैकेज स्थापित किया गया था, तो इसमें OpenSSL का संस्करण पहले से ही 1.1.0l था। इसलिए, सही संस्करण के लिए ओपनएसएसएल स्रोत कोड को अलग से डाउनलोड किया जाना चाहिए।

• वेबसाइट http://nginx.org/download nginx से वांछित संस्करण डाउनलोड करें, हमारे मामले में यह 1.10.3 है। OpenSSL स्रोतों को आधिकारिक साइट https://www.openssl.org/source/old से डाउनलोड करें और वास्तव में, github से nginx-मॉड्यूल-vts मॉड्यूल का स्रोत कोड डाउनलोड करें।

 cd /usr/local/src/ wget http://nginx.org/download/nginx-1.10.3.tar.gz wget https://www.openssl.org/source/old/1.1.0/openssl-1.1.0k.tar.gz git clone git://github.com/vozlt/nginx-module-vts.git tar xvfz nginx-1.10.3.tar.gz tar xzvf openssl-1.1.0k.tar.gz cd nginx-1.10.3 

• अब आप कॉन्फ़िगर स्क्रिप्ट को चलाने के लिए तैयार हैं। स्क्रिप्ट मापदंडों के रूप में, हम नगणक्स -V कमांड के आउटपुट से सभी मापदंडों को इंगित करते हैं, जो मैंने लेख की शुरुआत में लिखा था। हम nginx-मॉड्यूल-vts मॉड्यूल के निर्माण के लिए --add-डायनामिक-मॉड्यूल पैरामीटर भी जोड़ते हैं और --with -sslsl पैरामीटर के माध्यम से OpenSSL स्रोत फ़ाइलों के साथ निर्देशिका का पथ निर्दिष्ट करते हैं। अंतिम आदेश इस तरह दिखेगा:

 ./configure --with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-DhOtPd/nginx-1.10.3=. -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-z,relro -Wl,-z,now' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --modules-path=/usr/lib/nginx/modules --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-ipv6 --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_geoip_module=dynamic --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module=dynamic --with-http_sub_module --with-http_xslt_module=dynamic --with-stream=dynamic --with-stream_ssl_module --with-mail=dynamic --with-mail_ssl_module --with-openssl=../openssl-1.1.0k/ --add-dynamic-module=../nginx-module-vts/ 

• configure स्क्रिप्ट खत्म होने के बाद, हम मॉड्यूल की असेंबली शुरू करते हैं; हमें सभी nginx को इकट्ठा करने की आवश्यकता नहीं है:

 make modules 

ध्यान दें कि यह कमांड केवल nginx संस्करण 1.9.13 के साथ उपलब्ध है।

• असेंबली प्रक्रिया पूरी होने के बाद, परिणामी फ़ाइल को volume कॉपी करें, जो कंटेनर चालू होने पर मुहिम शुरू की गई थी:

 cp objs/ngx_http_vhost_traffic_status_module.so /nginx_module/ 

• अगला, हम फ़ाइल को लक्ष्य सर्वर पर रखते हैं, इस मामले में, मॉड्यूल के साथ निर्देशिका पथ /usr/share/nginx/modules । /etc/nginx/modules-enabled/mod-http-vhost-traffic-status.conf में मॉड्यूल को सक्षम करने के लिए हम निम्नलिखित सामग्री के साथ फाइल /etc/nginx/modules-enabled/mod-http-vhost-traffic-status.conf बनाते हैं:

 load_module modules/ngx_http_vhost_traffic_status_module.so; 

और /etc/nginx/modules-enabled निर्देशिका में इस फ़ाइल का एक प्रतीकात्मक लिंक बनाएं।

किए गए कार्य के बाद, हम nginx -t कमांड को कॉल करते हैं और ... हमें त्रुटि मिलती है:

 nginx: [emerg] module "/usr/share/nginx/modules/ngx_http_vhost_traffic_status_module.so" is not binary compatible in /etc/nginx/modules-enabled/50-mod-http-vhost-traffic-status.conf:1 

और यहां, आमतौर पर, कुछ घबराहट होती है, क्योंकि स्रोत संस्करण और सर्वर पर स्थापित nginx संस्करण समान हैं, ओपनएसएसएल संस्करण भी हैं, configure स्क्रिप्ट के मापदंडों को भी पूरी तरह से कॉपी किया जाता है। तो सौदा क्या है?

इस समस्या को समझने के लिए, मुझे यह समझना था कि अगर डायनेमिक मॉड्यूल इसके लिए उपयुक्त है, तो nginx कैसे जांचता है। इस कोड के लिए src/core/ngx_module.h ( https://github.com/nginx/nginx/blob/master/src/core/core/ngx_module.h ) में nginx स्रोतों में स्थित कोड जिम्मेदार है। इस फ़ाइल में कई चेक हैं, इस मामले में 34, जिसके दौरान nginx फॉर्म के चर के लिए सेट करता है NGX_MODULE_SIGNATURE_0 (1,2,3, आदि)
मान 1 या 0. अगला परिवर्तनशील NGX_MODULE_SIGNATURE
जो एक पंक्ति में सभी जाँचों के परिणाम एकत्र करता है। तदनुसार, समस्या यह है कि नए मॉड्यूल के हस्ताक्षर स्ट्रिंग मौजूदा nginx के हस्ताक्षर स्ट्रिंग से मेल नहीं खाते हैं। हस्ताक्षर स्ट्रिंग्स के मूल्यों की जांच करने के लिए, आप निम्न आदेशों का उपयोग कर सकते हैं:

• निर्मित किए गए मॉड्यूल की हस्ताक्षर रेखा:

 strings /usr/share/nginx/modules/ngx_http_vhost_traffic_status_module.so| fgrep '8,4,8' 8,4,8,000011111101011111111111110110111 

• सर्वर पर स्थापित nginx बाइनरी फ़ाइल की हस्ताक्षर लाइन:

 strings /usr/sbin/nginx| fgrep '8,4,8' 8,4,8,000011111101011111111111110111111 

जब इन रेखाओं की नग्न आंखों से तुलना की जाती है, तो यह स्पष्ट होता है कि मॉड्यूल सिग्नेचर लाइन में, अंत से चौथा nginx 0 निकला, जबकि nginx में 1. यह समझने के लिए कि मॉड्यूल में वास्तव में क्या गायब है, आपको src/core/ngx_module.h को संदर्भित करने की आवश्यकता है src/core/ngx_module.h और अंत से चौथे चर को खोजने के लिए, यह कुछ इस तरह दिखता है:

 #if (NGX_HTTP_REALIP) #define NGX_MODULE_SIGNATURE_29 "1" #else #define NGX_MODULE_SIGNATURE_29 "0" #endif #if (NGX_HTTP_HEADERS) #define NGX_MODULE_SIGNATURE_30 "1" #else #define NGX_MODULE_SIGNATURE_30 "0" #endif #if (NGX_HTTP_DAV) #define NGX_MODULE_SIGNATURE_31 "1" #else #define NGX_MODULE_SIGNATURE_31 "0" #endif #if (NGX_HTTP_CACHE) #define NGX_MODULE_SIGNATURE_32 "1" #else #define NGX_MODULE_SIGNATURE_32 "0" #endif #if (NGX_HTTP_UPSTREAM_ZONE) #define NGX_MODULE_SIGNATURE_33 "1" #else #define NGX_MODULE_SIGNATURE_33 "0" #endif #define NGX_MODULE_SIGNATURE 

हम वैरिएबल NGX_HTTP_HEADERS में रुचि रखते हैं, जब nginx निर्माण 1 था, और मॉड्यूल बनाते समय 0. मॉड्यूल में NGX_HTTP_HEADERS साथ NGX_HTTP_HEADERS करने के NGX_HTTP_HEADERS आपको लाइन have=NGX_HTTP_HEADERS . auto/have जोड़कर मॉड्यूल के स्रोत कोड के साथ निर्देशिका में फ़ाइल को समायोजित करना have=NGX_HTTP_HEADERS . auto/have have=NGX_HTTP_HEADERS . auto/have config. फ़ाइल की शुरुआत में है config. परिवर्तन करने के बाद कॉन्‍फ़िगर फ़ाइल की शुरुआत निम्न है:

 ngx_addon_name=ngx_http_vhost_traffic_status_module have=NGX_STAT_STUB . auto/have have=NGX_HTTP_HEADERS . auto/have ... 

अगला, make clean , और फिर configure फिर से शुरू configure और make modules । मॉड्यूल को इकट्ठा करने के बाद, हम उसके हस्ताक्षर स्ट्रिंग की जांच करते हैं और देखते हैं कि अब यह nginx स्ट्रिंग से मेल खाता है:

 $ strings /usr/sbin/nginx| fgrep '8,4,8' 8,4,8,000011111101011111111111110111111 $ strings /usr/share/nginx/modules/ngx_http_vhost_traffic_status_module.so | fgrep '8,4,8' 8,4,8,000011111101011111111111110111111 

उसके बाद, मॉड्यूल बिना किसी समस्या के जुड़ता है और आप nginx साथ उन्नत आंकड़े एकत्र कर सकते हैं।

आपके मामले में, शायद हस्ताक्षर रेखा अलग दिखेगी, साथ ही इस लाइन में प्रत्येक स्थिति के लिए जिम्मेदार चर भी होंगे। हालांकि, अब आप समझ सकते हैं कि मॉड्यूल की असेंबली में क्या गलत है और समस्या को ठीक करें।

मुझे उम्मीद है कि यह लेख किसी को कुछ घंटों का समय बचाता है, क्योंकि मैंने व्यक्तिगत रूप से कई बार इस समस्या का सामना किया कि मॉड्यूल nginx फिट नहीं था, नतीजतन, एक नियम के रूप में, मैंने इसे सही मॉड्यूल के साथ nginx की पूर्ण विधानसभा के माध्यम से हल किया।

हमारे ब्लॉग पर अन्य लेख भी पढ़ें:

• हाशिकॉर्प कंसल के कुबेरनेट्स प्राधिकरण का परिचय
• प्राधिकरण के साथ ClickHouse को प्राधिकरण के बिना ClickHouse से माइग्रेशन का परिणाम क्या था
• नगीनेक्स वेब सर्वर के साथ स्प्रिंग एप्लीकेशन की ब्लू-ग्रीन तैनाती
• गोलंग में प्रसंग पैकेज को समझना
• डॉक छवियों को कम करने के लिए तीन सरल ट्रिक्स
• कुबेरनेट्स में स्टेटफ़ुल बैकअप