OpenWhisk पर आधारित सर्वर रहित कंप्यूटिंग, भाग 3

यह लेख प्रीति देसाई द्वारा ओपनविस्क के बारे में अनुवादित नोट्स की श्रृंखला जारी है। आज हम ज़िप फ़ंक्शंस, GitHub निर्भरता को तैनात करने के उदाहरणों को देखेंगे, और क्लाइंट और OpenWhisk सर्वर के बीच ऑब्जेक्ट्स के सिंक्रनाइज़ेशन का अधिक विस्तार से वर्णन करेंगे।

जिप कार्य

OpenWhisk एकल स्रोत फ़ाइल से फ़ंक्शन बनाने का समर्थन करता है, क्योंकि यह [पहले दिखाया गया था] ()। यह स्रोत कोड के साथ कई फ़ाइलों का उपयोग करके फ़ंक्शन के निर्माण का भी समर्थन करता है और पैकेज का एक सेट जिस पर फ़ंक्शन निर्भर करता है। फ़ंक्शन के लिए इस उपयोग के मामले को एक ज़िप फ़ंक्शन कहा जाता है। चलो wskdeploy का उपयोग करके एक ज़िप फ़ंक्शन को तैनात करने का प्रयास करें।

पहला कदम

एक मैनिफ़ेस्ट फ़ाइल बनाएँ:

 packages: zipaction: actions: my-zip-action: function: actions/my-zip-action runtime: nodejs:6 inputs: name: Amy 

हम मानते हैं कि my-zip-action में ऐसी निर्देशिका संरचना है जिसमें फ़ंक्शन का स्रोत कोड होता है:

 $ ls actions/my-zip-action index.js package.json 

Index.js फ़ाइल की सामग्री:

 function helloworld(params) { var format = require('string-format'); var name = params.name || 'Stranger'; payload = format('Hello, {}!', name) return { message: payload }; } exports.main = helloworld; 

Package.json फ़ाइल की सामग्री:

 { "name": "my-zip-action", "description": "Node OpenWhisk zip action to demo Whisk Deploy", "license": "Apache-2.0", "version": "1.0.0", "main": "index.js", "dependencies": { "string-format": "0.5.0" } } 

दूसरा कदम

स्ट्रिंग प्रारूप को स्थापित करने के लिए npm स्थापित रन:

 cd actions/my-action npm install --production 

चरण तीन

ज़िप फ़ंक्शन का विस्तार करें:

 ./wskdeploy -i -p actions/my-zip-action/ ____ ___ _ _ _ _ _ /\ \ / _ \ _ __ ___ _ __ | | | | |__ (_)___| | __ /\ /__\ \ | | | | '_ \ / _ \ '_ \| | | | '_ \| / __| |/ / / \____ \ / | |_| | |_) | __/ | | | |/\| | | | | \__ \ < \ \ / \/ \___/| .__/ \___|_| |_|__/\__|_| |_|_|___/_|\_\ \___\/ |_| Packages: Name: zipaction bindings: * action: my-zip-action bindings: - name: name value: Amy Do you really want to deploy this? (y/N): y Deployment completed successfully. 

हमने डिपेंडेंट मॉड्यूल string-format साथ जिप फंक्शन माय-जिप-एक्शन को तैनात किया है। function कुंजी के साथ प्रकट में एक निर्देशिका निर्दिष्ट करते समय, इस निर्देशिका से एक ज़िप संग्रह बनाया जाता है, और इस संग्रह से एक फ़ंक्शन भी होता है, इसलिए आपको फ़ाइल सिस्टम में इसे खोजने की आवश्यकता नहीं है। तैनाती के बाद, आप नए फ़ंक्शन के साथ उसी तरह काम कर सकते हैं जैसे अन्य कार्यों के साथ।

ज़िप कार्यों में फ़ाइलों के लिए शामिल करें और बहिष्कृत करें

OpenWhisk आपको एक ज़िप संग्रह का उपयोग करके फ़ंक्शन बनाने की अनुमति देता है, जिसमें फ़ंक्शन के लिए किसी भी संख्या में फाइलें शामिल हैं उसके सभी व्यसनों। कार्य को कार्य करने के लिए फ़ाइलों के साथ निर्देशिका में function निर्दिष्ट करने के लिए परिनियोजन का समर्थन करता है। निर्देशिका की सामग्री से एक संग्रह बनाया जाएगा, जिसमें से फ़ंक्शन पहले से ही तैनात किया जाएगा।

