Projects

In Camunda Hub, a project is a type of folder that contains a set of related files you can work on and deploy as a single bundle.

For example, a project for a consumer loan application might consist of a BPMN diagram as an entry point and a number of additional supporting files, such as DMN diagrams and forms.

Project development lifecycle

In Camunda Hub, you can quickly develop project releases through the stages of a typical development lifecycle.

• Project development lifecycle

Create a project

Get started by creating a new project.

• When you create a project, you must select a cluster to use for deployment during development.
• You can add files to the project as required.

Validate and deploy your project

Validate your project in development before deploying it to testing, staging, or production.

• Validate and deploy your project

Project versioning

Use versioning to save a single snapshot of all the project files in one action.

• Project versioning

Known limitations

You should be aware of the following limitations when working with projects.

General limitations

• Self-Managed does not support defining cluster stages, identifying clusters by tags, or cluster promotion.

Deployment limitations

• Projects can only be deployed to a Zeebe cluster in version 8.4.0 or higher.
• The overall size of the deployment bundle is limited due to a maximum record size of 4 MB in Zeebe.
  • The limit is effectively between 2 and 3 MB, as Zeebe writes more data to the log stream than just the raw deployment.
  • If you exceed the limit, you are shown an error message:
    Command 'CREATE' rejected with code 'EXCEEDED_BATCH_RECORD_SIZE'.