이 리포지토리에는 Camunda Platform 8 리소스, 공식 릴리스 아티팩트(바이너리) 및 Docker Compose를 로컬 개발 옵션으로 실행하기 위한 지원 구성 파일에 대한 링크가 포함되어 있습니다.
개발에는 SaaS 또는 Helm/Kubernetes를 사용하는 것이 좋습니다.
추가 개발 설치 옵션을 포함하여 자체 관리형에 대한 자세한 내용은 설명서를 참조하세요.
프로덕션 설정의 경우 helm.camunda.io에서 찾을 수 있는 Helm 차트를 사용하는 것이 좋습니다.
이 저장소의 docker-compose 파일은 docker compose 버전 1.27.0+에서 도입된 최신 compose 사양을 사용합니다. 최신 Docker Compose 버전을 사용하시기 바랍니다.
도커 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
docker-compose 파일에서 볼 수 있듯이 Zeebe, Operate, Tasklist 및 Optimize에는 Identity와 별도의 네트워크가 필요합니다.
Optimize, Identity 및 Keycloak이 필요하지 않은 경우 대신 다음 구성 요소를 포함하지 않는 docker-compose-core.yaml을 사용할 수 있습니다.
docker compose -f docker-compose-core.yaml up -d
또는
ElasticSearch 대신 OpenSearch를 사용하려면 .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 파일에는 기본 제공 커넥터가 포함되어 있습니다.
모델링을 위한 관련 커넥터 템플릿을 제공하는 방법에 대한 자세한 내용은 커넥터 설치 가이드를 참조하세요.
커넥터 런타임에 비밀을 삽입하려면 저장소 내의 connector-secrets.txt
파일에 줄당 NAME=VALUE
형식으로 추가하면 됩니다. 그러면 비밀은 secrets.NAME
형식으로 커넥터 런타임에서 사용할 수 있습니다.
사용자 정의 커넥터를 추가하려면 여기에 설명된 대로 이를 번들로 묶는 새 Docker 이미지를 생성하세요.
또는 docker-compose 파일에 추가하여 새 커넥터 JAR을 /opt/app
폴더에 볼륨으로 마운트할 수 있습니다. 커넥터 JAR은 JAR 내부에 필요한 모든 종속성을 가져와야 한다는 점을 명심하세요.
kibana
프로필은 Elasticsearch에서 Camunda Platform 8 데이터의 검사 및 탐색을 지원하기 위해 제공된 docker compose 파일에서 사용할 수 있습니다. docker compose 명령에 --profile kibana
추가하여 활성화할 수 있습니다. 다른 구성 요소 외에도 이 프로필은 Kibana를 가동합니다. Kibana는 Zeebe가 Elasticsearch로 내보낸 레코드를 탐색하거나 다른 구성 요소(예: Operate)에서 사용하는 Elasticsearch의 데이터를 검색하는 데 사용할 수 있습니다.
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
Zeebe에서 GRPC 요청에 대한 인증을 활성화한 경우 프로세스를 배포하고 실행할 때 클라이언트 자격 증명을 제공해야 합니다.
OAuth
http://localhost:26500
zeebe
zecret
http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token
zeebe-api
Web Modeler Self-Managed는 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 Platform을 실행하려면 다음 명령을 실행하십시오.
.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에 액세스하고 http://localhost:8070에서 사용자 demo
및 비밀번호 demo
사용하여 로그인할 수 있습니다.
프로세스를 배포하거나 실행할 준비가 되면 다음 설정을 사용하여 로컬 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
설정에는 테스트 SMTP 서버로 Mailpit이 포함되어 있습니다. Web Modeler가 보낸 모든 이메일을 캡처하지만 실제 수신자에게 전달하지는 않습니다.
http://localhost:8075에서 Mailpit의 웹 UI를 통해 이메일에 액세스할 수 있습니다.
이 저장소에 문제를 제출할 때 문제가 Camunda 플랫폼의 docker compose 배포 방법과 관련되어 있는지 확인하십시오. 대신 웹 애플리케이션의 기능에 관한 모든 질문은 Camunda 포럼에 게시되어야 합니다. 이는 다른 사용자가 이미 접한 기존 답변을 사용자가 쿼리하는 가장 좋은 방법입니다. 또한 해당 포럼에는 특히 배포 관련 주제에 대한 카테고리가 있습니다.
M1 또는 M2 Mac과 같은 arm64 기반 하드웨어를 사용하는 경우 Bitnami는 버전 < 22에 대한 amd64 기반 이미지만 제공하므로 Keycloak 컨테이너가 시작되지 않을 수 있습니다. 다음 명령을 사용하여 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의 특정 프로세스 및 의사결정 테이블에 대한 액세스를 제어할 수 있습니다.
이 기능은 기본적으로 비활성화되어 있으며 .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
인증 공급자로 사용해야 합니다.
플랫폼을 시작한 후 ID로 테넌트를 설정했는지 확인하세요.
Camunda Platform 7에 대한 정보를 찾고 계십니까? 아래 링크를 확인하세요.