พื้นที่เก็บข้อมูลนี้มีลิงก์ไปยังทรัพยากร Camunda Platform 8, อาร์ติแฟกต์การเผยแพร่อย่างเป็นทางการ (ไบนารี) และรองรับไฟล์กำหนดค่าสำหรับการรัน Docker Compose เป็นตัวเลือกการพัฒนาในเครื่อง
เราขอแนะนำให้ใช้ SaaS หรือ Helm/Kubernetes เพื่อการพัฒนา
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการจัดการด้วยตนเอง รวมถึงตัวเลือกการติดตั้งการพัฒนาเพิ่มเติม โปรดดูเอกสารประกอบของเรา
สำหรับการตั้งค่าการผลิต เราขอแนะนำให้ใช้แผนภูมิ Helm ซึ่งสามารถดูได้ที่ helm.camunda.io
ไฟล์เขียนนักเทียบท่าในพื้นที่เก็บข้อมูลนี้ใช้ข้อกำหนดการเขียนล่าสุด ซึ่งนำมาใช้กับนักเทียบท่าเขียนเวอร์ชัน 1.27.0+ โปรดตรวจสอบให้แน่ใจว่าได้ใช้เวอร์ชันการเขียนนักเทียบท่าที่ทันสมัย
ต้องใช้นักเทียบท่า 20.10.16+
เพื่อรองรับการรีเฟรชโทเค็นและออกจากระบบ เครื่องในพื้นที่ของคุณจำเป็นต้องแก้ไข
keycloak
เป็น127.0.0.1
และตัวแปรKEYCLOAK_HOST
จะต้องตั้งค่าเป็นkeycloak
ในไฟล์ ..env
หากต้องการสร้างสภาพแวดล้อมแบบจัดการด้วยตนเองของ Camunda Platform 8 ที่สมบูรณ์ภายในเครื่อง คุณสามารถใช้ไฟล์ docker-compose.yaml ในที่เก็บนี้ได้
สภาพแวดล้อมแบบเต็มประกอบด้วยส่วนประกอบเหล่านี้:
Web Modeler ไม่ได้ถูกรวมไว้ตามค่าเริ่มต้น โปรดปฏิบัติตามคำแนะนำด้านล่างเพื่อติดตั้ง
โคลน repo นี้และออกคำสั่งต่อไปนี้เพื่อเริ่มต้นสภาพแวดล้อมของคุณ:
docker compose up -d
รอสักครู่เพื่อให้สภาพแวดล้อมเริ่มต้นและสงบลง ตรวจสอบบันทึก โดยเฉพาะบันทึกคอนเทนเนอร์ Keycloak เพื่อให้แน่ใจว่าส่วนประกอบต่างๆ ได้เริ่มทำงานแล้ว
ตอนนี้คุณสามารถนำทางไปยังเว็บแอปต่างๆ และเข้าสู่ระบบด้วย demo
ผู้ใช้และ demo
รหัสผ่าน:
Keycloak ใช้เพื่อจัดการผู้ใช้ ที่นี่คุณสามารถเข้าสู่ระบบด้วย admin
ผู้ใช้และ admin
ระบบรหัสผ่าน
เอ็นจิ้นเวิร์กโฟลว์ 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
นอกเหนือจากการตั้งค่าสภาพแวดล้อมในเครื่องด้วยการเขียนนักเทียบท่าแล้ว ให้ใช้ Camunda Desktop Modeler เพื่อสร้างโมเดลไดอะแกรม BPMN ในเครื่องเพื่อดำเนินการและปรับใช้กับสภาพแวดล้อมในเครื่องของคุณโดยตรง ในฐานะลูกค้าองค์กร คุณสามารถใช้ Web Modeler ได้
ยินดีต้อนรับข้อเสนอแนะและการปรับปรุง!
ตามค่าเริ่มต้น Zeebe GRPC API สามารถเข้าถึงได้แบบสาธารณะโดยไม่ต้องมีข้อมูลรับรองไคลเอ็นต์ใดๆ เพื่อวัตถุประสงค์ในการพัฒนา
อย่างไรก็ตาม คุณสามารถเปิดใช้งานการตรวจสอบสิทธิ์คำขอ GRPC ใน Zeebe ได้โดยการตั้งค่าตัวแปรสภาพแวดล้อม ZEEBE_AUTHENTICATION_MODE
เป็น identity
เช่นผ่านการรัน:
ZEEBE_AUTHENTICATION_MODE=identity docker compose up -d
หรือโดยการแก้ไขค่าเริ่มต้นในไฟล์ . .env
ไฟล์นักเทียบท่าทั้งสองไฟล์มีตัวเชื่อมต่อที่พร้อมใช้งานทันที
โปรดดูคู่มือการติดตั้งตัวเชื่อมต่อสำหรับรายละเอียดเกี่ยวกับวิธีการจัดเตรียมเทมเพลตตัวเชื่อมต่อที่เกี่ยวข้องสำหรับการสร้างแบบจำลอง
หากต้องการแทรกข้อมูลลับลงในรันไทม์ของ Connector คุณสามารถเพิ่มข้อมูลเหล่านี้ลงในไฟล์ connector-secrets.txt
ภายในที่เก็บในรูปแบบ NAME=VALUE
ต่อบรรทัด ข้อมูลลับจะพร้อมใช้งานในรันไทม์ของตัวเชื่อมต่อโดยมีรูปแบบ secrets.NAME
หากต้องการเพิ่มตัวเชื่อมต่อแบบกำหนดเอง ให้สร้างอิมเมจนักเทียบท่าใหม่รวมกลุ่มเข้าด้วยกันตามที่อธิบายไว้ที่นี่
หรือคุณสามารถต่อเชื่อม JAR ตัวเชื่อมต่อใหม่เป็นวอลุ่มลงในโฟลเดอร์ /opt/app
โดยเพิ่มสิ่งนี้ลงในไฟล์เขียนนักเทียบท่า โปรดทราบว่า Connector JAR จำเป็นต้องนำการขึ้นต่อกันที่จำเป็นทั้งหมดภายใน JAR ไปด้วย
โปรไฟล์ kibana
มีอยู่ในไฟล์เขียนนักเทียบท่าที่ให้มาเพื่อรองรับการตรวจสอบและการสำรวจข้อมูล Camunda Platform 8 ใน Elasticsearch สามารถเปิดใช้งานได้โดยเพิ่ม --profile kibana
ให้กับคำสั่งเขียนนักเทียบท่าของคุณ นอกเหนือจากส่วนประกอบอื่นๆ แล้ว โปรไฟล์นี้ยังหมุน Kibana อีกด้วย Kibana สามารถใช้เพื่อสำรวจบันทึกที่ Zeebe ส่งออกไปยัง Elasticsearch หรือเพื่อค้นหาข้อมูลใน Elasticsearch ที่ใช้โดยส่วนประกอบอื่นๆ (เช่น Operate)
คุณสามารถนำทางไปยังเว็บแอป Kibana และเริ่มสำรวจข้อมูลโดยไม่ต้องมีข้อมูลรับรองการเข้าสู่ระบบ:
หมายเหตุ คุณต้องกำหนดค่ารูปแบบดัชนีใน Kibana ก่อนจึงจะสามารถสำรวจข้อมูลได้
- ไปที่
Management > Stack Management > Kibana > Index Patterns
- สร้างรูปแบบดัชนีใหม่ ตัวอย่างเช่น
zeebe-record-*
ตรงกับบันทึกที่ส่งออก
- หากคุณไม่เห็นดัชนีใดๆ ตรวจสอบให้แน่ใจว่าได้ส่งออกข้อมูลบางส่วนก่อน (เช่น ปรับใช้กระบวนการ) ดัชนีของเรคคอร์ดจะถูกสร้างขึ้นเมื่อมีการส่งออกเรคคอร์ดแรกของประเภทนี้
- ไปที่
Analytics > Discover
และเลือกรูปแบบดัชนี
Desktop Modeler เป็นโอเพ่นซอร์สและใช้งานได้ฟรี
ดาวน์โหลด Desktop Modeler และเริ่มสร้างโมเดล BPMN, DMN และ Camunda Forms บนเครื่องของคุณ
เมื่อคุณพร้อมที่จะปรับใช้หรือดำเนินการกระบวนการแล้ว ให้ใช้การตั้งค่าเหล่านี้เพื่อปรับใช้กับอินสแตนซ์ Zeebe ในเครื่อง:
None
http://localhost:26500
หากคุณเปิดใช้งานการตรวจสอบสิทธิ์สำหรับคำขอ GRPC บน Zeebe คุณจะต้องให้ข้อมูลประจำตัวไคลเอ็นต์เมื่อปรับใช้และดำเนินการกระบวนการ:
OAuth
http://localhost:26500
zeebe
zecret
http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token
zeebe-api
Web Modeler Self-Managed มีให้สำหรับลูกค้าองค์กร Camunda เท่านั้น
อิมเมจ Docker สำหรับ Web Modeler มีอยู่ในรีจิสทรีส่วนตัว ลูกค้าองค์กรอาจมีข้อมูลรับรองการลงทะเบียนนี้อยู่แล้ว หรือสามารถขอเข้าถึงรีจิสทรีนี้ได้ผ่านทางผู้ติดต่อ CSM ที่ Camunda
หากต้องการรันแพลตฟอร์ม Camunda ด้วย Web Modeler Self-Managed โคลน repo นี้และออกคำสั่งต่อไปนี้:
$ docker login registry.camunda.cloud
Username: your_username
Password: ******
Login Succeeded
.env
และตั้งค่าพารามิเตอร์ SEARCH_DB=elasticserach
(ค่าเริ่มต้นนี้) $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml up -d
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
ให้รันคำสั่งนี้
.env
และตั้งค่าพารามิเตอร์ SEARCH_DB=opensearch
$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml --profile opensearch up -d
$ 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
http://zeebe:26500
หากคุณเปิดใช้งานการตรวจสอบสิทธิ์สำหรับคำขอ GRPC บน Zeebe คุณจะต้องให้ข้อมูลประจำตัวไคลเอ็นต์เมื่อปรับใช้และดำเนินการกระบวนการ:
OAuth
http://zeebe:26500
zeebe
zecret
http://keycloak:18080/auth/realms/camunda-platform/protocol/openid-connect/token
zeebe-api
การตั้งค่านี้รวม Mailpit ไว้เป็นเซิร์ฟเวอร์ทดสอบ SMTP โดยจะบันทึกอีเมลทั้งหมดที่ส่งโดย Web Modeler แต่ไม่ได้ส่งต่อไปยังผู้รับจริง
คุณสามารถเข้าถึงอีเมลใน Web UI ของ Mailpit ได้ที่ http://localhost:8075
เมื่อส่งปัญหาในพื้นที่เก็บข้อมูลนี้ โปรดตรวจสอบให้แน่ใจว่าปัญหาของคุณเกี่ยวข้องกับวิธีการปรับใช้นักเทียบท่าเขียนของแพลตฟอร์ม Camunda คำถามทั้งหมดเกี่ยวกับการทำงานของเว็บแอปพลิเคชันควรโพสต์ไว้ที่ฟอรัม Camunda แทน นี่เป็นวิธีที่ดีที่สุดสำหรับผู้ใช้ในการค้นหาคำตอบที่มีอยู่ซึ่งผู้อื่นพบแล้ว นอกจากนี้เรายังมีหมวดหมู่ในฟอรัมนั้นสำหรับหัวข้อที่เกี่ยวข้องกับการปรับใช้งานโดยเฉพาะ
เมื่อใช้ฮาร์ดแวร์ที่ใช้ arm64 เช่น M1 หรือ M2 Mac คอนเทนเนอร์ Keycloak อาจไม่เริ่มทำงานเนื่องจาก Bitnami จัดเตรียมเฉพาะอิมเมจที่ใช้ amd64 สำหรับเวอร์ชัน < 22 คุณสามารถสร้างและแท็กอิมเมจแบบ arm ในเครื่องโดยใช้คำสั่งต่อไปนี้ หลังจากสร้างและแท็กรูปภาพแล้ว คุณสามารถเริ่มต้นสภาพแวดล้อมตามที่อธิบายไว้ใน การใช้ docker-compose
$ DOCKER_BUILDKIT=0 docker build -t bitnami/keycloak:19.0.3 "https://github.com/camunda/camunda-platform.git#8.2.15:.keycloak/"
คุณสามารถควบคุมการเข้าถึงกระบวนการเฉพาะและตารางการตัดสินใจได้ใน Operate และ Tasklist ด้วยการอนุญาตตามทรัพยากร
คุณลักษณะนี้ถูกปิดใช้งานตามค่าเริ่มต้น และสามารถเปิดใช้งานได้โดยการตั้งค่า 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
เป็นผู้ให้บริการตรวจสอบสิทธิ์
ตรวจสอบให้แน่ใจว่าคุณตั้งค่าผู้เช่าในข้อมูลประจำตัวหลังจากที่คุณเริ่มแพลตฟอร์ม
กำลังมองหาข้อมูลเกี่ยวกับ Camunda Platform 7 อยู่ใช่ไหม? ตรวจสอบลิงค์ด้านล่าง: