REST અને વર્કફ્લો એન્જિન પર આધારિત સરળ ઓર્કેસ્ટ્રેશન માટે Camunda નો ઉપયોગ કરવો (કોઈ જાવા નથી)

હે હબર! હું તમારા ધ્યાન પર લેખનો અનુવાદ રજૂ કરું છું "ઉપયોગમાં સરળ REST-આધારિત ઓર્કેસ્ટ્રેશન અને વર્કફ્લો એન્જિન તરીકે (જાવાને સ્પર્શ કર્યા વિના) કેમુંડાનો ઉપયોગ કરો" બર્ન્ડ રકર દ્વારા.

07.07.2020/XNUMX/XNUMX, અનુવાદ લેખ બર્ન્ડ રકર

હું ઘણીવાર બિન-જાવા લોકો સાથે માઇક્રોસર્વિસ આર્કિટેક્ચરની ચર્ચા કરું છું: C# વિકાસકર્તાઓ, Node.JS/JavaScript વિકાસકર્તાઓ, અથવા Golang aficionados. તે બધાને એ હકીકતનો સામનો કરવો પડી રહ્યો છે કે તેમને માઇક્રોસર્વિસ આર્કિટેક્ચરમાં ઓર્કેસ્ટ્રેશન મિકેનિઝમની જરૂર છે, અથવા ફક્ત વર્કફ્લોને સુવ્યવસ્થિત કરવા અને ઓર્ડર કરવાની ક્ષમતા, સમય સમાપ્તિ, સાગા અને વળતર આપવા માટેની ક્ષમતા પ્રાપ્ત કરવા માટે એક સાધનની જરૂર છે.

સાથે BPM પ્લેટફોર્મ કમુન્ડા તરફથી ઓપન સોર્સ આવા કાર્યો માટે સરસ. વિકાસકર્તા મિત્રતા એ ઉત્પાદનની મુખ્ય લાક્ષણિકતાઓમાંની એક છે. પરંતુ જો તમે તેના દસ્તાવેજીકરણ પર નજર નાખો, તો તમને એવી છાપ મળી શકે છે કે કેમુંડાની "મિત્રતા" મુખ્યત્વે જાવા ડેવલપર્સ માટે છે. પ્લેટફોર્મ તમારા પોતાના કાર્યો અને એક્સ્ટેંશનને કનેક્ટ કરવા માટે ઘણા બધા વિકલ્પો પ્રદાન કરે છે, પરંતુ તે બધું જાવામાં થાય છે. તે ખરેખર છે?

ના! વાસ્તવમાં, તમે કોઈપણ જાવા જ્ઞાન વિના સરળતાથી કેમુંડા ચલાવી શકો છો અને તમારી પસંદગીની કોઈપણ ભાષામાં કોડ માટે આર્કિટેક્ચર સેટ કરી શકો છો. આ લેખમાં, અમે જોઈશું:

• મૂળભૂત આર્કિટેક્ચર;
• REST API
• જાવા સિવાયની ભાષાઓ માટે હાલની ક્લાયંટ લાઇબ્રેરીઓ પર સલાહ;
• C# અને Node.JS નો ઉપયોગ કરીને ઉદાહરણ;
• કેમુંડા સર્વર (ડોકર અથવા ટોમકેટ) શરૂ કરવાની રીતો.

સ્થાપત્ય

Camunda Java માં લખાયેલ છે અને તેને ચલાવવા માટે જાવા વર્ચ્યુઅલ મશીન (JVM) ની જરૂર છે. Camunda એક REST API પ્રદાન કરે છે જે તમને ગમે તે ભાષામાં લખવા અને Camunda સાથે REST નો ઉપયોગ કરવાની મંજૂરી આપે છે:

કામુંડામાં વર્કફ્લોને BPMN માં વ્યાખ્યાયિત કરવામાં આવે છે, જે મૂળભૂત રીતે XML ફાઇલ છે. તેની સાથે મોડેલ કરી શકાય છે કેમુંડા મોડેલર.

પ્રી-બિલ્ટ ડોકર ઈમેજ દ્વારા કામુન્ડાને ચલાવવું

Camunda ચલાવવાનો સૌથી સહેલો રસ્તો Docker નો ઉપયોગ કરવાનો છે. કમુન્ડાને લૉન્ચ કરવાની વૈકલ્પિક રીતો આ લેખમાં પછીથી વર્ણવવામાં આવી છે.

આ કિસ્સામાં, ફક્ત ચલાવો:

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

તમારે Linux, JVM અથવા Tomcats વિશે ચિંતા કરવાની જરૂર નથી. ડોકરફાઈલ્સ અને મૂળભૂત દસ્તાવેજો (ઉદાહરણ તરીકે, જરૂરી ડેટાબેસેસ સાથે જોડાવા માટેની સૂચનાઓ) અહીં ઉપલબ્ધ છે Github.

જો તમે Camunda એન્ટરપ્રાઇઝ એડિશન ચલાવવા માંગતા હોવ તો તમે સરળતાથી બદલી શકો છો ડોકરફાઇલ.

જો કે, ડોકર સાથે કામુન્ડા ચલાવવામાં એક નુકસાન છે: તમે ટોમકેટના સંસ્કરણ સાથે સમાપ્ત થશો જેમાં હંમેશા નવીનતમ ફિક્સેસ શામેલ હોતી નથી. આની આસપાસ કામ કરવા માટે, તમે ઇચ્છિત ટોમકેટ વિતરણના આધારે તમારી પોતાની ડોકર ઇમેજ બનાવી શકો છો, આ ઉદાહરણમાં બતાવ્યા પ્રમાણે, અથવા નીચે વર્ણવેલ ઉકેલોમાંથી એકનો ઉપયોગ કરો.

