REST आणि वर्कफ्लो इंजिनवर आधारित सोप्या ऑर्केस्ट्रेशनसाठी कॅमुंडा वापरणे (जावा नाही)

अहो हाब्र! लेखाचा अनुवाद मी तुमच्या लक्षात आणून देत आहे "कमुंडा वापरण्यास सुलभ REST-आधारित ऑर्केस्ट्रेशन आणि वर्कफ्लो इंजिन म्हणून वापरा (जावाला स्पर्श न करता)" Bernd Rücker द्वारे.

07.07.2020/XNUMX/XNUMX, अनुवाद लेख बर्ंड रुकर

मी बर्‍याचदा जावा नसलेल्या लोकांसोबत मायक्रोसर्व्हिस आर्किटेक्चरवर चर्चा करतो: C# विकसक, Node.JS/JavaScript डेव्हलपर किंवा Golang aficionados. या सर्वांना या वस्तुस्थितीचा सामना करावा लागतो की त्यांना मायक्रोसर्व्हिस आर्किटेक्चरमध्ये ऑर्केस्ट्रेशन यंत्रणा किंवा वर्कफ्लो सुव्यवस्थित करण्यासाठी आणि ऑर्डर करण्याची क्षमता, टाइमआउट्स, सागा आणि नुकसान भरपाईचे व्यवहार हाताळण्यासाठी फक्त एक साधन आवश्यक आहे.

सह BPM प्लॅटफॉर्म Camunda पासून मुक्त स्रोत अशा कामांसाठी उत्तम. विकसक मित्रत्व हे उत्पादनाच्या प्रमुख वैशिष्ट्यांपैकी एक आहे. परंतु तुम्ही त्याचे दस्तऐवजीकरण पाहिल्यास, तुम्हाला कदाचित असे समजेल की कॅमुंडाची "मित्रत्व" मुख्यतः Java विकासकांसाठी आहे. प्लॅटफॉर्म तुमची स्वतःची कार्ये आणि विस्तार कनेक्ट करण्यासाठी बरेच पर्याय प्रदान करते, परंतु हे सर्व Java मध्ये केले जाते. खरंच आहे का?

नाही! खरं तर, तुम्ही जावाच्या ज्ञानाशिवाय कॅमुंडा सहजपणे चालवू शकता आणि तुमच्या आवडीच्या कोणत्याही भाषेत कोडसाठी आर्किटेक्चर सेट करू शकता. या लेखात, आम्ही पाहू:

• मूलभूत आर्किटेक्चर;
• REST API
• Java व्यतिरिक्त इतर भाषांसाठी विद्यमान क्लायंट लायब्ररीबद्दल सल्ला;
• उदाहरण C# आणि Node.JS वापरून;
• कॅमुंडा सर्व्हर (डॉकर किंवा टॉमकॅट) सुरू करण्याचे मार्ग.

आर्किटेक्चर

Camunda Java मध्ये लिहिलेले आहे आणि चालविण्यासाठी Java Virtual Machine (JVM) आवश्यक आहे. Camunda एक REST API प्रदान करते जे तुम्हाला तुमच्या आवडीच्या कोणत्याही भाषेत लिहिण्याची आणि Camunda सह REST वापरण्याची परवानगी देते:

Camunda मधील वर्कफ्लो BPMN मध्ये परिभाषित केले आहेत, जी मुळात XML फाइल आहे. ते मॉडेल केले जाऊ शकते कॅमुंडा मॉडेलर.

पूर्व-निर्मित डॉकर प्रतिमेद्वारे कॅमुंडा चालवणे

कॅमुंडा चालवण्याचा सर्वात सोपा मार्ग म्हणजे डॉकर वापरणे. कॅमुंडा लाँच करण्याचे पर्यायी मार्ग या लेखात नंतर वर्णन केले आहेत.

या प्रकरणात, फक्त चालवा:

  docker run -d -p 8080:8080 camunda/camunda-bpm-platform:latest

