OXYGENHUB
# c987c86513df oxygenhub / templates / repo_settings.html
16.1 KiB · HTML · last changed A repository can live in its owner's bucket 1 month ago source blame history raw
1
{% extends "base.html" %}
2
{% import "webhooks_panel.html" as w %}
3
{% import "assistants_panel.html" as ai %}
4
{% import "variables_panel.html" as va %}
5
{% import "secrets_panel.html" as se %}
6
{% import "repo_tabs.html" as m %}
7
{% block title %}Settings · {{ repo.owner }}/{{ repo.name }}{% endblock %}
8
{% block bodyattrs %} data-repo="{{ repo.url }}"{% endblock %}
9
{% block tabs %}{% call m::tabs(repo, "settings") %}{% endblock %}
10
{% block content %}
11
<div class="head"><h1>Settings <small>{{ repo.owner }}/{{ repo.name }}</small></h1></div>
12
{% if let Some(n) = notice %}<p class="note">{{ n }}</p>{% endif %}
13
{% if let Some(e) = error %}<p class="error">{{ e }}</p>{% endif %}
14
<div class="sectioned">
15
<nav class="section-nav" aria-label="Sections">
16
  <a href="#general">General</a>
17
  <a href="#landing">Landing requirements</a>
18
  <a href="#git-mirror">Git mirror</a>
19
  <a href="#checks">Required checks</a>
20
  <a href="#flow">OxygenFlow</a>
21
  {% if role == crate::auth::Role::Admin %}<a href="#webhooks">Webhooks</a>
22
  <a href="#variables">Variables</a>
23
  <a href="#secrets">Secrets</a>
24
  <a href="#assistants">AI assistants</a>
25
  {% if storage.is_some() %}<a href="#storage">Storage</a>{% endif %}
26
  <a href="#collaborators">Collaborators</a>
27
  <a href="#advanced">Advanced</a>{% endif %}
28
</nav>
29
<div class="sections">
30
<form class="card wide" id="general" method="post" action="{{ repo.url }}/settings">
31
  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
32
  <h2>General</h2>
33
  <label for="description">Description</label><input type="text" id="description" name="description" value="{{ row.description }}">
34
  <label for="topics">Topics</label><input type="text" id="topics" name="topics" value="{{ row.topics }}" placeholder="rust version-control retro">
35
  <p class="small mute">Separated by spaces or commas; letters, digits and dashes. People find repositories by them under Explore.</p>
36
  <label for="default_bookmark">Default bookmark</label><input type="text" id="default_bookmark" name="default_bookmark" value="{{ row.default_bookmark }}">
37
  <label>Visibility{% if role != crate::auth::Role::Admin %} <span class="mute">(admins only)</span>{% endif %}</label>
38
  <div class="choice">
39
    <label><input type="radio" name="visibility" value="public"{% if row.visibility == "public" %} checked{% endif %}> public</label>
40
    <label><input type="radio" name="visibility" value="internal"{% if row.visibility == "internal" %} checked{% endif %}> internal</label>
41
    <label><input type="radio" name="visibility" value="private"{% if row.visibility == "private" %} checked{% endif %}> private</label>
42
  </div>
43
  <button type="submit">SAVE</button>
44
</form>
45
<form class="card wide" id="landing" method="post" action="{{ repo.url }}/settings/requirements">
46
  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
47
  <h2>Landing requirements</h2>
48
  <label for="required_approvals">Sealed approvals required</label><input type="number" id="required_approvals" name="required_approvals" min="0" value="{{ requirements.required_approvals }}">
49
  <div class="choice">
50
    <label><input type="checkbox" name="require_owners" value="1"{% if requirements.require_owners %} checked{% endif %}> code owners from <code>.oxyowners</code> must approve</label>
51
    <label><input type="checkbox" name="allow_conflicts" value="1"{% if requirements.allow_conflicts %} checked{% endif %}> allow landing with conflicts</label>
52
  </div>
53
  <button type="submit">SAVE</button>
54
</form>
55
<form class="card wide" id="git-mirror" method="post" action="{{ repo.url }}/settings/mirror">
56
  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
57
  <h2>Git mirror</h2>
58
  <div class="choice"><label><input type="checkbox" name="enabled" value="1"{% if row.git_mirror %} checked{% endif %}> keep a read-only Git mirror of <strong>{{ row.default_bookmark }}</strong></label></div>
