W-23492639-ch1-application-API-kt

[kevintroller]

Summary

Documents two new optional JVM tuning fields on the CloudHub 1.0 Application REST API (v2), added under a new JVM Tuning Fields section in cloudhub-api.adoc:

• openJvmPackagesForArrow — nullable Boolean (default false). When true, the worker starts with --add-opens=java.base/java.nio=ALL-UNNAMED and -Dmule.module.tweaking.validation.skip=true to enable Apache Arrow JDBC drivers on Java 17. Includes the security note (widened reflective access), deprecation note (transitional; removed after Module Layer Propagation), a field-semantics table, and POST/GET samples.
• gcMethod — nullable String (default null). Per-app GC selection: Serial, Parallel, or G1 (case-insensitive); any other value returns HTTP 400. Includes the input/canonical/JVM-flag table, per-workload guidance, the wrapper.conf ParallelGC baseline note, a field-semantics table, and POST/PUT/GET samples.

Both fields require a worker replacement (redeploy, restart, or scaling event) to take effect.

GUS: W-23492639

Sources

• GUS W-23492639 — the doc request; full field spec in Details__c
• Engineering spec canvas (CH1.txt) referenced by the ticket — JVM flags, semantics tables, canonical GC forms, AMI/wrapper.conf baseline, and sample payloads
• Referenced but not independently verified: Slack canvas/thread (F0BJ3LJRMEC) and implementing stories W-23245558 and W-23344407

Open items for reviewers

• Placement is on the narrative cloudhub-api.adoc page (vs. the cloudhub-api-reference.adoc endpoint table).
• No availability/version gate added; feature is planned for an August release.
• ADR-MULE-#072 is kept verbatim from the ticket — confirm whether that internal reference should stay in customer-facing docs.

Test plan

• Verify the page builds in the Antora site
• Review rendered tables and JSON samples
• Confirm field details against the implementing stories

Made with Cursor