pixie-lab 0.1.0__py3-none-any.whl

pixie/web/_templates/machines.html

@@ -0,0 +1,186 @@
+{% extends "layout.html" %}
+{% from "_partials/table_helpers.html" import search_input, sort_header, pagination_inline %}
+{% from "_partials/recent_events.html" import recent_events_card %}
+{% from "_partials/page_description.html" import page_description %}
+{% block title %}Machines - pixie{% endblock %}
+{% block subnav %}
+<nav class="navbar subnav-strip" aria-label="Section sub-navigation">
+    <div class="container">
+        {# LEFT: anchor links to in-page sections. Don't repeat the
+           top-nav label ("Machines"); use section-specific verbs. #}
+        <span class="subnav-jumps d-flex align-items-center flex-wrap">
+            <a href="#list">List</a>
+        </span>
+        {# RIGHT: no inline actions on this page. Bindings are edited
+           per-machine on the detail page. #}
+    </div>
+</nav>
+{% endblock %}
+{% block content %}
+{{ page_description('pc-display', 'Every MAC pixie has seen. A row appears here on the target\'s first PXE contact; the last-seen columns refresh every 5 s while the page is open. Click a MAC to bind its boot mode, edit labels, or inspect the inventory and events for that target.') }}
+<div class="card" id="list">
+    <div class="card-header bg-light fw-semibold d-flex flex-wrap align-items-center gap-3 py-2">
+        <span class="text-nowrap"><i class="bi bi-pc-display me-1"></i>Machines</span>
+        <span class="vr"></span>
+        {{ search_input('/ui/machines', q, preserved, 'MAC / boot mode / sha / last IP') }}
+        {{ pagination_inline(page_state, preserved, label='machines') }}
+    </div>
+    {% if machines %}
+    <div class="table-responsive">
+        <table class="table table-hover align-middle mb-0">
+            <thead class="table-light">
+                <tr>
+                    {{ sort_header('MAC', 'mac', sort, preserved) }}
+                    {{ sort_header('Boot mode', 'boot_mode', sort, preserved) }}
+                    <th scope="col">Image</th>
+                    <th scope="col">Inventory</th>
+                    {{ sort_header('Last seen', 'last_seen_at', sort, preserved) }}
+                    <th scope="col" class="text-end">Actions</th>
+                </tr>
+            </thead>
+            <tbody>
+                {% for m in machines %}
+                <tr data-machine-row="{{ m.mac }}">
+                    <td data-cell="mac-labels">
+                        <a href="/ui/machines/{{ m.mac }}" class="text-decoration-none">
+                            <code>{{ m.mac }}</code>
+                        </a>
+                        {% if m.labels %}
+                        <div class="mt-1">
+                            {% for lbl in m.labels %}
+                            <span class="badge text-bg-light border me-1">{{ lbl }}</span>
+                            {% endfor %}
+                        </div>
+                        {% endif %}
+                    </td>
+                    <td data-cell="boot-mode">
+                        {% if m.boot_mode == 'nbdboot' %}
+                        <span class="badge text-bg-primary">
+                            <i class="bi bi-hdd-network me-1"></i>nbdboot
+                        </span>
+                        {% else %}
+                        <span class="badge text-bg-secondary">
+                            <i class="bi bi-box-arrow-right me-1"></i>{{ m.boot_mode }}
+                        </span>
+                        {% endif %}
+                    </td>
+                    <td data-cell="image">
+                        {% if m.image_content_sha256 %}
+                        <code title="{{ m.image_content_sha256 }}">{{ m.image_content_sha256[:12] }}</code>
+                        {% else %}
+                        <span class="text-muted small">-</span>
+                        {% endif %}
+                    </td>
+                    <td data-cell="inventory">
+                        {% if m.inventory %}
+                        {% set d = m.inventory.get("disks") or [] %}
+                        <span class="small">
+                            <i class="bi bi-hdd me-1"></i>{{ d|length }} disk{{ '' if d|length == 1 else 's' }}
+                        </span>
+                        {% if m.inventory.get("lshw") %}
+                        <span class="text-muted small">+ lshw</span>
+                        {% endif %}
+                        {% else %}
+                        <span class="text-muted small">-</span>
+                        {% endif %}
+                    </td>
+                    <td class="small text-muted" data-cell="last-seen">
+                        {{ m.last_seen_at | fmt_ts }}
+                        {% if m.last_seen_ip %}<br><code>{{ m.last_seen_ip }}</code>{% endif %}
+                    </td>
+                    <td class="text-end text-nowrap">
+                        {# The MAC cell already links to the detail page;
+                           an "open" icon here is redundant. Keep only
+                           the destructive action, which needs its own
+                           control (a confirm-prompt on a link would be
+                           surprising). #}
+                        <form method="post" action="/ui/machines/delete" class="d-inline"
+                              onsubmit="return confirm('Delete machine record for {{ m.mac }}? Inventory + binding will be lost.');">
+                            <input type="hidden" name="mac" value="{{ m.mac }}">
+                            <button type="submit"
+                                    class="btn btn-sm btn-outline-danger"
+                                    title="Delete {{ m.mac }}"
+                                    aria-label="Delete {{ m.mac }}">
+                                <i class="bi bi-trash" aria-hidden="true"></i>
+                            </button>
+                        </form>
+                    </td>
+                </tr>
+                {% endfor %}
+            </tbody>
+        </table>
+    </div>
+    {% else %}
+    <div class="card-body">
+        <p class="text-muted mb-0">
+            <i class="bi bi-inbox me-1"></i>
+            {% if q %}
+            No machines match <code>{{ q }}</code>.
+            {% else %}
+            No machines yet. Machines appear when a PXE-booting target hits
+            <code>/pxe/&lt;mac&gt;</code>; open a machine to edit its binding.
+            {% endif %}
+        </p>
+    </div>
+    {% endif %}
+</div>
+
+<script>
+// Live refresh: every 5 s hit /ui/machines-live.json and update the
+// per-machine cells (boot_mode badge, image sha, inventory count,
+// last_seen_at + IP). Only rows currently on the page get updated
+// (rows on other pagination pages aren't visible; a full poll of
+// them would just churn the state dict). A new MAC that shows up
+// server-side but wasn't rendered here does NOT get injected --
+// pagination + sort would be wrong without a re-render; the
+// operator sees it on their next page load.
+(function () {
+    const POLL_MS = 5000;
+    const rows = document.querySelectorAll("[data-machine-row]");
+    if (!rows.length) return;
+
+    function bootBadge(mode) {
+        if (mode === "nbdboot") {
+            return `<span class="badge text-bg-primary"><i class="bi bi-hdd-network me-1"></i>nbdboot</span>`;
+        }
+        return `<span class="badge text-bg-secondary"><i class="bi bi-box-arrow-right me-1"></i>${mode}</span>`;
+    }
+
+    async function poll() {
+        try {
+            const r = await fetch("/ui/machines-live.json", {credentials: "same-origin"});
+            if (!r.ok) return;
+            const rowsData = await r.json();
+            rows.forEach((tr) => {
+                const mac = tr.getAttribute("data-machine-row");
+                const d = rowsData[mac];
+                if (!d) return;
+                const setCell = (key, html) => {
+                    const cell = tr.querySelector(`[data-cell="${key}"]`);
+                    if (cell && cell.innerHTML !== html) cell.innerHTML = html;
+                };
+                setCell("boot-mode", bootBadge(d.boot_mode));
+                setCell("image", d.image_content_sha256
+                    ? `<code title="${d.image_content_sha256}">${d.image_content_sha256.slice(0,12)}</code>`
+                    : `<span class="text-muted small">-</span>`);
+                let inv;
+                if (d.inventory_at) {
+                    const disks = d.disks_count || 0;
+                    inv = `<span class="small"><i class="bi bi-hdd me-1"></i>${disks} disk${disks === 1 ? "" : "s"}</span>`;
+                    if (d.has_lshw) inv += ` <span class="text-muted small">+ lshw</span>`;
+                } else {
+                    inv = `<span class="text-muted small">-</span>`;
+                }
+                setCell("inventory", inv);
+                let seen = d.last_seen_at_display || d.last_seen_at || "-";
+                if (d.last_seen_ip) seen += `<br><code>${d.last_seen_ip}</code>`;
+                setCell("last-seen", seen);
+            });
+        } catch (e) { /* swallow; try again next tick */ }
+    }
+    poll();
+    setInterval(poll, POLL_MS);
+})();
+</script>
+{{ recent_events_card(machine_events, "machine") }}
+{% endblock %}

pixie/web/_templates/settings.html

@@ -0,0 +1,265 @@
+{% extends "layout.html" %}
+{% from "_partials/page_description.html" import page_description %}
+{% block title %}Settings - pixie{% endblock %}
+{% block subnav %}
+<nav class="navbar subnav-strip" aria-label="Section sub-navigation">
+    <div class="container">
+        <span class="subnav-jumps d-flex align-items-center flex-wrap">
+            <a href="#display">Display</a>
+            <a href="#live-env">Live-env</a>
+            <a href="#deployment">Deployment</a>
+        </span>
+    </div>
+</nav>
+{% endblock %}
+{% block content %}
+{{ page_description('sliders', 'Operator-editable knobs that pixie persists across restarts, alongside the environment variables the deploy consumes at startup. UI edits below win over env-var defaults, so tuning a knob live in the browser does not need a redeploy. Env-var defaults are documented in the Deployment card at the bottom.') }}
+{% if flash_error %}
+<div class="alert alert-danger">
+    <i class="bi bi-exclamation-triangle me-1"></i>{{ flash_error }}
+</div>
+{% endif %}
+
+<div class="card shadow-sm mb-4" id="display">
+    <div class="card-header bg-light fw-semibold d-flex flex-wrap align-items-center gap-3 py-2">
+        <span class="text-nowrap"><i class="bi bi-clock me-1"></i>Display</span>
+        <span class="text-muted small">
+            timezone + strftime pattern for every operator-facing timestamp
+        </span>
+    </div>
+    <div class="card-body">
+        <form method="post" action="/ui/settings/display/edit" class="row g-3">
+            <div class="col-md-6">
+                <label for="timezone" class="form-label">
+                    Display timezone
+                    <span class="badge text-bg-{% if display_tz.override %}primary{% else %}secondary{% endif %} ms-1">
+                        {% if display_tz.override %}override{% elif display_tz.effective != display_tz.default %}env{% else %}default{% endif %}
+                    </span>
+                </label>
+                <input type="text" id="timezone" name="timezone"
+                       class="form-control font-monospace"
+                       value="{{ display_tz.override }}"
+                       placeholder="{{ display_tz.default }}"
+                       list="tz-suggestions">
+                <datalist id="tz-suggestions">
+                    <option value="UTC">
+                    <option value="Europe/Copenhagen">
+                    <option value="Europe/London">
+                    <option value="Europe/Berlin">
+                    <option value="America/New_York">
+                    <option value="America/Los_Angeles">
+                    <option value="Asia/Tokyo">
+                </datalist>
+                <div class="form-text">
+                    IANA timezone name. Blank falls back to
+                    <code>{{ display_tz.env }}</code> then <code>{{ display_tz.default }}</code>.
+                    Currently effective: <code>{{ display_tz.effective }}</code>.
+                    {% if display_tz.updated_at %}
+                    <br>Last updated: <code>{{ display_tz.updated_at | fmt_ts }}</code>.
+                    {% endif %}
+                </div>
+            </div>
+            <div class="col-md-6">
+                <label for="datetime_format" class="form-label">
+                    Datetime format
+                    <span class="badge text-bg-{% if datetime_format.override %}primary{% else %}secondary{% endif %} ms-1">
+                        {% if datetime_format.override %}override{% elif datetime_format.effective != datetime_format.default %}env{% else %}default{% endif %}
+                    </span>
+                </label>
+                <input type="text" id="datetime_format" name="datetime_format"
+                       class="form-control font-monospace"
+                       value="{{ datetime_format.override }}"
+                       placeholder="{{ datetime_format.default }}">
+                <div class="form-text">
+                    Python <code>strftime</code> pattern (e.g.
+                    <code>%Y-%m-%d %H:%M:%S %Z</code>,
+                    <code>%d %b %Y %H:%M</code>). Blank falls back to
+                    <code>{{ datetime_format.env }}</code> then the default.
+                    Currently effective: <code>{{ datetime_format.effective }}</code>.
+                    {% if datetime_format.updated_at %}
+                    <br>Last updated: <code>{{ datetime_format.updated_at | fmt_ts }}</code>.
+                    {% endif %}
+                </div>
+            </div>
+            <div class="col-12">
+                <button type="submit" class="btn btn-primary">
+                    <i class="bi bi-check2 me-1"></i>Save
+                </button>
+                <span class="text-muted small ms-2">
+                    Blank fields CLEAR the override. Env / default takes over.
+                </span>
+            </div>
+        </form>
+    </div>
+</div>
+
+<div class="card shadow-sm mb-4" id="live-env">
+    <div class="card-header bg-light fw-semibold d-flex flex-wrap align-items-center gap-3 py-2">
+        <span class="text-nowrap"><i class="bi bi-cpu me-1"></i>Live-env</span>
+        <span class="text-muted small">
+            per-deploy kernel-cmdline workarounds for hardware quirks
+        </span>
+    </div>
+    <div class="card-body">
+        <form method="post" action="/ui/settings/live-env/edit" class="row g-3">
+            <div class="col-12">
+                <label for="extra_cmdline" class="form-label">
+                    Extra kernel cmdline
+                    <span class="badge text-bg-{% if live_env_extra_cmdline.override %}primary{% else %}secondary{% endif %} ms-1">
+                        {% if live_env_extra_cmdline.override %}override{% elif live_env_extra_cmdline.effective %}env{% else %}default{% endif %}
+                    </span>
+                </label>
+                <input type="text" id="extra_cmdline" name="extra_cmdline"
+                       class="form-control font-monospace"
+                       value="{{ live_env_extra_cmdline.override }}"
+                       placeholder="e.g. pci=realloc=on,nocrs"
+                       list="live-env-cmdline-suggestions">
+                <datalist id="live-env-cmdline-suggestions">
+                    <option value="pci=realloc=on,nocrs">
+                </datalist>
+                <div class="form-text">
+                    Tokens appended verbatim to the <code>pixie-live-env</code>
+                    kernel cmdline (after <code>pixie.mac=</code> /
+                    <code>bty.mac=</code>, so last-token-wins on any
+                    conflict). Whitespace-separated; single line.
+                    Blank falls back to <code>{{ live_env_extra_cmdline.env }}</code>
+                    then no append.
+                    Currently effective:
+                    {% if live_env_extra_cmdline.effective %}
+                        <code>{{ live_env_extra_cmdline.effective }}</code>
+                    {% else %}
+                        <em class="text-muted">(none)</em>
+                    {% endif %}.
+                    Known-good values per hardware in
+                    <a href="https://github.com/safl/pixie/blob/main/docs/src/hardware-quirks.md" target="_blank" rel="noreferrer">docs/hardware-quirks.md</a>.
+                    {% if live_env_extra_cmdline.updated_at %}
+                    <br>Last updated: <code>{{ live_env_extra_cmdline.updated_at | fmt_ts }}</code>.
+                    {% endif %}
+                </div>
+            </div>
+            <div class="col-12">
+                <button type="submit" class="btn btn-primary">
+                    <i class="bi bi-check2 me-1"></i>Save
+                </button>
+                <span class="text-muted small ms-2">
+                    Takes effect on the NEXT <code>GET /pxe/&lt;mac&gt;</code>;
+                    a target already mid-boot must be power-cycled.
+                </span>
+            </div>
+        </form>
+    </div>
+</div>
+
+<div class="card shadow-sm mb-4" id="deployment">
+    <div class="card-header bg-light fw-semibold d-flex flex-wrap align-items-center gap-3 py-2">
+        <span class="text-nowrap"><i class="bi bi-gear-wide-connected me-1"></i>Deployment</span>
+        <span class="text-muted small">
+            environment variables consumed at startup + DHCP handoff
+        </span>
+    </div>
+    <div class="card-body">
+        <p class="text-muted small">
+            Environment variables the pixie process reads at startup.
+            The compose file bundled by <code>pixie deploy</code> sets
+            the important ones from <code>envvars</code>; anything not
+            set falls back to the default in the table. Changes here
+            require a container restart (they are read once at
+            startup), unlike the UI knobs above which are live.
+        </p>
+
+        <div class="table-responsive">
+            <table class="table table-sm mb-0 align-middle">
+                <thead>
+                    <tr>
+                        <th scope="col">Variable</th>
+                        <th scope="col">Default</th>
+                        <th scope="col">Purpose</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    {% for row in deployment_envvars %}
+                    <tr>
+                        <td><code>{{ row.name }}</code></td>
+                        <td>
+                            {% if row.default %}<code>{{ row.default }}</code>
+                            {% else %}<em class="text-muted small">(none)</em>{% endif %}
+                        </td>
+                        <td class="small">{{ row.purpose }}</td>
+                    </tr>
+                    {% endfor %}
+                </tbody>
+            </table>
+        </div>
+
+        <h3 class="h6 fw-semibold mt-4 mb-2">
+            <i class="bi bi-router me-1"></i>Pointing DHCP at pixie
+        </h3>
+        <p class="small mb-2">
+            Pixie chainloads iPXE via TFTP: the DHCP server tells the
+            target's PXE firmware where to fetch the iPXE bootloader,
+            and iPXE then chains to pixie's HTTP endpoint. The two
+            options below cover the common firmware split:
+        </p>
+        <div class="row g-3">
+            <div class="col-md-6">
+                <div class="border rounded p-3 h-100 bg-body-tertiary">
+                    <div class="fw-semibold mb-1">
+                        <i class="bi bi-hdd-network me-1"></i>Legacy BIOS / PXE
+                    </div>
+                    <div class="small text-muted mb-2">
+                        Target boots via PXE ROM. DHCP hands out an
+                        iPXE binary that pixie serves over TFTP;
+                        iPXE re-DHCPs and pixie sees the second
+                        request come in from an iPXE user-class
+                        + chains to <code>/pxe-bootstrap.ipxe</code>.
+                    </div>
+                    <pre class="mb-0 small"><code># dnsmasq
+dhcp-boot=tag:!ipxe,undionly.kpxe,{{ deployment.host }},{{ deployment.host }}
+dhcp-userclass=set:ipxe,iPXE
+dhcp-boot=tag:ipxe,http://{{ deployment.host }}:{{ deployment.port }}/pxe-bootstrap.ipxe</code></pre>
+                </div>
+            </div>
+            <div class="col-md-6">
+                <div class="border rounded p-3 h-100 bg-body-tertiary">
+                    <div class="fw-semibold mb-1">
+                        <i class="bi bi-hdd-network-fill me-1"></i>UEFI
+                    </div>
+                    <div class="small text-muted mb-2">
+                        Target boots via UEFI PXE. Same shape but
+                        the DHCP hand-off must serve an EFI iPXE
+                        binary. Same iPXE user-class re-DHCP dance
+                        lands on <code>/pxe-bootstrap.ipxe</code>.
+                    </div>
+                    <pre class="mb-0 small"><code># dnsmasq
+dhcp-boot=tag:!ipxe,ipxe.efi,{{ deployment.host }},{{ deployment.host }}
+dhcp-userclass=set:ipxe,iPXE
+dhcp-boot=tag:ipxe,http://{{ deployment.host }}:{{ deployment.port }}/pxe-bootstrap.ipxe</code></pre>
+                </div>
+            </div>
+        </div>
+
+        <div class="mt-3 small text-muted">
+            <div>
+                <span class="fw-semibold">TFTP listen:</span>
+                {% if deployment.tftp_enabled %}
+                <code>{{ deployment.tftp_bind }}:{{ deployment.tftp_port }}/udp</code>
+                (root <code>{{ deployment.tftp_root }}</code>)
+                {% else %}
+                <em>disabled</em> (set <code>PIXIE_TFTP_ENABLED=1</code>
+                to bind udp/69)
+                {% endif %}
+            </div>
+            <div>
+                <span class="fw-semibold">Bootstrap URL:</span>
+                <code>http://{{ deployment.host }}:{{ deployment.port }}/pxe-bootstrap.ipxe</code>
+            </div>
+            <div>
+                <span class="fw-semibold">NBD listen:</span>
+                <code>{{ deployment.nbd_bind }}</code> from port
+                <code>{{ deployment.nbd_port_base }}</code> upward
+                (one export per bound nbdboot image)
+            </div>
+        </div>
+    </div>
+</div>
+{% endblock %}