🐽 🧓🏾 📌 सर्वरलेस REST API "5 मिनट में घुटने पर" 🤵 🤥 🦉

नमस्कार, हेब्र! आज हम उन अवसरों के बारे में चर्चा जारी रखते हैं जो अमेज़ॅन वेब सर्विसेज हमें प्रदान करती हैं और एप्लिकेशन समस्याओं को हल करने में इन अवसरों का उपयोग कैसे करें।

एक सरल उदाहरण का उपयोग करते हुए, कुछ ही मिनटों में हमारे स्वयं के सर्वर रहित ऑटो-स्केलेबल REST API को केस पार्सिंग के साथ बनाने पर विचार करें - एक संसाधन के लिए एक सूची प्राप्त करना।

रुचि रखते हैं? फिर कट के नीचे जाओ!

(स्रोत)

ज्वाइन करने के बजाय

हम उदाहरण को पार्स करने के लिए किसी भी डेटाबेस का उपयोग नहीं करेंगे, इसके बजाय, हमारी जानकारी का स्रोत AWS S3 पर एक सादे पाठ फ़ाइल होगी।

तो, मान लीजिए कि AWS S3 पर हमारे पास हेडर के साथ एक टेक्स्ट फाइल है और कुछ प्रक्रिया इसकी जानकारी लिखती है।
हम एक क्लाउड एपीआई बनाएंगे जो JSON प्रतिक्रिया को पारित पैरामीटर के साथ GET अनुरोध के रूप में लौटाएगा।
उसी समय, कार्यों की जटिलता पर निर्भर करता है और, परिणामस्वरूप, संसाधनों की प्रसंस्करण शक्ति के लिए बढ़ती आवश्यकताओं, आपको इसके बारे में चिंता करने की ज़रूरत नहीं है, क्योंकि सेवा पूरी तरह से ऑटो-स्केलेबल है। और इसका मतलब है कि आपको किसी भी प्रशासन, सर्वर आवंटन और प्रबंधन की आवश्यकता नहीं है, बस अपना कोड अपलोड करें और इसे चलाएं।

विकास के तहत प्रणाली का आर्किटेक्चर

अमेज़न वेब सेवा घटक प्रयुक्त:

अमेज़ॅन एस 3 - ऑब्जेक्ट स्टोरेज, जो आपको लगभग असीमित मात्रा में जानकारी संग्रहीत करने की अनुमति देता है;
AWS पहचान और पहुंच प्रबंधन (IAM) - एक ऐसी सेवा जो AWS सेवाओं और संसाधनों तक सुरक्षित रूप से पहुंच को नियंत्रित करने की क्षमता प्रदान करती है। आईएएम का उपयोग करना, आप एडब्ल्यूएस उपयोगकर्ताओं और समूहों को बना सकते हैं, प्रबंधित कर सकते हैं, और एडब्ल्यूएस संसाधनों तक पहुंच प्रदान करने या अस्वीकार करने की अनुमति का उपयोग कर सकते हैं;
AWS लैम्ब्डा एक ऐसी सेवा है जो आपको सर्वर का बैक अप और कॉन्फ़िगरेशन किए बिना कोड चलाने की अनुमति देती है। प्रत्येक कॉलिंग के लिए सभी कंप्यूटिंग शक्ति स्वचालित रूप से बढ़ जाती है। शुल्क सुविधा अनुरोधों की संख्या और उनकी अवधि के आधार पर लिया जाता है, अर्थात्। समय जिसके दौरान कोड निष्पादित किया जाता है।
फ्री एक्सेस (फ्री टियर) का स्तर मुफ्त और 400K Gb-s के लिए प्रति माह 1 मिलियन अनुरोधों का अर्थ है। समर्थित भाषाएँ: Node.js, Java, C #, Go, Python, Ruby, PowerShell
। हम पायथन का उपयोग करेंगे:
- बोटो 3 पुस्तकालय पायथन के लिए एक एडब्ल्यूएस एसडीके है जो आपको विभिन्न अमेज़ॅन सेवाओं के साथ बातचीत करने की अनुमति देता है;
अमेज़ॅन एपीआई गेटवे किसी भी पैमाने पर एपीआई बनाने, प्रकाशित करने, बनाए रखने, निगरानी करने और सुरक्षित करने के लिए डिज़ाइन किया गया एक पूरी तरह से प्रबंधित डेवलपर सेवा है। डिबगिंग, शोधन और परीक्षण के लिए एक ही एपीआई (चरणों) के कई संस्करणों का उपयोग करने की क्षमता के अलावा, सेवा आपको एडब्ल्यूएस लैम्बडा का उपयोग करके सर्वर रहित रीस्ट एपीआई बनाने की अनुमति देती है। लैंबडा सर्वर वितरण, स्केलिंग और प्रबंधन की आवश्यकता को समाप्त करते हुए एक अत्यधिक सुलभ कंप्यूटिंग बुनियादी ढांचे में कोड निष्पादित करता है।
HTTP / REST API के लिए मुफ्त टियर में 12 महीनों के लिए प्रति माह एक मिलियन API कॉल शामिल हैं

