Skip to content

Commit 3e00b60

Browse files
committed
layout + supported tweaks and clarifications
1 parent 2df938a commit 3e00b60

1 file changed

Lines changed: 17 additions & 5 deletions

File tree

  • src/pages/docs/releases/channels

src/pages/docs/releases/channels/index.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -142,14 +142,26 @@ When **Use most recently published** is selected:
142142

143143
2. Click **Save**.
144144

145-
The **Design rule** dialog isn't available for Most recently published rules — there's no SemVer range to evaluate candidates against. The regex filter determines which candidates qualify; Octopus then picks the candidate with the latest publish date. When two candidates share the same publish timestamp (a rare tie), the SemVer-higher version wins as a deterministic secondary sort.
145+
The **Design rule** dialog isn't available for Most recently published rules — there's no SemVer range to evaluate candidates against. The regex filter determines which candidates qualify; Octopus then picks the candidate with the latest publish date. When two candidates share the same publish timestamp (a rare tie), the higher version wins as a deterministic secondary sort, using Octopus's numeric-aware version comparison rather than a plain alphabetical sort (so `build-10` sorts above `build-9`).
146146

147147
:::div{.hint}
148-
**Feed support.** Most recently published ordering needs the feed to report a publish date per version. It is supported on the built-in NuGet feed, external HTTP and filesystem NuGet feeds, Amazon S3, Google Cloud Storage, Helm, NPM, PyPI, and Artifactory Generic feeds.
148+
**Feed support.** Most recently published ordering needs the feed to report a publish date per version.
149149

150-
It is **not** supported on container or OCI registry feeds (Docker, DockerHub, GitHub Container Registry, Amazon ECR, Google GCR, or any OCI registry) because their tag-listing APIs return tag names only — fetching per-tag dates would require an extra manifest call for every tag. When you choose Most recently published for a step that targets one of these feeds, the channel rule editor warns you.
151-
152-
Other feeds that don't report a publish date — including Maven and GitHub feeds — don't error, but they can't order by publish date either: they silently fall back to version-string ordering. Only use Most recently published with the feed types listed above.
150+
| Feed | Most recently published | Notes |
151+
| --- | --- | --- |
152+
| Built-in NuGet | Supported | |
153+
| External NuGet (HTTP and filesystem) | Supported | |
154+
| Amazon S3 | Supported | |
155+
| Google Cloud Storage | Supported | |
156+
| Helm | Supported | |
157+
| NPM | Supported | |
158+
| PyPI | Supported | |
159+
| Artifactory Generic | Supported | |
160+
| Google Container Registry (GCR) and Google Artifact Registry (GAR) | Supported | Their tag-listing responses include per-tag publish dates, so ordering works automatically. |
161+
| Container / OCI registries — Docker, DockerHub, GitHub Container Registry, Amazon ECR, or any OCI registry | Not supported | Their tag-listing APIs return tag names only; fetching per-tag dates would require an extra manifest call for every tag. The channel rule editor warns you when you choose Most recently published for a step that targets one of these feeds. |
162+
| Maven, GitHub | Not supported (no error) | These feeds don't report a publish date, so they can't order by it — they silently fall back to version-string ordering. |
163+
164+
Only use Most recently published with the feeds listed as supported above.
153165
:::
154166

155167
### Git protection rules {#git-protection-rules}

0 commit comments

Comments
 (0)