Skip to content

Commit

Permalink
set all links to zeebe cli
Browse files Browse the repository at this point in the history
  • Loading branch information
megglos committed Sep 24, 2024
1 parent 344684c commit 95c05ef
Show file tree
Hide file tree
Showing 9 changed files with 19 additions and 48 deletions.
12 changes: 3 additions & 9 deletions docs/components/modeler/desktop-modeler/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,15 +54,11 @@ To produce logging output, you can also run Desktop Modeler from the command lin

You try to connect (i.e., to deploy) to a remote Zeebe instance, and Desktop Modeler tells you it "cannot find a running Zeebe."

<!-- NEEDS ATTENTION-->

To resolve this issue, check if you can connect to Zeebe through another client, i.e., [`zbctl`](#). If that works, [further debug your Zeebe connection](#debug-zeebe-connection-issues). If that does not work, resolve the [general connection issue](#resolve-a-general-zeebe-connection-issue) first.
To resolve this issue, check if you can connect to Zeebe through another client, i.e., [`zbctl`](/apis-tools/community-clients/cli-client/index.md). If that works, [further debug your Zeebe connection](#debug-zeebe-connection-issues). If that does not work, resolve the [general connection issue](#resolve-a-general-zeebe-connection-issue) first.

## Resolve a general Zeebe connection issue

<!-- NEEDS ATTENTION-->

You try to connect to Zeebe from both Desktop Modeler _and_ [`zbctl`](#), and neither of them works. General connection failures can have a couple of reasons:
You try to connect to Zeebe from both Desktop Modeler _and_ [`zbctl`](/apis-tools/community-clients/cli-client/index.md), and neither of them works. General connection failures can have a couple of reasons:

### The (remote) Zeebe instance is not reachable

Expand All @@ -76,9 +72,7 @@ Secure connections to Zeebe require [HTTP/2 over TLS with protocol negotiation v

## Debug Zeebe connection issues

<!-- NEEDS ATTENTION-->

You can connect to Zeebe via [`zbctl`](#) or another API client. However, connecting through Desktop Modeler fails.
You can connect to Zeebe via [`zbctl`](/apis-tools/community-clients/cli-client/index.md) or another API client. However, connecting through Desktop Modeler fails.

### Secure connection to Zeebe fails

Expand Down
12 changes: 3 additions & 9 deletions docs/guides/devops-lifecycle/integrate-web-modeler-in-ci-cd.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,9 +180,7 @@ In the build stage, deploy your process or project to a cluster or embedded engi
For GitLab users, consider using [GitLab Review Apps](https://docs.gitlab.com/ee/ci/review_apps/) to provide preview environments.
:::

<!-- NEEDS ATTENTION-->

Deploy resources using the [`zbctl` CLI](#) in this pipeline step, compatible with both SaaS and Self-Managed clusters. Alternately, utilize the [Java](/apis-tools/java-client/index.md) client library or any [community-built alternatives](/apis-tools/community-clients/index.md).
Deploy resources using the [`zbctl` CLI](/apis-tools/community-clients/cli-client/index.md) in this pipeline step, compatible with both SaaS and Self-Managed clusters. Alternately, utilize the [Java](/apis-tools/java-client/index.md) client library or any [community-built alternatives](/apis-tools/community-clients/index.md).

:::info Feature branches and Web Modeler installations
To maintain a single source of truth, avoid multiple Web Modeler instances for different feature branches. Instead, maintain a single Web Modeler installation for all environments, utilizing milestones to signify versioning and pipeline stages. Feature branches can be managed by cloning and merging files or projects, ensuring synchronization using VCS.
Expand Down Expand Up @@ -210,9 +208,7 @@ To retrieve the actual file `content`, iterate over the response and fetch it vi

If you are running Connectors in your process or application, you need to deploy the runtimes as well. Parse the process XML for `zeebe:taskDefinition` bindings to identify the necessary runtimes (in addition to job workers). To learn how to deploy Connector runtimes, read more [here](/self-managed/connectors-deployment/install-and-start.md) for Self-Managed, or [here](/components/connectors/custom-built-connectors/connector-sdk.md#runtime-environments) for SaaS.

<!-- NEEDS ATTENTION-->

Deploy resources in this pipeline step using the [`zbctl` CLI](#), compatible with both SaaS and Self-Managed clusters. Alternatively, utilize the Java or Go client library or any community-built alternatives.
Deploy resources in this pipeline step using the [`zbctl` CLI](/apis-tools/community-clients/cli-client/index.md), compatible with both SaaS and Self-Managed clusters. Alternatively, utilize the Java or Go client library or any community-built alternatives.

#### Add environment variables via secrets

Expand Down Expand Up @@ -263,9 +259,7 @@ In case you use an embedded Zeebe engine, or want to provide a lightweight, focu

### Publish stage

<!-- NEEDS ATTENTION -->

Push approved changes to staging or production by deploying them to the respective clusters. You can use the [`zbctl` CLI](#) to deploy via your pipeline, which works both for a SaaS or Self-Managed cluster. Deployments work slightly different on SaaS and Self-Managed, since there are differences in the cluster connection. Read more about deployments [here](/apis-tools/working-with-apis-tools.md#deploy-processes-start-process-instances-and-more-using-zeebe-client-libraries).
Push approved changes to staging or production by deploying them to the respective clusters. You can use the [`zbctl` CLI](/apis-tools/community-clients/cli-client/index.md) to deploy via your pipeline, which works both for a SaaS or Self-Managed cluster. Deployments work slightly different on SaaS and Self-Managed, since there are differences in the cluster connection. Read more about deployments [here](/apis-tools/working-with-apis-tools.md#deploy-processes-start-process-instances-and-more-using-zeebe-client-libraries).

#### Define resource authorizations

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,7 @@ sidebar_label: "Zeebe connection"

You try to connect (i.e., to deploy) to a remote Zeebe cluster and Web Modeler reports an error.

<!-- NEEDS ATTENTION-->

To resolve this issue, check if you can connect to Zeebe through another client, i.e., [`zbctl`](#).
To resolve this issue, check if you can connect to Zeebe through another client, i.e., [`zbctl`](/apis-tools/community-clients/cli-client/index.md).
If that doesn't work, resolve the general connection issue first (see [the platform deployment troubleshooting section](/self-managed/operational-guides/troubleshooting/troubleshooting.md), for example.)

If that works, further debug your Zeebe connection with the help of the information stated below. Enabling [debug logging in `modeler-restapi`](#how-can-i-debug-log-grpc--zeebe-communication) may also help to understand the issue.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,10 @@ Running dual-region setups requires the users to be able to detect any regional
## Prerequisites

- A dual-region Camunda 8 setup installed in two different regions, preferably derived from our [AWS dual-region guide](/self-managed/setup/deploy/amazon/amazon-eks/dual-region.md).
- In that guide, we're showcasing Kubernetes dual-region installation, based on the following tools: - [Helm (3.x)](https://helm.sh/docs/intro/install/) for installing and upgrading the [Camunda Helm chart](https://github.com/camunda/camunda-platform-helm). - [Kubectl (1.30.x)](https://kubernetes.io/docs/tasks/tools/#kubectl) to interact with the Kubernetes cluster.
<!-- NEEDS ATTENTION-->
- [zbctl](#) to interact with the Zeebe cluster.
- In that guide, we're showcasing Kubernetes dual-region installation, based on the following tools:
- [Helm (3.x)](https://helm.sh/docs/intro/install/) for installing and upgrading the [Camunda Helm chart](https://github.com/camunda/camunda-platform-helm).
- [Kubectl (1.30.x)](https://kubernetes.io/docs/tasks/tools/#kubectl) to interact with the Kubernetes cluster.
- [zbctl](/apis-tools/community-clients/cli-client/index.md) to interact with the Zeebe cluster.

## Terminology

Expand Down Expand Up @@ -152,9 +153,7 @@ The following alternatives to port-forwarding are possible:

In our example, we went with port-forwarding to a local host, but other alternatives can also be used.

<!-- NEEDS ATTENTION-->

1. Use the [zbctl client](#) to retrieve list of remaining brokers
1. Use the [zbctl client](/apis-tools/community-clients/cli-client/index.md) to retrieve list of remaining brokers

```bash
kubectl --context $CLUSTER_SURVIVING port-forward services/$HELM_RELEASE_NAME-zeebe-gateway 26500:26500 -n $CAMUNDA_NAMESPACE_SURVIVING
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -508,9 +508,7 @@ helm install $HELM_RELEASE_NAME camunda/camunda-platform \
kubectl --context "$CLUSTER_0" -n $CAMUNDA_NAMESPACE_0 port-forward services/$HELM_RELEASE_NAME-zeebe-gateway 26500:26500
```

<!-- NEEDS ATTENTION-->

2. Open another terminal and use [zbctl](#) to print the Zeebe cluster status:
1. Open another terminal and use [zbctl](/apis-tools/community-clients/cli-client/index.md) to print the Zeebe cluster status:

```shell
zbctl status --insecure --address localhost:26500
Expand Down
12 changes: 3 additions & 9 deletions docs/self-managed/setup/deploy/amazon/amazon-eks/eks-helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,7 @@ Lastly you'll verify that the connection to your Self-Managed Camunda 8 environm
- A Kubernetes cluster; see the [eksctl](./eksctl.md) or [terraform](./terraform-setup.md) guide.
- [Helm (3.13+)](https://helm.sh/docs/intro/install/)
- [kubectl (1.28+)](https://kubernetes.io/docs/tasks/tools/#kubectl) to interact with the cluster.
- (optional) Domain name/[hosted zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-working-with.html) in Route53. This allows you to expose Camunda 8 and connect via [zbctl](#) or [Camunda Modeler](https://camunda.com/download/modeler/).

<!-- NEEDS ATTENTION-->
- (optional) Domain name/[hosted zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-working-with.html) in Route53. This allows you to expose Camunda 8 and connect via [zbctl](/apis-tools/community-clients/cli-client/index.md) or [Camunda Modeler](https://camunda.com/download/modeler/).

## Considerations

Expand Down Expand Up @@ -270,9 +268,7 @@ This reveals a `client-id` and `client-secret` that can be used to connect to th
<Tabs groupId="c8-connectivity">
<TabItem value="zbctl" label="zbctl">

After following the installation instructions in the [zbctl docs](#), we can configure the required connectivity to check that the Zeebe cluster is reachable.

<!-- NEEDS ATTENTION-->
After following the installation instructions in the [zbctl docs](/apis-tools/community-clients/cli-client/index.md), we can configure the required connectivity to check that the Zeebe cluster is reachable.

<Tabs groupId="domain">
<TabItem value="with" label="With Domain">
Expand Down Expand Up @@ -344,9 +340,7 @@ Brokers:
Partition 3 : Leader, Healthy
```

<!-- NEEDS ATTENTION-->

For more advanced topics, like deploying a process or registering a worker, consult the [zbctl docs](#).
For more advanced topics, like deploying a process or registering a worker, consult the [zbctl docs](/apis-tools/community-clients/cli-client/cli-get-started.md).

If you want to access the other services and their UI, you can port-forward those as well:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,9 +91,7 @@ First, port-forward each of the components. Use a separate terminal for each com

## Connecting to the workflow engine

<!-- NEEDS ATTENTION-->

To interact with the Camunda workflow engine via Zeebe Gateway using [zbctl](#) or a local client/worker from outside the Kubernetes cluster, run `kubectl port-forward` to the Zeebe gateway as follows:
To interact with the Camunda workflow engine via Zeebe Gateway using [zbctl](/apis-tools/community-clients/cli-client/cli-get-started.md) or a local client/worker from outside the Kubernetes cluster, run `kubectl port-forward` to the Zeebe gateway as follows:

```sh
kubectl port-forward svc/camunda-zeebe-gateway 26500:26500
Expand Down
4 changes: 1 addition & 3 deletions docs/self-managed/setup/deploy/local/manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,9 +92,7 @@ You’ll know Zeebe has started successfully when you see a message similar to t
[exporter] [0.0.0.0:26501-zb-actors-1] INFO io.camunda.zeebe.broker.exporter.elasticsearch - Exporter opened
```

<!-- NEEDS ATTENTION-->

You can test the Zeebe Gateway by asking for the cluster topology with [zbtcl](#):
You can test the Zeebe Gateway by asking for the cluster topology with [zbtcl](/apis-tools/community-clients/cli-client/index.md#usage):

```shell
./bin/zbctl --insecure status
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,7 @@ You need to keep `port-forward` running all the time to communicate with the rem

## Accessing workflow engine

<!-- NEEDS ATTENTION-->

To interact with Camunda workflow engine via [Zeebe Gateway](/self-managed/zeebe-deployment/configuration/gateway.md) using [zbctl](#) or a local client/worker from outside the Kubernetes cluster, run `kubectl port-forward` to the Zeebe cluster as following:
To interact with Camunda workflow engine via [Zeebe Gateway](/self-managed/zeebe-deployment/configuration/gateway.md) using [zbctl](/apis-tools/community-clients/cli-client/index.md) or a local client/worker from outside the Kubernetes cluster, run `kubectl port-forward` to the Zeebe cluster as following:

```
kubectl port-forward svc/camunda-zeebe-gateway 26500:26500
Expand Down

0 comments on commit 95c05ef

Please sign in to comment.