तुम्हाला Linux, JVMs किंवा Tomcats बद्दल काळजी करण्याची गरज नाही. डॉकरफाईल्स आणि मूलभूत दस्तऐवजीकरण (उदाहरणार्थ, आवश्यक डेटाबेसशी कनेक्ट करण्यासाठी सूचना) येथे उपलब्ध आहेत जिथूब.

तुम्हाला Camunda Enterprise Edition चालवायची असल्यास तुम्ही सहज बदल करू शकता डॉकरफाइल.

तथापि, डॉकरसह कॅमुंडा चालवण्यामध्ये एक नकारात्मक बाजू आहे: तुम्हाला टॉमकॅटची आवृत्ती मिळेल ज्यामध्ये नेहमीच नवीनतम निराकरणे समाविष्ट नसतात. यावर काम करण्यासाठी, या उदाहरणात दर्शविल्याप्रमाणे, आपण इच्छित टॉमकॅट वितरणावर आधारित आपली स्वतःची डॉकर प्रतिमा तयार करू शकता किंवा खाली वर्णन केलेल्या उपायांपैकी एक वापरू शकता.

प्रक्रिया मॉडेल उपयोजन

क्लासिक ट्रिप बुकिंगसाठी सागा टेम्प्लेट वापरून एक उदाहरण पाहू जिथे तुम्हाला सलग तीन क्रिया सुरू करायच्या आहेत आणि नंतरच्या अपयशाच्या बाबतीत यशस्वीरीत्या पूर्ण केलेल्या कृतींची भरपाई करा. BPMN फॉर्ममध्ये प्रतिनिधित्व केलेले, ते असे दिसते:

आता तुम्ही वापरू शकता प्रक्रिया मॉडेल उपयोजनासाठी REST API. समजा तुम्ही ते trip.bpmn म्हणून सेव्ह करा आणि Docker द्वारे Camunda चालवा म्हणजे ते लोकलहोस्ट:8080 वर उपलब्ध आहे:

  curl -w "n" 
-H "Accept: application/json" 
-F "deployment-name=trip" 
-F "enable-duplicate-filtering=true" 
-F "deploy-changed-only=true" 
-F "[email protected]" 
http://localhost:8080/engine-rest/deployment/creat

आता तुम्ही धावू शकता नवीन कार्यप्रवाह उदाहरणे REST API वापरून आणि तुम्हाला वर्कफ्लो उदाहरण व्हेरिएबल्स म्हणून पाहायचा असलेला डेटा पास करा:

  curl 
-H "Content-Type: application/json" 
-X POST 
-d '{"variables":{"someData" : {"value" : "someValue", "type": "String"}},"businessKey" : "12345"}}' 
http://localhost:8080/engine-rest/<!-- -->process-definition/key/<!-- -->FlowingTripBookingSaga<!-- -->/start

पुढील मनोरंजक प्रश्न आहे: कॅमुंडा कार बुक करण्यासारख्या प्रक्रियेस कसे कॉल करते? कामुंडा काही अंगभूत वापरून सेवांना तात्काळ कॉल करू शकत नाही (पुश-प्रिन्सिपल). कनेक्टर, परंतु कामाच्या वस्तू एका प्रकारच्या अंगभूत क्रमाने ठेवतात. त्यानंतर कामगार REST द्वारे कामाच्या वस्तू आणू शकतो, काम करू शकतो आणि कमंडाला पूर्ण करण्यास सांगू शकतो (पुल-प्रिन्सिपल).

म्हणून प्रथम आपण कार्यान्वित करणे आवश्यक आहे fetchAndLock (कारण इतर कामगार एकाच वेळी सिस्टीम स्केल करण्यासाठी कार्ये प्राप्त करू शकतात):

  curl 
-H "Content-Type: application/json" 
-X POST 
-d <!-- -->'{"workerId":"worker123","maxTasks":1,"usePriority":true,"topics":[{"topicName": "reserve-car"}, "lockDuration": 10000, "variables": ["someData"]}]}'<!-- --> 
http://localhost:8080/engine-rest/external-task/fetchAndLock

