This tool allows to execute various operations on uuCloud using CLI.

How to install and update ?

Linux and MacOS

Stable

MONGOMS_DISABLE_POSTINSTALL=1 npm install --registry "https://repo.plus4u.net/repository/npm/" -g uucloud-cli

Beta

MONGOMS_DISABLE_POSTINSTALL=1 npm install --registry "https://repo.plus4u.net/repository/npm/" -g uucloud-cli@beta

Windows

Stable

npm install --registry "https://repo.plus4u.net/repository/npm/" -g uucloud-cli

Beta

npm install --registry "https://repo.plus4u.net/repository/npm/" -g uucloud-cli@beta

How to use ?

uucloud --help
uucloud use --help
uucloud ps --help
uucloud logs --help

How to use not default uuCloud ?

If you have dedicated deployment of uuCloud you must use different uri to access deployment list and logs.

Current version of uucloud-cli supports only specification of different uri for logs via option log-store-uri (see help for more information). For example:

uucloud logs -a browser --log-store-uri="https://libra-sys-ei.plus4u.net/uu-logstore/" -n "ues:DTC-BT[99923616732520257]:LIBRA_DATAFLOW[5c5d4bdce1ada19aba86fdbd]:USY.LIBRAG01.CONFIGURATION[5c5d4efde1ada1405d86fe42]"

How to use presets ?

Presets allows set default values for named preset.

Example of usage from config.json:

{
  "...": "any aother configuration",
  "presents": {
    "libra-int-west": {
      "resourcePool": "ues:DEV0149-BT[84753967820114986]:AWE_USYE.LIBRAM[5cdacf12b338bf708e1b7645]"
    },
    "cams-dev": {
      "resourcePool": "ues:UNI-BT:DEV",
      "authenticationType": "basic",
      "authentication": "vault",
      "user": "camsDevCloudAdmin",
      "c3-uri": "http://mongoa.cams:8080",
      "log-store-uri": "http://apps.cams/usy-logstore-elkbackendg01/79900000000000000000000000000000"
    }
  },
  "...": "any aother configuration"
}

How to use shortcuts ?

Shortcuts allow to replace whole command or part of the command by shortcut commands.

Example of usage from config.json:

{
  "...": "any aother configuration",
  "shortcuts": [
    {
      "shortcut": "p",
      "command": "ps"
    },
    {
      "shortcut": "l",
      "command": "logs"
    },    
    {
      "shortcut": "pp",
      "command": "ps -p cams-prs"
    },    
    {
      "shortcut": "lt",
      "command": "logs -p cams-test -f"
    }
  ],
  "...": "any other configuration"
}

//TODO JDK

Release Notes

0.16.1

bugfix: uuClougLogStoreg02 - fixed obtaining logs from defined interval to list more that first page

0.16.0

add support for uuClougLogStoreg02
add minimal support for logs in uuCloudg02

0.15.0

add support for logs download recovery (--recover flag)

0.14.1

extend ps & commands
- support for using multiple resource pools
add state to ps

0.13.1

bugfix: ensure uuUri query param is encoded

0.13.0

add support for shortcuts

0.12.2

bugfix: ensure that colors in version 1.4.0 is used (https://www.bleepingcomputer.com/news/security/dev-corrupts-npm-libs-colors-and-faker-breaking-thousands-of-apps/)

0.12.1

bugfix: support / in resource pool uri

0.12.0

extend logs command:
- add jsonstream codec
- add criteria option to support server side filtering
- add timeWindowType option to support paging by different time attribute(tmestamp is default)
all non-results texts (such as promp messages or information messages) are now printed to stderr instead of stdout. Only result is printed to stdout and it allows to forexample pipe result of logs command with jsonstream codec directly to jq tool

0.11.0

add support for on-premise uucloud
add option authenticationType to support http basic auth
add authentication option passwordFile and option passwordFile to support authrntication usin g password in same way as uuDevKitg01