This repository defines the official Cloud Controller Manager (CCM) Helm Charts for use with Crusoe Cloud.
The CCM Helm Charts are currently in :construction: Alpha :construction:.
The Crusoe CCM is only supported on Crusoe Managed Kubernetes (CMK). This guide assumes that the user has already set up CMK on Crusoe Cloud. Other configurations will be supported on a best-effort basis.
The examples below assume the intended namespace for the CCM is kube-system.
The Crusoe controller manager requires access to the Crusoe API to communicate for instance status and metadata. The secret should contain the following keys with base64 encoded values: CRUSOE_PROJECT_ID, CRUSOE_ACCESS_KEY, CRUSOE_SECRET_KEY, and CRUSOE_API_ENDPOINT. As the CCM will interact with the Crusoe Cloud API to manage VM/Instance operations, you need to set up credentials in your Kubernetes cluster. The CCM will use these credentials to communicate with the API. Below is a template .yaml file that you can modify with your credentials and apply to your cluster.
apiVersion: v1
kind: Secret
metadata:
name: crusoe-secrets
namespace: kube-system
type: Opaque
data:
CRUSOE_PROJECT_ID: [base64 encoded value]
CRUSOE_ACCESS_KEY: [base64 encoded value]
CRUSOE_SECRET_KEY: [base64 encoded value]
CRUSOE_API_ENDPOINT: [base64 encoded value]
An appropriate secret can be created in your cluster by filling out the command below and running it in the terminal:
kubectl create secret generic crusoe-secrets -n kube-system -o yaml \
--from-literal=CRUSOE_PROJECT_ID=$CRUSOE_PROJECT_ID \
--from-literal=CRUSOE_ACCESS_KEY=$CRUSOE_ACCESS_KEY \
--from-literal=CRUSOE_SECRET_KEY=$CRUSOE_SECRET_KEY \
--from-literal=CRUSOE_API_ENDPOINT=$CRUSOE_API_ENDPOINT
By default, the ccm will use the crusoe-secrets secret.
The name of the secret may be changed in the secrets section of the values.yaml file.
Helm must be installed to use the charts. Please refer to Helm’s documentation to get started.
Once Helm has been set up correctly, add the repo as follows:
helm repo add <repo alias> https://crusoecloud.github.io/crusoe-cloud-controller-manager-helm-charts/charts
If you have already added this repo earlier, run helm repo update to retrieve
the latest versions of the packages. You can then run `helm search repo