ClodBlue Connect Command Line Interface

Introduction

The CloudBlue Connect Command Line Interface (CLI) is a unified tool to perform various automation scenarios. With just one tool, you can control multiple Connect modules from the command line and automate them through scripts.

connect-cli allow users to export/synchronize the items of a product to/from an Excel workbook.

Install

Using PIP

To use connect-cli you need a system with python 3.6 or later installed.

    $ pip install --upgrade connect-cli

Binary distributions

A single executable binary distribution is available for windows, linux and mac os x. You can it from the Github Releases page.

To install under linux:

    $ curl -O -J https://github.com/cloudblue/connect-cli/releases/download/21.3/connect-cli_21.3_linux_amd64.tar.gz
    $ tar xvfz connect-cli_21.3_linux_amd64.tar.gz
    $ sudo cp dist/ccli /usr/local/bin/ccli

To install under Mac OS X:

    $ curl -O -J https://github.com/cloudblue/connect-cli/releases/download/21.3/connect-cli_21.3_osx_amd64.tar.gz
    $ tar xvfz connect-cli_21.3_osx_amd64.tar.gz
    $ sudo cp dist/ccli /usr/local/bin/ccli

If your user is not a sudoer, you can copy the ccli executable from the dist directory to a directory of your choice that is listed in the PATH variable.

To install under Windows

Download the windows single executable zipfile from Github Releases, extract it and place it in a folder that is included in your path system variable.

Usage

Add a new account

First of all you need to add an account the connect-cli with the CloudBlue Connect API key.

    $ ccli account add "ApiKey XXXXX:YYYYY"

List configured accounts

To get a list of all configured account run:

    $ ccli account list

Set the current active account

To set the current active account run:

    $ ccli account activate VA-000-000

Remove an account

To remove an account run:

    $ ccli account remove VA-000-000

List available products

To get a list of available products run:

    $ ccli product list

This command will output a list of all products (id and name) available within the current active account. You can also filter the results by adding the --query flag followed by a RQL query. For more information about RQL see the Resource Query Language article in the Connect community documentation portal.

Export a product to Excel

To export a product to Excel run:

    $ ccli product export PRD-000-000-000

This command will generate a excel file named PRD-000-000-000.xlsx in the current working directory.

Synchronize a product from Excel

To synchronize a product from Excel run:

    $ ccli product sync PRD-000-000-000.xlsx

Getting help

To get help about the connect-cli commands type:

    $ ccli --help

License

connect-cli is released under the Apache License Version 2.0.