फ़ाइल समावेशन

पहले, इसमें include कुंजी को निर्दिष्ट करना संभव था, जो प्रोग्रामिंग भाषाओं में import के समान ही काम करता है, जिसकी अनुमति है, उदाहरण के लिए, कोड के साथ एक ही पुस्तकालय को संदर्भित करने के लिए कई कार्य:

 $ cd actions/ $ ls -1 ./ common/ greeting1/ greeting2/ manifest.yaml $ ls -1 common/ utils.js $ ls -1 greeting1/ index.js package.json $ ls -1 greeting2/ index.js package.json 

आप index.js फ़ाइल को utils.js डायरेक्टरी में देख सकते हैं, साथ ही utils.js डायरेक्टरी में एक और utils.js , और दोनों utils.js को देखें।

Index.js फ़ाइल की सामग्री actions/greeting1/ में स्थित है:

 /** * Return a simple greeting message for someone. * * @param name A person's name. * @param place Where the person is from. */ var common = require('./common/utils.js') function main(params) { var name = params.name || params.payload || 'stranger'; var place = params.place || 'somewhere'; var hello = common.hello || 'Good Morning'; return {payload: hello + ', ' + name + ' from ' + place + '!'}; } exports.main = main; 

Index.js फ़ाइल की सामग्री actions/greeting2/ में स्थित है:

 /** * Return a simple greeting message for someone. * * @param name A person's name. * @param place Where the person is from. */ var common = require('./common/utils.js') function main(params) { var name = params.name || params.payload || 'stranger'; var place = params.place || 'somewhere'; var hello = common.hello || 'Good Evening'; return {payload: hello + ', ' + name + ' from ' + place + '!'}; } exports.main = main; 

अंदर include कुंजी में फ़ाइलों या निर्देशिकाओं की एक सूची होती है जिन्हें फ़ंक्शन में शामिल किया जाना चाहिए। इस सूची के प्रत्येक तत्व में source और \ या destination होना चाहिए, उदाहरण के लिए:

 include: - [source] - [source, destination] 

टिप्पणी:

• source में manimanifest.yaml युक्त निर्देशिका से संबंधित पथ शामिल है। destination तात्पर्य फ़ंक्शन निर्देशिका से सापेक्ष पथ से है, उदाहरण के लिए actions/greeting1 और actions/greeting2 निम्नलिखित उदाहरण में।
• यदि destination निर्दिष्ट नहीं है, तो यह माना जाता है कि यह source के समान होगा।

मैनिफ़ेस्ट फ़ाइल की सामग्री:

 packages: zipactionwithinclude: actions: greeting1: function: actions/greeting1 runtime: nodejs:6 include: - ["actions/common/utils.js", "common/utils.js"] greeting2: function: actions/greeting2 runtime: nodejs:6 include: - ["actions/common/utils.js", "common/utils.js"] 

source और destination विभिन्न संयोजनों के साथ कार्य include :

• बस source :

 include: - [actions/common/utils.js] 

इस प्रविष्टि के साथ, utils.js को actions/greeting/actions/common/utils.js कॉपी किया जाएगा, और index.js इसे इस तरह संदर्भित कर सकते हैं:

 var utils = require('./actions/common/utils.js') 

• नाम बदलने के साथ include करें:

 include: - ["actions/common/utils.js", "./common/myUtils.js"] 

इस परिभाषा के साथ, utils.js को पथ actions/greeting/common/myUtils.js साथ रखा जाएगा, और index.js इसे इस तरह संदर्भित करेंगे:

 var utils = require('./common/myUtils.js') 

• दूसरे तरीके से शामिल करें:

 include: - ["actions/common/utils.js", "./common/utility/utils.js"] 

इस स्थिति में, utils.js को actions/greeting/common/utility/utils.js कॉपी किया जाएगा, जिसमें index.js लिंक होगा:

 var utils = require('./common/utility/utils.js') 

• प्रतीक के साथ include करें * :

 include: - ["actions/common/*.js", "./common/"] 

