ການນໍາໃຊ້ Camunda ສໍາລັບ orchestration ງ່າຍໂດຍອີງໃສ່ REST ແລະ Workflow Engine (ບໍ່ມີ Java)

Hey Habr! ຂ້າ​ພະ​ເຈົ້າ​ນໍາ​ສະ​ເຫນີ​ໃຫ້​ທ່ານ​ສົນ​ໃຈ​ການ​ແປ​ພາ​ສາ​ຂອງ​ບົດ​ຄວາມ​ໄດ້​ "ໃຊ້ Camunda ເປັນເຄື່ອງ orchestration REST ທີ່ງ່າຍຕໍ່ການໃຊ້ແລະການເຮັດວຽກຂອງເຄື່ອງຈັກ (ໂດຍບໍ່ມີການສໍາຜັດກັບ Java)" ໂດຍ Bernd Rücker.

ວັນທີ 07.07.2020/XNUMX/XNUMX, ການແປ ບົດຄວາມ Bernd Rucker

ຂ້ອຍມັກຈະສົນທະນາກ່ຽວກັບສະຖາປັດຕະຍະກໍາ microservice ກັບຄົນທີ່ບໍ່ແມ່ນ Java: ນັກພັດທະນາ C#, Node.JS/JavaScript developers, ຫຼື Golang aficionados. ພວກເຂົາທັງຫມົດແມ່ນປະເຊີນຫນ້າກັບຄວາມຈິງທີ່ວ່າພວກເຂົາຕ້ອງການກົນໄກການ orchestration ໃນສະຖາປັດຕະຍະກໍາຈຸລະພາກ, ຫຼືພຽງແຕ່ເຄື່ອງມືເພື່ອປັບປຸງຂະບວນການເຮັດວຽກແລະໄດ້ຮັບຄວາມສາມາດໃນການສັ່ງ, ຈັດການເວລາຫມົດເວລາ, Saga ແລະການຊົດເຊີຍການເຮັດທຸລະກໍາ.

ເວທີ BPM ກັບ ແຫຼ່ງເປີດຈາກ Camunda ທີ່ຍິ່ງໃຫຍ່ສໍາລັບວຽກງານດັ່ງກ່າວ. ຄວາມເປັນມິດກັບນັກພັດທະນາແມ່ນຫນຶ່ງໃນລັກສະນະທີ່ສໍາຄັນຂອງຜະລິດຕະພັນ. ແຕ່ຖ້າທ່ານເບິ່ງເອກະສານຂອງມັນ, ທ່ານອາດຈະໄດ້ຮັບຄວາມປະທັບໃຈທີ່ວ່າ "ຄວາມເປັນມິດ" ຂອງ Camunda ສ່ວນໃຫຍ່ແມ່ນແນໃສ່ນັກພັດທະນາ Java. ແພລະຕະຟອມສະຫນອງໂອກາດຫຼາຍຢ່າງເພື່ອເຊື່ອມຕໍ່ຫນ້າທີ່ຂອງຕົນເອງແລະສ່ວນຂະຫຍາຍ, ແຕ່ມັນເຮັດທັງຫມົດໃນ Java. ແມ່ນແທ້ບໍ?

ບໍ່! ໃນຄວາມເປັນຈິງ, ທ່ານສາມາດດໍາເນີນການ Camunda ໄດ້ຢ່າງງ່າຍດາຍໂດຍບໍ່ມີຄວາມຮູ້ Java ແລະຕັ້ງສະຖາປັດຕະຍະກໍາສໍາລັບລະຫັດໃນພາສາທີ່ທ່ານເລືອກ. ໃນບົດຄວາມນີ້, ພວກເຮົາຈະເບິ່ງ:

• ສະຖາປັດຕະຍະກໍາພື້ນຖານ;
• REST API
• ຄໍາແນະນໍາກ່ຽວກັບຫ້ອງສະຫມຸດລູກຄ້າທີ່ມີຢູ່ສໍາລັບພາສານອກເຫນືອຈາກ Java;
• ຕົວຢ່າງທີ່ໃຊ້ C# ແລະ Node.JS;
• ວິທີການເລີ່ມຕົ້ນເຄື່ອງແມ່ຂ່າຍຂອງ Camunda (Docker ຫຼື Tomcat).

ຖາປັດຕະຍະ

Camunda ຖືກຂຽນໄວ້ໃນ Java ແລະຕ້ອງການ Java Virtual Machine (JVM) ເພື່ອແລ່ນ. Camunda ໃຫ້ REST API ທີ່ອະນຸຍາດໃຫ້ທ່ານຂຽນໃນພາສາໃດກໍໄດ້ທີ່ທ່ານມັກ ແລະໃຊ້ REST ກັບ Camunda:

