REST এবং ওয়ার্কফ্লো ইঞ্জিনের উপর ভিত্তি করে সহজ অর্কেস্ট্রেশনের জন্য কামুন্ডা ব্যবহার করা হচ্ছে (কোন জাভা নেই)

হে হাবর! আমি নিবন্ধটির অনুবাদ আপনার দৃষ্টি আকর্ষণ করছি "কামুন্ডাকে ব্যবহার করা সহজ REST-ভিত্তিক অর্কেস্ট্রেশন এবং ওয়ার্কফ্লো ইঞ্জিন হিসাবে ব্যবহার করুন (জাভা স্পর্শ না করে)" Bernd Rücker দ্বারা.

07.07.2020/XNUMX/XNUMX, অনুবাদ প্রবন্ধ বার্ন্ড রুকার

আমি প্রায়ই নন-জাভা লোকেদের সাথে মাইক্রোসার্ভিস আর্কিটেকচার নিয়ে আলোচনা করি: C# ডেভেলপার, Node.JS/JavaScript ডেভেলপার, অথবা Golang aficionados। তাদের সকলেরই এই সত্যের মুখোমুখি হয় যে তাদের একটি মাইক্রোসার্ভিস আর্কিটেকচারে একটি অর্কেস্ট্রেশন প্রক্রিয়া বা কর্মপ্রবাহকে স্ট্রীমলাইন করার জন্য এবং অর্ডার করার ক্ষমতা, টাইমআউট পরিচালনা, সাগা এবং ক্ষতিপূরণ লেনদেনের ক্ষমতা অর্জনের জন্য একটি টুল প্রয়োজন।

সঙ্গে BPM প্ল্যাটফর্ম কামুন্ডা থেকে ওপেন সোর্স এই ধরনের কাজের জন্য মহান। ডেভেলপার বন্ধুত্ব পণ্যের অন্যতম প্রধান বৈশিষ্ট্য। কিন্তু আপনি যদি এর ডকুমেন্টেশন দেখেন, তাহলে আপনি ধারণা পেতে পারেন যে কামুন্ডার "বন্ধুত্ব" মূলত জাভা বিকাশকারীদের লক্ষ্য করে। প্ল্যাটফর্মটি আপনার নিজস্ব ফাংশন এবং এক্সটেনশনগুলিকে সংযুক্ত করার জন্য অনেকগুলি বিকল্প সরবরাহ করে, তবে এটি সমস্ত জাভাতে করা হয়েছে। এটা কি সত্যি?

না! আসলে, আপনি সহজেই কামুন্ডা চালাতে পারেন কোনো জাভা জ্ঞান ছাড়াই এবং আপনার পছন্দের যেকোনো ভাষায় কোডের জন্য আর্কিটেকচার সেট আপ করতে পারেন। এই নিবন্ধে, আমরা দেখব:

• মৌলিক স্থাপত্য;
• REST API
• জাভা ব্যতীত অন্যান্য ভাষার জন্য বিদ্যমান ক্লায়েন্ট লাইব্রেরি সম্পর্কে পরামর্শ;
• উদাহরণ C# এবং Node.JS ব্যবহার করে;
• কামুন্ডা সার্ভার শুরু করার উপায় (ডকার বা টমক্যাট)।

স্থাপত্য

কামুন্ডা জাভাতে লেখা এবং চালানোর জন্য একটি জাভা ভার্চুয়াল মেশিন (JVM) প্রয়োজন। কামুন্ডা একটি REST API প্রদান করে যা আপনাকে আপনার পছন্দের যেকোনো ভাষায় লিখতে এবং কামুন্ডার সাথে REST ব্যবহার করতে দেয়:

কামুন্ডায় ওয়ার্কফ্লোগুলি BPMN-এ সংজ্ঞায়িত করা হয়েছে, যা মূলত একটি XML ফাইল। এটি দিয়ে মডেল করা যেতে পারে কামুন্ডা মডেলার.

