Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

Clarify unavailable Docker container updates

rcourtman197f9bac5e5e
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index 1a79ba8c03..935255d69d 100644
--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md
+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
@@ -2180,6 +2180,12 @@ and status payloads. Those labels are summary context inside the same strip,
not a replacement status card, CTA band, or page-local nested card.
1. Add shared primitives in `frontend-modern/src/components/shared/`
+ Container update availability and executability are separate facts. When
+ canonical action readiness refuses an update, the shared update control
+ renders a passive `Update available` status with `Apply on host` guidance,
+ never an Update command button. Its hover and keyboard-focus explanation
+ preserves the server refusal and directs the operator to their container
+ manager. In-flight actions retain their audited progress/review state.
Filterable table surfaces that separate high-frequency narrowing from
durable presentation preferences must compose
`frontend-modern/src/components/shared/FilterBar/ViewOptionsDisclosure.tsx`.
diff --git a/frontend-modern/browser-verification/a524ad0120d24f8d.json b/frontend-modern/browser-verification/a524ad0120d24f8d.json
new file mode 100644
index 0000000000..7d5f53a18b
--- /dev/null
+++ b/frontend-modern/browser-verification/a524ad0120d24f8d.json
@@ -0,0 +1,39 @@
+{
+ "version": 1,
+ "base_sha": "8c9c628c28a40d2295cb193cfb6504991bc9b871",
+ "verified_at": "2026-10-08T10:21:05.285Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/shared/ContainerUpdateBadge.tsx",
+ "frontend-modern/src/components/shared/useContainerUpdateButtonState.ts"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/shared/ContainerUpdateBadge.tsx": "e8fa83fb1d65ab587f6e85b5011469fe25512a8ca6d040e6f4dba9d82a5f44ab",
+ "frontend-modern/src/components/shared/useContainerUpdateButtonState.ts": "5c56b2e2eb47084ad0ce62de1814268fa6b9fe129b17f646ba4584cbb7ab7834"
+ },
+ "routes": [
+ "/docker/overview"
+ ],
+ "viewports": [
+ {
+ "width": 1440,
+ "height": 1000
+ },
+ {
+ "width": 900,
+ "height": 900
+ },
+ {
+ "width": 390,
+ "height": 844
+ }
+ ],
+ "states": [
+ "Four unavailable updates; current byparr and sonarr; PBS failed check",
+ "Refusal removed on reload restores enabled Update for one host"
+ ],
+ "interactions": [
+ "Hover, keyboard focus, Escape, status click without planning or row expansion, Tab blur at all three widths",
+ "Reload with changed canonical readiness; enabled Update opens review and Escape closes without approval or execution"
+ ]
+}
diff --git a/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx b/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx
index ed514331ed..8e5019054c 100644
--- a/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx
+++ b/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx
@@ -215,11 +215,21 @@ export const UpdateIcon: Component<UpdateIconProps> = (props) => {
*/
export const UpdateButton: Component<UpdateButtonProps> = (props) => {
const state = useContainerUpdateButtonState(props);
+ const readOnlyUpdateExplanation = () =>
+ `Update available. Pulse cannot apply it: ${state.updateUnavailableReason()}\nApply this update using your container manager on the host.`;
+ const showReadOnlyUpdateExplanation = (target: HTMLElement) => {
+ const rect = target.getBoundingClientRect();
+ showTooltip(readOnlyUpdateExplanation(), rect.left + rect.width / 2, rect.top, {
+ align: 'center',
+ direction: 'up',
+ });
+ };
const shouldRenderReadOnlyStatus = () =>
state.currentState() === 'idle' &&
(hasContainerUpdateError(props.updateStatus) ||
hasContainerUpdateCurrent(props.updateStatus) ||
isContainerUpdatePinned(props.updateStatus) ||
+ state.isUpdateUnavailable() ||
(state.settingsLoaded() && state.shouldHideButton()));
return (
@@ -287,11 +297,40 @@ export const UpdateButton: Component<UpdateButtonProps> = (props) => {
</div>
}
>
- <ContainerUpdateBadge
- updateStatus={props.updateStatus}
- compact={props.compact}
- showCurrent={true}
- />
+ <Show
+ when={hasContainerUpdate(props.updateStatus) && state.isUpdateUnavailable()}
+ fallback={
+ <ContainerUpdateBadge
+ updateStatus={props.updateStatus}
+ compact={props.compact}
+ showCurrent={true}
+ />
+ }
+ >
+ <span
+ class="inline-flex flex-col items-center gap-0.5 text-[11px] text-muted cursor-help focus-visible:outline focus-visible:outline-2 focus-visible:outline-primary"
+ tabindex="0"
+ aria-label={readOnlyUpdateExplanation()}
+ data-prevent-toggle
+ onClick={(event) => {
+ event.stopPropagation();
+ showReadOnlyUpdateExplanation(event.currentTarget);
+ }}
+ onMouseEnter={(event) => showReadOnlyUpdateExplanation(event.currentTarget)}
+ onMouseLeave={() => hideTooltip()}
+ onFocus={(event) => showReadOnlyUpdateExplanation(event.currentTarget)}
+ onBlur={() => hideTooltip()}
+ onKeyDown={(event) => {
+ if (event.key === 'Escape') hideTooltip();
+ }}
+ >
+ <span class="inline-flex items-center gap-1 whitespace-nowrap rounded-full bg-surface-alt px-1.5 py-0.5 font-medium">
+ <ErrorIndicatorIcon class="h-3 w-3" />
+ <span>Update available</span>
+ </span>
+ <span>Apply on host</span>
+ </span>
+ </Show>
</Show>
</Show>
);
diff --git a/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx b/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx
index 835787083b..0761a16a20 100644
--- a/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx
+++ b/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx
@@ -137,7 +137,7 @@ describe('ContainerUpdateBadge', () => {
expect(screen.getByRole('button', { name: /update/i })).toBeInTheDocument();
});
- it('disables the button with the refusal reason when the server refuses the update capability', () => {
+ it('shows update availability and host guidance without an action when the server refuses updates', () => {
render(() => (
<UpdateButton
agentId="agent-1"
@@ -161,11 +161,15 @@ describe('ContainerUpdateBadge', () => {
/>
));
- const button = screen.getByRole('button', { name: /update unavailable/i });
- expect(button).toBeDisabled();
- expect(button.getAttribute('aria-label')).toContain(
+ expect(screen.queryByRole('button')).not.toBeInTheDocument();
+ expect(screen.getByText('Update available')).toBeInTheDocument();
+ expect(screen.getByText('Apply on host')).toBeInTheDocument();
+ const status = screen.getByLabelText(/Pulse cannot apply it/);
+ expect(status.getAttribute('aria-label')).toContain(
'The Pulse agent on this host is still on an older version.',
);
+ fireEvent.click(status);
+ expect(ResourceActionsAPI.planAction).not.toHaveBeenCalled();
});
it('keeps the button enabled when the update readiness entry is available', () => {
diff --git a/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts b/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts
index facab5ad26..714ada7b91 100644
--- a/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts
+++ b/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts
@@ -74,8 +74,8 @@ export function useContainerUpdateButtonState(props: UpdateButtonProps) {
currentState() !== 'idle';
// Server-evaluated refusal for the update capability (agent disconnected,
- // agent too old, stale inventory). Mirrors the lifecycle buttons: render
- // disabled with the reason instead of letting the click fail at plan time.
+ // agent too old, stale inventory). Render a passive update status with the
+ // reason instead of suggesting that Pulse can apply the update.
// Only gates the actionable states; in-flight and settled states keep their
// own presentation.
const updateUnavailableReason = (): string | undefined => {
@@ -209,5 +209,6 @@ export function useContainerUpdateButtonState(props: UpdateButtonProps) {
reviewDetail,
settingsLoaded,
shouldHideButton,
+ updateUnavailableReason,
};
}