59
  <p class="small mute">For tools that only speak Git (CI runners, IDEs): <code>git clone {{ shell.base_url }}{{ repo.url }}.git</code>. Private repositories take a personal access token as the password. Pushing to the mirror is refused.{% if row.git_mirror && !row.git_mirror_state.is_empty() %} Last exported state <code>{{ row.git_mirror_state|short }}</code>.{% endif %}</p>
60
  <button type="submit">SAVE</button>
61
</form>
62
<form class="card wide" id="checks" method="post" action="{{ repo.url }}/settings/checks">
63
  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
64
  <h2>Required checks</h2>
65
  <label for="required_checks">Check names that must pass on a proposal's projected state (comma-separated)</label><input type="text" id="required_checks" name="required_checks" value="{{ required_checks }}" placeholder="build, test">
66
  <p class="small mute">Any token with <code>checks:write</code> reports checks with <code>POST {{ shell.base_url }}/api/v1/repos/{{ repo.owner }}/{{ repo.name }}/checks</code>.</p>
67
  <button type="submit">SAVE</button>
68
</form>
69
<form class="card wide" id="flow" method="post" action="{{ repo.url }}/settings/flow">
70
  <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
71
  <h2>OxygenFlow</h2>
72
  <p>Pushes to this repository {% if flow_enabled %}<strong>start runs</strong>{% else %}<strong>do not start runs</strong>{% endif %} of its <code>.flow/pipeline.kdl</code>.</p>
73
  {% if site_admin %}
74
  <div class="choice">
75
    <label><input type="radio" name="flow" value="on"{% if row.flow == "on" %} checked{% endif %}> on</label>
76
    <label><input type="radio" name="flow" value="off"{% if row.flow == "off" %} checked{% endif %}> off</label>
77
    <label><input type="radio" name="flow" value="default"{% if row.flow.is_empty() %} checked{% endif %}> site default ({% if flow_default %}on{% else %}off{% endif %}, from <code>[flow] repos</code> in <code>hub.toml</code>)</label>
78
  </div>
79
  <p class="small mute">Runs use the site's runners, so only site administrators change this. It takes effect at the next push.</p>
80
  <button type="submit">SAVE</button>
81
  {% else %}
82
  <p class="small mute">A site administrator turns OxygenFlow on or off here.</p>
83
  {% endif %}
84
</form>
85
{% if role == crate::auth::Role::Admin %}
86
<section class="panel" id="runners">
87
  <h2>Runners</h2>
88
  <p class="small">The OxygenFlow runners that may take this repository's jobs: the site's, {{ row.owner }}'s, and this repository's own.</p>
89
  {% if let Some(t) = runner_token %}<p class="note">Register a runner for this repository with:</p><pre class="snippet">flow runner register {{ shell.base_url }} --token {{ t }} --name NAME</pre>{% endif %}
90
  {% if runners.is_empty() %}<p class="mute small">None yet: runs wait until a runner that serves this repository is added.</p>{% else %}
91
  <div class="table"><table>
92
  <tr><th>Runner</th><th>Status</th><th>Serves</th><th>Machine</th><th></th></tr>
93
  {% for (r, serves, own) in runners %}<tr><td><strong>{{ r.name }}</strong></td><td><span class="runner-status st-{{ r.status() }}">{{ r.status() }}</span></td><td class="small">{{ serves }}</td><td class="small">{% if r.arch.is_empty() %}<span class="mute">unknown</span>{% else %}{{ r.arch }} · {{ r.os }}{% endif %}</td>
94
  <td>{% if *own %}<form class="tiny" method="post" action="{{ repo.url }}/settings/runners/{{ r.id }}/remove" onsubmit="return confirm('Remove {{ r.name }}? Its credential stops working.')"><input type="hidden" name="_csrf" value="{{ shell.csrf }}"><button class="danger-btn">remove</button></form>{% endif %}</td></tr>{% endfor %}
95
  </table></div>{% endif %}
96
  <form method="post" action="{{ repo.url }}/settings/runners/token"><input type="hidden" name="_csrf" value="{{ shell.csrf }}"><button type="submit">Add a runner for this repository</button></form>
