tkeel-io / cli

Command-line tools for tKeel.

tKeel CLI

🕹️ tKeel CLI is your main tool for various tasks related to tKeel Platform.

You can use it to install the tKeel platform, manage plugins and users.

👉 中文文档

Prerequisites

tKeel CLI can help you install the tKeel platform and help you manage the platform.

⚠️ tKeel currently relies on Dapr (Kubernetes mode).

• Install kubectl
• Install Dapr on Kubernetes

Install

🔧 We offer a variety of installation options, you choose the one you feel most comfortable installing according to your preference.

Using script to install the latest release

The components required for the entire tKeel platform are automatically installed for you by means of scripts we have written.

Linux

Install the latest linux tKeel CLI to /usr/local/bin

$ wget -q https://raw.githubusercontent.com/tkeel-io/cli/master/install/install.sh -O - | /bin/bash

MacOS

Install the latest darwin tKeel CLI to /usr/local/bin

$ curl -fsSL https://raw.githubusercontent.com/tkeel-io/cli/master/install/install.sh | /bin/bash

From the Binary Releases

Each release of tKeel CLI includes various OSes and architectures. These binary versions can be manually downloaded and installed.

1. Download the tKeel CLI
2. Unpack it (e.g. tkeel_linux_amd64.tar.gz, tkeel_windows_amd64.zip)
3. Move it to your desired location.
   • For Linux/MacOS - /usr/local/bin
   • For Windows, create a directory and add this to your System PATH. For example create a directory called c:\tkeel and add this directory to your path, by editing your system environment variable.

Init tKeel Platform on Kubernetes

Use the init command to initialize tKeel.

$ tkeel init

For Linux users, if you run your docker cmds with sudo, you need to use "sudo tkeel init"

Output should look like so:

⌛  Making the jump to hyperspace...
ℹ️  Checking the Dapr runtime status...
↑  Deploying the tKeel Platform to your cluster... 
ℹ️  install plugins...                                                        
ℹ️  install plugins done.                                                                                                        
✅  Deploying the tKeel Platform to your cluster...
↖  Register the plugins ... 
ℹ️  Plugin<plugins>  is registered.                                                                                          
ℹ️  Plugin<keel>  is registered.                                                                                                                        
ℹ️  Plugin<auth>  is registered.                                                                                                                        
✅  Success! tKeel Platform has been installed to namespace keel-system. To verify, run `tkeel plugin list' in your terminal. To get started, go here: https://tkeel.io/keel-getting-started

Uninstall tKeel on Kubernetes

To remove tKeel from your Kubernetes cluster, use the uninstall command.

$ tkeel uninstall

Deploy plugin

You can deploy the plugin app with the Dapr. There is deploy-the-plugin-app Doc

Manage plugins

Use the plugin command to manage plugins.

1. List plugin

$ tkeel plugin list      
NAME       NAMESPACE    HEALTHY  STATUS    PLUGINSTATUS  REPLICAS  VERSION  AGE  CREATED              
auth       keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00  
plugins    keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00  
keel       keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00
echo-demo  keel-system  False    Running   UNKNOWN       1         0.0.1    1m   2021-10-05 11:25.19  

2. Register plugin

$ tkeel plugin register echo-demo
✅  Success! Plugin<echo-demo> has been Registered to tKeel Platform . To verify, run `tkeel plugin list' in your terminal.

Check the status

$ tkeel plugin list              
NAME       NAMESPACE    HEALTHY  STATUS    PLUGINSTATUS  REPLICAS  VERSION  AGE  CREATED              
auth       keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00  
plugins    keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00  
keel       keel-system  True     Running   ACTIVE        1         0.0.1    37m  2021-10-07 16:07.00
echo-demo  keel-system  False    Running   ACTIVE        1         0.0.1    2m   2021-10-05 11:25.19  

3. Delete plugin

$ tkeel plugin uninstall echo-demo
✅  Remove "echo-demo" success!

Admin Login

Use this command to login your admin account of rudder.

input password with invisible

tkeel admin login