मी अधिकृतता आणि S3 सह माझे स्वतःचे PyPI भांडार बनवले. Nginx वर

या लेखात मी NJS सह माझा अनुभव सामायिक करू इच्छितो, Nginx Inc ने विकसित केलेल्या Nginx साठी JavaScript दुभाषी, वास्तविक उदाहरण वापरून त्याच्या मुख्य क्षमतांचे वर्णन करतो. NJS हा JavaScript चा उपसंच आहे जो तुम्हाला Nginx ची कार्यक्षमता वाढवण्याची परवानगी देतो. प्रश्नाला तुमचा स्वतःचा दुभाषी का??? दिमित्री व्हॉलिन्त्सेव्ह यांनी तपशीलवार उत्तर दिले. थोडक्यात: NJS हे nginx-वे आहे, आणि JavaScript अधिक प्रगतीशील, "नेटिव्ह" आणि GC शिवाय, Lua च्या विपरीत आहे.

फार पूर्वी…

माझ्या शेवटच्या नोकरीवर, मला डॉकर-कंपोज, डिंड आणि इतर आनंदांसह अनेक मोटली सीआय/सीडी पाइपलाइनसह गिटलॅबचा वारसा मिळाला, ज्या कानिको रेलमध्ये हस्तांतरित केल्या गेल्या. पूर्वी CI मध्ये वापरलेल्या प्रतिमा त्यांच्या मूळ स्वरूपात हलविण्यात आल्या होत्या. आमचा गिटलॅब आयपी बदलला आणि सीआय भोपळ्यात बदलला त्या दिवसापर्यंत त्यांनी व्यवस्थित काम केले. समस्या अशी होती की सीआयमध्ये सहभागी झालेल्या डॉकर प्रतिमांपैकी एक गिट होती, जी ssh द्वारे पायथन मॉड्यूल्स खेचते. ssh साठी तुम्हाला खाजगी की आवश्यक आहे आणि... ती ज्ञात_होस्ट्ससह इमेजमध्ये होती. आणि वास्तविक IP आणि ज्ञात_होस्ट्समध्ये निर्दिष्ट केलेल्या एकामध्ये जुळत नसल्यामुळे कोणतेही CI मुख्य सत्यापन त्रुटीसह अयशस्वी झाले. विद्यमान डॉकफाईल्समधून एक नवीन प्रतिमा द्रुतपणे एकत्र केली गेली आणि पर्याय जोडला गेला StrictHostKeyChecking no. पण वाईट चव कायम राहिली आणि libs खाजगी PyPI भांडारात हलवण्याची इच्छा होती. खाजगी PyPI वर स्विच केल्यानंतर अतिरिक्त बोनस, एक सोपी पाइपलाइन आणि आवश्यकतांचे सामान्य वर्णन होते.txt

निवड झाली आहे, सज्जनांनो!

आम्ही क्लाउड्स आणि कुबर्नेट्समध्ये सर्वकाही चालवतो आणि शेवटी आम्हाला एक छोटी सेवा मिळवायची होती जी बाह्य स्टोरेजसह स्टेटलेस कंटेनर होती. बरं, आम्ही S3 वापरत असल्याने, त्याला प्राधान्य दिले गेले. आणि, शक्य असल्यास, gitlab मध्ये प्रमाणीकरणासह (आवश्यक असल्यास आपण ते स्वतः जोडू शकता).

द्रुत शोधामुळे अनेक परिणाम मिळाले: s3pypi, pypicloud आणि सलगमसाठी html फाइल्सच्या "मॅन्युअल" निर्मितीसह पर्याय. शेवटचा पर्याय स्वतःच गायब झाला.

s3pypi: S3 होस्टिंग वापरण्यासाठी ही क्ली आहे. आम्ही फाइल्स अपलोड करतो, html जनरेट करतो आणि त्याच बकेटमध्ये अपलोड करतो. घरगुती वापरासाठी योग्य.