डेटा की तैयारी

टैब के साथ एक टेक्स्ट फ़ाइल का उपयोग GET REST अनुरोध के जवाब देने के लिए सूचना के स्रोत के रूप में क्षेत्र परिसीमन के रूप में किया जाएगा। जानकारी अब इस उदाहरण के लिए ज्यादा मायने नहीं रखती है, लेकिन एपीआई के आगे उपयोग के लिए, मैंने क्विक ट्रेडिंग टर्मिनल से रूसी रूबल में निगमित बॉन्ड पर वर्तमान व्यापार की तालिका डाउनलोड की, इसे बॉन्ड में सहेजा।टैक्स में इसे सहेजा और इस फाइल को विशेष रूप से निर्मित एडब्ल्यूएस एस 3 बाल्टी में रखा।

प्राप्त जानकारी का एक उदाहरण नीचे दिए गए चित्र में दिखाया गया है:

इसके बाद, आपको एक फ़ंक्शन लिखने की ज़रूरत है जो बॉन्ड्स.टैक्स फ़ाइल से जानकारी पढ़ेगी, इसे पार्स करें और इसे अनुरोध पर जारी करें। AWS लाम्बा इसके साथ ठीक काम करेगा। लेकिन पहले, आपको एक नई भूमिका बनाने की आवश्यकता होगी जो निर्मित लैम्ब्डा फ़ंक्शन को AWS S3 में स्थित बाल्टी से जानकारी पढ़ने की अनुमति देगा।

AWS लाम्बा के लिए भूमिकाएँ बनाएँ

AWS प्रबंधन कंसोल में, AWS IAM सेवा पर जाएं और फिर "Roles" टैब पर, "भूमिका बनाएँ" बटन पर क्लिक करें;

एक नई भूमिका जोड़ना
अब हम जो भूमिका बना रहे हैं उसका उपयोग AWS S3 की जानकारी पढ़ने के लिए AWS लाम्बा द्वारा किया जाएगा। इसलिए, अगले चरण में, "चयनित प्रकार के भरोसेमंद" -> "सेवा सेवा" का चयन करें और "उस सेवा का चयन करें जो इस भूमिका का उपयोग करेगी" -> "लैम्ब्डा" और "अगला: अनुमतियां" बटन पर क्लिक करें।

लाम्बा सेवा भूमिका
अब आपको AWS संसाधनों के लिए पहुँच नीतियों को सेट करने की आवश्यकता है जिनका उपयोग नई बनाई गई भूमिका में किया जाएगा। क्योंकि नीतियों की सूची काफी प्रभावशाली है, नीतियों के लिए फ़िल्टर का उपयोग करते हुए, हम इसे "S3" इंगित करते हैं। परिणामस्वरूप, हमें S3 सेवा के लिए एक फ़िल्टर की गई सूची मिलती है। "AmazonS3ReadOnlyAccess" नीति के विपरीत चेकबॉक्स पर ध्यान दें और "अगला: टैग" बटन पर क्लिक करें।

रोल्स के लिए नीतियां
चरण (टैग जोड़ें (वैकल्पिक)) वैकल्पिक है, लेकिन आप वांछित होने पर रोल्स के लिए टैग निर्दिष्ट कर सकते हैं। हम ऐसा नहीं करेंगे और अगले चरण पर जाएं - पूर्वावलोकन। यहां आपको भूमिका का नाम निर्धारित करना होगा - "ForLambdaS3-ReadOnly", एक विवरण जोड़ें और "भूमिका बनाएँ" बटन पर क्लिक करें।

टाइटल रोल्स

सब कुछ, भूमिका बनाई गई है और हम इसे आगे के काम में उपयोग कर सकते हैं।

AWS लाम्बा में एक नई सुविधा बनाएँ

AWS लाम्बा सेवा पर जाएं और "फ़ंक्शन बनाएं" बटन पर क्लिक करें:

फंक्शन क्रिएशन

