REST र कार्यप्रवाह इन्जिनमा आधारित सजिलो अर्केस्ट्रेसनको लागि Camunda प्रयोग गर्दै (जाभा छैन)

हे हाबर! म तपाईंको ध्यानाकर्षणमा लेखको अनुवाद प्रस्तुत गर्दछु "Camunda प्रयोग गर्न सजिलो REST-आधारित आर्केस्ट्रा र कार्यप्रवाह इन्जिनको रूपमा प्रयोग गर्नुहोस् (जाभा नछोइकन)" Bernd Rücker द्वारा।

०७/०७/२०२०, अनुवाद लेख बर्न्ड रुकर

म प्रायः गैर-जाभा व्यक्तिहरूसँग माइक्रोसर्भिस आर्किटेक्चर छलफल गर्छु: C# विकासकर्ताहरू, Node.JS/JavaScript विकासकर्ताहरू, वा Golang aficionados। ती सबैलाई माइक्रोसर्भिस आर्किटेक्चरमा अर्केस्ट्रेशन मेकानिजम चाहिन्छ, वा कार्यप्रवाहलाई सुव्यवस्थित गर्न र अर्डर गर्ने, टाइमआउटहरू ह्यान्डल गर्ने, सागा र क्षतिपूर्ति गर्ने लेनदेनहरू प्राप्त गर्ने क्षमता प्राप्त गर्नको लागि एउटा उपकरण चाहिन्छ भन्ने तथ्यको सामना गर्नु परेको छ।

BPM प्लेटफर्मको साथ Camunda बाट खुला स्रोत त्यस्ता कार्यहरूको लागि उत्कृष्ट। विकासकर्ता मित्रता उत्पादनको मुख्य विशेषताहरू मध्ये एक हो। तर यदि तपाईंले यसको कागजात हेर्नुभयो भने, तपाईंले क्यामुन्डाको "मित्रता" मुख्य रूपमा जाभा विकासकर्ताहरूलाई लक्षित गरेको छ भन्ने छाप पाउन सक्नुहुन्छ। प्लेटफर्मले तपाईंको आफ्नै प्रकार्यहरू र विस्तारहरू जडान गर्नका लागि धेरै विकल्पहरू प्रदान गर्दछ, तर यो सबै Java मा गरिन्छ। के यो साँच्चै हो?

होइन! वास्तवमा, तपाइँ सजिलै संग कुनै जाभा ज्ञान बिना क्यामुन्डा चलाउन सक्नुहुन्छ र तपाइँको मनपर्ने कुनै पनि भाषामा कोडको लागि वास्तुकला सेटअप गर्न सक्नुहुन्छ। यस लेखमा, हामी हेर्नेछौं:

• आधारभूत वास्तुकला;
• REST API
• जाभा बाहेक अन्य भाषाहरूको लागि अवस्थित ग्राहक पुस्तकालयहरूमा सल्लाह;
• उदाहरण C# र Node.JS प्रयोग गरेर;
• Camunda सर्भर (डकर वा Tomcat) सुरु गर्ने तरिकाहरू।

वास्तुकला

क्यामुन्डा जाभामा लेखिएको छ र चलाउनको लागि जाभा भर्चुअल मेसिन (JVM) चाहिन्छ। Camunda ले REST API प्रदान गर्दछ जसले तपाईंलाई मनपर्ने कुनै पनि भाषामा लेख्न र Camunda सँग REST प्रयोग गर्न अनुमति दिन्छ:

क्यामुन्डामा कार्यप्रवाहहरू BPMN मा परिभाषित गरिएको छ, जुन मूल रूपमा XML फाइल हो। यसको साथ मोडेल गर्न सकिन्छ क्यामुन्डा मोडेलर.

पूर्व-निर्मित डकर छवि मार्फत क्यामुन्डा चलाउँदै

क्यामुन्डा चलाउने सबैभन्दा सजिलो तरिका डकर प्रयोग गर्नु हो। क्यामुन्डा चलाउने वैकल्पिक तरिकाहरू यस लेखमा पछि वर्णन गरिएको छ।

यस अवस्थामा, बस चलाउनुहोस्:

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

तपाईंले लिनक्स, JVMs वा Tomcats को बारेमा चिन्ता लिनु पर्दैन। Dockerfiles र आधारभूत कागजातहरू (उदाहरणका लागि, आवश्यक डाटाबेस जडान गर्न निर्देशनहरू) मा उपलब्ध छन् Github.

यदि तपाइँ Camunda इन्टरप्राइज संस्करण चलाउन चाहनुहुन्छ भने, तपाइँ सजिलै परिवर्तन गर्न सक्नुहुन्छ डकरफाइल.

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

प्रक्रिया मोडेल तैनाती

क्लासिक ट्रिप बुकिङको लागि सागा टेम्प्लेट प्रयोग गरेर एउटा उदाहरण हेरौं जहाँ तपाईं पङ्क्तिमा तीनवटा कार्यहरू ट्रिगर गर्न चाहनुहुन्छ र पछि असफल भएमा सफलतापूर्वक सम्पन्न कार्यहरूको लागि राम्रो क्षतिपूर्ति दिन चाहनुहुन्छ। BPMN फारममा प्रतिनिधित्व गरिएको, यो यस्तो देखिन्छ:

