Overview

This quick start guide will lead you through the process of getting started with an own instance of the Banzai Cloud Pipeline platform on AWS. After completing the steps, you will have an environment where you can launch clusters and evaluate the services of the platform.

There is an alternative quick start method for local deployments as well. If you don’t want to bother with the installation, either try Banzai Cloud Pipeline online for free, or contact our sales team for a demo about our solutions for your environment.

In this method we will use the Banzai CLI tool to deploy a Banzai Cloud Pipeline environment to AWS. The infrastructure will consist of an EC2 instance, which runs a single-node PKE cluster for the components of Pipeline.

Prerequisites

Before we start, there are a few items that you will need on the machine that will be used to manage the deployment (usually your laptop).

  • AWS credentials — have an AWS access key ready for deploying the infrastructure
  • MacOS or Linux (x86_64) — most of the native tooling around Kubernetes is for these platforms, so is ours
  • Banzai CLI tool — the installation process depends heavily on the Banzai CLI tool
  • Docker 18.09+ — the heavy lifting of the deployment is managed by a Docker container

AWS credentials

You will need an AWS account, and more specifically access keys to complete this method. The installation process will use the credentials set on your machine for aws-cli. If you don’t have any, follow the advices of Amazon.

Banzai CLI tool

Banzai Cloud Pipeline is installed using the Banzai CLI tool, which you will like to use for everyday tasks anyway in the Banzai Cloud world.

The quickest way to install the banzai-cli package for your environment is to run the following command:

curl https://getpipeline.sh | sh

Alternatively you can use our packages for the most popular Linux distributions. You can install Banzai CLI on macOS directly with Homebrew: brew install banzaicloud/tap/banzai-cli. For more options, check our detailed Installation guide for Banzai CLI.

You will also need kubectl`, the command line tool for Kubernetes. The Homebrew formula for Banzai CLI takes care of installing it, but because most Linux distributions have outdated packages for kubectl, we recommend the following one-liner, or other options from the Kubernetes documentation:
curl https://getpipeline.sh | sh -s – kubectl.

Please make sure that your Banzai CLI is up-to-date.

Docker

The installer needs a recent version — at least 18.09 — of the Docker container engine. If you don’t already have it installed, follow the Docker docs for your platform.

Please note that the Docker daemon should be running, the docker command should be in the PATH, and the account used for the installation process should have the privileges needed to run containers (for Linux, check the post-installation steps).

In case of Docker for Mac, you will have to ensure that at least 3 CPU and 3 GiB of memory is allocated. You can check this on the Advanced tab of the Preferences window of Docker for Mac.

Install Banzai Cloud Pipeline

The installer will create an EC2 c5.large instance within your default AWS region, in the default VPC. If this is not what your want, please check how to customize the provider configuration.

To start the installer, simply execute the following command, and answer the questions displayed.

banzai pipeline up --provider=ec2

Your Banzai Cloud Pipeline instance is ready for use! Let’s create the first cluster for your workloads. In the examples we will use Banzai Cloud’s Kubernetes distribution, PKE on AWS.

Logging in with Banzai CLI

If the installation was successful, the last few lines of the output contains a user name and password that can be used for logging in. It will also show the endpoint URL, and a Banzai CLI login command.

Run the banzai login command printed, accept the certificate, and log in using your browser.

A browser window will show up, and you’ll be able to log in with the username and password from the output. After that, you can return to your console.

Next steps

To try the features of the platform, you will need a Kubernetes cluster that is managed by Pipeline. You can either create a cluster with or import an existing one into Pipeline by following the Create your first cluster guide. To launch a PKE cluster in Amazon EC2, check the Create a PKE cluster on AWS guide.