DCT Toolkit
Introduction
DCT Toolkit (dct-toolkit) is the command line application specifically designed to interact with a particular DCT instance. It aims to simplify and ease out interacting with DCT instances while making the process intuitive, with minimal configuration and setup. dct-toolkit abstracts all of the API level implementation complexities and provides a user friendly LINUX-like interface, which can be run from any terminal.
Compatibility
dct-toolkit is designed to be compatible with any DCT product version, but is fully supported from DCT version 8.0.0 onwards. While dct-toolkit can be used in testing or development environments against any DCT versions, Delphix highly recommends at least DCT version 8.0.0 for using it in the production environment. Some of the value added features are only supported from DCT 8.0.0 version onwards.
dct-toolkit does not need to be upgraded with every new version of DCT. All of the new APIs that are part of the newer DCT releases will automatically be available in dct-toolkit. This is possible because dct-toolkit reads the api specification from the DCT instance (configurable) it is configured to connect to and dynamically generates the list of commands and their respective options.
New features
Version 1.2.0
--json/-js option
dct-toolkit now supports a--json/-jsoption for all of the commands. If this option is specified, all properties from the DCT response are printed in JSON format. This option is mutually exclusive with the--all-columns/-Aand--columns/-coptions, but can be used along with the--jsonpath/-jpand--expand/-exoptions.--csv/-cs option
dct-toolkit now supports a--csv/-csoption for all of the commands. If this option is specified, all properties from the DCT response are printed in CSV format. This option can be used along with the--columns/-coption only to output particular properties from the DCT response. This option can also be specified along with the--jsonpath/-jpand--expand/-exoptions.This option is only applicable to list API responses where the response is printed in table format by default. For all other APIs that return a single object, this option is ignored.
create_config and encrypt_api_key commands are now interactive
While providing apiKey value in create_config and encrypt_api_key command, there is a risk that plaintext apiKey can leak via shell history. To protect against this, both of these commands are now made interactive. Providing an apiKey interactively does not leak it via shell history. Following examples demonstrates providing apiKey interactively. Once following commands are executed, dct-toolkit will ask and wait for the apiKey to be provided by the user before executing the command.
./dct-toolkit encrypt_api_key dctUrl=<DCT instance URL> apiKey
./dct-toolkit create_config dctUrl=<DCT instance URL> apiKey