# camunda-cloud-get-started

**Repository Path**: rgqancy/camunda-cloud-get-started

## Basic Information

- **Project Name**: camunda-cloud-get-started
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-02-13
- **Last Updated**: 2022-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Camunda Platform 8 - Get Started

This repository contains a short guide to get started with [Camunda
Platform 8](https://camunda.com/products/cloud/). It contains instructions on how to
model your first process, create a user task form, and automate a service task.
During the guide you will use Console, Modeler, Zeebe, Operate, and Tasklist.

# Table of contents

- [Camunda Platform 8 - Get Started](#camunda-platform-8---get-started)
- [Table of contents](#table-of-contents)
- [Repository structure](#repository-structure)
- [Set up the environment](#set-up-the-environment)
- [Model the process](#model-the-process)
  - [Model the user task form](#model-the-user-task-form)
  - [Configure user task to use form](#configure-user-task-to-use-form)
  - [Configure service task](#configure-service-task)
- [Deploy process](#deploy-process)
  - [Deploy using Camunda Modeler](#deploy-using-camunda-modeler)
  - [Deploy using Web Modeler](#deploy-using-web-modeler)
  - [Deploy using zbctl](#deploy-using-zbctl)
  - [Deploy using code](#deploy-using-code)
- [Start process instance](#start-process-instance)
  - [Start instance using Camunda Modeler](#start-instance-using-camunda-modeler)
  - [Start instance using Web Modeler](#start-instance-using-web-modeler)
  - [Start instance using zbctl](#start-instance-using-zbctl)
  - [Start instance using code](#start-instance-using-code)
- [Complete the user task](#complete-the-user-task)
- [Complete the service task](#complete-the-service-task)
- [Further references](#further-references)
  - [Developer setup of Camunda 8](#developer-setup)

# Repository structure

The repository contains the following folders:

- [_csharp_](csharp/) - C# example for deploy, create instance, and a job worker
- [_go_](go/) - Go example for deploy, create instance, and job worker
- [_images_](images/) - Contains screenshots and images for the guide
- [_java_](java/) - Plain Java example for deploy, create instance, and a job worker
- [_nodejs_](nodejs/) - Node.js example for deploy, create instance, and a job worker
- [_process_](process/) - Contains the BPMN process and the user task form
- [_spring_](spring/) - Spring Boot example for deploy, create instance, and a job worker

# Set up the environment

To follow this guide, we need a running Camunda Platform 8 cluster. For this purpose,
we use the Camunda Platform 8 SaaS offering at https://camunda.io.

If you prefer a local setup, visit the [end of this guide](#developer-setup).

After the sign-up and log-in at https://camunda.io, we need to [create a new cluster](https://docs.camunda.io/docs/guides/getting-started/create-your-cluster/) with the latest stable version of Zeebe and the name **Test Cluster**.

![Camunda Platform Cluster](images/cluster.png)

After the cluster is available, we need to create a pair of [Client
Credentials](https://docs.camunda.io/docs/components/console/manage-clusters/manage-api-clients/).
To do this, take the following steps:

1. Navigate to the **Clusters** detail page.
2. Switch to the **API** tab.
3. Create a new client credential and either note down the **client id** and **client secret**, or
download the credentials file.

# Model the process

In this example, we'll model a simple process to send an email message.

Camunda Platform 8 allows you to use the
[BPMN](https://docs.camunda.io/docs/components/modeler/bpmn/bpmn-primer/)
standard to model your business processes. The process consists of two
tasks: a user task to allow a human to enter the message content, and a service
task to automatically send the email message.

![Process](images/send-email.png)

**Note**: To keep the scope of this guide easy to follow, we only build the
scaffolding for this process automation example and will not actually send
an email. This can be a task for you to extend the example and connect to a mail
provider.

To create the process, we use the desktop [Camunda Modeler] or [Web Modeler].

Find the finished process at [process/send-email.bpmn](process/send-email.bpmn).

## Model the user task form

To help users complete the user task **Enter Message**, we create a user
task form using the modeler.

Use [Camunda Modeler] or [Web Modeler] to create the form.

Find the finished form at [process/enter-email-message.form](process/enter-email-message.form).

## Configure user task to use form

Now that we've created a form, we must configure the user task to use the form.
To do this, we copy the JSON content of the form into the **Form Json
Configuration** field under the **Forms** tab of the modeler.

![Configure user task form](images/user-task-form.png)

## Configure service task

The last step is defining the job type of the service task. The job type is
needed for a job worker to subscribe to the jobs of the task and
complete them. The [Camunda Platform 8 Documentation](https://docs.camunda.io) contains more information about
[job workers](https://docs.camunda.io/docs/components/concepts/job-workers/).

![Configure service task](images/configure-service-task.png)

# Deploy process

Deploy the process using [Camunda
Modeler](#deploy-using-camunda-modeler), [Web
Modeler](#deploy-using-web-modeler), [zbctl](#deploy-using-zbctl), or your [own
code](#deploy-using-code).

## Deploy using Camunda Modeler

To deploy the [process](process/send-email.bpmn) using Camunda Modeler,
follow [these steps](https://docs.camunda.io/docs/components/modeler/desktop-modeler/connect-to-camunda-cloud/).

## Deploy using Web Modeler

To deploy the [process](process/send-email.bpmn) using Web Modeler,
follow [these steps](https://docs.camunda.io/docs/components/modeler/web-modeler/save-and-deploy/).

## Deploy using zbctl

To the deploy the [process](process/send-email.bpmn) using `zbctl`, use the
following command:

```bash
zbctl deploy resource send-email.bpmn \
  --address 365eed98-16c1-4096-bb57-eb8828ed131e.zeebe.camunda.io:443 \
  --clientId 'GZVO3ALYy~qCcD3MYq~sf0GIszNzLE_z' \
  --clientSecret '.RPbZc6q0d6uzRbB4LW.B8lCpsxbBEpmBX0AHQGzINf3.KK9RkzZW1aDaZ-7WYNJ'
```

For **Camunda Platform 8**, we need the cluster id and the [client
credentials](#setup-the-environment).

## Deploy using code

Writing your own code allows you to deploy the process (for example, on application
startup) to ensure the latest version is deployed. To see examples of
this, visit the programming language [specific folders](#repository-structure).

# Start process instance

Start a new instance of the process using [Camunda
Modeler](#start-instance-using-camunda-modeler), [Web
Modeler](#start-instance-using-web-modeler), [zbctl](#start-instance-using-zbctl), or your [own
code](#start-instance-using-code).

## Start instance using Camunda Modeler

After the process is deployed, follow [these steps](click **Start Current Diagram**) to start an instance of the process with Camunda Modeler.

## Start instance using Web Modeler

To start an instance of the process using Web Modeler, follow [these steps](https://docs.camunda.io/docs/components/modeler/web-modeler/start-instance/).

## Start instance using zbctl

To start a process instance of the BPMN process id `send-email` using `zbctl`,
use the following command:

```bash
zbctl create instance send-email \
  --address 365eed98-16c1-4096-bb57-eb8828ed131e.zeebe.camunda.io:443 \
  --clientId 'GZVO3ALYy~qCcD3MYq~sf0GIszNzLE_z' \
  --clientSecret '.RPbZc6q0d6uzRbB4LW.B8lCpsxbBEpmBX0AHQGzINf3.KK9RkzZW1aDaZ-7WYNJ'
```

For **Camunda Platform 8**, we need the cluster id and the [client
credentials](#setup-the-environment).

## Start instance using code

Writing your own code allows you to start an instance of the process on an
external trigger, like an incoming message or a user request. To see examples of this,
visit the programming language [specific folders](#repository-structure).

# Complete the user task

The first task of the process is the [user
task](https://docs.camunda.io/docs/components/modeler/bpmn/user-tasks/)
**Enter Message**.

![Process](images/send-email.png)

To complete the user task, we use Tasklist. To do this, visit the cluster's
details page in Camunda Platform 8 and launch Tasklist.

Take the following steps:

1. In Tasklist, select the **Enter Message** task from the list of tasks.
2. Click the **Claim** button to assign the task to you to work on it.
3. Fill out the **E-Mail Content** field with the message you want to send.
4. Select **Complete Task**.

![Tasklist](images/tasklist.png)

# Complete the service task

The second task of the process is the [service
task](https://docs.camunda.io/docs/components/modeler/bpmn/service-tasks/)
**Send Email**.

![Process](images/send-email.png)

To complete the service task, we need to implement the business logic. Therefore, we must create a [job
worker](https://docs.camunda.io/docs/components/concepts/job-workers/) for
the task type we defined in the diagram. The job worker will subscribe to all
jobs with the same task type.

To define the task type, we select the service task in the diagram and use
the properties panel to set the task type to `email`.

To implement the logic, we implement a job worker. Check out the
programming language [specific folders](#repository-structure) to find the job
worker implementations.

# Further references

Find more information in the [Camunda Platform 8 Documentation](https://docs.camunda.io), or join the [Camunda Platform 8
Forum](https://forum.camunda.io) and [Camunda Platform 8
Slack](https://camunda-cloud.slack.com) community.

## Developer setup

To run the getting started guide against a locally-hosted instance, follow the [Camunda 8 Platform Deployment Guide](https://docs.camunda.io/docs/self-managed/platform-deployment/).