platform camunda
8.6+gen4
Repositori ini berisi tautan ke sumber daya Camunda Platform 8, artefak rilis resmi (biner), dan file konfigurasi pendukung untuk menjalankan Docker Compose sebagai opsi pengembangan lokal.
Kami merekomendasikan penggunaan SaaS atau Helm/Kubernetes untuk pengembangan.
Untuk informasi selengkapnya tentang Dikelola Sendiri, termasuk opsi instalasi pengembangan tambahan, lihat dokumentasi kami.
Untuk pengaturan produksi kami merekomendasikan penggunaan grafik Helm yang dapat ditemukan di helm.camunda.io.
File docker-compose dalam repositori ini menggunakan spesifikasi penulisan terbaru, yang diperkenalkan dengan docker composer versi 1.27.0+. Harap pastikan untuk menggunakan versi penulisan buruh pelabuhan yang terbaru.
Diperlukan Docker 20.10.16+.
Untuk mendukung penyegaran token dan keluar, mesin lokal Anda perlu menyelesaikan
keycloakke127.0.0.1dan variabelKEYCLOAK_HOSTperlu disetel kekeycloakdi file.env.
Untuk menjalankan lingkungan Self-Managed Camunda Platform 8 yang lengkap secara lokal, file docker-compose.yaml di repositori ini dapat digunakan.
Lingkungan lengkap berisi komponen berikut:
Pemodel Web tidak disertakan secara default. Silakan ikuti petunjuk di bawah ini untuk menginstalnya.
Kloning repo ini dan jalankan perintah berikut untuk memulai lingkungan Anda:
docker compose up -d
Tunggu beberapa menit hingga lingkungan mulai aktif dan tenang. Pantau log, terutama log kontainer Keycloak, untuk memastikan komponen telah dimulai.
Sekarang Anda dapat menavigasi ke berbagai aplikasi web dan masuk dengan demo pengguna dan demo kata sandi :
Keycloak digunakan untuk mengelola pengguna. Di sini Anda dapat login dengan user admin dan password admin
Mesin alur kerja Zeebe tersedia menggunakan gRPC di localhost:26500 .
Untuk menghancurkan seluruh lingkungan, jalankan perintah berikut:
docker compose down -v
Zeebe, Operate, Tasklist, dan Optimize memerlukan jaringan terpisah dari Identity seperti yang akan Anda lihat di file docker-compose.
Jika Optimize, Identity, dan Keycloak tidak diperlukan, Anda dapat menggunakan docker-compose-core.yaml yang tidak menyertakan komponen berikut:
docker compose -f docker-compose-core.yaml up -d
ATAU
Tetapkan parameter SEARCH_DB=opensearch di file .env jika Anda ingin menggunakan OpenSearch alih-alih ElasticSearch
docker compose -f docker-compose-core.yaml --profile opensearch up -d
Selain pengaturan lingkungan lokal dengan penulisan buruh pelabuhan, gunakan Camunda Desktop Modeler untuk memodelkan diagram BPMN secara lokal untuk dieksekusi dan langsung menyebarkannya ke lingkungan lokal Anda. Sebagai pelanggan perusahaan, Anda dapat menggunakan Web Modeler.
Umpan balik dan pembaruan dipersilakan!
Secara default, Zeebe GRPC API dapat diakses publik tanpa memerlukan kredensial klien apa pun untuk tujuan pengembangan.
Namun Anda dapat mengaktifkan autentikasi permintaan GRPC di Zeebe dengan mengatur variabel lingkungan ZEEBE_AUTHENTICATION_MODE identity , misalnya dengan menjalankan:
ZEEBE_AUTHENTICATION_MODE=identity docker compose up -d
atau dengan mengubah nilai default di file .env .
Kedua file pembuat buruh pelabuhan berisi Konektor bawaan kami.
Lihat panduan pemasangan Konektor untuk detail tentang cara menyediakan templat Konektor terkait untuk pemodelan.
Untuk memasukkan rahasia ke dalam runtime Connector, rahasia tersebut dapat ditambahkan ke file connector-secrets.txt di dalam repositori dalam format NAME=VALUE per baris. Rahasia tersebut kemudian akan tersedia di runtime Connector dengan format secrets.NAME .
Untuk menambahkan Konektor khusus, buatlah gambar buruh pelabuhan baru yang menggabungkannya seperti yang dijelaskan di sini.
Alternatifnya, Anda dapat memasang Connector JAR baru sebagai volume ke dalam folder /opt/app dengan menambahkan ini ke file docker-compose. Ingatlah bahwa Connector JAR harus membawa semua dependensi yang diperlukan di dalam JAR.
Profil kibana tersedia di file penulisan buruh pelabuhan yang disediakan untuk mendukung inspeksi dan eksplorasi data Camunda Platform 8 di Elasticsearch. Ini dapat diaktifkan dengan menambahkan --profile kibana ke perintah penulisan buruh pelabuhan Anda. Selain komponen lainnya, profil ini memutar Kibana. Kibana dapat digunakan untuk menjelajahi catatan yang diekspor oleh Zeebe ke Elasticsearch, atau untuk menemukan data di Elasticsearch yang digunakan oleh komponen lain (misalnya Operate).
Anda dapat menavigasi ke aplikasi web Kibana dan mulai menjelajahi data tanpa kredensial login:
Catatan Anda perlu mengonfigurasi pola indeks di Kibana sebelum Anda dapat menjelajahi data.
- Buka
Management > Stack Management > Kibana > Index Patterns.- Buat pola indeks baru. Misalnya,
zeebe-record-*cocok dengan catatan yang diekspor.
- Jika Anda tidak melihat indeks apa pun, pastikan untuk mengekspor beberapa data terlebih dahulu (misalnya menerapkan suatu proses). Indeks rekaman dibuat saat rekaman pertama jenis ini diekspor.
- Buka
Analytics > Discoverdan pilih pola indeks.
Desktop Modeler bersifat open source dan gratis untuk digunakan.
Unduh Desktop Modeler dan mulai memodelkan Formulir BPMN, DMN, dan Camunda di mesin lokal Anda.
Setelah Anda siap menerapkan atau menjalankan proses, gunakan pengaturan berikut untuk menerapkan ke instans Zeebe lokal:
Nonehttp://localhost:26500 Jika Anda mengaktifkan autentikasi untuk permintaan GRPC di Zeebe, Anda perlu memberikan kredensial klien saat menerapkan dan menjalankan proses:
OAuthhttp://localhost:26500zeebezecrethttp://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/tokenzeebe-api Web Modeler Self-Managed hanya tersedia untuk pelanggan perusahaan Camunda.
Gambar Docker untuk Web Modeler tersedia di registri pribadi. Pelanggan perusahaan sudah memiliki kredensial ke registri ini, atau mereka dapat meminta akses ke registri ini melalui kontak CSM mereka di Camunda.
Untuk menjalankan Platform Camunda dengan Web Modeler Self-Managed, kloning repo ini dan jalankan perintah berikut:
$ docker login registry.camunda.cloud
Username: your_username
Password: ******
Login Succeeded
.env dan atur parameter SEARCH_DB=elasticserach (nilai default ini) $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml up -d
ElasticSearch jalankan perintah berikut $ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down -v
Jika Anda ingin menghapus semuanya (termasuk data apa pun yang Anda buat). Alternatifnya, jika Anda ingin data tetap berjalan:
$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down
Untuk menjalankan Platform Camunda dengan OpenSearch jalankan perintah ini
.env dan atur parameter 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
Anda dapat mengakses Web Modeler Self-Managed dan masuk dengan demo pengguna dan demo kata sandi di http://localhost:8070.
Setelah Anda siap menerapkan atau menjalankan proses, gunakan pengaturan berikut untuk menerapkan ke instans Zeebe lokal:
Nonehttp://zeebe:26500 Jika Anda mengaktifkan autentikasi untuk permintaan GRPC di Zeebe, Anda perlu memberikan kredensial klien saat menerapkan dan menjalankan proses:
OAuthhttp://zeebe:26500zeebezecrethttp://keycloak:18080/auth/realms/camunda-platform/protocol/openid-connect/tokenzeebe-apiPenyiapannya menyertakan Mailpit sebagai server SMTP pengujian. Ini menangkap semua email yang dikirim oleh Web Modeler, tetapi tidak meneruskannya ke penerima sebenarnya.
Anda dapat mengakses email di UI Web Mailpit di http://localhost:8075.
Saat mengirimkan masalah pada repositori ini, pastikan masalah Anda terkait dengan metode penerapan penulisan buruh pelabuhan pada Platform Camunda. Semua pertanyaan mengenai fungsionalitas aplikasi web sebaiknya diposting di Forum Camunda. Ini adalah cara terbaik bagi pengguna untuk menanyakan jawaban yang sudah ada yang telah ditemukan orang lain. Kami juga memiliki kategori di forum tersebut khusus untuk Topik Terkait Penerapan.
Saat menggunakan perangkat keras berbasis arm64 seperti Mac M1 atau M2, wadah Keycloak mungkin tidak dimulai karena Bitnami hanya menyediakan gambar berbasis amd64 untuk versi <22. Anda dapat membuat dan menandai gambar berbasis arm secara lokal menggunakan perintah berikut. Setelah membuat dan memberi tag pada gambar, Anda dapat memulai lingkungan seperti yang dijelaskan dalam Menggunakan komposisi buruh pelabuhan.
$ DOCKER_BUILDKIT=0 docker build -t bitnami/keycloak:19.0.3 "https://github.com/camunda/camunda-platform.git#8.2.15:.keycloak/"
Anda dapat mengontrol akses ke proses tertentu dan tabel keputusan di Operate dan Tasklist dengan otorisasi berbasis sumber daya.
Fitur ini dinonaktifkan secara default dan dapat diaktifkan dengan menyetel RESOURCE_AUTHORIZATIONS_ENABLED ke true , baik melalui file .env atau melalui baris perintah:
RESOURCE_AUTHORIZATIONS_ENABLED=true docker compose up -d
Anda dapat menggunakan multi-tenancy untuk mencapai isolasi berbasis penyewa.
Fitur ini dinonaktifkan secara default dan dapat diaktifkan dengan menyetel MULTI_TENANCY_ENABLED ke true , baik melalui file .env atau melalui baris perintah:
ZEEBE_AUTHENICATION_MODE=identity MULTI_TENANCY_ENABLED=true docker compose up -d
Seperti yang terlihat di atas, fitur ini juga mengharuskan Anda menggunakan identity sebagai penyedia otentikasi.
Pastikan Anda menyiapkan penyewa dalam identitas setelah Anda memulai platform.
Mencari informasi tentang Camunda Platform 7? Lihat tautan di bawah ini:
