الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

منصة كاموندا 8

يحتوي هذا المستودع على روابط لموارد Camunda Platform 8، وعناصر الإصدار الرسمية (الثنائيات)، وملفات التكوين الداعمة لتشغيل Docker Compose كخيار تطوير محلي.

️ يوصى باستخدام Docker Compose للتطوير المحلي فقط. ️

نوصي باستخدام SaaS أو Helm/Kubernetes للتطوير.

لمزيد من المعلومات حول الإدارة الذاتية، بما في ذلك خيارات تثبيت التطوير الإضافية، راجع الوثائق الخاصة بنا.

بالنسبة لإعدادات الإنتاج، نوصي باستخدام مخططات Helm التي يمكن العثور عليها على helm.camunda.io.

روابط إلى اتفاقيات وأصول Camunda Platform 8 الإضافية

  • التوثيق
  • منصة Camunda SaaS
  • دليل البدء
  • الإصدارات
  • مخططات هيلم
  • محرك سير العمل زيبي
  • اتصال

باستخدام دوكر يؤلف

يستخدم ملف docker-compose الموجود في هذا المستودع أحدث مواصفات الإنشاء، والتي تم تقديمها مع إصدار docker compose 1.27.0+. يرجى التأكد من استخدام إصدار محدث من عامل الإرساء.

مطلوب دوكر 20.10.16+.

لدعم تحديث الرمز المميز وتسجيل الخروج، يحتاج جهازك المحلي إلى حل keycloak إلى 127.0.0.1 ويجب تعيين المتغير KEYCLOAK_HOST على keycloak في ملف .env .

لتدوير بيئة Camunda Platform 8 ذاتية الإدارة بالكامل محليًا، يمكن استخدام ملف docker-compose.yaml الموجود في هذا المستودع.

تحتوي البيئة الكاملة على هذه المكونات:

  • زيبي
  • تشغيل
  • قائمة المهام
  • الموصلات
  • تحسين
  • هوية
  • البحث المرن/البحث المفتوح
  • عباءة المفاتيح
  • PostgreSQL

لا يتم تضمين Web Modeler بشكل افتراضي. يرجى اتباع التعليمات أدناه لتثبيته.

انسخ هذا الريبو وأصدر الأمر التالي لبدء بيئتك: 

 docker compose up -d

انتظر بضع دقائق حتى تبدأ البيئة وتستقر. راقب السجلات، وخاصة سجل حاوية Keycloak، للتأكد من بدء تشغيل المكونات.

يمكنك الآن الانتقال إلى تطبيقات الويب المختلفة وتسجيل الدخول باستخدام demo للمستخدم والعرض demo لكلمة المرور:

  • التشغيل: http://localhost:8081
  • قائمة المهام: http://localhost:8082
  • الأمثل: http://localhost:8083
  • الهوية: http://localhost:8084
  • البحث المرن: http://localhost:9200

يتم استخدام Keycloak لإدارة المستخدمين. هنا يمكنك تسجيل الدخول باستخدام admin المستخدم وكلمة المرور admin

  • عباءة المفتاح: http://localhost:18080/auth/

يتوفر محرك سير العمل Zeebe باستخدام gRPC على localhost:26500 .

لهدم البيئة بأكملها، قم بتشغيل الأمر التالي: 

 docker compose down -v

تتطلب Zeebe وOperate وTasklist بالإضافة إلى Optimize شبكة منفصلة عن Identity كما ستشاهد في ملف إنشاء عامل الإرساء.

باستخدام المكونات الأساسية

إذا لم تكن هناك حاجة إلى Optimize وIdentity وKeycloak، فيمكنك استخدام docker-compose-core.yaml بدلاً من ذلك والذي لا يتضمن هذه المكونات: 

 docker compose -f docker-compose-core.yaml up -d

أو

قم بتعيين المعلمة SEARCH_DB=opensearch في الملف .env إذا كنت تريد استخدام OpenSearch بدلاً من ElasticSearch 

 docker compose -f docker-compose-core.yaml --profile opensearch up -d

نشر مخططات BPMN

بالإضافة إلى إعداد البيئة المحلية باستخدام docker compose، استخدم Camunda Desktop Modeler لتصميم مخططات BPMN محليًا للتنفيذ ونشرها مباشرة في بيئتك المحلية. باعتبارك أحد عملاء المؤسسة، يمكنك استخدام Web Modeler.

ردود الفعل والتحديثات هي موضع ترحيب!

تأمين واجهة برمجة تطبيقات Zeebe

افتراضيًا، يمكن الوصول إلى واجهة برمجة تطبيقات Zeebe GRPC بشكل عام دون الحاجة إلى أي بيانات اعتماد للعميل لأغراض التطوير.

ومع ذلك، يمكنك تمكين مصادقة طلبات GRPC في Zeebe عن طريق تعيين متغير البيئة ZEEBE_AUTHENTICATION_MODE على identity ، على سبيل المثال عبر تشغيل: 

 ZEEBE_AUTHENTICATION_MODE=identity docker compose up -d

