Skip to main content

Get started with your Cosmonic Control trial

Welcome to your trial of Cosmonic Control. To get started, you'll need:

  • Trial credentials from Cosmonic, including:
    • Username (cosmonic+<account_name>)
    • Password
  • Kubernetes cluster
  • kubectl
  • Helm

Add your trial credentials​

Create environment variables for your trial credentials from Cosmonic:

CC_USERNAME=username-value-here

CC_PASSWORD=password-value-here

Create a pull secret using your trial credentials:

kubectl create secret docker-registry cosmonic-quay \
  --docker-username $CC_USERNAME \
  --docker-password $CC_PASSWORD \
  --docker-server quay.io

Install Cosmonic Control​

Install the Cosmonic infrastructure operator:

helm upgrade --install cosmonic-control oci://quay.io/cosmonic/cosmonic-control \
    --version 0.1.2 \
    --values https://github.com/cosmonic-labs/control-demos/blob/main/trial/values.yaml \
    --username $(op read op://Shared/quay_io-cosmonic_internal_read_only/username) \
    --password $(op read op://Shared/quay_io-cosmonic_internal_read_only/credential)

Wait for the Cosmonic infrastructure operator to become ready:

kubectl rollout status deployment cosmonic-control

Deploy a wasmCloud cluster:

kubectl apply -f https://github.com/cosmonic-labs/control-demos/blob/main/trial/cluster.yaml

Wait for the cluster to become ready:

kubectl rollout status deployment operator-demo --timeout=90s

Deploy a host group:

kubectl apply -f https://github.com/cosmonic-labs/control-demos/blob/main/trial/hostgroup.yaml

Wait for the host group to become ready:

kubectl rollout status deployment demo-hostgroup --timeout=90s

Now you're ready to run wasmCloud applications with Cosmonic Control.

Deploy a wasmCloud application​

Use Helm to deploy the "Hello World" application:

helm install hello-world oci://ghcr.io/cosmonic-labs/charts/hello-world

Open a port-forward to the host group to access the provider:

kubectl port-forward deploy/demo-hostgroup 8080

In another tab or window, call the http-server provider through the port-forward:

curl localhost:8080

You should now be greeted with:

Hello from Cosmonic Control!
Your deployment is now running a WebAssembly application with wasmCloud.
        
To learn more about building your own WebAssembly applications, visit:
        
https://wasmcloud.com/docs/tour/hello-world/

Next steps​