97
</section>
98
{% call w::panel(repo.url ~ "/settings", hooks, shell.csrf, "Each delivery is signed with the secret (X-Oxyhub-Signature) and retried with backoff for a day.") %}
99
{% call va::panel(repo.url ~ "/settings", variables, shell.csrf, "This repository's jobs get these, beside the ones the site and its owner set.") %}
100
{% call se::panel(repo.url ~ "/settings", secrets, shell.csrf, "This repository's jobs may use these, beside the ones the site and its owner set.") %}
101
{% call ai::panel(repo.url ~ "/settings", assistants, shell.csrf, "This repository may ask these, beside the ones the site and its owner provide.") %}
102
{% if role == crate::auth::Role::Admin %}{% if let Some(st) = storage %}<section class="panel" id="storage">
103
  <h2>Storage</h2>
104
  <p>This repository's data lives in <code>{{ st.url }}</code>, your bucket. This server keeps a cache and the credentials, sealed.</p>
105
  <dl class="facts">
106
    <dt>Since</dt><dd><time title="{{ st.created_ms|when_i }}">{{ st.created_ms|ago_i }}</time></dd>
107
    <dt>Last check</dt><dd>{% if let Some(t) = st.checked_ms %}<time title="{{ t|when_i }}">{{ t|ago_i }}</time>: {{ st.check_result }}{% else %}<span class="mute">never</span>{% endif %}</dd>
108
  </dl>
109
  <form class="inline" method="post" action="{{ repo.url }}/settings/storage">
110
    <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
111
    <input type="hidden" name="action" value="check">
112
    <button type="submit" title="Write, read, list and delete under a probe prefix of the bucket, and compare-and-swap a record">CHECK THE BUCKET</button>
113
  </form>
114
  <details>
115
    <summary>Replace the credentials</summary>
116
    <form class="card" method="post" action="{{ repo.url }}/settings/storage">
117
      <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
118
      <input type="hidden" name="action" value="credentials">
119
      <p class="small mute">The new credentials must pass the check before they replace the old ones. Fill the fields for your provider.</p>
120
      {% if st.url.starts_with("s3://") %}<div class="row">
121
        <div><label for="sak">Access key ID</label><input type="text" id="sak" name="access_key_id" autocomplete="off" required></div>
122
        <div><label for="ssk">Secret access key</label><input type="password" id="ssk" name="secret_access_key" autocomplete="new-password" required></div>
123
      </div>{% else if st.url.starts_with("gs://") %}<label for="ssa">Service account key</label><textarea id="ssa" name="service_account_key" rows="3" required spellcheck="false"></textarea>{% else %}<div class="row">
124
        <div><label for="stn">Tenant ID</label><input type="text" id="stn" name="tenant_id" autocomplete="off" required></div>
125
        <div><label for="sci">Client ID</label><input type="text" id="sci" name="client_id" autocomplete="off" required></div>
126
        <div><label for="scs">Client secret</label><input type="password" id="scs" name="client_secret" autocomplete="new-password" required></div>
127
      </div>{% endif %}
128
      <button type="submit">SAVE</button>
129
    </form>
130
  </details>
131
</section>{% endif %}{% endif %}
132
<section class="panel" id="collaborators">
133
  <h2>Collaborators</h2>
134
  {% if collaborators.is_empty() %}<p class="mute small">Nobody beyond the owner{% if !teams.is_empty() %} and the organisation's members{% endif %}.</p>{% else %}
135
  <table class="small">
136
  {% for c in collaborators %}
137
  <tr><td>{% if let Some(a) = c.account %}<a href="/{{ a.username }}">{{ a.username }}</a>{% else if let Some(t) = c.team %}team {{ t.name }}{% endif %}</td><td>{{ c.role }}</td>
138
  <td><form class="tiny" method="post" action="{{ repo.url }}/settings/collaborators"><input type="hidden" name="_csrf" value="{{ shell.csrf }}">{% if let Some(a) = c.account %}<input type="hidden" name="username" value="{{ a.username }}">{% else if let Some(t) = c.team %}<input type="hidden" name="team" value="{{ t.name }}">{% endif %}<button name="remove" value="1">remove</button></form></td></tr>
139
  {% endfor %}
140
  </table>{% endif %}
141
  <form class="card" method="post" action="{{ repo.url }}/settings/collaborators">
142
    <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
143
    <div class="row">
144
      <div><label for="username">Account</label><input type="text" id="username" name="username"></div>
145
      {% if !teams.is_empty() %}<div><label for="team">or team</label><select id="team" name="team"><option value="">—</option>{% for t in teams %}<option value="{{ t.name }}">{{ t.name }}</option>{% endfor %}</select></div>{% endif %}