Workflows ໃນ Camunda ຖືກກໍານົດໄວ້ໃນ BPMN, ເຊິ່ງໂດຍພື້ນຖານແລ້ວແມ່ນໄຟລ໌ XML. ມັນສາມາດໄດ້ຮັບການສ້າງແບບຈໍາລອງດ້ວຍ ນາຍແບບ Camunda.

ແລ່ນ Camunda ຜ່ານຮູບ Docker ທີ່ສ້າງຂຶ້ນກ່ອນ

ວິທີທີ່ງ່າຍທີ່ສຸດທີ່ຈະດໍາເນີນການ Camunda ແມ່ນການໃຊ້ Docker. ວິທີການທາງເລືອກໃນການເປີດຕົວ Camunda ແມ່ນໄດ້ອະທິບາຍຕໍ່ມາໃນບົດຄວາມນີ້.

ໃນກໍລະນີດັ່ງກ່າວນີ້, ພຽງແຕ່ດໍາເນີນການ:

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

ທ່ານບໍ່ຈໍາເປັນຕ້ອງກັງວົນກ່ຽວກັບ Linux, JVMs ຫຼື Tomcats. Dockerfiles ແລະເອກະສານພື້ນຖານ (ຕົວຢ່າງ, ຄໍາແນະນໍາສໍາລັບການເຊື່ອມຕໍ່ກັບຖານຂໍ້ມູນທີ່ຕ້ອງການ) ແມ່ນມີຢູ່ GitHub.

ຖ້າທ່ານຕ້ອງການດໍາເນີນການ Camunda Enterprise Edition ທ່ານສາມາດປ່ຽນໄດ້ຢ່າງງ່າຍດາຍ dockerfile.

ຢ່າງໃດກໍຕາມ, ການແລ່ນ Camunda ກັບ Docker ມີຂໍ້ເສຍຫນຶ່ງ: ທ່ານຈະສິ້ນສຸດດ້ວຍສະບັບຂອງ Tomcat ທີ່ບໍ່ປະກອບມີການແກ້ໄຂຫລ້າສຸດ. ເພື່ອເຮັດວຽກນີ້, ທ່ານສາມາດສ້າງຮູບພາບ Docker ຂອງທ່ານເອງໂດຍອີງໃສ່ການແຈກຢາຍ Tomcat ທີ່ຕ້ອງການ, ດັ່ງທີ່ສະແດງຢູ່ໃນຕົວຢ່າງນີ້, ຫຼືໃຊ້ຫນຶ່ງໃນການແກ້ໄຂທີ່ໄດ້ອະທິບາຍຂ້າງລຸ່ມນີ້.

ການນຳໃຊ້ຕົວແບບຂະບວນການ

ຂໍໃຫ້ເບິ່ງຕົວຢ່າງການນໍາໃຊ້ແມ່ແບບ Saga ສໍາລັບການຈອງການເດີນທາງແບບຄລາສສິກທີ່ທ່ານຕ້ອງການທີ່ຈະກະຕຸ້ນສາມການດໍາເນີນການຕິດຕໍ່ກັນແລະ gracefully ຊົດເຊີຍການດໍາເນີນການສໍາເລັດສົບຜົນສໍາເລັດໃນກໍລະນີຂອງຄວາມລົ້ມເຫຼວຕໍ່ມາ. ເປັນຕົວແທນໃນຮູບແບບ BPMN, ມັນເບິ່ງຄືວ່ານີ້:

ໃນປັດຈຸບັນທ່ານສາມາດນໍາໃຊ້ REST API ສຳລັບການວາງຕົວແບບຂະບວນການ. ສົມມຸດວ່າທ່ານບັນທຶກມັນເປັນ trip.bpmn ແລະແລ່ນ Camunda ຜ່ານ Docker ດັ່ງນັ້ນມັນມີຢູ່ໃນ localhost: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 ແລະສົ່ງຂໍ້ມູນທີ່ທ່ານຕ້ອງການເບິ່ງເປັນຕົວແປຂອງ workflow instance:

  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

ຄໍາຖາມທີ່ຫນ້າສົນໃຈຕໍ່ໄປແມ່ນ: Camunda ໂທຫາຂັ້ນຕອນເຊັ່ນການຈອງລົດແນວໃດ? Camunda ບໍ່ພຽງແຕ່ສາມາດໂທຫາການບໍລິການທັນທີ (Push-Principle) ໂດຍໃຊ້ບາງຕົວໃນ ຕົວເຊື່ອມຕໍ່, ແຕ່ຍັງເອົາລາຍການເຮັດວຽກຢູ່ໃນປະເພດຂອງຄໍາສັ່ງທີ່ສ້າງຂຶ້ນ. ຫຼັງຈາກນັ້ນ, ພະນັກງານສາມາດດຶງເອົາລາຍການວຽກຜ່ານ REST, ປະຕິບັດວຽກງານ, ແລະບອກ Camunda ໃຫ້ສໍາເລັດ (Pull-Principle).

