You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iggy.apache.org by "ParthibanRajasekaran (via GitHub)" <gi...@apache.org> on 2026/10/03 17:36:23 UTC
[PR] docs: document config environment listing [iggy-website]
ParthibanRajasekaran opened a new pull request, #130:
URL: https://github.com/apache/iggy-website/pull/130
Documents the config environment variable discovery flag added by apache/iggy#4350 for the server, connectors runtime, and MCP server. Covers the <N>, <KEY>, and <FIELD> placeholder semantics and early-exit behavior requested in apache/iggy#4322.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "justinmclean (via GitHub)" <gi...@apache.org>.
justinmclean commented on PR #130:
URL: https://github.com/apache/iggy-website/pull/130#issuecomment-5989365804
Thanks, this matches the code in apache/iggy#4350, and we'll need to wait for that to be merged first. Can you fix your description above? It's hiding some content due to the presence of the characters "<" and ">".
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "ParthibanRajasekaran (via GitHub)" <gi...@apache.org>.
ParthibanRajasekaran commented on PR #130:
URL: https://github.com/apache/iggy-website/pull/130#issuecomment-6120311277
Thanks @justinmclean, addressed. I moved `--list-config-env-vars` below the existing startup flags, removed the redundant MCP wording, and fixed the PR description so the placeholders render correctly. I also rebased onto the latest main and verified the typecheck and documentation links. Could you take another look when you have time?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "justinmclean (via GitHub)" <gi...@apache.org>.
justinmclean commented on code in PR #130:
URL: https://github.com/apache/iggy-website/pull/130#discussion_r4181268446
##########
content/docs/server/configuration.mdx:
##########
@@ -65,10 +67,11 @@ Five values are secret-flagged: `http.jwt.encoding_secret`, `http.jwt.decoding_s
## Command-line flags
-`iggy-server` accepts these three startup options, plus `--help` (`-h`) and `--version` (`-V`):
+`iggy-server` accepts these four startup options, plus `--help` (`-h`) and `--version` (`-V`):
| Flag | Description |
|------|-------------|
+| `--list-config-env-vars` | Print the supported configuration environment-variable names and templates, then exit without starting the server. See [Environment variables](#environment-variables). |
| `--fresh`, `-f` | Delete the configured data directory (`local_data` by default, see `IGGY_PATH`) before boot and start on empty state. In cluster mode this wipes **this replica only**; it rejoins and refills by state transfer from the others. Wiping a quorum at the same time can destroy committed data. Do not put `--fresh` in a service unit: it would re-transfer the whole dataset on every restart. |
Review Comment:
Probably better if this comes later after the startup flags
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "justinmclean (via GitHub)" <gi...@apache.org>.
justinmclean commented on code in PR #130:
URL: https://github.com/apache/iggy-website/pull/130#discussion_r4181276644
##########
content/docs/ai/mcp.mdx:
##########
@@ -80,6 +80,10 @@ The configuration file must be in the `toml` format. By default, the server look
Each setting can also be overridden using `IGGY_MCP_<SECTION>_<KEY>`, for example `IGGY_MCP_IGGY_USERNAME` or `IGGY_MCP_HTTP_ADDRESS`. Nested settings use the same underscore convention, such as `IGGY_MCP_IGGY_TLS_ENABLED`. Set `IGGY_MCP_ENV_PATH` to load a particular dotenv file; otherwise `.env` is searched for in the current directory and its parents. Existing environment variables take precedence over dotenv values.
+Run `iggy-mcp --list-config-env-vars` to print every supported MCP configuration variable and exit before loading dotenv or configuration files or creating the Tokio runtime. The output is sorted and contains names only. If a configuration field is an indexed vector, its template uses `<N>` for indices from `0` through `255`; whole-value vectors are listed once without a placeholder.
+
+`iggy-mcp` rejects unknown command-line arguments with exit code 2. Keep client and container argument lists empty unless they contain a supported flag.
+
Review Comment:
This is a bit circular. Something like "MCP clients and containers must not pass unknown arguments," and even that may be redundant.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "justinmclean (via GitHub)" <gi...@apache.org>.
justinmclean commented on code in PR #130:
URL: https://github.com/apache/iggy-website/pull/130#discussion_r4181268446
##########
content/docs/server/configuration.mdx:
##########
@@ -65,10 +67,11 @@ Five values are secret-flagged: `http.jwt.encoding_secret`, `http.jwt.decoding_s
## Command-line flags
-`iggy-server` accepts these three startup options, plus `--help` (`-h`) and `--version` (`-V`):
+`iggy-server` accepts these four startup options, plus `--help` (`-h`) and `--version` (`-V`):
| Flag | Description |
|------|-------------|
+| `--list-config-env-vars` | Print the supported configuration environment-variable names and templates, then exit without starting the server. See [Environment variables](#environment-variables). |
| `--fresh`, `-f` | Delete the configured data directory (`local_data` by default, see `IGGY_PATH`) before boot and start on empty state. In cluster mode this wipes **this replica only**; it rejoins and refills by state transfer from the others. Wiping a quorum at the same time can destroy committed data. Do not put `--fresh` in a service unit: it would re-transfer the whole dataset on every restart. |
Review Comment:
Probably better if this comes later after the strtup flags
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: document config environment listing [iggy-website]
Posted by "mmodzelewski (via GitHub)" <gi...@apache.org>.
mmodzelewski merged PR #130:
URL: https://github.com/apache/iggy-website/pull/130
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org