Home

Awesome

Introduction

GitHub release Go Report Card license Go Reference Coverage Status

💡 kusionup is a version management tool for kusion. It is heavily inspired by goup.

📜ī¸ Language

English | įŽ€äŊ“中文

✨ Functional Overview

🛠ī¸ Installation

Binary (Cross-platform: windows, linux, mac ...)

To get the binary just download the latest release for your OS/Arch from the release page and put the binary somewhere convenient.

Homebrew

The KusionStack/tap has macOS and GNU/Linux pre-built binaries available.

First installation:

brew install KusionStack/tap/kusionup && kusionup init

Upgrade:

brew upgrade KusionStack/tap/kusionup

Script

The kusionup can be installed on Linux and macOS with a small install script:

curl -sSf https://raw.githubusercontent.com/KusionStack/kusionup/main/scripts/install.sh | bash

Or:

wget -qO- https://raw.githubusercontent.com/KusionStack/kusionup/main/scripts/install.sh | bash

Windows or otherwise interested users can download binaries directly from the GitHub Releases page.

Build from Source

Starting with Go 1.17, you can install kusionup from source using go install:

go install github.com/KusionStack/kusionup@latest && kusionup init

Docker

Docker users can use the following commands to pull the latest image of the kusionup:

docker pull kusionstack/kusionup:latest

⚡ Usage

$ kusionup init     # Need to run at first execution

$ kusionup ls-ver   # View all installable kusion versions
github@latest
github@v0.4.3
cdn@latest
cdn@v0.4.3

$ kusionup install cdn@latest   # Install the specified kusion version
Downloaded   0.0% (     2426 / 139988826 bytes) ...
Downloaded  11.4% ( 16003466 / 139988826 bytes) ...
Downloaded  21.0% ( 29433014 / 139988826 bytes) ...
Downloaded  32.2% ( 45077686 / 139988826 bytes) ...
Downloaded  41.9% ( 58642898 / 139988826 bytes) ...
Downloaded  51.2% ( 71647010 / 139988826 bytes) ...
Downloaded  61.6% ( 86258486 / 139988826 bytes) ...
Downloaded  71.2% ( 99667706 / 139988826 bytes) ...
Downloaded  81.5% (114078806 / 139988826 bytes) ...
Downloaded  91.5% (128134166 / 139988826 bytes) ...
Downloaded 100.0% (139988826 / 139988826 bytes)
INFO[0053] Unpacking ~/.kusionup/kusion-cdn@latest/kusion-darwin.tgz ... 
INFO[0059] Success: latest downloaded in ~/.kusionup/kusion-cdn@latest 
INFO[0059] Default Kusion is set to 'cdn@latest'

$ kusionup show     # View all installed kusion versions
|    VERSION    | ACTIVE |
|---------------|--------|
|   cdn@latest  |   *    |

For details, please refer to the documentation

🙏 Thanks