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 9 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. |
|
Things seem to have gone quiet on this PR. There has been no activity for 60 days, so it will be closed in 14 days if there is still no movement. |
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