इस संस्करण में, utils.js के साथ अन्य फाइलों के साथ utils.js .js को actions/greeting/common/ निर्देशिका में कॉपी किया जाएगा, और index.js इन फ़ाइलों को इस तरह से जोड़ा जाएगा:

 var utils = require('./common/utils.js') 

निर्देशिका समावेश

इसमें include आप एक निर्देशिका निर्दिष्ट कर सकते हैं जिसे संग्रह में शामिल किए जाने से पहले निर्दिष्ट स्थान पर कॉपी किया जाएगा। उदाहरण के लिए, libs`` ,

 $ cd actions/ $ ls -1 libs/ greeting3/ manifest.yaml $ ls -1 libs/ lib1/ lib2/ lib3/ $ ls -1 libs/lib1/ utils.js $ ls -1 libs/lib2/ utils.js $ ls -1 libs/lib3/ utils.js $ ls -1 greeting3/ index.js package.json 

Index.js की सामग्री actions/greeting3/ निर्देशिका:

 /** * Return a simple greeting message for someone. * * @param name A person's name. * @param place Where the person is from. */ var lib1 = require('./libs/lib1/utils.js') var lib2 = require('./libs/lib2/utils.js') var lib3 = require('./libs/lib3/utils.js') function main(params) { var name = params.name || params.payload || 'stranger'; var place = params.place || 'somewhere'; var hello = lib1.hello || lib2.hello || lib3.hello || 'Hello'; return {payload: hello + ', ' + name + ' from ' + place + '!'}; } exports.main = main; 

मैनिफ़ेस्ट फ़ाइल की सामग्री:

 packages: zipactionwithinclude: actions: greeting3: function: actions/greeting3 runtime: nodejs:6 include: - ["actions/libs/*", "libs/"] 

इस उदाहरण में, libs डायरेक्टरी पूरी तरह से actions/greeting3/libs/ नकल की जाती है।

निर्देशिकाओं को प्रतीक से जोड़ना * :

• उदाहरण 1:

 include: - ["actions/libs/*/utils.js", "libs/"] 

इस लेखन के साथ सभी उपनिर्देशिकाएं जिनमें utils.js को utils.js से कॉपी किया जाएगा। index.js लिंक इस तरह दिखेंगे:

 var lib1 = require('./libs/lib1/utils.js') var lib2 = require('./libs/lib2/utils.js') var lib3 = require('./libs/lib3/utils.js') 

• उदाहरण 2:

 include: - ["actions/*/*/utils.js"] 

इस प्रविष्टि के साथ, मुखौटा और utils.js मिलान वाले सभी उपनिर्देशिकाएं कॉपी की जाएंगी। index.js से पहुंच इस तरह होगी:

 var lib1 = require('./actions/libs/lib1/utils.js') var lib2 = require('./actions/libs/lib2/utils.js') var lib3 = require('./actions/libs/lib3/utils.js') 

• उदाहरण 3:

 include: - ["actions/*/*/utils.js", "actions/"] 

यह उदाहरण स्पष्ट रूप से इंगित करता है कि सब कुछ कहां कॉपी किया जाएगा। index.js से पहुंच पिछले उदाहरण के समान होगी।

अपवाद

exclude कीवर्ड का उपयोग फ़ाइलों और निर्देशिकाओं की सूची के रूप में किया जा सकता है, इसे * चरित्र के रूप में मास्क का उपयोग करने की अनुमति है। उपयोग उदाहरण:

 exclude: - actions/common/*.js - actions/libs/*/utils.js 

