{% extends "base.html" %}

{% import "admin_nav.html" as an %}

{% import "runner_update_fields.html" as ruf %}

{% block title %}Runner updates · Administration{% endblock %}

{% block content %}

<div class="head"><h1>Runners <small><a href="/admin">Administration</a></small></h1></div>

<div class="settings-layout">

{% call an::nav(crate::web::admin::AdminSection::RunnerUpdates) %}

<div class="sections settings-body">

<div class="bar"><span class="modes"><a href="/admin/runners">runners</a><a href="/admin/runners/images">images</a><a href="/admin/runners/settings">settings</a><a href="/admin/runners/updates" class="on">updates</a></span></div>

{% if let Some(n) = notice %}<p class="note">{{ n }}</p>{% endif %}

{% if let Some(e) = error %}<p class="error">{{ e }}</p>{% endif %}

<datalist id="update-channels"><option value="stable"><option value="canary"></datalist>

<section class="panel">

  <h2>Runners update themselves</h2>

  <p>A runner asks the hub which build it should run, fetches it, checks it as a release, finishes what it holds and swaps itself in; a build that does not reach the hub goes back to the one before. <strong>Off unless chosen.</strong> The site, an owner, a test group and a runner each may set any of the settings below, and the nearest setting wins: a runner's own, then its test groups', then its owner's, then the site's. A runner's <code>flow.toml</code> can still refuse every update (<code>[runner.update] allow = false</code>).</p>

  <p class="small mute">A rollout: turn updates on for a test group (two chosen runners, or 10% of them), watch it, then widen it to 50%, then turn updates on for everyone. A percentage is taken by a stable hash of each runner's id, so it is the same machines every time, and 10% sits inside 50%.</p>

</section>

<form class="card wide" method="post" action="/admin/runners/updates/source">

  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">

  <h2>Where builds come from</h2>

  <label for="update-repo">The repository whose releases carry runner builds</label>

  <input type="text" id="update-repo" name="repo" value="{{ repo }}" placeholder="owner/name, e.g. andymccall/oxygenflow">

  <p class="small mute">Each release offers one file per machine, <code>flow-linux-x86_64</code>, <code>flow-linux-aarch64</code>, <code>flow-linux-riscv64</code>, <code>flow-windows-x86_64.exe</code>. <em>stable</em> is its newest release, <em>canary</em> its newest including pre-releases; a version (<code>0.3.4</code>) pins it, going back if need be.</p>

  <h3>Waves</h3>

  <p class="small mute">Give test groups a wave (1, 2, …) and a new version reaches them in order: wave 2's runners are offered it once every runner of wave 1 that took it has finished this many jobs on it with none ending in error, or this many hours have passed since its first job there. A job that ends in error (the runner's or the machine's fault, not a test's) on a wave stops the version for everyone until you lift it. Runners in no wave come last.</p>

  <div class="pol-row">

    <label class="pol">Jobs each <input type="number" name="soak_jobs" min="1" max="1000" size="4" value="{{ soak_jobs }}"></label>

    <label class="pol">or hours <input type="number" name="soak_hours" min="1" max="720" size="4" value="{{ soak_hours }}"></label>

  </div>

  <button type="submit">Save</button>

</form>

{% if !holds.is_empty() %}

<section class="panel strip warn" id="holds">

  <h2>Held builds</h2>

  <p class="small">A build that rolled back on a runner, or that a wave stopped, is offered to no other until you lift the hold.</p>

  {% for h in holds %}

  <form class="pol-form" method="post" action="/admin/runners/updates/holds/lift"><input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="version" value="{{ h.version }}">

    <strong>flow {{ h.version }}</strong><span class="small">{{ h.why }} · <time title="{{ h.at_ms|when_i }}">{{ h.at_ms|ago_i }}</time></span><button type="submit" class="small">LIFT</button>

  </form>

  {% endfor %}

</section>

{% endif %}

<form class="card wide" method="post" action="/admin/runners/updates/policy">

  <input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="scope" value="site">

  <h2>The site</h2>

  <p class="small mute">What every runner does unless a nearer level says otherwise: {{ site.summary() }}.</p>

  <div class="pol-row">{% call ruf::policy_fields(site, true) %}</div>

  <button type="submit">Save</button>

</form>

<section class="panel" id="owners">

  <h2>Owners</h2>

  <p class="small mute">For the runners an account or organisation registered for its own repositories.</p>

  {% if owners.is_empty() %}<p class="mute small">No owner sets anything; their runners follow the site.</p>{% endif %}

  {% for o in owners %}

  <form class="pol-form" method="post" action="/admin/runners/updates/policy">

    <input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="scope" value="owner"><input type="hidden" name="key" value="{{ o.key }}">

    <strong>{{ o.key }}</strong>{% call ruf::policy_fields(o, false) %}<button type="submit">Save</button>

  </form>

  {% endfor %}

  <form class="pol-form" method="post" action="/admin/runners/updates/policy">

    <input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="scope" value="owner">

    <label class="pol">Owner <input type="text" name="key" size="12" placeholder="account or org" required></label>{% call ruf::policy_fields(site, false) %}<button type="submit">Add</button>

  </form>

</section>