pypicloud: हा एक मनोरंजक प्रकल्प असल्यासारखे वाटले, परंतु दस्तऐवजीकरण वाचल्यानंतर मी निराश झालो. चांगले दस्तऐवजीकरण आणि आपल्या गरजेनुसार विस्तार करण्याची क्षमता असूनही, प्रत्यक्षात ते अनावश्यक आणि कॉन्फिगर करणे कठीण असल्याचे दिसून आले. त्यावेळच्या अंदाजानुसार, तुमच्या कार्यांसाठी कोड दुरुस्त करण्यासाठी ३-५ दिवस लागले असते. सेवेला डेटाबेस देखील आवश्यक आहे. आम्हाला दुसरे काही सापडले नाही तर आम्ही ते सोडले.

अधिक सखोल शोधामुळे Nginx, ngx_aws_auth साठी मॉड्यूल मिळाले. त्याच्या चाचणीचा परिणाम ब्राउझरमध्ये XML प्रदर्शित झाला, ज्याने S3 बकेटमधील सामग्री दर्शविली. शोधाच्या वेळी शेवटची कमिट एक वर्षापूर्वीची होती. भांडार भन्नाट दिसत होते.

स्रोतावर जाऊन वाचून पीईपी -503 माझ्या लक्षात आले की एक्सएमएल फ्लायवर एचटीएमएलमध्ये रूपांतरित केले जाऊ शकते आणि पिपला दिले जाऊ शकते. Nginx आणि S3 बद्दल थोडे अधिक गुगल केल्यानंतर, Nginx साठी JS मध्ये लिहिलेल्या S3 मधील प्रमाणीकरणाचे उदाहरण मला मिळाले. अशातच मी NJS ला भेटलो.

हे उदाहरण आधार म्हणून घेतल्यास, एका तासानंतर मी माझ्या ब्राउझरमध्ये ngx_aws_auth मॉड्यूल वापरताना समान XML पाहिले, परंतु सर्वकाही जेएसमध्ये आधीच लिहिलेले होते.

मला nginx सोल्यूशन खरोखर आवडले. प्रथम, चांगले दस्तऐवजीकरण आणि बरीच उदाहरणे, दुसरे म्हणजे, आम्हाला फायलींसह (बॉक्सच्या बाहेर) काम करण्यासाठी Nginx च्या सर्व वस्तू मिळतात, तिसरे म्हणजे, Nginx साठी कॉन्फिगरेशन कसे लिहायचे हे माहित असलेल्या कोणालाही काय आहे ते समजण्यास सक्षम असेल. मिनिमलिझम देखील माझ्यासाठी एक प्लस आहे, पायथन किंवा गो (जर सुरवातीपासून लिहिले असल्यास), नेक्ससचा उल्लेख करू नका.

TL;DR 2 दिवसांनंतर, PyPi ची चाचणी आवृत्ती आधीच CI मध्ये वापरली गेली होती.

ते कसे कार्य करते?

मॉड्यूल Nginx मध्ये लोड केले आहे ngx_http_js_module, अधिकृत डॉकर प्रतिमेमध्ये समाविष्ट आहे. आम्ही निर्देश वापरून आमची स्क्रिप्ट आयात करतो js_importNginx कॉन्फिगरेशनमध्ये. फंक्शनला निर्देशाद्वारे कॉल केले जाते js_content. डायरेक्टिव्हचा वापर व्हेरिएबल्स सेट करण्यासाठी केला जातो js_set, जे फक्त स्क्रिप्टमध्ये वर्णन केलेले फंक्शन एक युक्तिवाद म्हणून घेते. परंतु आम्ही NJS मध्ये फक्त Nginx वापरून सबक्वेरी कार्यान्वित करू शकतो, कोणत्याही XMLHttpRequest नाही. हे करण्यासाठी, Nginx कॉन्फिगरेशनमध्ये संबंधित स्थान जोडणे आवश्यक आहे. आणि स्क्रिप्टमध्ये या स्थानासाठी सबरिक्वेस्टचे वर्णन करणे आवश्यक आहे. Nginx कॉन्फिगरेशनमधून फंक्शनमध्ये प्रवेश करण्यास सक्षम होण्यासाठी, फंक्शनचे नाव स्क्रिप्टमध्येच निर्यात केले जाणे आवश्यक आहे export default.

