此儲存庫包含 Camunda Platform 8 資源、官方發布工件(二進位檔案)以及用於將 Docker Compose 作為本機開發選項運行的支援設定檔的連結。
我們建議使用 SaaS 或 Helm/Kubernetes 進行開發。
有關自我管理的更多信息,包括其他開發安裝選項,請參閱我們的文件。
對於生產設置,我們建議使用 Helm 圖表,可以在 helm.camunda.io 上找到該圖表。
此儲存庫中的 docker-compose 檔案使用最新的 compose 規範,該規範是在 docker compose 版本 1.27.0+ 中引入的。請確保使用最新的 docker compose 版本。
需要 Docker 20.10.16+。
為了支援令牌刷新和註銷,您的本機電腦需要將
keycloak
解析為127.0.0.1
,並且需要將變數KEYCLOAK_HOST
設定為.env
檔案中的keycloak
。
若要在本機啟動完整的 Camunda Platform 8 自管環境,可以使用此儲存庫中的 docker-compose.yaml 檔案。
完整的環境包含以下元件:
預設不包含 Web Modeler。請按照以下說明進行安裝。
克隆此存儲庫並發出以下命令來啟動您的環境:
docker compose up -d
等待幾分鐘,讓環境啟動並穩定下來。監控日誌,尤其是Keycloak容器日誌,以確保元件已啟動。
現在您可以導航到不同的網路應用程式並使用使用者demo
和密碼demo
登入:
Keycloak用於管理用戶。這裡可以使用使用者admin
和密碼admin
登入
工作流程引擎 Zeebe 可在localhost:26500
使用 gRPC 來使用。
若要拆除整個環境,請執行以下命令:
docker compose down -v
Zeebe、Operate、Tasklist 以及 Optimize 需要與 Identity 分開的網絡,正如您將在 docker-compose 檔案中看到的那樣。
如果不需要 Optimize、Identity 和 Keycloak,您可以使用 docker-compose-core.yaml 代替,它不包含以下元件:
docker compose -f docker-compose-core.yaml up -d
或者
如果要使用 OpenSearch 而不是 ElasticSearch,請在.env
檔中設定參數SEARCH_DB=opensearch
docker compose -f docker-compose-core.yaml --profile opensearch up -d
除了使用 docker compose 設定本地環境之外,還可以使用 Camunda Desktop Modeler 對 BPMN 圖進行本地建模以供執行,並將其直接部署到本地環境。作為企業客戶,您可以使用 Web Modeler。
歡迎反饋和更新!
預設情況下,Zeebe GRPC API 可公開訪問,無需任何客戶端憑證即可進行開發。
但是,您可以透過將環境變數ZEEBE_AUTHENTICATION_MODE
設為identity
來啟用 Zeebe 中的 GRPC 請求身份驗證,例如透過執行:
ZEEBE_AUTHENTICATION_MODE=identity docker compose up -d
或透過修改.env
檔中的預設值。
兩個 docker-compose 檔案都包含我們開箱即用的連接器。
有關如何提供相關連接器範本以進行建模的詳細信息,請參閱連接器安裝指南。
若要將機密注入連接器執行時,可以將其以每行NAME=VALUE
格式新增至儲存庫內的connector-secrets.txt
檔案中。然後,這些機密將在連接器運行時中以secrets.NAME
格式提供。
若要新增自訂連接器,請建立一個新的 docker 映像,將它們捆綁在一起,如此處所述。
或者,您可以透過將新的連接器 JAR 新增至 docker-compose 文件,將新的連接器 JAR 作為磁碟區安裝到/opt/app
資料夾中。請記住,連接器 JAR 需要將所有必需的依賴項帶入 JAR 內。
提供的 docker compose 檔案中提供了kibana
配置文件,以支援在 Elasticsearch 中檢查和探索 Camunda Platform 8 資料。可以透過將--profile kibana
新增至 docker compose 指令來啟用它。除了其他元件之外,此設定檔還啟動 Kibana。 Kibana 可用於探索 Zeebe 匯出至 Elasticsearch 中的記錄,或發現 Elasticsearch 中其他元件(例如 Operate)所使用的資料。
您可以導航到 Kibana Web 應用程式並開始探索數據,而無需登入憑證:
注意您需要先在 Kibana 中配置索引模式,然後才能探索資料。
- 前往
Management > Stack Management > Kibana > Index Patterns
。- 建立新的索引模式。例如,
zeebe-record-*
匹配導出的記錄。
- 如果您沒有看到任何索引,請確保首先匯出一些資料(例如部署進程)。當匯出該類型的第一筆記錄時,將建立記錄的索引。
- 前往
Analytics > Discover
並選擇索引模式。
Desktop Modeler 是開源的,可以免費使用。
下載 Desktop Modeler 並開始在本機上對 BPMN、DMN 和 Camunda Forms 進行建模。
準備好部署或執行流程後,請使用這些設定部署到本機 Zeebe 實例:
None
http://localhost:26500
如果您在 Zeebe 上啟用了 GRPC 請求身份驗證,則需要在部署和執行流程時提供用戶端憑證:
OAuth
http://localhost:26500
zeebe
zecret
http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token
zeebe-api
Web Modeler 自我管理僅適用於 Camunda 企業客戶。
Web Modeler 的 Docker 映像可在私人註冊表中取得。企業客戶要么已經擁有此註冊表的憑證,要么可以透過 Camunda 的 CSM 聯絡人要求存取此註冊表。
若要使用 Web Modeler 自管理執行 Camunda 平台,請複製此儲存庫並發出以下命令:
$ 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
若要使用OpenSearch
運行 Camunda 平台,請執行下列命令
.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
如果您在 Zeebe 上啟用了 GRPC 請求身份驗證,則需要在部署和執行流程時提供用戶端憑證:
OAuth
http://zeebe:26500
zeebe
zecret
http://keycloak:18080/auth/realms/camunda-platform/protocol/openid-connect/token
zeebe-api
此設定包括 Mailpit 作為測試 SMTP 伺服器。它會捕獲 Web Modeler 發送的所有電子郵件,但不會將它們轉發給實際收件者。
您可以在 Mailpit 的 Web UI 中存取電子郵件:http://localhost:8075。
在此儲存庫上提交問題時,請確保您的問題與Camunda平台的docker compose部署方法有關。有關網頁應用程式功能的所有問題都應發佈在 Camunda 論壇上。這是用戶查詢其他人已經遇到過的現有答案的最佳方式。我們在該論壇上還有一個專門針對部署相關主題的類別。
當使用基於arm64的硬體(如M1或M2 Mac)時,Keycloak容器可能無法啟動,因為Bitnami僅為版本<22提供基於amd64的映像。建置並標記映像後,您可以啟動環境,如使用 docker-compose 中所述。
$ DOCKER_BUILDKIT=0 docker build -t bitnami/keycloak:19.0.3 "https://github.com/camunda/camunda-platform.git#8.2.15:.keycloak/"
您可以使用基於資源的授權來控制對操作和任務清單中特定流程和決策表的存取。
預設情況下停用此功能,可以透過.env
檔案或透過命令列將RESOURCE_AUTHORIZATIONS_ENABLED
設為true
來啟用:
RESOURCE_AUTHORIZATIONS_ENABLED=true docker compose up -d
您可以使用多租戶來實現基於租戶的隔離。
預設情況下停用此功能,可以透過.env
檔案或透過命令列將MULTI_TENANCY_ENABLED
設為true
來啟用:
ZEEBE_AUTHENICATION_MODE=identity MULTI_TENANCY_ENABLED=true docker compose up -d
如上所示,該功能還要求您使用identity
作為身分驗證提供者。
確保在啟動平台後以身分設定租戶。
正在尋找有關 Camunda Platform 7 的資訊?查看以下連結: