Shulou(Shulou.com)06/03 Report--

Up to now, UCloud has provided API SDK in different languages such as Python/Java/Golang. In order to further reduce the manpower input of users in operation and maintenance, a command line tool CLI (Command Line Interface) based on Golang SDK is launched, which provides lightweight API command line invocation and open source in GitHub (https://github.com/ucloud/ucloud-cli). The command-line interaction mode of CLI is more in line with the operation habits of R & D operation and maintenance, and some typical usage scenarios are easier to precipitate and maintain through CLI.

Here are some actual scenarios encountered by users, which can be better solved with CLI. Here is a summary and examples.

Scenario 1: mass creation and deletion of hosts

As a professional distributed database provider, PingCAP needs to create 300 CVMs in batch for distributed business testing when using UCloud. The UCloud console allows a maximum of 10 CVMs to be created at a time, so users need to operate foolishly 30 times. However, the host API can actually support up to 1000 concurrent creations. For one-time API operations, the input-output ratio of taking the time to write a creation script in SDK is very low. This kind of scenario PingCAP is solved through CLI.

An example command for this scenario is as follows:

$ucloud uhost create-cpu 1-memory-gb 2-image-id uimage-xxx-password test123-count 300

Cdn.xitu.io/2019/8/16/16c99c5ff0df8c87?w=640&h=279&f=jpeg&s=19030 ">

(figure: console page host creates up to 10 concurrency at a time)

Scenario 2: centralized management / clean-up of resources, not easy to miss

Users often buy a variety of products, the number of each varies, some of the resources created by temporary needs, often forget to delete in time after use, because the distribution is scattered and difficult to manage, unwittingly spent a lot of money. Users such as X.D. GLOBAL are good at using CLI to quickly create and clean up unused resources.

The example commands are as follows:

$ucloud uhost delete-uhost-id ucloud uhost list-uhost-id-only-page-off

(figure: scattered product resources on the console)

Scenario 3: global dynamic acceleration PathX instance massive port management

In order to improve the player experience, overseas game publishers often use UCloud global dynamic acceleration service PathX to access players in different regions to effectively avoid slow response and packet loss caused by cross-border network congestion.

A game company also uses PathX, but its single line needs to manage more than 60 ports. Method 1, the product must first support 60 port management in the console, and then the user will add configurations to all ports one by one on the page. The second method is for the architect to write a script, and the user adjusts the port through parameter updates. However, with product iterations and API adjustments, script upgrades become a problem, relying heavily on the cooperation of both parties.

(figure: console PathX supports 9-port protocol management)

CLI directly supports PathX multi-port management by settling scenarios like this. The sample code is as follows: # add 80 TCP ports to the line instance resource specified by PathX

$ucloud pathx uga add-port-- uga-id uga-kjkxxx-- protocol tcp-- port 3000-3079Penny 8080

Scenario 4: frequent batch switching of EIP

A user in the information industry will frequently trigger his service to switch public network IP due to the needs of business scenarios. It is a very common practice in the industry to invest R & D manpower to achieve this requirement by script. With UCloud CLI, the goal can be achieved in a lightweight way.

The sample code is as follows: # create an eip and bind it, then unbind and release the previously bound eip

$ucloud ext uhost switch-eip-- create-eip-bandwidth-mb 2-- uhost-id xxx-- unband-all-- release-all

(figure: the console is unbound before binding the new EIP)

The convenience of UCloud CLI

1. Multi-dimensional support command completion function

In terms of command completion, each release of a new version usually requires the end user to generate the completion script again, which is limited in function and expensive to use. Therefore, UCloud CLI extends the functions of the spf13/cobra framework (the relevant code has been open source https://github.com/lixiaojun629/cobra) and integrates the command completion function into the command line tool. Users only need to configure once, and future version upgrades do not have to regenerate the completion script, which is easy to use.

The completion functions include: support command completion, command parameter completion, command parameter value static completion and command parameter value dynamic completion. Aiming at the dynamic completion of command parameter values, in order to reduce the number of calls to API and avoid stutter, UCloud CLI also adds the feature of dynamic completion of local cache.

The code examples of static completion of command parameter values and dynamic completion of command parameter values are shown in the following figure, where the optional values of parameter line BGP and International are static enumerated values fixed in the code, and the optional value of parameter eip-id is obtained from the API request triggered by the Tab key.

(figure: static completion of command parameter values)

(figure: dynamic completion of command parameters)

two。 Command writing is simpler and more efficient.

UCloud CLI supports concurrency and UI multithreaded rendering natively when operating resources in batches, which takes up less system resources than opening the command line of multi-process execution, and the command writing is simpler, reducing the cost of operation and maintenance code. For example, bulk delete host command:

# Command 1

$ucloud uhost list-uhost-id-only | xargs-P 32-I {} ucloud uhost delete-- yes-- uhost-id {}

# Command 2

$ucloud uhost delete-uhost-id ucloud uhost list-uhost-id-only-page-off

It is obvious that Command 2 is simpler and can effectively reduce the code operations of operators.

(figure: UI multithreaded rendering when creating hosts concurrently)

3. Stable and reliable

Because UCloud CLI uses the spf13/cobra command line development framework, it is also the CLI usage framework for famous open source projects such as Docker, Kubernetes and etcd. It is time-tested, stable and reliable.

4. Rich product support

In terms of product support, UCloud CLI already supports common cloud product services such as host, network, storage and database, which can basically meet the daily operation needs of users in most usage scenarios. The list of supported products is shown in the figure below:

(figure: CLI support products)

Running UCloud CLI in Docker

You can also quickly use UCloud CLI in Docker, and you can experience it by following the example steps below.

1. First install Docker and pull the image we have prepared for you: uhub.service.ucloud.cn/ucloudcli/ucloud-cli:0.1.20

$docker pull uhub.service.ucloud.cn/ucloudcli/ucloud-cli:0.1.20

The build script for this image is as follows:

FROM ubuntu:18.04RUN apt-get update & & apt-get install wget-yRUN wget https://github.com/ucloud/ucloud-cli/releases/download/0.1.20/ucloud-cli-linux-0.1.20-amd64.tgzRUN tar-zxf ucloud-cli-linux-0.1.20-amd64.tgz-C / usr/local/bin/RUN echo "complete-C $(which ucloud) ucloud" > > ~ / .bashrc # configuration automatic completion

two。 Execute the following command to start a container with the name ucloud-cli in the image of uhub.service.ucloud.cn/ucloudcli/ucloud-cli:0.1.20:

$docker run-- name ucloud-cli-it-d uhub.service.ucloud.cn/ucloudcli/ucloud-cli:0.1.20

3. Execute the following command to connect to the container ucloud-cli. After the connection is successful, you can start using ucloud-cli. It is recommended that you first execute the ucloud init command to initialize the configuration.

$docker exec-it ucloud-cli bash

Summary

One of the important significance of UCloud CLI is that it can organically combine API and transactions, support the needs of users, present the labor-consuming resource management in a standardized form, and provide users with convenient and flexible product solutions. In the future, UCloud CLI will also help operators get rid of operation problems in more usage scenarios. You are welcome to click on the link to read the original text to download the trial and give feedback. (installation Guide: https://docs.ucloud.cn/software/cli/intro).

Skillfully using command line tool UCloud CLI to manage cloud resources with light operation of API

Event recommendation: at Shanghai's original realm gallery on August 17th, [UCan afternoon Tea-Development and Operation and maintenance of Cloud Native Kubernetes] Technology Salon will invite six senior technical experts to have an in-depth technical discussion and practice case sharing. Welcome to scan the QR code below to sign up!

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.