मग कमंडाला ते सांग कामगाराने काम पूर्ण केले (लक्षात ठेवा की तुम्ही पहिल्या विनंतीमध्ये प्राप्त केलेला बाह्य कार्य आयडी प्रविष्ट करणे आवश्यक आहे):

  curl 
-H "Content-Type: application/json" 
-X POST 
-d <!-- -->'{"workerId":"worker123", "variables": {}}'<!-- --> 
http://localhost:8080/engine-rest/<!-- -->external-task/EXTERNAL_TASK_ID/complete

तेच - तुम्हाला अजूनही जावाची गरज नाही, बरोबर? आणि प्रारंभ करण्यासाठी ते पुरेसे आहे!

क्लायंट लायब्ररी

REST API कॉल करणे कोणत्याही प्रोग्रामिंग भाषेत सोपे आहे. JavaScript मध्ये, JQuery वापरून आणि C# मध्ये, System.Net.Http आणि Newtonsoft.Json वापरून हे सोयीस्करपणे केले जाते. पण यासाठी वेळ लागेल. त्यामुळे तुम्ही फक्त काही क्लायंट लायब्ररी वापरू शकता.

याक्षणी, अनेक तयार क्लायंट लायब्ररी उपलब्ध आहेत:

• जावास्क्रिप्ट: ссылка. कॅमुंडा द्वारे समर्थित;
• जावा: ссылка. कॅमुंडा द्वारे समर्थित;
• सी #:ссылка и ссылка. हे दोन्ही प्रकल्प मध्यवर्ती अवस्थेत आहेत आणि व्यावहारिकदृष्ट्या सुप्त आहेत, परंतु एक चांगला प्रारंभ बिंदू म्हणून काम करू शकतात;
• PHP: ссылка - खूप पूर्ण नाही आणि नवीनतम API बदलांचा समावेश नाही, परंतु मला ते वापरणारे प्रकल्प माहित आहेत.

JavaScript आणि Java वगळता, क्लायंट लायब्ररी Camunda उत्पादनाचाच भाग नाहीत. ते Camunda च्या REST API वैशिष्ट्यांचे समर्थन करतील अशी अपेक्षा करू नका. केवळ लायब्ररी विशिष्ट कार्य प्रदान करत नाही याचा अर्थ असा नाही की ते तेथे नाही, नेहमी Camunda चे REST API तपासा. संदर्भ प्रकल्प लायब्ररींचा प्रारंभ बिंदू आणि टेम्पलेट म्हणून वापर करतात.

C# उदाहरण

वरील क्लायंट लायब्ररी वापरून, आम्ही फक्त लिहू शकतो:

  var camunda = new CamundaEngineClient("http://localhost:8080/engine-rest/engine/default/", null, null);
  // Deploy the BPMN XML file from the resources
  camunda.RepositoryService.Deploy("trip-booking", new List<object> {
        FileParameter.FromManifestResource(Assembly.GetExecutingAssembly(), "FlowingTripBookingSaga.Models.FlowingTripBookingSaga.bpmn")
     });
  
  // Register workers
  registerWorker("reserve-car", externalTask => {
    // here you can do the real thing! Like a sysout :-)
    Console.WriteLine("Reserving car now...");
    camunda.ExternalTaskService.Complete(workerId, externalTask.Id);
  });
  registerWorker("cancel-car", externalTask => {
    Console.WriteLine("Cancelling car now...");
    camunda.ExternalTaskService.Complete(workerId, externalTask.Id);
  });
  registerWorker("book-hotel", externalTask => {
    Console.WriteLine("Reserving hotel now...");
    camunda.ExternalTaskService.Complete(workerId, externalTask.Id);
  });
  // Register more workers...
  
  StartPolling();
  
  string processInstanceId = camunda.BpmnWorkflowService.StartProcessInstance("FlowingTripBookingSaga", new Dictionary<string, object>()
    {
      {"someBookingData", "..." }
    });

पूर्णपणे कार्यरत स्त्रोत कोड ऑनलाइन आढळू शकतो: ссылка. दुसरे उदाहरण येथे उपलब्ध आहे ссылка.

