Document --package escape syntax for Maven and delimiter-containing IDs#3145
Document --package escape syntax for Maven and delimiter-containing IDs#3145HuyPhanNguyen wants to merge 8 commits into
Conversation
…elimiter chars. Adds a Maven CLI override section to maven-feeds.md. Version placeholders left for fill-in during PR review.
|
Pull request environment is available at https://stoctodocspr3145.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
…ets to dashes, wrap bare URLs, expand tab-formatted table).
|
Pull request environment is available at https://stoctodocspr3145.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
…nd --package docs.
|
Pull request environment is available at https://stoctodocspr3145.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
…doc updates for FD-135.
|
Pull request environment is available at https://stoctodocspr3145.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
| If the package ID or step name contains a colon, slash, or equals sign (such as Maven coordinates | ||
| like com.example:my-artifact), escape that character with a backslash: | ||
| --package "com.example\:my-artifact:1.0". | ||
| Requires Octopus CLI 2.21.2 or later and Octopus Server 2026.2.10450 or later. |
There was a problem hiding this comment.
Could this fix have been backported to LTS for on-prem customers?
There was a problem hiding this comment.
Backport to 2025.4
There was a problem hiding this comment.
The PR for updating CLI docs is generated by https://github.com/OctopusDeploy/cli/actions/workflows/generate-docs.yml, so these changes will be overwritten by the next run if they aren't reflected in the CLI commands.
Looks like the last run didn't generate a PR.
…4 line as 2025.4.10680.
|
Pull request environment is available at https://stoctodocspr3145.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
3 participants
Documents the new backslash-escape syntax for the
--packageflag, added in cli#584 and supported by the server-side parser in OctopusDeploy#41734.What changed
octopus release create,octopus runbook run, andoctopus runbook snapshot create--packageflag descriptions now mention the\:,\/,\=escape syntax and link the Maven coordinate example.maven-feeds.mdso users hitting the colon-in-package-ID problem land on a working example.Version placeholders
Both
<server-version>and<cli-version>are left as placeholders. Replace before merging once the actual release versions are known:<server-version>→ the Octopus Server release containing FD-135<cli-version>→ the Octopus CLI release containing cli#584Linear: FD-135
Server PR: https://github.com/OctopusDeploy/OctopusDeploy/pull/41734
CLI PR: OctopusDeploy/cli#584
Related issue: OctopusDeploy/cli#547