<section class="panel" id="groups">

  <h2>Test groups</h2>

  <p class="small mute">A named set of runners: those you choose, or a percentage of the site's runners (or one owner's). Give a group its own settings to try a build on it before the rest.</p>

  {% if groups.is_empty() %}<p class="mute small">No test groups yet.</p>{% endif %}

  {% for gv in groups %}{% let g = gv.g %}

  <div class="card wide update-group">

    <h3>{{ g.name }} <small class="mute">{{ gv.reach }} · {% if let Some(p) = g.percent %}{{ p }}%{% else %}chosen{% endif %} · {{ gv.members.len()|plural("runner", "runners") }} now{% if let Some(w) = g.wave %} · wave {{ w }}{% endif %}</small></h3>

    <p class="small">{% if gv.members.is_empty() %}<span class="mute">No runners in it.</span>{% else %}{% for m in gv.members %}<span class="lbl">{{ m }}</span> {% endfor %}{% endif %}</p>

    <form class="pol-form" method="post" action="/admin/runners/updates/policy">

      <input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="scope" value="group"><input type="hidden" name="key" value="{{ g.id }}">

      {% call ruf::policy_fields(gv.policy, false) %}<button type="submit">Save settings</button>

    </form>

    <details><summary class="small">Who is in it</summary>

    <form method="post" action="/admin/runners/updates/groups/{{ g.id }}">

      <input type="hidden" name="_csrf" value="{{ shell.csrf }}">

      <label class="pol"><input type="radio" name="mode" value="percent"{% if g.percent.is_some() %} checked{% endif %}> a percentage of {{ gv.reach }}: <input type="number" name="percent" min="1" max="100" size="4" value="{% if let Some(p) = g.percent %}{{ p }}{% endif %}">%</label>

      <label class="pol"><input type="radio" name="mode" value="chosen"{% if g.percent.is_none() %} checked{% endif %}> these runners:</label>

      <div class="pol-row">{% for rv in runners %}{% if g.owner.is_empty() || g.owner == rv.r.scope_owner %}<label class="pol"><input type="checkbox" name="runner" value="{{ rv.r.id }}"{% if gv.chosen.contains(rv.r.id) %} checked{% endif %}> {{ rv.r.name }}</label>{% endif %}{% endfor %}</div>

      <label class="pol">Wave <input type="number" name="wave" min="1" max="9" size="3" value="{% if let Some(w) = g.wave %}{{ w }}{% endif %}" title="Blank: after every wave"></label>

      <button type="submit">Save members</button>

    </form>

    <form class="tiny" method="post" action="/admin/runners/updates/groups/{{ g.id }}/delete" data-confirm="Remove the test group {{ g.name }}? Its runners follow the levels above it."><input type="hidden" name="_csrf" value="{{ shell.csrf }}"><button class="danger-btn">remove group</button></form>

    </details>

  </div>

  {% endfor %}

  <form class="card wide" method="post" action="/admin/runners/updates/groups">

    <input type="hidden" name="_csrf" value="{{ shell.csrf }}">

    <h3>New test group</h3>

    <div class="pol-row">

      <label class="pol">Name <input type="text" name="name" size="14" required placeholder="canary"></label>

      <label class="pol">Of <input type="text" name="owner" size="12" placeholder="the site's runners" title="Blank for the site's runners, or an owner for theirs"></label>

    </div>

    <label class="pol"><input type="radio" name="mode" value="percent"> a percentage: <input type="number" name="percent" min="1" max="100" size="4">%</label>

    <label class="pol"><input type="radio" name="mode" value="chosen" checked> these runners:</label>

    <div class="pol-row">{% for rv in runners %}<label class="pol"><input type="checkbox" name="runner" value="{{ rv.r.id }}"> {{ rv.r.name }}</label>{% endfor %}</div>

    <label class="pol">Wave <input type="number" name="wave" min="1" max="9" size="3" title="Blank: after every wave"></label>

    <button type="submit">Make group</button>

  </form>

</section>

<section class="panel" id="runners">

  <h2>Runners</h2>

  {% if runners.is_empty() %}<p class="mute">No runners yet.</p>{% else %}

  <div class="table"><table>

  <tr><th>Runner</th><th>Runs</th><th>Groups</th><th>Its policy</th><th>Now</th><th>Last said</th><th>Its own settings</th></tr>

  {% for rv in runners %}{% let r = rv.r %}

  <tr>

    <td><a href="/admin/runners/{{ r.id }}"><strong>{{ r.name }}</strong></a>{% if !r.scope_owner.is_empty() %}<br><span class="small mute">{{ r.scope_owner }}'s</span>{% endif %}</td>

    <td class="small">{% if r.version.is_empty() %}<span class="mute">unknown</span>{% else %}flow {{ r.version }}{% endif %}</td>

    <td class="small">{% for g in rv.groups %}<span class="lbl">{{ g }}</span> {% endfor %}</td>

    <td class="small">{{ rv.effective_words() }}</td>

    <td class="small">{{ rv.offer }}</td>

    <td class="small">{% if r.update_note.is_empty() %}<span class="mute">nothing yet</span>{% else %}{{ r.update_note }}{% if let Some(t) = r.update_ms %} <time class="mute" title="{{ t|when_i }}">{{ t|ago_i }}</time>{% endif %}{% endif %}</td>

    <td><form class="pol-form tiny" method="post" action="/admin/runners/updates/policy">

      <input type="hidden" name="_csrf" value="{{ shell.csrf }}"><input type="hidden" name="scope" value="runner"><input type="hidden" name="key" value="{{ r.id }}">

      {% call ruf::policy_fields(rv.policy, false) %}<button type="submit">set</button></form></td>

  </tr>

  {% endfor %}

  </table></div>

  {% endif %}

</section>

</div>

</div>

{% endblock %}