HDDS-15082. Add User facing Config Contract for ozone local

[henrybear327]

What changes were proposed in this pull request?

Introduce user-facing paremeters for local ozone cluster spin up.

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-15082

How was this patch tested?

Unit tests.

[Copilot]

Pull request overview

Adds an internal ozone local CLI surface and supporting configuration objects to define a user-facing configuration contract for spinning up a local single-node Ozone cluster.

Changes:

• Introduces OzoneLocal (hidden) CLI with run subcommand and env/CLI-based config resolution into LocalOzoneClusterConfig.
• Adds LocalOzoneClusterConfig and LocalOzoneRuntime as the local runtime contract/config model.
• Adds unit tests covering command metadata/help visibility and config parsing/precedence/validation.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
hadoop-ozone/tools/src/main/java/org/apache/hadoop/ozone/local/OzoneLocal.java	New internal CLI entry point and config resolution logic from flags/env vars.
hadoop-ozone/tools/src/main/java/org/apache/hadoop/ozone/local/LocalOzoneClusterConfig.java	New config model + builder + FormatMode parsing for user-facing values.
hadoop-ozone/tools/src/main/java/org/apache/hadoop/ozone/local/LocalOzoneRuntime.java	New runtime interface contract for local single-node runtimes.
hadoop-ozone/tools/src/main/java/org/apache/hadoop/ozone/local/package-info.java	New package documentation for the local runtime support package.
hadoop-ozone/tools/src/test/java/org/apache/hadoop/ozone/local/TestOzoneLocal.java	Tests for CLI metadata, help behavior, and env/CLI precedence + validation errors.
hadoop-ozone/tools/src/test/java/org/apache/hadoop/ozone/local/TestLocalOzoneClusterConfig.java	Tests for builder defaults/overrides and FormatMode parsing.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[peterxcli]

@henrybear327 please merge upstream master, thanks!

[peterxcli]

feel free to request me to for review if you think this is ready, thanks!

[chungen0126]

Thanks @henrybear327 for the patch.

Please consider leveraging PicoCLI's built-in environment variable support (e.g., @option(..., defaultValue = "${env:OZONE_LOCAL_DATANODES:-1}")). This automatically handles type binding and validation for us, which could help remove a lot of boilerplate code in resolveConfig. It might keep the code much cleaner and simpler. See https://picocli.info/#_variables_in_default_values.

[henrybear327]

Thanks @henrybear327 for the patch.

Please consider leveraging PicoCLI's built-in environment variable support (e.g., @option(..., defaultValue = "${env:OZONE_LOCAL_DATANODES:-1}")). This automatically handles type binding and validation for us, which could help remove a lot of boilerplate code in resolveConfig. It might keep the code much cleaner and simpler. See https://picocli.info/#_variables_in_default_values.

Thank you for the feedback! Addressed in the latest commit.

[henrybear327]

feel free to request me to for review if you think this is ready, thanks!

Hi @peterxcli, PTAL :) Thank you!

[peterxcli]

LGTM +1

[peterxcli]

Thanks @henrybear327 for the patch, @chungen0126 for the review!

[henrybear327]

Thanks @henrybear327 for the patch, @chungen0126 for the review!

Thanks @peterxcli and @chungen0126 for the review!