Skip to main content
The chkk command-line interface (CLI) offers a developer-first way to explore the Chkk universe.
1

Download Chkk CLI

Follow the steps in the Installation guide to download the Chkk CLI.
2

Run chkk start

Run the interactive starter to authenticate and register clusters:
chkk start
The chkk start command will get you started in the Chkk universe.The command will lead you through registering one or more clusters with Chkk and request a Chkk upgrade assessment for those registered clusters.Registering a cluster with Chkk is the process of collecting resources from the cluster and submitting those collected results to Chkk.Type chkk start in a terminal to begin.
> chkk start
        __    __    __
  .----|  |--|  |--|  |--.
  |  __|     |    <|    <
  |____|__|__|__|__|__|__|

Welcome to Chkk!

This command will help you get started with Chkk.

It will guide you through the process of logging in to your Chkk account and
registering any clusters if desired.

You may also request an upgrade assessment for any of your registered
clusters.

────────────────────────────────────────────────────────────────────────────────────────────────────────
Let's get you logged in to your Chkk account.
please confirm the code LCZS-DKDB at https://auth.chkk.io/activate?user_code=LCZS-DKDB
Click on the link and a browser window will appear asking you to confirm a code.
3

Register a Cluster

After clicking “Confirm”, in your terminal you will see a successful login message and a prompt to register a cluster with Chkk:
successfully logged in as "Jane Doe" (jane.doe@example.com) into organization "demo-org" (org_3c2732f7-9328-477d-910b-54cd94ade5c0).

Do you want to register any Kubernetes Clusters with Chkk? (Y/n)
Hit Enter or “Y” to start the registration process. We will look in your kubeconfig for Cloud Native Clusters and ask you to select one or more of those Kubernetes Clusters to register with Chkk.
Found 1 total Kubernetes Clusters in your kubeconfig.

Select the clusters you would like to register. Resources from the selected
clusters will be collected and submitted to Chkk for analysis.

Use the arrow keys to navigate: ↓ ↑ → ←
Select "Submit" to submit choices.
    Submit
  → ✔   kind-charlie (https://127.0.0.1:39775)
Use the arrow keys to navigate, hit Enter to select one or more of the clusters and navigate up to the Submit line and hit Enter again.We will ask you to confirm your selection:
You made the following 1 selections:

1: kind-charlie (https://127.0.0.1:39775)

Are you sure you want to submit these? Enter 'n' to select again. (Y/n)
Hit Enter or “Y” to collect resources from the selected clusters and register them with Chkk.
Registering 1 Kubernetes Cluster(s) with Chkk...

  registering kind-charlie (https://127.0.0.1:39775)...

✅ cluster "kind-charlie" resource collection successful. 49 resource groups collected.

To view information about your cluster, do:

  chkk cluster get k8scl_13673ce4-1cbd-454a-aa31-67b722fadc99
Your newly-registered cluster will then be displayed along with a prompt asking if you would like to request a Chkk upgrade assessment for this cluster:
The following 1 Kubernetes Clusters are active in your Chkk account:

┌────────────────────────────────────────────┬──────────────┬────────┬─────────────┬──────────┬──────────────┬──────────┐
│                     ID                     │     NAME     │ STATUS │ ENVIRONMENT │ PROVIDER │ KUBE VERSION │ #  NODES │
├────────────────────────────────────────────┼──────────────┼────────┼─────────────┼──────────┼──────────────┼──────────┤
│ k8scl_13673ce4-1cbd-454a-aa31-67b722fadc99 │ kind-charlie │ active │             │ KinD     │ 1.28         │ 2        │
└────────────────────────────────────────────┴──────────────┴────────┴─────────────┴──────────┴──────────────┴──────────┘
showing 1-1 of 1 records.

Would you like to request an upgrade assessment for any of these Kubernetes Clusters? (Y/n)
4

Review the Upgrade Assessment

A Chkk upgrade assessment is a report that alerts you to potential issues with an upgrade of your cluster and recommends upgrade versions for your Cloud Native Projects and Application Services.Hit Enter or “Y” to select one or more clusters for an upgrade assessment.
Use the arrow keys to navigate: ↓ ↑ → ←
? Select a cluster to request an upgrade assessment for:
  ▸ kind-charlie (1.28) (KinD)
select a cluster and hit Enter.
You selected "kind-charlie (1.28) (KinD)". Is this correct? Enter 'n' to select again. (Y/n)

Requesting upgrade assessment for kind-charlie (1.28) (KinD)...

(required) enter the name for the upgrade assessment
charlie
✅ request for upgrade assessement for cluster "k8scl_13673ce4-1cbd-454a-aa31-67b722fadc99" successful.
... waiting for upgrade assessment to complete. this will take a few minutes ...
The upgrade assessment will take a few minutes to generate and then you will see:
completed!

To view your upgrade assessment, do:

  chkk upgradeassessment get ua_a59a7fff-f3c2-4443-9f26-fe97cd187def

Learn more about Chkk upgrade assessments at: https://docs.chkk.io/product/upgrade-copilot/assessments

​
Need Help?

Email us at support@chkk.io for assistance.