|
1 | 1 | # rabbitmqadmin-ng Change Log |
2 | 2 |
|
3 | | -## v0.30.0 (in development) |
4 | | - |
5 | | -No (documented) changes yet. |
| 3 | +## v2.0.0 (in development) |
| 4 | + |
| 5 | +### Intentionally Restricted Environment Variable Support |
| 6 | + |
| 7 | +Environment variables have a number of serious downsides compared to a `rabbitmqadmin.conf` |
| 8 | +and the regular `--long-options` on the command line: |
| 9 | + |
| 10 | +1. Non-existent support for value types and validation ("everything is a string") |
| 11 | +2. Subprocess inheritance restrictions that can be very time-consuming to debug |
| 12 | +3. Different syntax for setting them between the classic POSIX-era shells (such as `bash`, `zsh`) and modern ones (such as [`nushell`](https://www.nushell.sh/)) |
| 13 | + |
| 14 | +For these reasons and others, `rabbitmqadmin` v2 intentionally uses the configuration file and the |
| 15 | +CLI options over the environment variables. |
| 16 | + |
| 17 | +`rabbitmqadmin` v2 does, however, supports a number of environment variables for a few |
| 18 | +global settings that cannot be configured any other way (besides a CLI option), |
| 19 | +or truly represent an environment characteristic, e.g. either the non-interactive mode |
| 20 | +should be enabled. |
| 21 | + |
| 22 | +These environment variables are as follows: |
| 23 | + |
| 24 | +| Environment variable | Type | When used | Description | |
| 25 | +|--------------------------------------|---------------------------------------------------|---------------------------------------|--------------------------------------------------------------| |
| 26 | +| `RABBITMQADMIN_CONFIG_FILE_PATH` | Local filesystem path | Pre-flight (before command execution) | Same meaning as the global `--confg-file` argument | |
| 27 | +| `RABBITMQADMIN_NON_INTERACTIVE_MODE` | Boolean | Command execution | Enables the non-interactive mode.<br><br>Same meaning as the global `--non-interactive` argument | |
| 28 | +| `RABBITMQADMIN_QUIET_MODE`<br> | Boolean | Command execution | Instructs the tool to produce less output.<br><br>Same meaning as the global `--quiet` argument | |
| 29 | +| `RABBITMQADMIN_NODE_ALIAS` | String | Command execution | Same meaning as the global `--node` argument | |
| 30 | +| `RABBITMQADMIN_TARGET_HOST` | String | Command execution | Same meaning as the global `--host` argument | |
| 31 | +| `RABBITMQADMIN_TARGET_PORT` | Positive integer | Command execution | Same meaning as the global `--port` argument | |
| 32 | +| `RABBITMQADMIN_API_PATH_PREFIX` | String | Command execution | Same meaning as the global `--path-prefix` argument | |
| 33 | +| `RABBITMQADMIN_TARGET_VHOST` | String | Command execution | Same meaning as the global `--vhost` argument | |
| 34 | +| `RABBITMQADMIN_BASE_URI` | String | Command execution | Same meaning as the global `--base-uri` argument | |
| 35 | +| `RABBITMQADMIN_USE_TLS` | Boolean | Command execution | Same meaning as the global `--tls` argument | |
| 36 | +| `RABBITMQADMIN_USERNAME` | String | Command execution | Same meaning as the global `--username` argument | |
| 37 | +| `RABBITMQADMIN_PASSWORD` | String | Command execution | Same meaning as the global `--password` argument | |
| 38 | +| `RABBITMQADMIN_TABLE_STYLE` | Enum, see `--table-style` in `rabbitmqadmin help` | Command execution | Same meaning as the global `--table-style` argument | |
6 | 39 |
|
7 | 40 |
|
8 | 41 | ## v0.29.0 (Mar 23, 2025) |
|
0 commit comments