Tools: unitc YAML mode.
Added --format option to manage configuration in other formats. Initially, YAML is the only supported conversion format. JSON/YAML conversion is performed with yq(1). Suggested by: Torstein Krause Johansen <https://github.com/skybert> Closes: #958 <https://github.com/nginx/unit/issues/958>
This commit is contained in:
@@ -37,12 +37,16 @@ web page with NGINX Unit.
|
||||
| _HTTP method_ | It is usually not required to specify a HTTP method. `GET` is used to read the configuration. `PUT` is used when making configuration changes unless a specific method is provided.
|
||||
| `edit` | Opens **URI** in the default editor for interactive configuration. The [jq](https://stedolan.github.io/jq/) tool is required for this option.
|
||||
| `INSERT` | A _virtual_ HTTP method that prepends data when the URI specifies an existing array. The [jq](https://stedolan.github.io/jq/) tool is required for this option.
|
||||
| `-f` \| `--format YAML` | Convert configuration data to/from YAML format. The [yq](https://github.com/mikefarah/yq) tool is required for this option.
|
||||
| `-q` \| `--quiet` | No output to stdout.
|
||||
|
||||
Options are case insensitive and can appear in any order. For example, a
|
||||
redundant part of the configuration can be identified by its URI, and
|
||||
followed by `delete` in a subsequent command.
|
||||
|
||||
Options may be combined. For example, `edit -f yaml` will open the
|
||||
configuration URI in a text editor, in YAML format.
|
||||
|
||||
### Local Configuration
|
||||
For local instances of Unit, the control socket is automatically detected.
|
||||
The error log is monitored; when changes occur, new log entries are shown.
|
||||
|
||||
Reference in New Issue
Block a user