maggesandClaude Sonnet 5
7f6fcb9166
Root cause of a fresh-install "cannot reach the Podman API socket" report (a friend's Unraid box, cache pool present and mounted): unlike Docker-for-Unraid's docker.img path, this plugin never auto-created STORAGE_PATH itself — only podman.img inside it. A perfectly normal, already-mounted cache pool still failed preflight/storage-create with "does not exist", just because its own .../system/podman subdirectory had never been created. Fixed by walking up to the nearest existing ancestor and checking whether it's on a different device than / (real mount vs. nothing mounted at all) — see podman-common.sh's new podman_path_has_real_mount_ancestor(), used by both podman-preflight.sh and podman-storage.sh. Settings gets a "Podman Service" card (status chip + Start/Restart, backed by new ajax/settings.php service_status/start/restart actions that just shell out to rc.podman) so a fresh install that failed to start can be diagnosed and retried without SSH/terminal access at all — exactly what was missing when this was first needed live. Also adds "Format a Disk for Podman Storage" (new ajax/disks.php) for a single-disk system with no cache pool at all. Only ever lists disks with literally no existing partition/filesystem/RAID-or-ZFS-membership signature and that aren't Unraid's boot flash — found live, twice, during development: the boot USB (FAT, labeled "UNRAID") passed the initial mounted-only check because this host's /boot is backed by a ZFS dataset rather than a direct partition mount, and active RAID-member cache disks passed a data-vs-blank *warning* rather than a hard exclusion. Both are now excluded outright, not just flagged — see disks.php's device_or_children_labeled_unraid() and the hasData exclusion in list_candidate_disks(). A disk formatted this way is remounted by UUID on every boot via a new plugin/sbin/podman-mount-managed-disk.sh, called from plugin/event/disks_mounted before rc.podman start. Unrelated fix bundled in: scripts/lib/slackbuild-common.sh now sets SOURCE_DATE_EPOCH (derived from the repo's last commit) before calling makepkg, so two separate builds of the same commit produce byte-identical .txz files — makepkg already supports this (`--clamp-mtime` when $SOURCE_DATE_EPOCH is set, confirmed by reading a real host's /sbin/makepkg) but nothing was setting the variable, so release.yml's "rebuild in CI and verify it matches the committed checksums" step was guaranteed to fail on the first package it checked alphabetically (observed live: aardvark-dns). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
337 lines
16 KiB
Plaintext
337 lines
16 KiB
Plaintext
Menu="Tasks:66"
|
|
Type="xmenu"
|
|
Tabs="false"
|
|
Title="Podman"
|
|
Icon="podman"
|
|
---
|
|
<?php
|
|
/**
|
|
* Podman.page — Unraid Dynamix-style GUI page for unraid-podman.
|
|
*
|
|
* This file only renders the page shell: the header, the sub-navigation
|
|
* for the ten sections, and one (mostly empty) container per panel. Every
|
|
* panel fills itself in via AJAX after load — see javascript/app.js's
|
|
* router and each javascript/<panel>.js module — so this file has no
|
|
* business logic of its own and does not talk to PodmanClient directly.
|
|
* See docs/ARCHITECTURE.md section 18 for the overall WebUI design and
|
|
* webui/mockups/prototype.html for the approved visual reference this
|
|
* page's markup mirrors (same structure, same CSS classes, real data
|
|
* instead of static samples).
|
|
*/
|
|
|
|
/**
|
|
* Cache-busts every static asset with its own on-disk mtime. Unraid's
|
|
* webserver sends no explicit no-cache headers for /plugins/ static
|
|
* files, so without this, browsers can keep serving a stale app.js/
|
|
* podman.css for a long time after a plugin update — verified live: a
|
|
* bugfix to app.js's CSRF handling silently kept failing in a real
|
|
* browser after redeploy until this was added, even though the deployed
|
|
* file on disk was byte-for-byte correct.
|
|
*/
|
|
function podman_asset_version(string $relPath): string
|
|
{
|
|
$full = __DIR__ . $relPath;
|
|
return is_file($full) ? (string) filemtime($full) : '0';
|
|
}
|
|
?>
|
|
<link rel="stylesheet" type="text/css" href="/plugins/podman/styles/podman.css?v=<?=podman_asset_version('/styles/podman.css')?>">
|
|
|
|
<div class="podman-plugin">
|
|
|
|
<header class="podman-pagehead">
|
|
<div class="titlewrap">
|
|
<div class="icon" aria-hidden="true">
|
|
<svg width="20" height="20" viewBox="0 0 24 24" fill="none"><path d="M12 2l8 4.5v9L12 20l-8-4.5v-9L12 2z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/><path d="M12 11l8-4.5M12 11v9M12 11L4 6.5" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/></svg>
|
|
</div>
|
|
<div>
|
|
<h1>Podman</h1>
|
|
<div class="meta" id="podman-header-meta">Connecting…</div>
|
|
</div>
|
|
</div>
|
|
<div style="display:flex; gap:8px;">
|
|
<button class="podman-btn" id="podman-refresh-all">↻ Refresh</button>
|
|
</div>
|
|
</header>
|
|
|
|
<nav class="podman-subnav">
|
|
<button class="active" data-panel="dashboard">Dashboard</button>
|
|
<button data-panel="containers">Containers</button>
|
|
<button data-panel="templates">Templates</button>
|
|
<button data-panel="pods">Pods</button>
|
|
<button data-panel="images">Images</button>
|
|
<button data-panel="volumes">Volumes</button>
|
|
<button data-panel="networks">Networks</button>
|
|
<button data-panel="logs">Logs</button>
|
|
<button data-panel="terminal">Terminal</button>
|
|
<button data-panel="compose">Compose</button>
|
|
<button data-panel="settings">Settings</button>
|
|
</nav>
|
|
|
|
<main class="podman-main">
|
|
|
|
<!-- ============================= DASHBOARD ============================= -->
|
|
<section class="podman-panel active" id="podman-panel-dashboard">
|
|
<div class="podman-grid podman-stat-grid">
|
|
<div class="podman-stat"><div class="label">Running</div><div class="value tnum"><span id="stat-running">—</span> <small id="stat-running-total"></small></div></div>
|
|
<div class="podman-stat"><div class="label">Pods</div><div class="value tnum" id="stat-pods">—</div></div>
|
|
<div class="podman-stat"><div class="label">Images</div><div class="value tnum" id="stat-images">—</div></div>
|
|
<div class="podman-stat"><div class="label">Volumes</div><div class="value tnum" id="stat-volumes">—</div></div>
|
|
<div class="podman-stat"><div class="label">Networks</div><div class="value tnum" id="stat-networks">—</div></div>
|
|
<div class="podman-stat"><div class="label">Images on Disk</div><div class="value tnum" id="stat-images-size">—</div></div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= CONTAINERS ============================= -->
|
|
<section class="podman-panel" id="podman-panel-containers">
|
|
<div class="podman-card">
|
|
<div class="podman-toolbar">
|
|
<input class="podman-search" id="containers-search" type="text" placeholder="Search containers by name or image…">
|
|
<div class="podman-segmented" id="containers-filterset">
|
|
<button class="active" data-filter="all" id="containers-count-all">All</button>
|
|
<button data-filter="running" id="containers-count-running">Running</button>
|
|
<button data-filter="stopped" id="containers-count-stopped">Stopped</button>
|
|
</div>
|
|
<button class="podman-btn podman-btn-primary" id="containers-check-updates-btn" style="margin-left:auto;">Check for Updates</button>
|
|
<button class="podman-btn podman-btn-primary" id="containers-update-all-btn">Update All</button>
|
|
<button class="podman-btn podman-btn-primary" id="containers-create-btn">+ New Container</button>
|
|
</div>
|
|
<div class="podman-table-wrap">
|
|
<table>
|
|
<thead><tr><th>Status</th><th>Name</th><th>Image</th><th>CPU/Mem</th><th>Ports</th><th>Uptime</th><th></th></tr></thead>
|
|
<tbody id="containers-tbody"></tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= TEMPLATES ============================= -->
|
|
<section class="podman-panel" id="podman-panel-templates"></section>
|
|
|
|
<!-- ============================= PODS ============================= -->
|
|
<section class="podman-panel" id="podman-panel-pods"></section>
|
|
|
|
<!-- ============================= IMAGES ============================= -->
|
|
<section class="podman-panel" id="podman-panel-images">
|
|
<div class="podman-card">
|
|
<div class="podman-toolbar">
|
|
<input class="podman-search" type="text" placeholder="Search images…" disabled title="Client-side filtering not yet wired up for Images">
|
|
<button class="podman-btn" id="images-prune-btn" style="margin-left:auto;">Prune unused</button>
|
|
<button class="podman-btn" id="images-pull-btn">⬇ Pull Image</button>
|
|
</div>
|
|
<div class="podman-table-wrap">
|
|
<table>
|
|
<thead><tr><th>Repository</th><th>Tag</th><th>Image ID</th><th>Size</th><th>Created</th><th>Used By</th><th></th></tr></thead>
|
|
<tbody id="images-tbody"></tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= VOLUMES ============================= -->
|
|
<section class="podman-panel" id="podman-panel-volumes">
|
|
<div class="podman-card">
|
|
<div class="podman-toolbar">
|
|
<div style="flex:1;"></div>
|
|
<button class="podman-btn podman-btn-primary" id="volumes-create-btn">+ New Volume</button>
|
|
</div>
|
|
<div class="podman-table-wrap">
|
|
<table>
|
|
<thead><tr><th>Name</th><th>Driver</th><th>Mountpoint</th><th>Used By</th><th></th></tr></thead>
|
|
<tbody id="volumes-tbody"></tbody>
|
|
</table>
|
|
</div>
|
|
<div class="podman-empty-note" style="border-top:1px solid var(--border); text-align:left; padding:12px 18px;">
|
|
App data mapped from Unraid shares (e.g. <span class="mono">/mnt/user/appdata/…</span>) is managed as bind mounts per-container and does not appear here.
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= NETWORKS ============================= -->
|
|
<section class="podman-panel" id="podman-panel-networks">
|
|
<div class="podman-card">
|
|
<div class="podman-toolbar">
|
|
<div style="flex:1;"></div>
|
|
<button class="podman-btn podman-btn-primary" id="networks-create-btn">+ New Network</button>
|
|
</div>
|
|
<div class="podman-table-wrap">
|
|
<table>
|
|
<thead><tr><th>Name</th><th>Driver</th><th>Subnet</th><th>Gateway</th><th>Containers</th><th></th></tr></thead>
|
|
<tbody id="networks-tbody"></tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= LOGS ============================= -->
|
|
<section class="podman-panel" id="podman-panel-logs">
|
|
<div class="podman-card">
|
|
<div class="podman-logs-layout">
|
|
<div class="podman-logs-side" id="logs-sidebar"></div>
|
|
<div>
|
|
<div class="podman-toolbar">
|
|
<input class="podman-search" id="logs-filter" type="text" placeholder="Filter log output…" style="max-width:280px;">
|
|
<span class="podman-segmented" id="logs-follow-toggle">
|
|
<button class="active" data-follow="true">Follow</button>
|
|
<button data-follow="false">Paused</button>
|
|
</span>
|
|
</div>
|
|
<div class="podman-log-pane" id="log-pane" role="log"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= TERMINAL ============================= -->
|
|
<section class="podman-panel" id="podman-panel-terminal">
|
|
<div class="podman-card">
|
|
<div class="podman-card-head"><h2>Live Terminal</h2></div>
|
|
<div class="podman-card-pad">
|
|
<div class="podman-term-launcher">
|
|
<label>Container <select class="podman-term-select" id="term-container-select"></select></label>
|
|
<label>Shell
|
|
<select class="podman-term-select" id="term-shell-select">
|
|
<option value="bash" selected>bash</option>
|
|
<option value="sh">sh</option>
|
|
</select>
|
|
</label>
|
|
<button class="podman-btn podman-btn-primary" id="term-open-btn">▶ Open Terminal</button>
|
|
<button class="podman-btn podman-btn-ghost podman-btn-danger" id="term-disconnect-btn" disabled>■ Disconnect</button>
|
|
</div>
|
|
<div id="term-frame-wrap">
|
|
<p class="podman-empty-note">Pick a running container and click "Open Terminal" — the same live, fully interactive terminal Unraid's own Docker "Console" button opens (arrow-key history, tab completion, vim, etc. all work).</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= COMPOSE ============================= -->
|
|
<section class="podman-panel" id="podman-panel-compose">
|
|
<div class="podman-card">
|
|
<div class="podman-compose-layout">
|
|
<div class="podman-compose-side">
|
|
<div class="podman-toolbar" style="border-bottom:1px solid var(--border); padding:10px;">
|
|
<button class="podman-btn podman-btn-primary" id="compose-new-btn" style="width:100%; justify-content:center;">+ New Project</button>
|
|
</div>
|
|
<div id="compose-sidebar"></div>
|
|
</div>
|
|
<div>
|
|
<div class="podman-toolbar">
|
|
<strong id="compose-title" style="flex:1;">—</strong>
|
|
<button class="podman-btn podman-btn-ghost podman-btn-danger" id="compose-action-delete">Delete</button>
|
|
<button class="podman-btn" id="compose-action-pull">⬇ Pull</button>
|
|
<button class="podman-btn" id="compose-action-down">■ Down</button>
|
|
<button class="podman-btn podman-btn-primary" id="compose-action-up">▶ Up</button>
|
|
<button class="podman-btn podman-btn-primary" id="compose-action-save">Save</button>
|
|
</div>
|
|
<textarea class="podman-yaml podman-yaml-editor mono" id="compose-yaml" spellcheck="false"></textarea>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<!-- ============================= SETTINGS ============================= -->
|
|
<section class="podman-panel" id="podman-panel-settings">
|
|
<div class="podman-settings-actions">
|
|
<span class="hint" id="settings-save-hint">Changes to storage/enabled/timeout need <span class="mono">rc.podman restart</span> to take effect.</span>
|
|
<button class="podman-btn podman-btn-primary" id="settings-save-btn">Save Settings</button>
|
|
</div>
|
|
<div class="podman-grid">
|
|
<div class="podman-card">
|
|
<div class="podman-card-head">
|
|
<div><h2>Podman Service</h2><div class="sub">Start, restart, or check the podman.sock backend — no terminal needed.</div></div>
|
|
</div>
|
|
<div class="podman-card-pad">
|
|
<div class="podman-service-row">
|
|
<span class="podman-chip podman-chip-neutral" id="settings-service-chip"><span class="d"></span>Checking…</span>
|
|
<button class="podman-btn" id="settings-service-status-btn">Refresh Status</button>
|
|
<button class="podman-btn podman-btn-primary" id="settings-service-start-btn">▶ Start Podman</button>
|
|
<button class="podman-btn" id="settings-service-restart-btn">↻ Restart Podman</button>
|
|
</div>
|
|
<div class="podman-log-pane" id="settings-service-log" style="display:none;"></div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="podman-card">
|
|
<div class="podman-card-head">
|
|
<div><h2>Storage</h2><div class="sub">Where podman keeps images, containers and volumes on disk.</div></div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label for="settings-storage-path">Storage path</label>
|
|
<div>
|
|
<input type="text" id="settings-storage-path" class="mono">
|
|
<div class="hint">Cache pool or dedicated disk — never a path under /mnt/user (FUSE).</div>
|
|
</div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label>No cache pool?</label>
|
|
<div>
|
|
<button class="podman-btn" id="settings-format-disk-btn">Format a Disk for Podman Storage…</button>
|
|
<div class="hint">Formats an unused disk with XFS and mounts it, for a single-disk system with no cache pool set up yet.</div>
|
|
</div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label for="settings-storage-size">podman.img size</label>
|
|
<div>
|
|
<div class="podman-input-suffix"><input type="number" id="settings-storage-size" min="1"> <span>GB</span></div>
|
|
<div class="hint">Overlay filesystem image size. Only applies the first time podman initializes storage at this path.</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="podman-card">
|
|
<div class="podman-card-head">
|
|
<div><h2>Autostart & Lifecycle</h2><div class="sub">What runs when the array starts, and how containers shut down.</div></div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label for="settings-enabled">Start podman on array start</label>
|
|
<div>
|
|
<label class="podman-switch">
|
|
<input type="checkbox" id="settings-enabled"><span class="podman-switch-track"><span class="podman-switch-thumb"></span></span>
|
|
</label>
|
|
</div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label for="settings-stop-timeout">Container stop timeout</label>
|
|
<div>
|
|
<div class="podman-input-suffix"><input type="number" id="settings-stop-timeout" min="0"> <span>seconds</span></div>
|
|
<div class="hint">Grace period before a stop/restart escalates to SIGKILL.</div>
|
|
</div>
|
|
</div>
|
|
<div class="podman-field-row">
|
|
<label>Autostart order</label>
|
|
<div>
|
|
<div class="podman-table-wrap">
|
|
<table>
|
|
<thead><tr><th>#</th><th>Container</th><th></th></tr></thead>
|
|
<tbody id="autostart-tbody"></tbody>
|
|
</table>
|
|
</div>
|
|
<div class="hint">Saved immediately on reorder/remove — no separate save step.</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="podman-card">
|
|
<div class="podman-card-head">
|
|
<div><h2>Installed Packages</h2><div class="sub">Versions currently installed on this system.</div></div>
|
|
</div>
|
|
<div class="podman-card-pad">
|
|
<div class="podman-version-chips" id="settings-package-versions">—</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
</main>
|
|
</div>
|
|
|
|
<?php
|
|
foreach ([
|
|
'app', 'dashboard', 'containers', 'templates', 'pods', 'images', 'volumes',
|
|
'networks', 'logs', 'terminal', 'compose', 'settings',
|
|
] as $podmanJsModule) {
|
|
$podmanJsPath = "/javascript/{$podmanJsModule}.js";
|
|
echo '<script src="/plugins/podman' . $podmanJsPath . '?v=' . podman_asset_version($podmanJsPath) . '"></script>' . "\n";
|
|
}
|
|
?>
|