أو عن طريق تعديل القيمة الافتراضية في ملف .env .

الموصلات

يحتوي كلا ملفي إنشاء عامل الإرساء على موصلاتنا الجاهزة.

راجع دليل تثبيت الرابط للحصول على تفاصيل حول كيفية توفير قوالب الموصل ذات الصلة للنمذجة.

لإدخال أسرار في وقت تشغيل الرابط، يمكن إضافتها إلى ملف connector-secrets.txt داخل المستودع بالتنسيق NAME=VALUE لكل سطر. ستكون الأسرار متاحة بعد ذلك في وقت تشغيل الرابط بالتنسيق secrets.NAME .

لإضافة موصلات مخصصة، قم إما بإنشاء صورة عامل إرساء جديدة مجمعة عليها كما هو موضح هنا.

وبدلاً من ذلك، يمكنك تحميل موصل JARs الجديد كوحدات تخزين في المجلد /opt/app عن طريق إضافة هذا إلى ملف docker-compose. ضع في اعتبارك أن موصل JARs يحتاج إلى إحضار جميع التبعيات الضرورية داخل JAR.

كيبانا

يتوفر ملف تعريف kibana في ملفات إنشاء عامل الإرساء المتوفرة لدعم فحص واستكشاف بيانات Camunda Platform 8 في Elasticsearch. يمكن تمكينه عن طريق إضافة --profile kibana إلى أمر إنشاء عامل الإرساء الخاص بك. بالإضافة إلى المكونات الأخرى، يدور هذا الملف حول كيبانا. يمكن استخدام Kibana لاستكشاف السجلات التي تم تصديرها بواسطة Zeebe إلى Elasticsearch، أو لاكتشاف البيانات الموجودة في Elasticsearch التي تستخدمها المكونات الأخرى (مثل التشغيل).

يمكنك الانتقال إلى تطبيق الويب Kibana والبدء في استكشاف البيانات بدون بيانات اعتماد تسجيل الدخول:

  • كيبانا: http://localhost:5601

ملاحظة: تحتاج إلى تكوين أنماط الفهرس في Kibana قبل أن تتمكن من استكشاف البيانات.

  • انتقل إلى Management > Stack Management > Kibana > Index Patterns .
  • إنشاء نمط فهرس جديد. على سبيل المثال، zeebe-record-* يطابق السجلات المصدرة.
    • إذا كنت لا ترى أي فهارس، فتأكد من تصدير بعض البيانات أولاً (على سبيل المثال، نشر عملية). يتم إنشاء فهارس السجلات عند تصدير السجل الأول من هذا النوع.
  • انتقل إلى Analytics > Discover وحدد نمط الفهرس.

مصمم نماذج سطح المكتب

يعد Desktop Modeler مفتوح المصدر ومجاني الاستخدام.

قم بتنزيل Desktop Modeler وابدأ في تصميم نماذج BPMN وDMN وCamunda على جهازك المحلي.

نشر أو تنفيذ عملية

بدون مصادقة

بمجرد أن تصبح جاهزًا لنشر العمليات أو تنفيذها، استخدم هذه الإعدادات للنشر على مثيل Zeebe المحلي:

  • المصادقة: None
  • عنوان URL: http://localhost:26500

مع مصادقة طلب Zeebe

إذا قمت بتمكين المصادقة لطلبات GRPC على Zeebe، فستحتاج إلى توفير بيانات اعتماد العميل عند نشر العمليات وتنفيذها:

  • المصادقة: OAuth
  • عنوان URL: http://localhost:26500
  • معرف العميل: zeebe
  • سر العميل: zecret
  • عنوان URL لـ OAuth: http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token
  • الجمهور: zeebe-api

مصمم الويب المُدار ذاتيًا

يتوفر Web Modeler Self-Managed لعملاء مؤسسة Camunda فقط.

تتوفر صور Docker الخاصة بـ Web Modeler في سجل خاص. لدى عملاء المؤسسات بيانات اعتماد لهذا السجل بالفعل، أو يمكنهم طلب الوصول إلى هذا السجل من خلال جهة اتصال CSM الخاصة بهم في Camunda.

لتشغيل Camunda Platform باستخدام Web Modeler، قم باستنساخ هذا الريبو وأصدر الأوامر التالية: 

 $ docker login registry.camunda.cloud
Username: your_username
Password: ******
Login Succeeded

لتشغيل Camunda Platform مع Elasticsearch، قم بتنفيذ هذه الأوامر

  1. تحرير ملف .env وتعيين المعلمة SEARCH_DB=elasticserach (هذه القيمة الافتراضية)
  2. تشغيل الأمر 
 $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml up -d
  1. لتدمير البيئة بأكملها باستخدام ElasticSearch قم بتشغيل الأمر التالي 
 $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down -v