अब तपाईं प्रयोग गर्न सक्नुहुन्छ प्रक्रिया मोडेल परिनियोजनको लागि REST API। मानौं तपाईंले यसलाई trip.bpmn को रूपमा बचत गर्नुभयो र डकर मार्फत क्यामुन्डा चलाउनुहोस् ताकि यो लोकलहोस्ट: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 मार्फत कामका वस्तुहरू ल्याउन सक्छ, काम गर्न सक्छ, र Camunda लाई पूरा गर्न (पुल-सिद्धान्त) भन्न सक्छ।

त्यसैले पहिले तपाईं कार्यान्वयन गर्न आवश्यक छ 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 प्रयोग गरेर। तर यो समय लाग्नेछ। त्यसोभए तपाईले केहि ग्राहक पुस्तकालय प्रयोग गर्न सक्नुहुन्छ।

यस समयमा, धेरै तयार ग्राहक पुस्तकालयहरू उपलब्ध छन्:

• जाभास्क्रिप्ट: लिङ्क। Camunda द्वारा समर्थित;
• जाभा: लिङ्क। Camunda द्वारा समर्थित;
• C #:लिङ्क и लिङ्क। यी दुबै परियोजनाहरू मध्यवर्ती अवस्थामा छन् र व्यावहारिक रूपमा निष्क्रिय छन्, तर राम्रो सुरुवात बिन्दुको रूपमा सेवा गर्न सक्छन्;
• PHP: लिङ्क - धेरै पूर्ण छैन र नवीनतम API परिवर्तनहरू समावेश गर्दैन, तर मलाई यो प्रयोग गर्ने परियोजनाहरू थाहा छ।

JavaScript र Java को अपवादको साथ, ग्राहक पुस्तकालयहरू 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" संग कस्टम डकर छवि

क्यामुन्डाबाट पूर्व-निर्मित डकर छविको विकल्पको रूपमा, तपाईंले टमक्याट आफैं तयार गर्न सक्नुहुन्छ (उदाहरणका लागि, आधिकारिक डकर टमक्याट छविहरूमा आधारित) र त्यसपछि कमुन्डालाई एक तथाकथित WAR फाइलहरूको रूपमा प्रतिलिपि गर्न सक्नुहुन्छ।

यदि तपाइँसँग धेरै अतिरिक्त आवश्यकताहरू छन् र जाभा निर्माण वातावरण सेटअप गर्न सक्नुहुन्छ भने, तपाइँ क्यामुन्डा स्ट्यान्डअलोन युद्ध पनि सेट अप गर्न सक्नुहुन्छ। यी उदाहरणहरूमा जस्तै Maven निर्माण सेट अप गर्नुहोस्: निर्माण युद्ध कन्फिगरेसन संग Maven वा विधानसभा ओभरले संग Maven.

Camunda Tomcat वितरण सुरु गर्दै

अर्को विकल्प भनेको Camunda Tomcat वितरण डाउनलोड गर्नुहोस्, यसलाई अनजिप गर्नुहोस्, र यसलाई चलाउनुहोस्। यसका लागि तपाइँको कम्प्युटरमा Java Runtime Environment (JRE) स्थापना भएको मात्र आवश्यक छ। यो सजिलै हुन सक्छ यहाँबाट डाउनलोड गर्नुहोस्.

डाटाबेस परिवर्तन गर्न वा अरू केहि गर्न को लागी तपाईले Tomcat लाई कन्फिगर गर्न आवश्यक छ दस्तावेजमा वर्णन गरिएको छ। मलाई थाहा छ Tomcat जटिल लाग्न सक्छ, तर यो वास्तवमा धेरै सरल छ। र Google लाई प्रक्रियामा आवश्यक पर्ने सबै कुराको जवाफ थाहा छ।

Tomcat प्रयोग गरेर Camunda चलिरहेको छ

अन्तिम विकल्प भनेको टमक्याट आफैं सेटअप गर्नु र यसमा क्यामुन्डा स्थापना गर्नु हो, स्थापना विवरण पछ्याउँदै। यसले तपाइँलाई Tomcat को जुनसुकै संस्करण प्रयोग गर्ने विकल्प दिनेछ, वा यसलाई Windows सेवाको रूपमा स्थापना गर्नुहोस्, उदाहरणका लागि।

क्यामुन्डालाई उत्पादनमा लन्च गर्दै

यो सामान्यतया Camunda चलाउन केहि अन्तिम सेटअप आवश्यक हुनेछ। त्यहाँ क्यामुन्डामा दिशानिर्देशहरू छन् जसले यसलाई विस्तृत रूपमा वर्णन गर्दछ, तर म यस लेखमा तिनीहरूलाई जानेछैन - म केवल एउटा उदाहरणको नाम दिनेछु: वितरणको REST API पूर्वनिर्धारित रूपमा प्रमाणीकरणको लागि कन्फिगर गरिएको छैन। तपाईं यसलाई परिवर्तन गर्न चाहनुहुन्छ होला।

संक्षेप हुँदै

तपाईले देख्न सक्नुहुने रूपमा, तपाईले प्रयोग गरिरहनु भएको भाषाको पर्वाह नगरी Camunda सँग सुरु गर्न धेरै सजिलो छ। मुख्य बिन्दु यो हो कि सबै अन्तरक्रिया REST API मार्फत गरिन्छ। स्थापना पनि धेरै सजिलो छ, विशेष गरी डकर प्रयोग गर्दा।

स्रोत: www.habr.com