साझा include और exclude करने का एक सामान्य उदाहरण है:

 packages: zipactionwithexclude: actions: greeting1: function: actions runtime: nodejs:6 exclude: - actions/* include: - ["actions/common/utils.js", "common/utils.js"] - ["actions/index.js", "index.js"] - ["actions/package.json", "package.json"] 

GitHub निर्भरता के साथ कार्य

OpenWhisk निर्भरता का समर्थन करता है, इसलिए आप अन्य OpenWhisk पैकेजों का वर्णन कर सकते हैं जो हमारी परियोजना पर निर्भर करता है। इन निर्भरताओं के साथ, OpenWhisk स्वचालित रूप से निर्भर पैकेजों को भी तैनात करेगा। manifest.yaml और \ या deployment.yaml साथ कोई भी पैकेज। deployment.yaml को एक आश्रित पैकेज के रूप में माना जा सकता है, जिसे हमारी परियोजना के प्रकटन में निर्दिष्ट किया जा सकता है। आप dependencies अनुभाग में प्रकट में इस तरह की निर्भरता का वर्णन कर सकते हैं:

 packages: RootProject: dependencies: helloworlds: location: github.com/apache/incubator-openwhisk-test/packages/helloworlds triggers: trigger1: trigger2: rules: rule1: trigger: trigger1 action: helloworlds/hello-js rule2: trigger: trigger2 action: helloworlds/helloworld-js 

इस उदाहरण में, helloworlds एक बाहरी पैकेज है जिसे GitHub रिपॉजिटरी में https://github.com/apache/incubator-openwhisk-test पर होस्ट किया गया है। जब आप हमारे RootProject प्रोजेक्ट को तैनात करते हैं, तो RootProject packages/helloworlds में तैनाती के लिए इसकी फाइलों के आधार पर तैनात किया जाएगा। उदाहरण के लिए, आश्रित पैकेज का नाम बदलना भी संभव है, उदाहरण के लिए, ChildProject बजाय helloworlds ChildProject सेट ChildProject :

 packages: RootProject: dependencies: ChildProject: location: github.com/apache/incubator-openwhisk-test/packages/helloworlds triggers: trigger1: trigger2: rules: rule1: trigger: trigger1 action: ChildProject/hello-js rule2: trigger: trigger2 action: ChildProject/helloworld-js 

आप कई पैकेजों में कई निर्भरताएँ जोड़ सकते हैं:

 packages: RootProject: dependencies: ChildProject1: location: github.com/apache/incubator-openwhisk-test/packages/helloworlds ChildProject2: location: github.com/apache/incubator-openwhisk-test/packages/hellowhisk sequences: ChildProject1-series: actions: ChildProject1/hello-js, ChildProject1/helloworld-js ChildProject2-series: actions: ChildProject2/greeting, ChildProject2/httpGet triggers: trigger1: trigger2: rules: rule1: trigger: trigger1 action: ChildProject1-series rule2: trigger: trigger2 action: ChildProject2-series 

क्लाइंट और सर्वर के बीच OpenWhisk परियोजनाओं का सिंक्रनाइज़ेशन कैसे होता है

जवाब देने के लिए, आपको परिनियोजन managed deployment मोड में प्रारंभ करना होगा। इस मोड में, OpenWhisk सभी वस्तुओं को प्रकट से हटाता है, और उनमें से प्रत्येक के लिए एक छिपा हुआ विवरण भी संलग्न करता है, तथाकथित managed । यह विवरण इस तरह दिखता है:

 managed: __OW_PROJECT_NAME: MyProjectName __OW_PROJECT_HASH: SHA1("OpenWhisk " + <size_of_manifest_file> + "\0" + <contents_of_manifest_file>) __OW_FILE: Absolute path of manifest file on file system 

यहाँ, OpenWhisk एक निरंतर स्ट्रिंग है, और "\ 0" NULL वर्ण है। size_of_manifest_file और content_of_manifest_file फ़ाइल निर्भर हैं। managed deployment मोड में उसी प्रोजेक्ट का परिनियोजन अनुक्रम क्लाइंट पर प्रत्येक ऑब्जेक्ट के लिए एक नए __OW_PROJECT_HASH गणना करता है और सर्वर पर उसी प्रोजेक्ट से __OW_PROJECT_HASH ऑब्जेक्ट के साथ तुलना करता है। नीचे कई विकल्प हैं।

विकल्प 1 : यदि __OW_PROJECT_HASH क्लाइंट और सर्वर पर मेल खाता है, अर्थात यदि क्लाइंट की ओर से प्रोजेक्ट में कोई परिवर्तन नहीं हैं, तो सर्वर पर प्रोजेक्ट वैसा ही रहता है, जैसे कि deployment.yaml में कोई भी परिवर्तन प्राप्त करने के लिए मैनिफ़ेस्ट से wskdeploy नई ऑब्जेक्ट्स को deployment.yaml करने के अलावा।

विकल्प 2 : यदि __OW_PROJECT_HASH मेल नहीं खाता, अर्थात यदि क्लाइंट पक्ष में परिवर्तन होते हैं, तो wskdeploy मैनिफ़ेस्ट से सभी ऑब्जेक्ट्स को wskdeploy , और फिर उन्हें सर्वर पर __OW_PROJECT_HASH अपडेट करता है। wskdeploy सभी ऑब्जेक्ट्स को भी wskdeploy : जिसमें फ़ंक्शन, अनुक्रम और सशर्त __OW_PROJECT_NAME शामिल हैं, जिनमें समान __OW_PROJECT_NAME , अर्थात एक ही परियोजना से संबंधित, लेकिन एक अलग __OW_PROJECT_HASH होने के __OW_PROJECT_HASH , उन्हें क्लाइंट पर प्रकट होने से हटाया जा सकता है। मेनिफ़ेस्ट में प्रोजेक्ट का नाम क्लाइंट और सर्वर के बीच प्रोजेक्ट को सिंक्रनाइज़ करने के लिए आवश्यक है:

 project: name: MyProjectName packages: package1: .... 

OpenWhisk में ऑब्जेक्ट जो प्रोजेक्ट का हिस्सा हैं, लेकिन अन्य टूल या ऑटोमेशन टूल का उपयोग करके तैनात किए जाते हैं, जब वे प्रोजेक्ट से हटा दिए जाते हैं तो अपरिवर्तित रहते हैं। उन्हें बाहरी वस्तु माना जाता है और इसलिए उन्हें अधिलेखित नहीं किया जाता है। आप ऐसी परियोजना को wskdeploy का उपयोग करके wskdeploy कर सकते wskdeploy , इसे प्रकट फ़ाइल में निर्देशित कर wskdeploy , जिसमें केवल परियोजना का नाम है:

 project: name: MyProjectName 

आइए managed deployment को समझने के लिए एक नमूना परियोजना को देखें। इस रिपॉजिटरी में, आप विभिन्न घोषणापत्रों के साथ परियोजना को देख सकते हैं जो managed deployment दिखाते हैं।

पहला कदम

managed deployment मोड का उपयोग करके MyFirstManagedProject managed deployment करें:

 $wskdeploy -m tests/src/integration/managed-deployment/manifest.yaml --managed Deployment completed successfully. 

एक OpenWhisk सर्वर पर तैनात वस्तुओं की सूची

संपत्ति का विवरण

दूसरा कदम

हम क्लाइंट और सर्वर को सिंक्रनाइज़ करते हैं - हम ManagedPackage-2 को हटाते हैं:

 ./wskdeploy -m tests/src/integration/managed-deployment/00-manifest-minus-second-package.yaml --managed Deployment completed successfully. 

MyFirstManagedProject में हटाने के बाद वस्तुओं की सूची

चरण तीन

हम क्लाइंट और सर्वर को सिंक्रोनाइज़ करते हैं - हम ManagedSequence-2 को हटाते हैं:

 ./wskdeploy -m tests/src/integration/managed-deployment/01-manifest-minus-sequence-2.yaml --managed Deployment completed successfully. 

हटाने के बाद वस्तुओं की सूची

चौथा चरण

Helloworld-3 फ़ंक्शन को हटाएँ:

 ./wskdeploy -m tests/src/integration/managed-deployment/02-manifest-minus-action-3.yaml --managed Deployment completed successfully. 

हटाने के बाद वस्तुओं की सूची

पांचवां चरण

ManagedPackage-1 को हटाएं:

 ./wskdeploy -m tests/src/integration/managed-deployment/04-manifest-minus-package.yaml --managed Deployment completed successfully. 

MyFirstManagedProject में अन्य ऑब्जेक्ट

अन्य चक्र लेख

OpenWhisk पर आधारित सर्वर रहित कंप्यूटिंग, भाग 1
OpenWhisk पर आधारित सर्वर रहित कंप्यूटिंग, भाग 2
OpenWhisk पर आधारित सर्वर रहित कंप्यूटिंग, भाग 3
सर्वरलेस कंप्यूटिंग OpenWhisk, भाग 4 पर आधारित है