Running on Kubernetes
We advise running any production-grade Checkly Agent deployments on a container orchestrator like Kubernetes. To help you get started, we created the checkly-k8s repo which contains a Helm chart and a few example Kubernetes manifests.
- You’ve created a Private Location and have an API key.
- A running Kubernetes cluster
- Helm if you are using Helm charts.
Now, clone the repo with the examples:
git clone https://github.com/checkly/checkly-k8s.git cd checkly-k8
Find the Helm chart in the
/helm-cart directory. The Helm chart does two basic things:
- Creates a secret for the API key.
- Spins up two pods running the Checkly Agent
Assuming you have Helm set up to point at your K8S cluster, run it with the following command, making sure you
apikey="pl_..." with your Checkly Private Location API key.
helm install checkly-agent --set apiKey="pl_..." ./helm-chart
If you are not using Helm, you can also use K8S manifest files to create your preferred cluster setup for the Checkly Agent. Here is a rundown of the manifest files you can find in the repo:
Creates a secret containing the API key your agents use to connect to the private location. The pod and deployment manifests are configured to use this secret.
This is a quick way to test the Checkly Agent on your cluster. Be aware, if the container exits, it will not automatically restarted.
Optional but recommended - Creates a namespace for the Checkly agent resources. Make sure to have NetworkPolicies in place to your other namespaces.
You can contribute to this documentation by editing this page on Github