Orchestrator Tools 0.43.0 Release Note

Introduction

The Orchestrator Tools simplify the management of the orchestrator.

This release note describes the changes of Orchestrator Tools version 0.43.0 compared to 0.42.0.

Orchestrator Tools 0.43.0 were released on September 27, 2023.

---

New features

• Issue tools #80 Refactor list outputs

  • get workflows
  • get channels
  • get agents
  • get qualitygate
  • get subscriptions

  do not return comma-separated values anymore, but fixed-width columns instead.
  They can also now produce output in YAML (-o yaml) or JSON (-o json), and also report additional information (--output=wide) and specified data (--output=custom-columns=).

• Issue tools #87 Add selectors to 'list' and 'delete' subcommands
  Label selectors (--selector or -l) and field selectors (--field-selector) can now be used on the following opentf-ctl commands:

  • get subscriptions
  • get channels
  • get agents
  • kill workflow (--all option can also be used to kill all running workflows)
  • delete subscription (--all option can also be used to delete all subscriptions)
  • delete agent (--all option can also be used to de-register all running agents)

• Issue tools #81 Improve parameters handling
  opentf-ctl’s sub-command syntax has been relaxed:

  • Options are specifiable in any order, allowing the UUID to be specified last.
  • It is possible to abbreviate the UUIDs.

  Additionally, parameters that should not have been duplicated are now reported.

• Issue tools #83 When generating a token, there is no way to specify an expiration date
  opentf-ctl generate token using now allows specifying an expiration date for the generated token.

• Issue tools #84 opentf-ctl does not generate jwt tokens if the private key has a passphrase
  opentf-ctl generate token using now asks for a passphrase if the specified private key is encrypted.

• Issue tools #85 The name of the Java microservice generating a log message is lost
  In order to facilitate log analysis, the names of the Java microservices are now indicated in the output of opentf-ctl get workflow.

• Issue tools #79 Add more details on custom-columns in --help
  Issue tools #86 Improving online help
  The help messages of opentf-ctl have been slightly completed and cleaned up.