नीचे स्क्रीनशॉट में दिखाए अनुसार सभी फ़ील्ड भरें:
- नाम - "getAllBondsList";
- रनटाइम - "पायथन 3.6"
- भूमिका - "एक मौजूदा भूमिका चुनें"
- मौजूदा भूमिका - यहां हम उस भूमिका का चयन करते हैं जो हमने ऊपर बनाई थी - ForLambdaS3-ReadOnly
भूमिका का नाम और विकल्प
यह केवल फ़ंक्शन कोड लिखने और विभिन्न टेस्ट रन पर उसके प्रदर्शन की जांच करने के लिए बना हुआ है। यह ध्यान दिया जाना चाहिए कि किसी भी लैम्ब्डा फ़ंक्शन का मुख्य घटक (यदि आप पायथन का उपयोग करते हैं) boto3 लाइब्रेरी है:
```
import boto3 s3 = boto3.resource('s3') bucket = s3.Bucket('your-s3-bucket') obj = bucket.Object(key = 'bonds.txt') response = obj.get() 
```
हमारे पायथन फ़ंक्शन का मूल विचार इस प्रकार है:
- बंधन खोलें।
- कॉलम हेडर पढ़ें;
- पृष्ठ द्वारा रिकॉर्ड तोड़ना (हमारे मामले में 10 संग्रह);
- वांछित पृष्ठ का चयन करें;
- स्तंभों और अभिलेखों का नाम मानचित्रित करें;
- परिणाम को संग्रह के रूप में दें।
हम फ़ंक्शन कोड और तकनीकी कार्यान्वयन के लिए बहुत समय समर्पित नहीं करेंगे, यहां सब कुछ बहुत सरल है और मेरे GubHub में पूर्ण कोड उपलब्ध है ।
```
  for i in range(0, len(lines_proc)): d = dict((u''.join(key), u''.join(value)) for (key, value) in zip(headers, lines_proc[i].split("\t"))) response_body.append(d) return { 'statusCode': 200, 'page' : num_page, 'body': response_body } 
```
"फ़ंक्शन कोड" ब्लॉक में कोड डालें (या अपना खुद का :) लिखें) और स्क्रीन के ऊपरी दाएं कोने में "सहेजें" बटन पर क्लिक करें।

कोड प्रविष्टि
परीक्षण कार्यक्रम बनाएं। कोड डालने के बाद, फ़ंक्शन लॉन्च और परीक्षण के लिए उपलब्ध है। "टेस्ट" बटन पर क्लिक करें और कुछ टेस्ट ईवेंट बनाएं: विभिन्न मापदंडों के साथ lambda_handler फ़ंक्शन लॉन्च करना। अर्थात्:
- पैरामीटर 'पेज' के साथ एक फ़ंक्शन शुरू करना: '100';
- 'पेज' पैरामीटर के साथ एक फ़ंक्शन लॉन्च करना: '1000000';
- 'पेज' पैरामीटर के साथ एक फ़ंक्शन शुरू करना: 'bla-bla-bla';
- 'पेज' पैरामीटर के बिना फ़ंक्शन चलाना।
टेस्ट इवेंट पेज 100

टेस्ट इवेंट पेज भेजने के साथ निर्मित फ़ंक्शन शुरू करना == 100. जैसा कि नीचे स्क्रीनशॉट से देखा जा सकता है, फ़ंक्शन ने सफलतापूर्वक काम किया, स्थिति 200 (ओके) लौटा दी, साथ ही संग्रह का एक संग्रह जो पेजिनेशन का उपयोग करके विभाजित डेटा के सौवें पेज के अनुरूप है।

ट्रिगरिंग इवेंट इवेंट पेज 100

प्रयोग की शुद्धता के लिए, हम एक और परीक्षण कार्यक्रम शुरू करेंगे - "पेजब्लाब्ला"। इस स्थिति में, फ़ंक्शन कोड 415 के साथ परिणाम देता है और एक टिप्पणी जो पारित मापदंडों की शुद्धता की जांच करना आवश्यक है:

टेस्ट ईवेंट PageBlaBlaBla

PageBlaBlaBla ईवेंट ट्रिगर हो रहा है

एपीआई निर्माण

अन्य सभी मामलों का परीक्षण करने के बाद और एक समझ है कि लैम्ब्डा फ़ंक्शन काम करता है जैसा कि हम उम्मीद करते हैं, हम एपीआई बनाने के लिए आगे बढ़ते हैं। आइए ऊपर बनाए गए लैम्ब्डा फ़ंक्शन तक पहुंच बिंदु बनाएं और इसके अलावा एपीआई कुंजी का उपयोग करके अवांछित शुरुआत के खिलाफ सुरक्षा स्थापित करें।