Node.js सह उदाहरण

  var Workers = require('camunda-worker-node');
  var workers = Workers('http://localhost:8080/engine-rest', {
    workerId: 'some-worker-id'
  });
  
  workers.registerWorker('reserve-car', [ 'someData' ], function(context, callback) {
    var someNewData = context.variables.someData + " - added something";
    callback(null, {
      variables: {
        someNewData: someNewData
      }
    });
  });
  
  workers.shutdown();

अधिक माहिती वेबसाइटवर मिळू शकते Github.com

कॅमुंडा लाँच करण्याचे पर्यायी मार्ग

"कमुंडा स्टँडअलोन वॉर" सह सानुकूल डॉकर प्रतिमा

Camunda मधील प्री-बिल्ट डॉकर इमेजला पर्याय म्हणून, तुम्ही टॉमकॅट स्वत: तयार करू शकता (उदाहरणार्थ, अधिकृत डॉकर टॉमकॅट प्रतिमांवर आधारित) आणि नंतर तथाकथित WAR फायलींपैकी एक म्हणून Camunda कॉपी करू शकता.

तुमच्याकडे अनेक अतिरिक्त आवश्यकता असल्यास आणि Java बिल्ड वातावरण सेट करू शकत असल्यास, तुम्ही Camunda स्टँडअलोन युद्ध देखील सेट करू शकता. या उदाहरणांप्रमाणे मावेन बिल्ड सेट करा: बिल्ड युद्ध कॉन्फिगरेशनसह मावेन किंवा विधानसभा आच्छादन सह Maven.

Camunda Tomcat वितरण सुरू करत आहे

दुसरा पर्याय म्हणजे कॅमुंडा टॉमकॅट वितरण डाउनलोड करणे, ते अनझिप करणे आणि चालवणे. यासाठी फक्त तुमच्या संगणकावर Java Runtime Environment (JRE) स्थापित करणे आवश्यक आहे. ते सहज असू शकते येथून डाउनलोड करा.

डेटाबेस बदलण्यासाठी किंवा इतर काहीही करण्यासाठी तुम्हाला टॉमकॅट सारखे कॉन्फिगर करावे लागेल दस्तऐवजीकरणात वर्णन केले आहे. मला माहित आहे की टॉमकॅट क्लिष्ट वाटू शकते, परंतु प्रत्यक्षात ते खूप सोपे आहे. आणि प्रक्रियेत आवश्यक असलेल्या प्रत्येक गोष्टीची उत्तरे Google ला माहित आहेत.

टॉमकॅट वापरून कॅमुंडा चालवणे

शेवटचा पर्याय म्हणजे टॉमकॅट स्वतः सेट करणे आणि त्यात कॅमुंडा स्थापित करणे, प्रतिष्ठापन वर्णन खालील. हे तुम्हाला टॉमकॅटची तुम्‍ही पसंतीची कोणत्‍याही आवृत्तीचा वापर करण्‍याचा पर्याय देईल किंवा उदाहरणार्थ, Windows सेवा म्‍हणून स्‍थापित करण्‍याचा पर्याय देईल.

कमंडाचे उत्पादन सुरू करत आहे

Camunda चालविण्यासाठी यास सहसा काही अंतिम सेटअप आवश्यक असेल. कॅमुंडामध्ये मार्गदर्शक तत्त्वे आहेत जी याचे तपशीलवार वर्णन करतात, परंतु मी या लेखात त्यामध्ये जाणार नाही - मी फक्त एक उदाहरण देईन: वितरणाचे REST API डीफॉल्टनुसार प्रमाणीकरणासाठी कॉन्फिगर केलेले नाही. तुम्हाला हे बदलायचे असेल.

गोळा करीत आहे

तुम्ही बघू शकता, तुम्ही कोणती भाषा वापरत आहात याची पर्वा न करता, Camunda सह प्रारंभ करणे खूप सोपे आहे. मुख्य मुद्दा असा आहे की सर्व परस्परसंवाद REST API द्वारे केले जातात. विशेषत: डॉकर वापरताना, स्थापना देखील खूप सोपे आहे.

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