একটি পূর্ব-নির্মিত ডকার ইমেজের মাধ্যমে কামুন্ডা চালানো

কামুন্ডা চালানোর সবচেয়ে সহজ উপায় হল ডকার ব্যবহার করা। কামুন্ডা চালু করার বিকল্প উপায়গুলি এই নিবন্ধে পরে বর্ণিত হয়েছে৷

এই ক্ষেত্রে, সহজভাবে চালান:

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

আপনাকে লিনাক্স, জেভিএম বা টমক্যাটস নিয়ে চিন্তা করতে হবে না। ডকারফাইল এবং মৌলিক ডকুমেন্টেশন (উদাহরণস্বরূপ, প্রয়োজনীয় ডাটাবেসের সাথে সংযোগ করার জন্য নির্দেশাবলী) এখানে উপলব্ধ গিটহাব.

আপনি যদি কামুন্ডা এন্টারপ্রাইজ সংস্করণ চালাতে চান তবে আপনি সহজেই পরিবর্তন করতে পারেন Dockerfile.

যাইহোক, ডকারের সাথে কামুন্ডা চালানোর একটি নেতিবাচক দিক রয়েছে: আপনি টমক্যাটের একটি সংস্করণ পাবেন যা সর্বদা সর্বশেষ সংশোধনগুলি অন্তর্ভুক্ত করে না। এটিকে ঘিরে কাজ করার জন্য, আপনি পছন্দসই টমক্যাট বিতরণের উপর ভিত্তি করে আপনার নিজস্ব ডকার ইমেজ তৈরি করতে পারেন, যেমন এই উদাহরণে দেখানো হয়েছে, বা নীচে বর্ণিত সমাধানগুলির একটি ব্যবহার করুন।

প্রক্রিয়া মডেল স্থাপনা

আসুন একটি ক্লাসিক ট্রিপ বুকিংয়ের জন্য সাগা টেমপ্লেট ব্যবহার করে একটি উদাহরণ দেখি যেখানে আপনি একটি সারিতে তিনটি অ্যাকশন ট্রিগার করতে চান এবং পরবর্তী ব্যর্থতার ক্ষেত্রে সফলভাবে সম্পন্ন করা অ্যাকশনের জন্য সুন্দরভাবে ক্ষতিপূরণ দিতে চান। 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 এর মাধ্যমে কাজের আইটেম আনতে পারেন, কাজটি সম্পাদন করতে পারেন এবং কামুন্ডাকে সম্পূর্ণ করতে বলতে পারেন (টান-নীতি)।

তাই প্রথমে আপনাকে কার্যকর করতে হবে 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 কল করা সহজ। জাভাস্ক্রিপ্টে, এটি JQuery ব্যবহার করে সুবিধাজনকভাবে করা হয় এবং C# এ, System.Net.Http এবং Newtonsoft.Json ব্যবহার করে। কিন্তু এই সময় লাগবে. তাই আপনি শুধু কিছু ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন.

এই মুহুর্তে, বেশ কয়েকটি রেডিমেড ক্লায়েন্ট লাইব্রেরি উপলব্ধ:

• জাভাস্ক্রিপ্ট: লিংক. Camunda দ্বারা সমর্থিত;
• জাভা: লিংক. Camunda দ্বারা সমর্থিত;
• সি #:লিংক и লিংক. এই দুটি প্রকল্পই একটি মধ্যবর্তী অবস্থায় রয়েছে এবং কার্যত সুপ্ত, তবে একটি ভাল সূচনা পয়েন্ট হিসাবে কাজ করতে পারে;
• পিএইচপি: লিংক - খুব সম্পূর্ণ নয় এবং সর্বশেষ API পরিবর্তনগুলি অন্তর্ভুক্ত করে না, তবে আমি এমন প্রকল্পগুলি জানি যা এটি ব্যবহার করে।

