This article instructs on how to install Cloudaware Breeze agent on Kubernetes clusters running in a private network. Linux only.
Breeze Agent Setup
1. Log in to Cloudaware account. Select Admin under your username in the upper right corner.
2. Locate Breeze in the list of DevOps Integrations → 1 Configured.
3. Select Linux* Agent version to download the Breeze agent.
*This integration is for Linux only.
4. Clone or download the breeze-tools repository:
# git clone https://github.com/cloudaware/breeze-tools.git
5. Change the working directory to kubernetes
, put archive with Breeze agent installer and then extract it:
# cd breeze-tools/kubernetes/ # cp /path/to/agent/distro/breeze-agent.x86_64.linux.tgz . # tar xf breeze-agent.x86_64.linux.tgz
6. Build docker images:
# docker build -t breeze-agent-init -f Dockerfile.breeze-agent-init . # docker build -t breeze-agent -f Dockerfile.breeze-agent .
In order to check if images have been generated, the following command can be used:
# docker images "breeze*"
7. Create two repositories named ‘breeze-agent' and 'breeze-agent-init’ in the private Docker registry.
8. Push the created images to the PRIVATE Docker container registry:
# docker tag breeze-agent-init:latest CONTAINER_REGISTRY_URI/breeze-agent-init:latest # docker push breeze-agent-init:latest CONTAINER_REGISTRY_URI/breeze-agent-init:latest # docker tag breeze-agent:latest CONTAINER_REGISTRY_URI/breeze-agent:latest # docker push breeze-agent:latest CONTAINER_REGISTRY_URI/breeze-agent:latest
- where CONTAINER_REGISTRY_URI
- the fully qualified path to the private registry with the repositories
9. Open file breeze-agent-deployment-eks.yaml
(for EKS) or breeze-agent-deployment-aks.yaml
(for AKS) in the text editor and replace the following placeholders with proper values:
CONTAINER_REGISTRY_URI
- same as in the previous stepIMAGE_PULL_SECRET_NAME
- name of the Kubernetes secret containing auth data of the private registry
10. Apply the configuration:
# kubectl create -f breeze-agent-deployment-eks.yaml
Integration Status Check
Once Breeze is installed, Cloudaware automatically enables TunHub Gateway for a secure connection with Kubernetes which may be running in a private network.
Go to Admin → Clouds & Integrations → TunHub. Ensure that the TunHub connection has been created and has a green status.
Checking Cloudaware Access To Amazon EKS
Ensure that Cloudaware has required permissions for Amazon EKS using this guide.
Please allow 1 hour for the data to load into Cloudaware.