Skip to content

CAEPE quickstart

This guide shows you how to access and log in to your CAEPE account portal and create the resources needed to run an application.


This guide assumes you have received an email invitation from an account administrator and that you have an already running and accessible Kubernetes cluster.

This quickstart guide uses the Sock shop microservices demo as an application to deploy as you follow the steps in this guide.

You can follow the steps in the following demo video or follow the the instructions in the following sections to jump start your CAEPE journey.

CAEPE account portal

The portal shows an overview of your account data and CAEPE application instances.

You can run the CAEPE application as a hosted instance, or self-host it on your own public cloud or on-premise infrastructure.


This guide uses the hosted option, for more details on self-hosting CAEPE, read the self-hosting section.

Find your pre-installed hosted instance from the CAEPE Application menu item and clicking the Launch CAEPE Application button.

After clicking the button, the CAEPE application dashboard appears. You can log in to the dashboard using the same credentials used to log in to the portal.

Screenshot of CAEPE dashboard

The application dashboard provides an overview of cluster and application resources and their health.

Connect a cluster

Connect a cluster from the Configuration -> Clusters menu item and clicking the New Cluster button. CAEPE supports connecting to an existing cluster, or building a new cluster as you connect to it. This quickstart connects to an existing cluster you should already have running.

Select the Connect to live clusters button.

In the form that appears set a name and description for the cluster and a region. Set the type based on where the cluster is running. CAEPE supports clusters running on multiple Kubernetes providers, including:

  • Amazon EKS
  • Azure AKS
  • Google GKE
  • Lightweight Kubernetes (K3s)
  • Kubernetes running on private clusters and on-premises
  • OCI container engine
  • Rancher Kubernetes engine

Upload a kubeconfig file for the cluster so that CAEPE has the connection details.

When you create a cluster you can add it to a logical grouping of clusters. You can select a pre-existing group, or create a new one.

When the Pods are ready, the cluster shows in the list with a "Healthy" state.


If you add the cluster to a pre-existing group that has an application defined for it, CAEPE automatically deploys that application to the new cluster.

Create a repository

Repositories represent where CAEPE can find the definition of an application.

Create a repository from the Configuration -> Application Sources -> Repositories menu item and clicking the New Repository button.

You can select any public or private git-based repositories or Helm charts by supplying a name and a URL. If you need credentials to access repositories or Helm charts, select or create them with a user ID and password or private key.

Screenshot of repository configuration page

When you create a repository, select the type and the location. CAEPE supports application definitions stored in the following repository types:

  • Git
  • Helm

And stored in the following locations:

  • GitHub
  • Bitbucket
  • Gitlab
  • Custom location

Give the repository a name and a URL.


For the Sock shop application, use the following details:

  • Select Git and GitHub
  • Repository Name: sock-shop
  • Repository Url:

Leave all other options.

Create an application

Applications represent a Kubernetes application connected to a repository that you deploy to a cluster or cluster group multiple times.

Create an application from the Configuration -> Applications menu item and clicking the New Application button.

First give the application a name, a description, and tags for metadata.

Screenshot of step 1 of creating an application

In the next step, select the repository created above, add the branch to use, and the namespace to create the application in.


For the Sock shop application, use the following details:

  • Branch: master
  • Namespace: sock-shop

Screenshot of step 2 of creating an application

In the final step, select the path in the repository that contains the Kubernetes manifests that define the application. This folder is relative to the repository root.

CAEPE supports three deployment methods: Helm, Kustomize, and Manifest files. Select the one relevant for your application.


For the Sock shop application, use the following details:

  • Type of Deployment: Manifest
  • Path: deploy/kubernetes

Screenshot of step 3 of creating an application

Create a deployment

A deployment connects an Application to a Cluster to create running versions of applications at a particular time.

Create a deployment from the Deployments menu item and clicking the New Deployment button.

First give the deployment a name, select an application to deploy, the namespace to deploy the application to, and git branch or tag to pull the application definitions from.

Screenshot of step 1 of creating a de0loyment

In the next step, select the cluster or cluster group to deploy the application to.

Confirm deployment

If you now use kubectl get namespaces you can see the CAEPE created namespace for the deployment, and if you list pods in the namespace with kubectl get pods -n {NAMESPACE} you can see the CAEPE created pods for the deployment.

Last update: 2024-01-22
Back to top