Overview

To try the features of the Banzai Cloud Pipeline in your own environment, you will need a Kubernetes cluster managed by Pipeline. You can either create a cloud provider managed cluster (like AKS, EKS, GKE, etc), or a PKE cluster or import an existing Kubernetes cluster.

When you have an own instance of Banzai Cloud Pipeline in AWS, we recommend to follow this guide, and create a PKE cluster too.

This quick start guide will lead you through the process of launching a PKE cluster with Banzai Cloud Pipeline on Amazon EC2.

Prerequisites

  • AWS credentials
  • Banzai CLI tool logged in to your Pipeline instance

Create AWS secret

For creating the first PKE cluster, we will need to add AWS credentials to Banzai Cloud Pipeline’s secret store. The quickest way is to copy the credentials from your aws-cli configuration (the same one that we used for the installation).

You can simply do this with the following command:

banzai secret create --name=my-aws --magic --type=amazon

Alternatively you can create a more restricted access key for this purpose.

Create your first PKE on AWS cluster

Use the following command.

banzai cluster create

The command will ask for some details interactively. Select PKE on AWS as cluster type, and confirm the creation of the cluster at the end. All the other defaults should fit the needs for a test cluster.

Verify running cluster

You can check the status of the cluster creation with the following command:

banzai cluster list

Once the cluster is ready, you can try it with some simple commands. banzai cluster shell executes a shell within the context of the selected cluster. If you type a command in the shell opened, or pass it as arguments, it will be executed in a prepared environment. For example, you can list the nodes of the cluster using the original kubectl command:

banzai cluster shell -- kubectl get nodes

Further steps

If you are happy with the results, go on with the Deploying workload guide to learn about the basic features of a cluster.