drg : Drogue cloud command line tool

A Command line tool for managing apps and devices in a drogue cloud instance.

Installation

Download the latest release from the github release page and place it somewhere in your $PATH. Or build from source via crates.io: cargo install drg

Usage

Log in to a drogue cloud instance

In order to use drg to manage resources in drogue cloud you first need to authenticate : drg login https://drogue-cloud-registry-endpoint Then follow the steps to authenticate. drg will ask you to name this new context and generate a config file to save your configuration.

Managing resources

drg interacts with resources existing in drogue-cloud, currently apps and devices operations are supported. The following operations are handled : * create * delete * edit * get

Apps operations

```

Create an app

drg create app

adding data

drg create app -d {"foo":"bar"}

edit an app - this will open an editor.

drg edit app

update an app providing the data

drg edit app -f

Delete an app

drg delete app ```

Devices operations

```

Create a device

drg create device --app # --app and -a are interchangeable

Add some data

drg create device -a -d {"foo":"bar"}

Edit a device data - this will open an editor

drg edit device --app

update a device providing the data

drg edit device -a -f

Delete a device

drg delete device - ```

Configuration file

drg will load cluster settings from the default context of a configuration file. The DRGCFG environment variable can point to a config file location. The default config file location is $HOME/.config/drg_config.yaml. This default value will be used if the environment variable is not set. This location can be overriden with the --config argument : drg --config path/to/config create device <deviceId> --app <appId>

To get a working config file, run see login to a drogue cloud instance

Context management

A valid configuration can contain multiple context allowing you to switch between cluster easily. To create a new context simply log into a cluster with drg login : login to a drogue cloud instance If it's the first context created for this configuration file it will be set as active by default.

To update the active context for a config file : drg context set-active <contextId>

Here are some other commads available to manage contexts : drg context show #will display the whole config file. drg context list drg context set-default-app <appId> #will use active context drg context set-default-app <appId> --context <anotherContextId> drg context delete <contextId> drg context rename <contextId> <newContextId>

context and app can be set with environment variables : DRG_CONTEXT and DRG_APP.

Roadmap

In no particular order here are the following things that we would like to add to drg : * List resources * Trust anchors support * Json patch operations * Other platforms binaries : MacOS and windows.