પ્રક્રિયા મોડલ જમાવટ

ચાલો ક્લાસિક ટ્રિપ બુકિંગ માટે સાગા ટેમ્પલેટનો ઉપયોગ કરીને એક ઉદાહરણ જોઈએ જ્યાં તમે સળંગ ત્રણ ક્રિયાઓ ટ્રિગર કરવા માંગો છો અને પછીની નિષ્ફળતાના કિસ્સામાં સફળતાપૂર્વક પૂર્ણ થયેલી ક્રિયાઓ માટે આકર્ષક વળતર આપવા માંગો છો. 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

પછી કમુંડાને કહે કાર્યકર કામ પૂર્ણ કરે છે (નોંધ કરો કે તમારે પ્રથમ વિનંતીમાં પ્રાપ્ત બાહ્ય કાર્ય ID દાખલ કરવું આવશ્યક છે):

  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 ની 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 તરફથી પ્રી-બિલ્ટ ડોકર ઈમેજના વિકલ્પ તરીકે, તમે તમારી જાતે ટોમકેટ તૈયાર કરી શકો છો (ઉદાહરણ તરીકે, અધિકૃત ડોકર ટોમકેટ ઈમેજોના આધારે) અને પછી કહેવાતી WAR ફાઈલોમાંથી એક તરીકે તેમાં Camunda ની નકલ કરી શકો છો.

જો તમારી પાસે ઘણી વધારાની આવશ્યકતાઓ છે અને તમે જાવા બિલ્ડ એન્વાયર્નમેન્ટ સેટ કરી શકો છો, તો તમે કેમુંડા સ્ટેન્ડઅલોન વોર પણ સેટ કરી શકો છો. આ ઉદાહરણોની જેમ મેવેન બિલ્ડ સેટ કરો: બિલ્ડ યુદ્ધ રૂપરેખા સાથે Maven અથવા એસેમ્બલી ઓવરલે સાથે Maven.

Camunda Tomcat વિતરણ શરૂ કરી રહ્યા છીએ

બીજો વિકલ્પ એ છે કે કેમુંડા ટોમકેટ ડિસ્ટ્રિબ્યુશન ડાઉનલોડ કરો, તેને અનઝિપ કરો અને તેને ચલાવો. આને ફક્ત તમારા કમ્પ્યુટર પર જાવા રનટાઇમ એન્વાયર્નમેન્ટ (JRE) ઇન્સ્ટોલ કરવાની જરૂર છે. તે સરળતાથી બની શકે છે અહીંથી ડાઉનલોડ કરો.

ડેટાબેઝ બદલવા અથવા બીજું કંઈપણ કરવા માટે તમારે ટોમકેટની જેમ રૂપરેખાંકિત કરવાની જરૂર છે દસ્તાવેજીકરણમાં વર્ણવેલ છે. હું જાણું છું કે ટોમકેટ જટિલ લાગે છે, પરંતુ તે ખરેખર ખૂબ જ સરળ છે. અને Google એ દરેક વસ્તુના જવાબો જાણે છે જે પ્રક્રિયામાં જરૂરી હોઈ શકે છે.

ટોમકેટનો ઉપયોગ કરીને કેમુંડા ચલાવવું

છેલ્લો વિકલ્પ એ છે કે ટોમકેટ જાતે સેટ કરો અને તેમાં કમુંડા ઇન્સ્ટોલ કરો, સ્થાપન વર્ણનને અનુસરીને. આ તમને ટોમકેટના કોઈપણ સંસ્કરણનો ઉપયોગ કરવાનો વિકલ્પ આપશે, અથવા ઉદાહરણ તરીકે, તેને Windows સેવા તરીકે ઇન્સ્ટોલ કરો.

કામુન્ડાને ઉત્પાદનમાં લૉન્ચ કરી રહ્યું છે

આને સામાન્ય રીતે કેમુંડા ચલાવવા માટે કેટલાક અંતિમ સેટઅપની જરૂર પડશે. કમુંડામાં માર્ગદર્શિકાઓ છે જે આનું વિગતવાર વર્ણન કરે છે, પરંતુ હું આ લેખમાં તેમાં જઈશ નહીં - હું ફક્ત એક ઉદાહરણનું નામ આપીશ: ડિસ્ટ્રિબ્યુશનનું REST API ડિફૉલ્ટ રૂપે પ્રમાણીકરણ માટે ગોઠવેલું નથી. તમે આને બદલવા માગી શકો છો.

એકત્ર કરવું

જેમ તમે જોઈ શકો છો, તમે ગમે તે ભાષાનો ઉપયોગ કરી રહ્યાં હોવ, કેમન્ડા સાથે પ્રારંભ કરવું ખૂબ જ સરળ છે. મુખ્ય મુદ્દો એ છે કે તમામ ક્રિયાપ્રતિક્રિયા REST API દ્વારા કરવામાં આવે છે. ઇન્સ્ટોલેશન પણ ખૂબ સરળ છે, ખાસ કરીને જ્યારે ડોકરનો ઉપયોગ કરો.

સોર્સ: www.habr.com