Install Cosmonic Control
Cosmonic Control is an enterprise control plane for managing WebAssembly (Wasm) workloads in cloud native environments.
You'll need a Cosmonic license key to follow these instructions. Sign up for Cosmonic Control's free trial to get a key.
Requirements
- Kubernetes
- Helm v3.8.0+
Installation
helm install cosmonic-control oci://ghcr.io/cosmonic/cosmonic-control\
--version 0.2.0\
--namespace cosmonic-system\
--create-namespace\
--set cosmonicLicenseKey="<insert license here>"
Helm will confirm a successful installation:
Pulled: registry-1.docker.io/cosmonic/cosmonic-control:0.1.0
Digest: sha256:<hash>
NAME: cosmonic-control
LAST DEPLOYED: <date>
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Congratulations! You have successfully installed Cosmonic Control!
Install a HostGroup:
helm install hostgroup oci://ghcr.io/cosmonic/cosmonic-control-hostgroup --version 0.2.0 --namespace cosmonic-system --set http.enabled=true
Deploy the Welcome Tour component:
helm install welcome-tour oci://ghcr.io/cosmonic-labs/charts/welcome-tour -n welcome-app --create-namespace --version 0.1.0
Running the Welcome Tour on Kubernetes
In separate terminal tabs:
kubectl -n cosmonic-system port-forward svc/console 8080:8080
kubectl -n cosmonic-system port-forward svc/hostgroup-default 9091:9091
Open browser to http://localhost:9091 to see the tour!
See some of the resources running with:
kubectl get hosts
kubectl get components -A
kubectl get providers -A
Cleaning up
helm uninstall welcome-tour -n welcome-app
kubectl delete ns welcome-app
helm uninstall hostgroup -n cosmonic-system
helm uninstall cosmonic-control -n cosmonic-system
kubectl delete ns cosmonic-system
Declarative values configuration
The Cosmonic Control Helm chart uses the values.yaml
file below.
# Additional configuration options for Cosmonic Control
global:
image:
# -- Globally override container image registry, e.g. "ghcr.io"
registry: ''
# -- Globally override container imagePullSecrets
pullSecrets: []
nameOverride: ''
fullnameOverride: ''
cosmonicLicenseKey: 'test-license'
# -- This section builds out the service account.
# See the [Kubernetes documentation](https://kubernetes.io/docs/concepts/security/service-accounts/).
serviceAccount:
# -- Specifies whether a service account should be created
create: true
# -- Automatically mount a ServiceAccount's API credentials?
automountServiceAccountToken: true
# -- Annotations to add to the service account
annotations: {}
rbac:
create: true
You can declaratively customize values and override the chart defaults as needed by running (from your working directory):
helm install cosmonic-control oci://ghcr.io/cosmonic/cosmonic-control --version 0.2.0 -f values.yaml
Frequently asked questions
Can I install the chart with a Helm 3 version prior to v3.8.0?
In versions of Helm 3 prior to Helm v3.8.0, OCI support was an experimental feature. You can run export HELM_EXPERIMENTAL_OCI=1
to enable support, but some OCI functionality may perform differently. See the Helm documentation for more information.