Introduction

The document's purpose is to provide the step-by-step guide for BuildBen trial version helm hart deployment on ready K8S clusters.

The installation requires management access to the K8S cluster and a dedicated namespace.

BuildBen Trial Version is limited to a maximum of 3 parallel execution processes.

BuildBen Trial Version EKS cluster consists of backend service, PostgreSQL database, MinIO cluster, and 3 worker agents (depending on customer request).

BuildBen Trial Version Helm Chart Deployment

Prerequisites

In case the customer will allocate BuildBen worker agents in the same K8S cluster, run the following command to label the cluster's nodes to be used in Buildben agents management process:

ITER=1; for i in $(kubectl get nodes --no-headers | awk '{printf "%s ",}'); do kubectl label nodes "$i" number=$ITER; ((ITER++)); done

Download BuildBen helm chart

1. Create directory to store BuildBen helm chart

mkdir ~/buildben

2. Change to new directory

cd ~/buildben

3. Download the latest BuildBen helm chart

curl https://buildben-trial.s3.eu-central-1.amazonaws.com/helm_charts/buildben-helm-latest.tar.gz -o buildben-helm-latest.tar.gz

4. Unarchive the helm chart files

tar -xvf buildben-helm-latest.tar.gz

Edit BuildBen helm chart values.yaml file

1. Open ~/buildben/values.yaml file for editing

2. For BUILDBEN_LICENSE_KEY key provide the value received from BuildBen support

Deploy BuildBen helm chart

1. From the same directory, run the following command to install BuildBen helm chart

helm upgrade --install -n <k8s_namespace_name> buildben -f values.yaml .

2. Validate the process completion by the following command

kubectl -n <k8s_namespace_name> get pods

The expected output example: all pods are in RUNNING status.

Post deployment steps

1. Run the following command to get the BuildBen backend link

kubectl get svc -n <k8s_namespace_name> | grep 'buildben-backend ' | awk '{printf "http://%s:8080",}'

Copy the printed link to be used in section Usage Steps, step #3.a of the Using BuildBen Agent in CI/CD Scripts document (BUILDBEN_HOST_URL environment variable value).

2. Run the following command to get the BuildBen MinIO cluster link

kubectl get svc -n <k8s_namespace_name> | grep 'buildben-minio ' | awk '{printf "http://%s:9000",}'

Copy the printed link to be used in section Usage Steps, step #3.b of the Using BuildBen Agent in CI/CD Scripts document (BUILDBEN_MINIO_URL environment variable value).

3. Run the following command to get the link to BuildBen agent used in CI platforms

kubectl get svc -n <k8s_namespace_name> | grep 'bb-init-agent ' | awk '{printf "http://%s:8081",}'

Copy the printed link to be used in section Usage Steps", step #1 of the Using BuildBen Agent in CI/CD Scripts document (replace <BUILDBEN_CI_AGENT_URL> placeholder).