إذا كنت تريد حذف كل شيء (بما في ذلك أي بيانات قمت بإنشائها). وبدلاً من ذلك، إذا كنت تريد الاحتفاظ بتشغيل البيانات: 

 $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down

لتشغيل منصة Camunda باستخدام OpenSearch قم بتنفيذ هذه الأوامر

  1. تحرير ملف .env وتعيين المعلمة SEARCH_DB=opensearch
  2. تشغيل الأمر 
 $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml --profile opensearch up -d
  1. لتدمير البيئة بأكملها باستخدام Elasticsearch، قم بتشغيل الأمر التالي (-v هي علامة اختيارية. استخدمها، إذا كنت تريد حذف جميع البيانات) 
 $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml --profile opensearch down -v

تسجيل الدخول

يمكنك الوصول إلى Web Modeler Self-Managed وتسجيل الدخول باستخدام demo demo للمستخدم وكلمة المرور على http://localhost:8070.

نشر أو تنفيذ عملية

بدون مصادقة

بمجرد أن تصبح جاهزًا لنشر العمليات أو تنفيذها، استخدم هذه الإعدادات للنشر على مثيل Zeebe المحلي:

  • المصادقة: None
  • عنوان URL: http://zeebe:26500

مع مصادقة طلب Zeebe

إذا قمت بتمكين المصادقة لطلبات GRPC على Zeebe، فستحتاج إلى توفير بيانات اعتماد العميل عند نشر العمليات وتنفيذها:

  • المصادقة: OAuth
  • عنوان URL: http://zeebe:26500
  • معرف العميل: zeebe
  • سر العميل: zecret
  • عنوان URL لـ OAuth: http://keycloak:18080/auth/realms/camunda-platform/protocol/openid-connect/token
  • الجمهور: zeebe-api

رسائل البريد الإلكتروني

يتضمن الإعداد Mailpit كخادم اختبار SMTP. فهو يلتقط جميع رسائل البريد الإلكتروني المرسلة بواسطة Web Modeler، لكنه لا يعيد توجيهها إلى المستلمين الفعليين.

يمكنك الوصول إلى رسائل البريد الإلكتروني في واجهة مستخدم الويب الخاصة بـ Mailpit على http://localhost:8075.

استكشاف الأخطاء وإصلاحها

تقديم القضايا

عند إرسال مشكلة في هذا المستودع، يرجى التأكد من أن مشكلتك مرتبطة بطريقة نشر عامل الإرساء لمنصة Camunda. يجب بدلاً من ذلك نشر جميع الأسئلة المتعلقة بوظائف تطبيقات الويب في منتدى Camunda. هذه هي أفضل طريقة للمستخدمين للاستعلام عن الإجابات الموجودة التي واجهها الآخرون بالفعل. لدينا أيضًا فئة في هذا المنتدى مخصصة للمواضيع المتعلقة بالنشر.

يعمل على الأجهزة المستندة إلى Arm64

عند استخدام الأجهزة المستندة إلى Arm64 مثل M1 أو M2 Mac، قد لا تبدأ حاوية Keycloak لأن Bitnami توفر فقط الصور المستندة إلى amd64 للإصدارات < 22. يمكنك إنشاء صورة مستندة إلى الذراع ووضع علامة عليها محليًا باستخدام الأمر التالي. بعد إنشاء الصورة ووضع علامات عليها، يمكنك بدء البيئة كما هو موضح في استخدام docker-compose. 

 $ DOCKER_BUILDKIT=0 docker build -t bitnami/keycloak:19.0.3 "https://github.com/camunda/camunda-platform.git#8.2.15:.keycloak/"

التراخيص القائمة على الموارد

يمكنك التحكم في الوصول إلى عمليات محددة وجداول القرار في التشغيل وقائمة المهام من خلال التفويض المستند إلى الموارد.

يتم تعطيل هذه الميزة افتراضيًا ويمكن تمكينها عن طريق تعيين RESOURCE_AUTHORIZATIONS_ENABLED على true ، إما عبر ملف .env أو من خلال سطر الأوامر: 

 RESOURCE_AUTHORIZATIONS_ENABLED=true docker compose up -d

متعدد الإيجار

يمكنك استخدام الإيجارات المتعددة لتحقيق العزلة المستندة إلى المستأجر.

يتم تعطيل هذه الميزة افتراضيًا ويمكن تمكينها عن طريق تعيين MULTI_TENANCY_ENABLED على true ، إما عبر ملف .env أو من خلال سطر الأوامر: 

 ZEEBE_AUTHENICATION_MODE=identity MULTI_TENANCY_ENABLED=true docker compose up -d

كما هو موضح أعلاه، تتطلب الميزة أيضًا استخدام identity كموفر مصادقة.

تأكد من إعداد هوية المستأجرين بعد بدء تشغيل النظام الأساسي.

منصة كاموندا 7

هل تبحث عن معلومات حول منصة Camunda 7؟ تحقق من الروابط أدناه:

  • التوثيق
  • جيثب
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل
تعليقات المستخدمين