146
      <div><label for="role">Role</label><select id="role" name="role"><option value="read">read</option><option value="triage">triage</option><option value="write" selected>write</option><option value="maintain">maintain</option><option value="admin">admin</option></select></div>
147
    </div>
148
    <button type="submit">ADD</button>
149
  </form>
150
</section>
151
<section class="panel danger-zone" id="advanced">
152
  <h2>Advanced</h2>
153
  <p class="small mute">Settings that change what this repository is. Each asks you to confirm; none can be undone from here except archiving.</p>
154
  <div class="danger-row">
155
    <div><strong>Transfer ownership</strong><p class="small mute">Move this repository to a user or an organisation you may create repositories under. Its address changes to <code>/OWNER/{{ repo.name }}</code>; the old address redirects, and <code>oxy</code> remotes keep working.</p></div>
156
    <details class="danger-act"><summary class="danger-btn">Transfer</summary>
157
      <form class="card" method="post" action="{{ repo.url }}/settings/transfer">
158
        <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
159
        <label for="towner">New owner</label><input type="text" id="towner" name="owner" placeholder="an organisation or a user" required>
160
        <label for="tconfirm">Type <code>{{ repo.owner }}/{{ repo.name }}</code> to confirm</label><input type="text" id="tconfirm" name="confirm" required autocomplete="off">
161
        <button type="submit">TRANSFER</button>
162
      </form>
163
    </details>
164
  </div>
165
  <div class="danger-row">
166
    <div><strong>{% if row.archived %}Bring this repository back{% else %}Archive this repository{% endif %}</strong><p class="small mute">{% if row.archived %}It is archived: read-only for everyone, shown with a badge.{% if !row.archived_reason.is_empty() %} Reason: {{ row.archived_reason }}{% endif %}{% else %}Read-only for everyone, including you: no pushes, edits, issues, proposals or comments, until an admin brings it back. Say why, for whoever finds it later.{% endif %}</p></div>
167
    <details class="danger-act"><summary class="danger-btn">{% if row.archived %}Unarchive{% else %}Archive{% endif %}</summary>
168
      <form class="card" method="post" action="{{ repo.url }}/settings/archive">
169
        <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
170
        {% if row.archived %}<input type="hidden" name="action" value="unarchive"><button type="submit">BRING IT BACK</button>{% else %}<input type="hidden" name="action" value="archive">
171
        <label for="areason">Reason (optional)</label><textarea id="areason" name="reason" rows="2" maxlength="500" placeholder="Superseded by …"></textarea>
172
        <button type="submit">ARCHIVE</button>{% endif %}
173
      </form>
174
    </details>
175
  </div>
176
  <div class="danger-row">
177
    <div><strong>Delete wiki data</strong><p class="small mute">{% if repo.wiki %}The wiki's repository moves to the trash with its history; a new first page starts a fresh one.{% else %}This repository has no wiki.{% endif %}</p></div>
178
    {% if repo.wiki %}<details class="danger-act"><summary class="danger-btn">Delete wiki data</summary>
179
      <form class="card" method="post" action="{{ repo.url }}/settings/wiki/delete">
180
        <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
181
        <label for="wconfirm">Type <code>{{ repo.owner }}/{{ repo.name }}</code> to confirm</label><input type="text" id="wconfirm" name="confirm" required autocomplete="off">
182
        <button type="submit">DELETE WIKI DATA</button>
183
      </form>
184
    </details>{% else %}<button class="danger-btn" type="button" disabled>Delete wiki data</button>{% endif %}
185
  </div>
186
  <div class="danger-row">
187
    <div><strong>Delete this repository</strong><p class="small mute">The repository moves to the trash and is removed after the retention period.</p></div>
188
    <details class="danger-act"><summary class="danger-btn">Delete</summary>
189
      <form class="card" method="post" action="{{ repo.url }}/settings/delete">
190
        <input type="hidden" name="_csrf" value="{{ shell.csrf }}">
191
        <label for="dconfirm">Type <code>{{ repo.owner }}/{{ repo.name }}</code> to confirm</label><input type="text" id="dconfirm" name="confirm" required autocomplete="off">
192
        <button type="submit">DELETE</button>
193
      </form>
194
    </details>
195
  </div>
196
</section>
197
{% endif %}
198
</div>
199
</div>
200
{% endblock %}