ດັ່ງນັ້ນທໍາອິດທ່ານຈໍາເປັນຕ້ອງປະຕິບັດ 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

ແລ້ວບອກ Camunda ວ່າ ຄົນ​ງານ​ເຮັດ​ວຽກ​ສໍາ​ເລັດ​ (ສັງເກດວ່າທ່ານຕ້ອງໃສ່ ID ວຽກພາຍນອກທີ່ໄດ້ຮັບໃນຄໍາຮ້ອງຂໍທໍາອິດ):

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

ນັ້ນແມ່ນມັນ - ເຈົ້າຍັງບໍ່ໄດ້ຕ້ອງການ Java, ແມ່ນບໍ? ແລະມັນພຽງພໍທີ່ຈະເລີ່ມຕົ້ນ!

ຫ້ອງສະໝຸດລູກຄ້າ

ການໂທຫາ REST API ແມ່ນງ່າຍໃນພາສາການຂຽນໂປຼແກຼມໃດໆ. ໃນ JavaScript, ນີ້ແມ່ນເຮັດໄດ້ສະດວກໂດຍໃຊ້ JQuery, ແລະໃນ C#, ໂດຍໃຊ້ System.Net.Http ແລະ Newtonsoft.Json. ແຕ່ນີ້ຈະໃຊ້ເວລາ. ດັ່ງນັ້ນທ່ານພຽງແຕ່ສາມາດນໍາໃຊ້ຫ້ອງສະຫມຸດລູກຄ້າຈໍານວນຫນຶ່ງ.

ໃນປັດຈຸບັນ, ຫ້ອງສະຫມຸດລູກຄ້າທີ່ກຽມພ້ອມຫຼາຍແມ່ນມີ:

• javascript: ຫນ້າທໍາອິດ. ສະຫນັບສະຫນູນໂດຍ Camunda;
• Java: ຫນ້າທໍາອິດ. ສະຫນັບສະຫນູນໂດຍ Camunda;
• C #:ຫນ້າທໍາອິດ и ຫນ້າທໍາອິດ. ທັງສອງໂຄງການເຫຼົ່ານີ້ແມ່ນຢູ່ໃນລັດກາງແລະປະຕິບັດ dormant, ແຕ່ສາມາດເປັນຈຸດເລີ່ມຕົ້ນທີ່ດີ;
• PHP: ຫນ້າທໍາອິດ - ບໍ່ສົມບູນເກີນໄປແລະບໍ່ລວມເອົາການປ່ຽນແປງ API ຫຼ້າສຸດ, ແຕ່ຂ້ອຍຮູ້ວ່າໂຄງການທີ່ໃຊ້ມັນ.

ມີຂໍ້ຍົກເວັ້ນຂອງ JavaScript ແລະ Java, ຫ້ອງສະຫມຸດລູກຄ້າບໍ່ແມ່ນສ່ວນຫນຶ່ງຂອງຜະລິດຕະພັນ Camunda ເອງ. ຢ່າຄາດຫວັງວ່າພວກເຂົາຈະສະຫນັບສະຫນູນຄຸນນະສົມບັດ REST API ທັງຫມົດຂອງ Camunda. ພຽງແຕ່ຍ້ອນວ່າຫ້ອງສະຫມຸດບໍ່ສະຫນອງຫນ້າທີ່ສະເພາະໃດຫນຶ່ງບໍ່ໄດ້ຫມາຍຄວາມວ່າມັນບໍ່ຢູ່ທີ່ນັ້ນ, ໃຫ້ກວດເບິ່ງ Camunda's 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();

ຂໍ້ມູນເພີ່ມເຕີມສາມາດພົບໄດ້ຢູ່ໃນເວັບໄຊທ໌ githubcom

ວິທີການທາງເລືອກໃນການເປີດຕົວ Camunda

ຮູບພາບ Docker ແບບກຳນົດເອງກັບ "Camunda standalone WAR"

ເປັນທາງເລືອກສໍາລັບຮູບພາບ Docker ທີ່ສ້າງໄວ້ກ່ອນຈາກ Camunda, ທ່ານສາມາດກະກຽມ Tomcat ຕົວທ່ານເອງ (ຕົວຢ່າງ, ອີງຕາມຮູບພາບ Docker Tomcat ຢ່າງເປັນທາງການ) ແລະຫຼັງຈາກນັ້ນຄັດລອກ Camunda ເຂົ້າໄປໃນມັນເປັນຫນຶ່ງໃນໄຟລ໌ WAR ທີ່ເອີ້ນວ່າ.