AWS API गेटवे सेवा पर जाएं। एपीआई बनाएं बटन पर क्लिक करें, एपीआई नाम सेट करें - getAllBondsList

एक नया एपीआई बनाएं
नए बनाए गए API में GET विधि जोड़ें। ऐसा करने के लिए, क्रियाएँ चुनें -> विधि बनाएँ, ड्रॉप-डाउन सूची में जीईटी विधि का चयन करें और चेकमार्क पर क्लिक करें

नई विधि प्राप्त करें

अगला, हम संकेत देते हैं कि GET विधि हमारे लैम्ब्डा फ़ंक्शन getAllBondsList का उपयोग करेगी। इसे चुनें और सेव बटन पर क्लिक करें।

लैम्ब्डा फंक्शन बाइंडिंग
आइए हमारे एपीआई को तैनात करें, जिससे एपीआई को कॉल करने के लिए यूआरएल प्राप्त हो।
कार्रवाई पर क्लिक करें -> एपीआई तैनात करें, और फिर, तैनाती चरण -> नया चरण
एपीआई को विभिन्न चरणों में तैनात करना संभव है और आप इन चरणों को अपनी इच्छानुसार कॉल कर सकते हैं (उदाहरण के लिए, DEV / QA / PROD)। हम तुरंत PROD को तैनात करेंगे।
एपीआई तैनात करें

तैनाती के बाद, नव निर्मित एपीआई को लॉन्च करने के लिए एक लिंक उपलब्ध होगा। हम ब्राउज़र के एड्रेस बार में इस URL पर जाएंगे (या टर्मिनल में कर्ल कमांड को निष्पादित करेंगे) - हमें एक एपीआई कॉल मिलेगी और इसके परिणामस्वरूप, लैम्ब्डा फ़ंक्शन लॉन्च करें:

एपीआई यूआरएल

मैं एडब्ल्यूएस एपीआई गेटवे को प्रदर्शित करने के लिए पोस्टमैन एप्लिकेशन का उपयोग करूंगा। इसमें, आप काफी आराम से डिबग कर सकते हैं और एपीआई के संचालन का परीक्षण कर सकते हैं।

पहला एपीआई परीक्षण
URL को PROD स्टेज से Postman तक कॉपी करें और हमारे API पर GET रिक्वेस्ट भेजें:

कुछ गलत हो गया लगता है ... GET अनुरोध ने कोड 400 के साथ एक JSON प्रतिक्रिया और एक संकेत दिया कि पृष्ठ पैरामीटर API कॉल अनुरोध में सेट नहीं किया गया था। एपीआई के लिए अनुरोध मापदंडों के लिए समर्थन जोड़ें।
अनुरोध में पारित मापदंडों के लिए समर्थन।
हम GET अनुरोध की सेटिंग पर लौटते हैं और Method Request चरण पर जाते हैं।

विधि का अनुरोध

विधि अनुरोध की विस्तृत सेटिंग्स में, आपको URL क्वेरी स्ट्रिंग पैरामीटर ब्लॉक का विस्तार करना होगा और एक नया पैरामीटर "पेज" जोड़ना होगा और इसे आवश्यक बनाना होगा:

एक पैरामीटर जोड़ना

हम मेथड एक्ज़ीक्यूशन पेज पर वापस आते हैं और इंटीग्रेशन रिक्वेस्ट पर जाते हैं। हम पृष्ठ के निचले भाग में जाते हैं और "मैपिंग टेम्प्लेट" ब्लॉक खोलते हैं। सामग्री-प्रकार के क्षेत्र में "जब कोई परिभाषित नहीं (अनुशंसित)" का चयन करें, तो आवेदन / जौन निर्दिष्ट करें और चेकमार्क पर क्लिक करें। हम नीचे दिए गए पृष्ठ को स्क्रॉल करते हैं और पाठ बॉक्स में कोड दर्ज करते हैं, जैसा कि नीचे दी गई तस्वीर में दिखाया गया है। उसके बाद, सेव बटन पर क्लिक करें।

विधि का अनुरोध

पहले API परिनियोजन करने के बाद, हम फिर से जाँच करते हैं, लेकिन "पृष्ठ" पैरामीटर के साथ:

यह एक सफलता है! अब अनुरोध सफलतापूर्वक काम कर गया और हमारे पास दसवें पृष्ठ पर समाहित संग्रह लौट आया! हुर्रे!
यह केवल हमारे एपीआई को बाहर से अवांछित हमलों से बचाने के लिए बना हुआ है।

