• website: https://www.ucloud.cn/

The ucloud-cli provides a unified command line interface to manage Ucloud services. It works through Golang SDK based on UCloud OpenAPI and support Linux, macOS, and Windows.

The easiest way to install ucloud-cli is to use home-brew for Linux and macOS users. This will install the package as well as all dependencies.

$ brew install ucloud

If you have the ucloud-cli installed and want to upgrade to the latest version you can run:

$ brew upgrade ucloud

Note

If you come across error during the installation via home-brew, you may update the management package first.

$ brew update

Build from the source code

For windows users, suggest build from the source code which require install Golang first. This also works for Linux and macOS.

$ mkdir -p $GOPATH/src/github.com/ucloud
$ cd $GOPATH/src/github.com/ucloud
$ git clone https://github.com/ucloud/ucloud-cli.git
$ cd ucloud-cli
$ make install

The ucloud-cli include command completion feature and need configure it manually. Add following scripts to ~/.bash_profile or ~/.bashrc

complete -C /usr/local/bin/ucloud ucloud

Zsh shell please add following scripts to ~/.zshrc

autoload -U +X bashcompinit && bashcompinit
complete -F /usr/local/bin/ucloud ucloud

Run the command to get started and configure ucloud-cli follow the steps. The public & private keys will be saved automatically and locally to directory ~/.ucloud. You can delete the directory whenever you want.

$ ucloud init

To reset the configurations, run the command:

$ ucloud config

To learn the usage and flags, run the command:

$ ucloud help

Taking create uhost in Nigeria (region: air-nigeria) and bind a public IP as an example, then configure GlobalSSH to accelerate the SSH efficiency beyond China mainland.

First to create an uhost instance:

$ ucloud uhost create --cpu 1 --memory 1 --password mypassword123 --image-id uimage-fya3qr

UHost:[uhost-tr1eau] created successfully!

Note

Run follow command to get details regarding the parameters to create new uhost instance.

$ ucloud uhost create --help

And suggest run the command to get the image-id first.

$ ucloud image list

Secondly, we're going to allocate an EIP and bind to the instance created above.

$ ucloud eip allocate --line International --bandwidth 1
EIPId:eip-xov13b,IP:152.32.140.92,Line:International 

$ ucloud eip bind --eip-id eip-xov13b --resource-id uhost-tr1eau
EIP: [eip-xov13b] bind with uhost:[uhost-tr1eau] successfully 

Configure the GlobalSSH to the uhost instance and login the instance via GlobalSSH

$ ucloud gssh create --location Washington --target-ip 152.32.140.92
ResourceID: uga-pdhxvs

$ ssh root@152.32.140.92.ipssh.net
root@152.32.140.92.ipssh.net's password: password of the uhost instance