জাভাস্ক্রিপ্ট এবং জাভা বাদ দিয়ে, ক্লায়েন্ট লাইব্রেরিগুলি কামুন্ডা পণ্যের অংশ নয়। আশা করবেন না যে তারা কামুন্ডার সমস্ত 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 standalone WAR" সহ কাস্টম ডকার ইমেজ

কামুন্ডা থেকে একটি পূর্ব-নির্মিত ডকার চিত্রের বিকল্প হিসাবে, আপনি নিজে টমক্যাট প্রস্তুত করতে পারেন (উদাহরণস্বরূপ, অফিসিয়াল ডকার টমক্যাট চিত্রগুলির উপর ভিত্তি করে) এবং তারপরে তথাকথিত ওয়ার ফাইলগুলির মধ্যে একটি হিসাবে কামুন্ডাকে কপি করুন৷

আপনার যদি অনেক অতিরিক্ত প্রয়োজনীয়তা থাকে এবং একটি জাভা বিল্ড এনভায়রনমেন্ট সেট আপ করতে পারেন, আপনি ক্যামুন্ডা স্ট্যান্ডঅ্যালোন যুদ্ধও সেট আপ করতে পারেন। এই উদাহরণগুলির মত একটি Maven বিল্ড সেট আপ করুন: বিল্ড যুদ্ধ কনফিগার সহ Maven বা সমাবেশ ওভারলে সঙ্গে Maven.

কামুন্ডা টমক্যাট বিতরণ শুরু হচ্ছে

আরেকটি বিকল্প হল ক্যামুন্ডা টমক্যাট ডিস্ট্রিবিউশন ডাউনলোড করা, এটি আনজিপ করা এবং এটি চালানো। এটি শুধুমাত্র আপনার কম্পিউটারে ইনস্টল করা Java Runtime Environment (JRE) প্রয়োজন। এটা সহজেই হতে পারে এখান থেকে ডাউনলোড করুন.

ডাটাবেস পরিবর্তন করতে বা অন্য কিছু করার জন্য আপনাকে টমক্যাট মত কনফিগার করতে হবে ডকুমেন্টেশনে বর্ণিত. আমি জানি টমক্যাট জটিল শোনাতে পারে, তবে এটি আসলে খুব সহজ। এবং Google এই প্রক্রিয়ার প্রয়োজন হতে পারে এমন সমস্ত কিছুর উত্তর জানে৷

টমক্যাট ব্যবহার করে কামুন্ডা চালানো

শেষ বিকল্পটি হ'ল নিজেই টমক্যাট সেট আপ করুন এবং এতে কামুন্ডা ইনস্টল করুন, ইনস্টলেশন বিবরণ অনুসরণ করুন. এটি আপনাকে টমক্যাটের যে কোনও সংস্করণ ব্যবহার করার বিকল্প দেবে, বা উদাহরণস্বরূপ এটি একটি উইন্ডোজ পরিষেবা হিসাবে ইনস্টল করবে।

উৎপাদনে কামুন্ডা চালু করা

এটি সাধারণত কামুন্ডা চালানোর জন্য কিছু চূড়ান্ত সেটআপের প্রয়োজন হবে। কামুন্ডায় এমন নির্দেশিকা রয়েছে যা এটিকে বিশদভাবে বর্ণনা করে, তবে আমি এই নিবন্ধে সেগুলিতে যাব না - আমি কেবল একটি উদাহরণের নাম দেব: ডিস্ট্রিবিউশনের REST API ডিফল্টরূপে প্রমাণীকরণের জন্য কনফিগার করা নেই। আপনি এটি পরিবর্তন করতে চাইতে পারেন.

বুদ্ধিমান

আপনি দেখতে পাচ্ছেন, আপনি যে ভাষাই ব্যবহার করছেন না কেন, Camunda দিয়ে শুরু করা খুবই সহজ। মূল বিষয় হল যে সমস্ত মিথস্ক্রিয়া REST API এর মাধ্যমে সম্পন্ন হয়। ইনস্টলেশনটিও বেশ সহজ, বিশেষ করে ডকার ব্যবহার করার সময়।

উত্স: www.habr.com