ऐसा करने के लिए, आपको एपीआई को इस तरह से कॉन्फ़िगर करने की आवश्यकता है कि इसे एक्सेस करने के लिए एक गुप्त कुंजी की आवश्यकता होती है, जिसे हेडर को पास किया जाता है।

API कुंजियों पर जाएं और API कुंजियों का एक नया गुच्छा बनाएं - KeyForBondsList।

एपीआई कुंजी

API कुंजी के सफलतापूर्वक बन जाने के बाद, आपको यह निर्दिष्ट करना होगा कि getAllBondsList API को अनुरोध शीर्षक में पास की जाने वाली एपीआई कुंजी की आवश्यकता होगी। और getAllBondsList एपीआई के लिए एक विशिष्ट KeyForBondsList बाँधें।

चलिए मेथड रिक्वेस्ट में GET रिक्वेस्ट की सेटिंग में जाते हैं और API Key आवश्यक पैरामीटर को असत्य से सत्य में बदलते हैं। अब एपीआई को एपीआई कुंजी के हस्तांतरण की आवश्यकता होगी।

एपीआई कुंजी आवश्यक है

उपयोग योजना पर जाएं और एपीआई का उपयोग करने के लिए एक नई योजना बनाएं।

सबसे पहले, हम इसे एक नाम और विवरण देते हैं, और दूसरा, यहां आप एपीआई लॉन्च करने की सीमा निर्धारित कर सकते हैं, उदाहरण के लिए, प्रति सेकंड एक से अधिक लॉन्च नहीं, आदि।

उपयोग योजना बनाना

अगला पर क्लिक करें और अगले पृष्ठ पर जाएं जहां आपको एपीआई के चरणों को उपयोग योजना से जोड़ने की आवश्यकता है:

एक उपयोग योजना के लिए एक स्टेज बांधना

अगले पृष्ठ पर, हम एपीआई कुंजी का उपयोग एपीआई की योजना के लिए करते हैं। उपयोग योजना बटन में ऐड एपीआई कीज़ पर क्लिक करें और पिछले चरणों में बनाए गए एपीआई कीज़ को नाम से खोजें:

बाइंडिंग एपीआई कीज़ टू यूज़ प्लान

तैनाती और हमारे एपीआई के जीईटी कॉल को फिर से चलाने के बाद, हमें जवाब मिलता है: "निषिद्ध", क्योंकि अनुरोध शीर्षलेख API API गुम है:

आइए एपीआई कीज़ से कॉपी करके इसे जोड़ने का प्रयास करें -> KeyForBondsList -> एपीआई कुंजी -> कुंजी "x-api-key" के साथ अनुरोध के संबंधित अनुभाग में इसे दिखाएं और पेस्ट करें:

सब कुछ काम कर गया! इस बार, अनुरोध बिना किसी समस्या के डेटा देता है, एपीआई कॉल गुप्त एपीआई कुंजी द्वारा घुसपैठियों से सुरक्षित और संरक्षित है।

निष्कर्ष और सारांश

इस लेख में, हमने अमेज़ॅन क्लाउड सेवाओं का उपयोग करते हुए एक सर्वर रहित ऑटो-स्केलेबल REST API बनाने पर ध्यान दिया। लेख वॉल्यूम में सबसे छोटा नहीं था, लेकिन मैंने एपीआई बनाने की पूरी प्रक्रिया को यथासंभव समझाने और कार्रवाई के पूरे अनुक्रम की रचना करने की कोशिश की।

मुझे यकीन है कि लेख में वर्णित चरणों के एक या दो दोहराव के बाद, आप अपने क्लाउड एपीआई को 5 मिनट या उससे भी अधिक समय तक बढ़ा सकते हैं।

अपनी रिश्तेदार सादगी, सस्तेपन और शक्ति के कारण, AWS API गेटवे सेवा डेवलपर्स के लिए काम और व्यावसायिक परियोजनाओं में उपयोग करने के व्यापक अवसर खोलती है। इस लेख में सैद्धांतिक सामग्री को समेकित करने के लिए, एक निशुल्क अमेज़ॅन वेब सेवा वार्षिक सदस्यता के लिए साइन अप करने और ऊपर दिए गए चरणों को करने के लिए REST API बनाने का प्रयास करें।

किसी भी प्रश्न और सुझाव के लिए, मैं खुशी के साथ बात करने के लिए तैयार हूं। मैं लेख पर आपकी टिप्पणियों के लिए तत्पर हूं और आपकी सफलता की कामना करता हूं!

सर्वरलेस REST API "5 मिनट में घुटने पर"