Core Instance operations

Core Instance operations

You can use Calyptia CLI to perform the following Core Instance operations.

Install Core Instance and Core Operator

If you deployed Calyptia Core inside a Kubernetes cluster, Calyptia CLI must be able to access that cluster. If you deployed Calyptia Core on a Linux server, you must run Calyptia CLI from inside that server environment.

You can use a single command to install Core Instance and Core Operator at the same time. The Core Operator installation includes custom resource definitions (CRDs) and the operator image.

To install Core Instance and Core Operator:

  1. Update Calyptia CLI. Because Core Instance versions are dependent on your Calyptia CLI version, the latest version of Calyptia CLI installs the latest version of Core Instance.

  2. Run the following command:

    calyptia config set_token KEY &&
      calyptia install operator &&
      calyptia create core_instance operator --name INSTANCE --wait

    Replace KEY with the value of the API key you generated to authenticate with Calyptia services and INSTANCE with the name of your Core Instance.

Upgrade Core Instance

If you deployed Calyptia Core inside a Kubernetes cluster, Calyptia CLI must have access that cluster. If you deployed Calyptia Core on a Linux server, you must run Calyptia CLI from inside that server environment.

To upgrade Core Instance by using Calyptia CLI:

  1. Run the following command to update Core Operator:

    calyptia update operator --version VERSION

    Replace VERSION with the latest version of the Core Instance binary.

  2. Run the following command to update Core Instance:

    calyptia update core_instance INSTANCE operator --version VERSION

    Replace VERSION with the same value from the previous step and INSTANCE with the name of the Core Instance you'd like to update.

Both steps use the same VERSION value because Core Instance and Core Operator are packaged in the same binary.

Configure Kubernetes deployment

If you deployed Calyptia Core in a Kubernetes cluster, you can use Calyptia CLI to configure additional parameters and make sure that your Core Instance adheres to any other Kubernetes policies that you've set.

Namespaces

When you install Core Operator, use the --kube-namespace flag to set the namespace for your Core Operator installation. However, be aware that Core Operator CRDs do not support namespace scoping.

Tolerations and taints

Requires Core Instance version 2.8.4 or later and Calyptia CLI version 1.7.2 or later.

Tolerations and taints (opens in a new tab) can help you take advantage of high-availability hardware by ensuring that your deployments spread evenly.

To specify tolerations, use the --tolerations flag and key1=Equal:value1:Execute syntax.

Annotations

To set custom annotations, use the --annotations flag and annotation1=value1,annotation2=value2 syntax.