Install Lightbend Console

The Lightbend Console for Akka Data Pipelines is available to Lightbend Subscription new tab customers. It consists of a set of Helm charts.

Prerequisites

Before you can use Console, you need to have Cloudflow installed Cloudflow components on a cluster. Make sure you have the credentials new tab required to download the components from the Lightbend commercial repository.

Downloading and installing

  1. Add the Lightbend Helm repository and update the local index:

    helm repo add cloudflow-helm-charts https://lightbend.github.io/cloudflow-helm-charts/
    helm repo update
  2. Set the $DOCKER_USERNAME and $DOCKER_PASSWORD environment variables to the username and password of the Lightbend commercial repository.

    To avoid storing your Lightbend credentials in the shell’s history file, use the following commands to create an environment variable for username and password. The username/password are your credentials to the Lightbend docker repository - commercial-registry.lightbend.com). If you want to see the password, remove the -s (for silent) flag.

      read DOCKER_USERNAME
      read -s DOCKER_PASSWORD
  3. Execute the Helm command to install the Cloudflow enterprise components. Note the use of $DOCKER_USERNAME and $DOCKER_PASSWORD in the Helm command.

    helm install cloudflow-enterprise-components cloudflow-helm-charts/cloudflow-enterprise-components \
      --namespace cloudflow \
      --set enterpriseOperator.version=2.2.2 \
      --set enterprise-suite.imageCredentials.username="$DOCKER_USERNAME" \
      --set enterprise-suite.imageCredentials.password="$DOCKER_PASSWORD"
  4. After using the username and password environment variables, clear them by closing the shell or by executing the following commands:

      unset DOCKER_USERNAME
      unset DOCKER_PASSWORD
  5. To quickly verify that the installation worked, you can open a proxy to the Lightbend console service and confirm that you can access the Lightbend console UI:

    1. First, create the port-forward.

        kubectl port-forward -n cloudflow svc/console-server 5000:80
    2. Open the following URL in your browser: http://localhost:5000

Upgrading

If you need to upgrade the Console to a newer version, see Upgrading Console.

What’s next