ຖ້າທ່ານມີຄວາມຕ້ອງການເພີ່ມເຕີມຈໍານວນຫຼາຍແລະສາມາດຕັ້ງຄ່າສະພາບແວດລ້ອມການກໍ່ສ້າງ Java, ທ່ານຍັງສາມາດຕັ້ງຄ່າສົງຄາມ Camunda Standalone. ຕັ້ງຄ່າການກໍ່ສ້າງ Maven ເຊັ່ນໃນຕົວຢ່າງເຫຼົ່ານີ້: ການກໍ່ສ້າງ Maven ກັບ config ສົງຄາມ ຫຼືການປະກອບ Maven ກັບ Overlay.

ເລີ່ມການແຈກຢາຍ Camunda Tomcat

ທາງເລືອກອື່ນແມ່ນພຽງແຕ່ດາວນ໌ໂຫລດການແຈກຢາຍ Camunda Tomcat, unzip ມັນ, ແລະດໍາເນີນການມັນ. ອັນນີ້ຕ້ອງການພຽງແຕ່ Java Runtime Environment (JRE) ທີ່ຕິດຕັ້ງຢູ່ໃນຄອມພິວເຕີຂອງທ່ານ. ມັນສາມາດໄດ້ຢ່າງງ່າຍດາຍ ດາວ​ນ​໌​ໂຫລດ​ຈາກ​ທີ່​ນີ້​.

ໃນຄໍາສັ່ງທີ່ຈະປ່ຽນຖານຂໍ້ມູນຫຼືເຮັດສິ່ງອື່ນໃດ, ທ່ານຈໍາເປັນຕ້ອງ configure Tomcat ຄື ອະທິບາຍໄວ້ໃນເອກະສານ. ຂ້ອຍຮູ້ວ່າ Tomcat ອາດຈະສັບສົນ, ແຕ່ຕົວຈິງແລ້ວມັນງ່າຍດາຍຫຼາຍ. ແລະ Google ຮູ້ຄໍາຕອບຂອງທຸກສິ່ງທຸກຢ່າງທີ່ອາດຈະຕ້ອງການໃນຂະບວນການ.

ແລ່ນ Camunda ໃຊ້ Tomcat

ທາງເລືອກສຸດທ້າຍແມ່ນການຕິດຕັ້ງ Tomcat ຕົວທ່ານເອງແລະຕິດຕັ້ງ Camunda ເຂົ້າໄປໃນມັນ, ປະຕິບັດຕາມຄໍາອະທິບາຍການຕິດຕັ້ງ. ນີ້ຈະໃຫ້ທ່ານທາງເລືອກທີ່ຈະໃຊ້ Tomcat ລຸ້ນໃດກໍ່ຕາມທີ່ທ່ານຕ້ອງການ, ຫຼືຕິດຕັ້ງມັນເປັນບໍລິການ Windows, ຕົວຢ່າງ.

ການເປີດຕົວ Camunda ໃນການຜະລິດ

ປົກກະຕິອັນນີ້ຈະຕ້ອງມີການຕັ້ງຄ່າຂັ້ນສຸດທ້າຍເພື່ອເປີດໃຊ້ Camunda. ມີຄໍາແນະນໍາໃນ Camunda ທີ່ອະທິບາຍເລື່ອງນີ້ໃນລາຍລະອຽດທີ່ຍິ່ງໃຫຍ່, ແຕ່ຂ້ອຍຈະບໍ່ເຂົ້າໄປໃນພວກມັນໃນບົດຄວາມນີ້ - ຂ້ອຍຈະຕັ້ງຊື່ພຽງແຕ່ຫນຶ່ງຕົວຢ່າງ: REST API ຂອງການແຈກຢາຍບໍ່ໄດ້ຖືກຕັ້ງຄ່າສໍາລັບການພິສູດຢືນຢັນໂດຍຄ່າເລີ່ມຕົ້ນ. ທ່ານອາດຈະຕ້ອງການປ່ຽນແປງນີ້.

Summing up

ດັ່ງທີ່ເຈົ້າສາມາດເຫັນໄດ້, ມັນງ່າຍຫຼາຍທີ່ຈະເລີ່ມຕົ້ນກັບ Camunda, ໂດຍບໍ່ຄໍານຶງເຖິງພາສາທີ່ທ່ານກໍາລັງໃຊ້. ຈຸດສໍາຄັນແມ່ນວ່າການໂຕ້ຕອບທັງຫມົດແມ່ນເຮັດຜ່ານ REST API. ການຕິດຕັ້ງກໍ່ງ່າຍຫຼາຍ, ໂດຍສະເພາະເມື່ອໃຊ້ Docker.

ແຫຼ່ງຂໍ້ມູນ: www.habr.com