Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This article instructs on how to create a DaemonSet in order to install and run 1 sample of Cloudaware Breeze agent on every node of cloud-managed Kubernetes cluster (Amazon EKS, Azure AKS, Google GKE). This allows to enable TunHub on the cluster and get the URL for further configuration of Kubernetes integration in Cloudaware. Linux only.

Table of Contents

Description

DaemonSet starts the container with Breeze agent installer. The container has two bind mounts:

  • host:/opt > container:/opt - used for the Breeze agent installation from container to the host file system

  • host:/ > container:/var/root - used for launching the agent in the chroot environment

The container runs two commands:

  1. Install the Breeze agent to the /opt directory

  2. Run the simple daemon which runs the Breeze agent every 15 minutes

Step-by-step guide

1. Open Cloudaware Github repo with Kubernetes files. Clone the repo to your Github using the following command:

Code Block
git clone https://github.com/cloudaware/breeze-tools.git

2. Log in to Cloudaware account. Select Admin under your username in the upper right corner.

3. Locate Breeze in the list of DevOps Integrations. Click 1 Configured.

4. Download the Breeze installer file (for Linux).

5. Untar the Breeze installer and copy the extracted files (./breeze-agent folder) into kubernetes/daemonset folder of the cloned repo:

Code Block
cd breeze-tools/kubernetes/daemonset && tar xzvf <DOWNLOADS_PATH>/breeze-agent.example.version.0.x86_64.linux.tgz

WHERE

breeze-agent.example.version.0.x86_64 should be replaced by the name of the dowloaded installer file.

Code Block
docker build -t ca-breeze-ds .

6. Create a repository in your private container registry (e.g. AWS ECR, Azure ACR, Google GCR, etc.) named ca-breeze-ds. Upload the result image to your private container registry.

Code Block
docker tag ca-breeze-ds:latest <CONTAINER_REGISTRY_HOSTNAME>/ca-breeze-ds:latest
Code Block
docker push <CONTAINER_REGISTRY_HOSTNAME>/ca-breeze-ds:latest 

WHERE

<CONTAINER_REGISTRY_HOSTNAME> is a placeholder that needs to be replaced by your private container registry URI (e.g. 111111111111.dkr.ecr.us-east-1.amazonaws.com/breeze-agent).

7. Edit the DaemonSet configuration file ds-breeze-agent.yaml replacing the placeholders with valid values. Ensure that image pull secret is added to Kubernetes Secrets.

8. Create the DaemonSet using the following command:

Code Block
kubectl create -f ds-breeze-agent.yaml

9. To verify that the DaemonSet has been created, you may run the following command:

Code Block
kubectl get ds

Further Configuration