bvandeusen
42f7840c26
Extend the playbook metadata convention with a namespaced `# steward:<key>:` comment block: - steward:category — free-text grouping label, shown as a badge in the browse list and on the run form. - steward:confirm — true/yes/1/on marks a playbook destructive; the run form then requires a confirmation tick (required checkbox in the shared vars fragment) before it can launch. sources.discover_playbook_meta() parses description + category + confirm (first match per key; `# description:` still primary, `# steward:description:` alias). discover_playbook_description() now delegates to it. The browse list reads per-playbook meta to show category badges + descriptions; the run-form and playbook-vars fragments render the badge + confirm gate. Bundled playbooks tagged: docker_prune → category maintenance + confirm true; provision/install/update → category host-agent. Docs: docs/reference/playbook-authoring.md updated (keys now implemented) and a quick reference added next to the code at steward/ansible/PLAYBOOK_CONVENTIONS.md. Tests added for category/confirm/alias parsing. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
101 lines
4.8 KiB
HTML
101 lines
4.8 KiB
HTML
{% extends "base.html" %}
|
|
{% from "_macros.html" import crumbs %}
|
|
{% block title %}Browse Playbooks — Steward{% endblock %}
|
|
{% block breadcrumb %}
|
|
{%- if view_contents is defined -%}
|
|
{{ crumbs([("Ansible", "/ansible/"), ("Browse", "/ansible/browse"), (view_path, "")]) }}
|
|
{%- else -%}
|
|
{{ crumbs([("Ansible", "/ansible/"), ("Browse", "")]) }}
|
|
{%- endif -%}
|
|
{% endblock %}
|
|
{% block content %}
|
|
<div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:1.5rem;">
|
|
<h1 class="page-title" style="margin-bottom:0;">Browse Playbooks</h1>
|
|
<div style="display:flex;gap:0.5rem;">
|
|
{% if session.user_role == 'admin' %}
|
|
<a href="/ansible/playbooks/new" class="btn btn-sm">New playbook</a>
|
|
{% endif %}
|
|
<a href="/ansible/inventory/targets" class="btn btn-ghost btn-sm">Inventory</a>
|
|
<a href="/ansible/schedules" class="btn btn-ghost btn-sm">Schedules</a>
|
|
<a href="/ansible/" class="btn btn-ghost btn-sm">← Run History</a>
|
|
</div>
|
|
</div>
|
|
|
|
{% if view_contents is defined %}
|
|
<div class="card">
|
|
<div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:1rem;">
|
|
<h3 class="section-title">{{ view_path }}</h3>
|
|
<div style="display:flex;gap:0.5rem;">
|
|
{% if view_editable and session.user_role == 'admin' %}
|
|
<a href="/ansible/playbooks/edit/{{ view_source }}/{{ view_path }}" class="btn btn-sm">Edit</a>
|
|
<form method="post" action="/ansible/playbooks/delete" style="display:inline;"
|
|
onsubmit="return confirm('Delete {{ view_path }}?');">
|
|
<input type="hidden" name="source_name" value="{{ view_source }}">
|
|
<input type="hidden" name="playbook_path" value="{{ view_path }}">
|
|
<button type="submit" class="btn btn-sm btn-danger">Delete</button>
|
|
</form>
|
|
{% endif %}
|
|
<a href="/ansible/browse" class="btn btn-ghost btn-sm">← Back to browse</a>
|
|
</div>
|
|
</div>
|
|
<pre style="background:var(--bg);padding:1rem;border-radius:4px;overflow-x:auto;font-size:0.8rem;color:var(--text-muted);max-height:600px;overflow-y:auto;">{{ view_contents }}</pre>
|
|
</div>
|
|
{% endif %}
|
|
|
|
{% if not source_data %}
|
|
{% if view_contents is not defined %}
|
|
<div class="card">
|
|
<p style="color:var(--text-muted);">No Ansible sources configured. <a href="/settings/ansible/">Add sources in Settings → Ansible</a>.</p>
|
|
</div>
|
|
{% endif %}
|
|
{% else %}
|
|
{% for sd in source_data %}
|
|
<div class="card" style="margin-bottom:1.5rem;">
|
|
<div style="display:flex;align-items:center;gap:0.75rem;margin-bottom:1rem;">
|
|
<h3 class="section-title">{{ sd.source.name }}</h3>
|
|
<span style="color:var(--text-muted);font-size:0.8rem;background:var(--bg-elevated);padding:0.2rem 0.5rem;border-radius:3px;">{{ sd.source.type }}</span>
|
|
<span style="color:var(--text-dim);font-size:0.8rem;">{{ sd.source.path }}</span>
|
|
</div>
|
|
|
|
{% if not sd.playbooks %}
|
|
<p style="color:#606080;font-size:0.9rem;">No playbooks found at this path.</p>
|
|
{% else %}
|
|
<table class="table" style="margin-bottom:1rem;">
|
|
<thead>
|
|
<tr>
|
|
<th>Playbook</th>
|
|
<th style="width:120px;"></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
{% for pb in sd.playbooks %}
|
|
<tr>
|
|
<td>
|
|
<div style="display:flex;align-items:center;gap:0.5rem;flex-wrap:wrap;">
|
|
{% if pb.category %}<span style="font-size:0.68rem;text-transform:uppercase;letter-spacing:0.04em;background:var(--bg-elevated);color:var(--text-dim);border-radius:3px;padding:0.05em 0.45em;">{{ pb.category }}</span>{% endif %}
|
|
<span style="font-family:ui-monospace,monospace;font-size:0.88rem;">{{ pb.path }}</span>
|
|
</div>
|
|
{% if pb.description %}<div style="font-size:0.78rem;color:var(--text-muted);margin-top:0.15rem;">{{ pb.description }}</div>{% endif %}
|
|
</td>
|
|
<td class="td-actions">
|
|
<a href="/ansible/browse/{{ sd.source.name }}/{{ pb.path }}" class="btn btn-sm btn-ghost" style="margin-right:0.5rem;">View</a>
|
|
{% if sd.editable and session.user_role == 'admin' %}
|
|
<a href="/ansible/playbooks/edit/{{ sd.source.name }}/{{ pb.path }}" class="btn btn-sm btn-ghost" style="margin-right:0.5rem;">Edit</a>
|
|
{% endif %}
|
|
<a hx-get="/ansible/run-form/{{ sd.source.name }}/{{ pb.path }}"
|
|
hx-target="#run-form-{{ sd.source.name }}" hx-swap="innerHTML"
|
|
style="cursor:pointer;" class="btn btn-sm btn-ghost">Run</a>
|
|
</td>
|
|
</tr>
|
|
{% endfor %}
|
|
</tbody>
|
|
</table>
|
|
|
|
{# Run form (loaded on demand via HTMX from /ansible/run-form/<source>/<pb>) #}
|
|
<div id="run-form-{{ sd.source.name }}"></div>
|
|
{% endif %}
|
|
</div>
|
|
{% endfor %}
|
|
{% endif %}
|
|
{% endblock %}
|