nginx.conf

load_module modules/ngx_http_js_module.so;
http {
  js_import   imported_name  from script.js;

server {
  listen 8080;
  ...
  location = /sub-query {
    internal;

    proxy_pass http://upstream;
  }

  location / {
    js_content imported_name.request;
  }
}

script.js

function request(r) {
  function call_back(resp) {
    // handler's code
    r.return(resp.status, resp.responseBody);
  }

  r.subrequest('/sub-query', { method: r.method }, call_back);
}

export default {request}

जेव्हा ब्राउझरमध्ये विनंती केली जाते http://localhost:8080/ आम्ही प्रवेश करतो location /ज्यामध्ये निर्देश आहे js_content फंक्शन कॉल करते request आमच्या स्क्रिप्टमध्ये वर्णन केले आहे script.js. यामधून, फंक्शनमध्ये request एक सबक्वेरी केली जाते location = /sub-query, युक्तिवादातून मिळवलेल्या पद्धतीसह (सध्याच्या उदाहरणात GET). (r), जेव्हा हे फंक्शन कॉल केले जाते तेव्हा अस्पष्टपणे पास होते. उप-रिक्वेस्टच्या प्रतिसादावर फंक्शनमध्ये प्रक्रिया केली जाईल call_back.

S3 प्रयत्न करत आहे

खाजगी S3 स्टोरेजसाठी विनंती करण्यासाठी, आम्हाला आवश्यक आहे:

ACCESS_KEY

SECRET_KEY

S3_BUCKET

वापरलेल्या http पद्धतीवरून, वर्तमान तारीख/वेळ, S3_NAME आणि URI, विशिष्ट प्रकारची स्ट्रिंग तयार केली जाते, जी SECRET_KEY वापरून स्वाक्षरी (HMAC_SHA1) केली जाते. पुढे अशी एक ओळ आहे AWS $ACCESS_KEY:$HASH, अधिकृतता शीर्षलेख मध्ये वापरले जाऊ शकते. मागील चरणात स्ट्रिंग व्युत्पन्न करण्यासाठी वापरलेली तारीख/वेळ हेडरमध्ये जोडली जाणे आवश्यक आहे X-amz-date. कोडमध्ये हे असे दिसते:

nginx.conf

load_module modules/ngx_http_js_module.so;
http {
  js_import   s3      from     s3.js;

  js_set      $s3_datetime     s3.date_now;
  js_set      $s3_auth         s3.s3_sign;

server {
  listen 8080;
  ...
  location ~* /s3-query/(?<s3_path>.*) {
    internal;

    proxy_set_header    X-amz-date     $s3_datetime;
    proxy_set_header    Authorization  $s3_auth;

    proxy_pass          $s3_endpoint/$s3_path;
  }

  location ~ "^/(?<prefix>[w-]*)[/]?(?<postfix>[w-.]*)$" {
    js_content s3.request;
  }
}

s3.js(AWS साइन v2 अधिकृतता उदाहरण, नापसंत स्थितीत बदलले)

var crypt = require('crypto');

var s3_bucket = process.env.S3_BUCKET;
var s3_access_key = process.env.S3_ACCESS_KEY;
var s3_secret_key = process.env.S3_SECRET_KEY;
var _datetime = new Date().toISOString().replace(/[:-]|.d{3}/g, '');

function date_now() {
  return _datetime
}

function s3_sign(r) {
  var s2s = r.method + 'nnnn';

  s2s += `x-amz-date:${date_now()}n`;
  s2s += '/' + s3_bucket;
  s2s += r.uri.endsWith('/') ? '/' : r.variables.s3_path;

  return `AWS ${s3_access_key}:${crypt.createHmac('sha1', s3_secret_key).update(s2s).digest('base64')}`;
}

function request(r) {
  var v = r.variables;

  function call_back(resp) {
    r.return(resp.status, resp.responseBody);
  }

  var _subrequest_uri = r.uri;
  if (r.uri === '/') {
    // root
    _subrequest_uri = '/?delimiter=/';

  } else if (v.prefix !== '' && v.postfix === '') {
    // directory
    var slash = v.prefix.endsWith('/') ? '' : '/';
    _subrequest_uri = '/?prefix=' + v.prefix + slash;
  }

  r.subrequest(`/s3-query${_subrequest_uri}`, { method: r.method }, call_back);
}

export default {request, s3_sign, date_now}

बद्दल थोडे स्पष्टीकरण _subrequest_uri: हा एक व्हेरिएबल आहे जो प्रारंभिक uri वर अवलंबून, S3 ला विनंती करतो. जर तुम्हाला "रूट" ची सामग्री मिळवायची असेल, तर तुम्हाला डिलिमिटर दर्शविणारी uri विनंती तयार करावी लागेल. delimiter, जे सर्व CommonPrefixes xml घटकांची सूची परत करेल, निर्देशिकांशी संबंधित (PyPI च्या बाबतीत, सर्व पॅकेजेसची सूची). तुम्हाला एखाद्या विशिष्ट निर्देशिकेत (सर्व पॅकेज आवृत्त्यांची सूची) सामग्रीची सूची मिळवायची असल्यास, uri विनंतीमध्ये निर्देशिका (पॅकेज) च्या नावासह एक उपसर्ग फील्ड असणे आवश्यक आहे जे स्लॅश / ने समाप्त होईल. अन्यथा, निर्देशिकेतील सामग्रीची विनंती करताना टक्कर शक्य आहे, उदाहरणार्थ. aiohttp-request आणि aiohttp-requests आणि विनंती निर्दिष्ट केल्यास निर्देशिका आहेत /?prefix=aiohttp-request, नंतर प्रतिसादात दोन्ही निर्देशिकांची सामग्री असेल. शेवटी स्लॅश असल्यास, /?prefix=aiohttp-request/, नंतर प्रतिसादात फक्त आवश्यक निर्देशिका असेल. आणि जर आपण फाईलची विनंती केली, तर परिणामी uri मूळपेक्षा वेगळी नसावी.

Nginx जतन करा आणि रीस्टार्ट करा. ब्राउझरमध्ये आम्ही आमच्या Nginx चा पत्ता प्रविष्ट करतो, विनंतीचा परिणाम XML असेल, उदाहरणार्थ:

निर्देशिकांची यादी

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>myback-space</Name>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys>10000</MaxKeys>
  <Delimiter>/</Delimiter>
  <IsTruncated>false</IsTruncated>
  <CommonPrefixes>
    <Prefix>new/</Prefix>
  </CommonPrefixes>
  <CommonPrefixes>
    <Prefix>old/</Prefix>
  </CommonPrefixes>
</ListBucketResult>

निर्देशिकांच्या सूचीमधून आपल्याला फक्त घटकांची आवश्यकता असेल CommonPrefixes.

आम्हाला ब्राउझरमधील आमच्या पत्त्यावर आवश्यक असलेली निर्देशिका जोडून, ​​आम्ही त्यातील सामग्री XML स्वरूपात देखील प्राप्त करू:

निर्देशिकेतील फाइल्सची सूची

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name> myback-space</Name>
  <Prefix>old/</Prefix>
  <Marker></Marker>
  <MaxKeys>10000</MaxKeys>
  <Delimiter></Delimiter>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>old/giphy.mp4</Key>
    <LastModified>2020-08-21T20:27:46.000Z</LastModified>
    <ETag>&#34;00000000000000000000000000000000-1&#34;</ETag>
    <Size>1350084</Size>
    <Owner>
      <ID>02d6176db174dc93cb1b899f7c6078f08654445fe8cf1b6ce98d8855f66bdbf4</ID>
      <DisplayName></DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <Contents>
    <Key>old/hsd-k8s.jpg</Key>
    <LastModified>2020-08-31T16:40:01.000Z</LastModified>
    <ETag>&#34;b2d76df4aeb4493c5456366748218093&#34;</ETag>
    <Size>93183</Size>
    <Owner>
      <ID>02d6176db174dc93cb1b899f7c6078f08654445fe8cf1b6ce98d8855f66bdbf4</ID>
      <DisplayName></DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
</ListBucketResult>

फायलींच्या सूचीमधून आम्ही फक्त घटक घेऊ Key.

जे उरते ते म्हणजे परिणामी XML पार्स करणे आणि ते HTML म्हणून पाठवणे, प्रथम मजकूर/html सह सामग्री-प्रकार शीर्षलेख बदलणे.

function request(r) {
  var v = r.variables;

  function call_back(resp) {
    var body = resp.responseBody;

    if (r.method !== 'PUT' && resp.status < 400 && v.postfix === '') {
      r.headersOut['Content-Type'] = "text/html; charset=utf-8";
      body = toHTML(body);
    }

    r.return(resp.status, body);
  }
  
  var _subrequest_uri = r.uri;
  ...
}

function toHTML(xml_str) {
  var keysMap = {
    'CommonPrefixes': 'Prefix',
    'Contents': 'Key',
  };

  var pattern = `<k>(?<v>.*?)</k>`;
  var out = [];

  for(var group_key in keysMap) {
    var reS;
    var reGroup = new RegExp(pattern.replace(/k/g, group_key), 'g');

    while(reS = reGroup.exec(xml_str)) {
      var data = new RegExp(pattern.replace(/k/g, keysMap[group_key]), 'g');
      var reValue = data.exec(reS);
      var a_text = '';

      if (group_key === 'CommonPrefixes') {
        a_text = reValue.groups.v.replace(///g, '');
      } else {
        a_text = reValue.groups.v.split('/').slice(-1);
      }

      out.push(`<a href="/mr/${reValue.groups.v}">${a_text}</a>`);
    }
  }

  return '<html><body>n' + out.join('</br>n') + 'n</html></body>'
}

PyPI प्रयत्न करत आहे

आम्ही तपासतो की कार्य करण्यासाठी ज्ञात असलेल्या पॅकेजेसवर कुठेही काहीही खंडित होत नाही.

# Создаем для тестов новое окружение
python3 -m venv venv
. ./venv/bin/activate

# Скачиваем рабочие пакеты.
pip download aiohttp

# Загружаем в приватную репу
for wheel in *.whl; do curl -T $wheel http://localhost:8080/${wheel%%-*}/$wheel; done

rm -f *.whl

# Устанавливаем из приватной репы
pip install aiohttp -i http://localhost:8080

आम्ही आमच्या libs सह पुनरावृत्ती.

# Создаем для тестов новое окружение
python3 -m venv venv
. ./venv/bin/activate

pip install setuptools wheel
python setup.py bdist_wheel
for wheel in dist/*.whl; do curl -T $wheel http://localhost:8080/${wheel%%-*}/$wheel; done

pip install our_pkg --extra-index-url http://localhost:8080

CI मध्ये, पॅकेज तयार करणे आणि लोड करणे असे दिसते:

pip install setuptools wheel
python setup.py bdist_wheel

curl -sSfT dist/*.whl -u "gitlab-ci-token:${CI_JOB_TOKEN}" "https://pypi.our-domain.com/${CI_PROJECT_NAME}"

प्रमाणीकरण

Gitlab मध्ये बाह्य सेवांच्या प्रमाणीकरण/अधिकृतीकरणासाठी JWT वापरणे शक्य आहे. Nginx मधील auth_request निर्देश वापरून, आम्ही प्रमाणीकरण डेटा स्क्रिप्टमधील फंक्शन कॉल असलेल्या सबरिक्वेस्टवर पुनर्निर्देशित करू. स्क्रिप्ट गिटलॅब url ला आणखी एक सबरिक्वेस्ट करेल आणि जर ऑथेंटिकेशन डेटा योग्यरित्या निर्दिष्ट केला असेल, तर Gitlab कोड 200 परत करेल आणि पॅकेज अपलोड/डाउनलोड करण्याची परवानगी असेल. एक सबक्वेरी का वापरत नाही आणि लगेच डेटा Gitlab ला पाठवायचा? कारण मग प्रत्येक वेळी आम्ही अधिकृततेमध्ये कोणतेही बदल केल्यावर आम्हाला Nginx कॉन्फिगरेशन फाइल संपादित करावी लागेल आणि हे खूप त्रासदायक काम आहे. तसेच, जर Kubernetes केवळ-वाचनीय रूट फाइलसिस्टम धोरण वापरत असेल, तर configmap द्वारे nginx.conf बदलताना हे आणखी जटिलता जोडते. आणि एकाच वेळी व्हॉल्यूम (पीव्हीसी) आणि केवळ-वाचनीय रूट फाइलसिस्टम (हे देखील घडते) कनेक्शन प्रतिबंधित धोरणे वापरत असताना कॉन्फिगरमॅपद्वारे Nginx कॉन्फिगर करणे पूर्णपणे अशक्य होते.

NJS इंटरमीडिएट वापरून, आम्हाला एनजिनक्स कॉन्फिगरेशनमधील निर्दिष्ट पॅरामीटर्स पर्यावरण व्हेरिएबल्स वापरून बदलण्याची आणि स्क्रिप्टमध्ये काही तपासणी करण्याची संधी मिळते (उदाहरणार्थ, चुकीची निर्दिष्ट URL).

nginx.conf

location = /auth-provider {
  internal;

  proxy_pass $auth_url;
}

location = /auth {
  internal;

  proxy_set_header Content-Length "";
  proxy_pass_request_body off;
  js_content auth.auth;
}

location ~ "^/(?<prefix>[w-]*)[/]?(?<postfix>[w-.]*)$" {
  auth_request /auth;

  js_content s3.request;
}

s3.js

var env = process.env;
var env_bool = new RegExp(/[Tt]rue|[Yy]es|[Oo]n|[TtYy]|1/);
var auth_disabled  = env_bool.test(env.DISABLE_AUTH);
var gitlab_url = env.AUTH_URL;

function url() {
  return `${gitlab_url}/jwt/auth?service=container_registry`
}

function auth(r) {
  if (auth_disabled) {
    r.return(202, '{"auth": "disabled"}');
    return null
  }

  r.subrequest('/auth-provider',
                {method: 'GET', body: ''},
                function(res) {
                  r.return(res.status, "");
                });
}

export default {auth, url}

बहुधा प्रश्न तयार होत आहे: - रेडीमेड मॉड्यूल का वापरत नाहीत? तेथे सर्व काही आधीच केले गेले आहे! उदाहरणार्थ, var AWS = require('aws-sdk') आणि S3 प्रमाणीकरणासह “bike” लिहिण्याची गरज नाही!

चला बाधकांकडे जाऊया

माझ्यासाठी, बाह्य JS मॉड्यूल्स आयात करण्यास असमर्थता एक अप्रिय, परंतु अपेक्षित वैशिष्ट्य बनले. वरच्या उदाहरणामध्ये आवश्यक ('क्रिप्टो') वर्णन केले आहे बिल्ड-इन मॉड्यूल्स आणि त्यांच्यासाठी फक्त कामांची आवश्यकता आहे. स्क्रिप्टमधून कोड पुन्हा वापरण्याचा कोणताही मार्ग नाही आणि तुम्हाला तो वेगवेगळ्या फाइल्समध्ये कॉपी आणि पेस्ट करावा लागेल. मला आशा आहे की एखाद्या दिवशी ही कार्यक्षमता लागू होईल.

Nginx मधील वर्तमान प्रकल्पासाठी कॉम्प्रेशन देखील अक्षम केले जाणे आवश्यक आहे gzip off;

कारण NJS मध्ये कोणतेही gzip मॉड्यूल नाही आणि ते कनेक्ट करणे अशक्य आहे; म्हणून, संकुचित डेटासह कार्य करण्याचा कोणताही मार्ग नाही. खरे आहे, या प्रकरणात हे खरोखर एक वजा नाही. तेथे खूप मजकूर नाही आणि हस्तांतरित केलेल्या फायली आधीच संकुचित केल्या आहेत आणि अतिरिक्त कॉम्प्रेशन त्यांना जास्त मदत करणार नाही. तसेच, ही इतकी लोड केलेली किंवा गंभीर सेवा नाही की तुम्हाला सामग्री काही मिलिसेकंद जलद वितरीत करण्यासाठी त्रास द्यावा लागेल.

स्क्रिप्ट डीबग करण्यासाठी बराच वेळ लागतो आणि error.log मधील “प्रिंट्स” द्वारेच शक्य आहे. सेट लॉगिंग पातळी माहिती, चेतावणी किंवा त्रुटी यावर अवलंबून, अनुक्रमे r.log, r.warn, r.error या 3 पद्धती वापरणे शक्य आहे. मी Chrome (v8) किंवा njs कन्सोल टूलमध्ये काही स्क्रिप्ट डीबग करण्याचा प्रयत्न करतो, परंतु तेथे सर्वकाही तपासले जाऊ शकत नाही. कोड डीबग करताना, उर्फ ​​​​फंक्शनल चाचणी, इतिहास असे काहीतरी दिसते:

docker-compose restart nginx
curl localhost:8080/
docker-compose logs --tail 10 nginx

आणि असे शेकडो क्रम असू शकतात.

त्यांच्यासाठी सबक्वेरी आणि व्हेरिएबल्स वापरून कोड लिहिणे गोंधळलेल्या गोंधळात बदलते. काहीवेळा तुम्ही तुमच्या कोडच्या क्रियांचा क्रम शोधण्याचा प्रयत्न करत वेगवेगळ्या IDE खिडक्यांभोवती धावू लागता. हे अवघड नाही, परंतु कधीकधी ते खूप त्रासदायक असते.

ES6 साठी पूर्ण समर्थन नाही.

इतर काही उणीवा असू शकतात, पण मला अजून काही आढळले नाही. तुम्हाला NJS वापरण्याचा नकारात्मक अनुभव असल्यास माहिती शेअर करा.

निष्कर्ष

NJS हा एक हलका ओपन-सोर्स इंटरप्रिटर आहे जो तुम्हाला Nginx मध्ये विविध JavaScript स्क्रिप्ट लागू करण्याची परवानगी देतो. त्याच्या विकासादरम्यान, कार्यक्षमतेवर खूप लक्ष दिले गेले. अर्थात, अजूनही बरेच काही गहाळ आहे, परंतु प्रकल्प एका लहान संघाद्वारे विकसित केला जात आहे आणि ते सक्रियपणे नवीन वैशिष्ट्ये जोडत आहेत आणि दोष निराकरण करत आहेत. मला आशा आहे की एखाद्या दिवशी NJS तुम्हाला बाह्य मॉड्यूल कनेक्ट करण्याची परवानगी देईल, ज्यामुळे Nginx कार्यक्षमता जवळजवळ अमर्यादित होईल. पण एनजीआयएनएक्स प्लस आहे आणि बहुधा कोणतीही वैशिष्ट्ये नसतील!

लेखासाठी संपूर्ण कोडसह भांडार

AWS साइन v4 समर्थनासह njs-pypi

ngx_http_js_module मॉड्यूलच्या निर्देशांचे वर्णन

अधिकृत NJS भांडार и दस्तऐवजीकरण

दिमित्री व्हॉलिन्टसेव्ह कडून एनजेएस वापरण्याची उदाहरणे

njs - nginx मध्ये मूळ JavaScript स्क्रिप्टिंग / सेंट हायलोड++ 2019 येथे दिमित्री व्होल्नीव्ह यांचे भाषण

उत्पादनात NJS / HighLoad++ 2019 वर वसिली सोश्निकोव्ह यांचे भाषण

AWS मध्ये REST विनंत्यांवर स्वाक्षरी करणे आणि प्रमाणीकरण करणे

स्त्रोत: www.habr.com