__    __    __         __                __             __   _ 
  / /__ / /_  / /  ____  / / ___  __ __ ___/ / ____ ____  / /  (_)
 /  '_// __/ / _ \/ __/ / / / _ \/ // // _  / /___// __/ / /  / / 
/_/\_\ \__/ /_//_/\__/ /_/  \___/\_,_/ \_,_/       \__/ /_/  /_/  

kthcloud-cli

Note

This project is in the very early stages of development. Features are incomplete, and things may change frequently.

Table of Contents

• Overview
  • Compose
• Installation
  • Download binary
    • Mac and Linux
    • Windows
  • Build
• Commands
  • Login
  • Compose
    • Up
    • Down
    • Parse
  • Update
  • Version
• Configuration

Overview

kthcloud-cli is a command-line interface tool for interacting with kthcloud’s API. It allows you to perform various operations such as listin deployments, creating api keys, and creating deployments from docker-compose files.

Compose

The clis core functionality is to parse docker compose files and create deployments from the content.

For example, if i have this docker-compose.yaml file:

services:
  file-server:
    image: phillezi/tinyhttpfileserver:latest
    environment:
      KTHCLOUD_CORES: 0.1
      KTHCLOUD_RAM: 0.1
      KTHCLOUD_VISIBILITY: auth
      KTHCLOUD_HEALTH_PATH: "/"
    ports:
      - "8080:8080"
    volumes:
      - "./testpath:/static"

  log-test-app1:
    image: phillezi/litelogger:latest
    environment:
      KTHCLOUD_CORES: 0.1
      KTHCLOUD_RAM: 0.1
      KTHCLOUD_VISIBILITY: private
    depends_on:
      - file-server

  log-test-app2:
    image: phillezi/litelogger:latest
    environment:
      KTHCLOUD_CORES: 0.1
      KTHCLOUD_RAM: 0.1
      KTHCLOUD_VISIBILITY: private
    depends_on: [log-test-app1]

  log-test-app3:
    image: phillezi/litelogger:latest
    environment:
      KTHCLOUD_CORES: 0.1
      KTHCLOUD_RAM: 0.1
      KTHCLOUD_VISIBILITY: private

Note

The above example showcases what is supported but does not provide a functional application. You need to have the ./testpath in your cwd.

The tool will create four deployments and set up their environment variables, port, start commands and persistent storage.

Installation

Download and install binary

Mac and Linux

For Mac and Linux, there is an installation script that can be run to install the CLI.

Prerequisites

• bash
• curl

curl -fsSL https://raw.githubusercontent.com/Phillezi/kthcloud-cli/main/scripts/install.sh | bash

Check out what the script does here.

Windows

There is a PowerShell installation script that can be run to install the CLI.

powershell -c "irm https://raw.githubusercontent.com/Phillezi/kthcloud-cli/main/scripts/install.ps1 | iex"

Check out what the script does here.

Build it yourself

Prerequisites

• 
• 
• 

1. Clone the repository:

   git clone https://github.com/Phillezi/kthcloud-cli.git
   cd kthcloud-cli

2. Build the application:

   make

3. Run the application:

   ./bin/kthcloud

Tip

Alternatively you can add it to the PATH to be able to use it globally. The installation script automatically does this.

Commands

Login command

Logs in to kthcloud and retrieves an authentication token, the token gets saved to a file named session.json inside the configuration path. It opens a browser window to let you login through the kthcloud keycloak login page.

Usage of the login command

kthcloud login

Compose command

Parses a docker-compose.yaml, docker-compose.yml or *.docker-compose.yaml file (will prefer kthcloud.docker-compose.yaml/yml) and gives the ability to bring up these services with the specified configuration on kthcloud.

Usage of the compose command

kthcloud compose # lists all options

Compose up command

Brings up the services defined in the Docker Compose file.

Compose down command

Brings down the services defined in the Docker Compose file.

![NOTE] This will not remove the volumes created on the storagemanager.

Compose parse command

Parses a Docker Compose file and prints the Services, Envs, Ports, Commands, Depends on and Volumes. And prints out the resulting deployments (the json used with the REST API).

Update command

Checks for newer releases than the release of the binary running the command. If a newer release is found it will prompt you to install it, (can be bypassed wit the -y flag).

Versions can be selected by passing the -i flag.

Warning

This currently doesnt work as expected on Windows.

Warning

This does not verify against a hash to confirm the integrity of the bibary (yet).

Usage of the update command

kthcloud update

Version command

Displays the version of the binary.

Usage of the version command

kthcloud version

Configuration

The kthcloud-cli uses a configuration file named config.yaml it is located in the configuration directory. You can specify the following fields:

• api-url: The URL of the API endpoint.
• api-token: The api token from kthcloud.
• loglevel: The logging level (info, warn, error, debug) (default "info")
• resource-cache-duration duration: How long resources should be cached when possible (default 1m0s)
• session-path: The filepath where the session should be loaded and saved to (default "~/.config/.kthcloud/session.json")
• zone: The preferred kthcloud zone to use, will use se-flem2 by default

Example config.yaml:

api-url: https://api.example.com
api-token: your-api-key-from-kthcloud
loglevel: error