OXYGENHUB
# bf3d07541368 oxygenhub / crates / hub / tests / flow.rs
36.6 KiB · Rust · last changed A queued run says where it stands 1 month ago source blame history raw
1
//! OxygenFlow on the hub (hub spec §13.2), end to end: a real `oxy` push
2
//! starts a run, a runner claims jobs through the API in dependency order,
3
//! job tokens read only their repository, results become checks and pages.
4
5
use axum::body::Body;
6
use axum::http::{header, Request, StatusCode};
7
use http_body_util::BodyExt;
8
use oxy_core::protocol::{open_remote, RemoteOptions};
9
use oxy_core::repo::Repo;
10
use oxygenhub::config::Config;
11
use oxygenhub::repos::RepoName;
12
use oxygenhub::{db, Shared};
13
use std::path::Path;
14
use tower::ServiceExt;
15
16
const ROOTFS: &str = "36fc4e3238044e424219a2b9002bf61bbe1805fec14d52cf37e17fae77c9ff16";
17
18
fn hermetic() {
19
    static ONCE: std::sync::Once = std::sync::Once::new();
20
    static DIR: std::sync::OnceLock<tempfile::TempDir> = std::sync::OnceLock::new();
21
    ONCE.call_once(|| {
22
        let d = tempfile::tempdir().unwrap();
23
        std::env::set_var("OXY_HOME", d.path());
24
        DIR.set(d).ok();
25
    });
26
}
27
28
fn write(root: &Path, rel: &str, content: &str) {
29
    let p = root.join(rel);
30
    std::fs::create_dir_all(p.parent().unwrap()).unwrap();
31
    std::fs::write(p, content).unwrap();
32
}
33
34
struct Hub {
35
    app: Shared,
36
    base: String,
37
    _dir: tempfile::TempDir,
38
}
39
40
async fn hub() -> Hub {
41
    hermetic();
42
    let dir = tempfile::tempdir().unwrap();
43
    let mut config = Config::load(dir.path()).unwrap();
44
    config.auth.push_tokens = vec!["site".into()];
45
    config.flow.runner_tokens = vec!["runner-secret".into()];
46
    config.flow.repos = vec!["andy/*".into()];
47
    let listener = tokio::net::TcpListener::bind("127.0.0.1:0").await.unwrap();
48
    let port = listener.local_addr().unwrap().port();
49
    config.server.base_url = format!("http://127.0.0.1:{port}");
50
    let app = oxygenhub::build(config).await.unwrap();
51
    let router = oxygenhub::router(app.clone());
52
    tokio::spawn(async move { axum::serve(listener, router).await.unwrap() });
53
    Hub { app, base: format!("http://127.0.0.1:{port}"), _dir: dir }
54
}
55
56
async fn call(app: &Shared, method: &str, path: &str, bearer: Option<&str>, json: Option<String>) -> (StatusCode, String) {
57
    let mut req = Request::builder().method(method).uri(path);
58
    if let Some(b) = bearer {
59
        req = req.header(header::AUTHORIZATION, format!("Bearer {b}"));
60
    }
61
    let body = match json {
62
        Some(j) => {
63
            req = req.header(header::CONTENT_TYPE, "application/json");
64
            Body::from(j)
65
        }
66
        None => Body::empty(),
67
    };
68
    let res = oxygenhub::router(app.clone()).oneshot(req.body(body).unwrap()).await.unwrap();
69
    let status = res.status();
70
    let bytes = res.into_body().collect().await.unwrap().to_bytes();
71
    (status, String::from_utf8_lossy(&bytes).into_owned())
72
}
73
74
/// A GET's status, `Location` and `Content-Type`.
75
async fn head(app: &Shared, path: &str) -> (StatusCode, String, String) {
76
    let res = oxygenhub::router(app.clone()).oneshot(Request::get(path).body(Body::empty()).unwrap()).await.unwrap();
77
    let h = |k: header::HeaderName| res.headers().get(k).and_then(|v| v.to_str().ok()).unwrap_or("").to_string();
78
    (res.status(), h(header::LOCATION), h(header::CONTENT_TYPE))
79
}
80
81
async fn claim(app: &Shared) -> Option<serde_json::Value> {
82
    let (st, body) =
83
        call(app, "POST", "/api/v1/flow/claim", Some("runner-secret"), Some(r#"{"runner":"test-1","runtimes":["microvm"]}"#.into())).await;
84
    match st {
85
        StatusCode::NO_CONTENT => None,
86
        StatusCode::OK => Some(serde_json::from_str(&body).unwrap()),
87
        other => panic!("claim: {other} {body}"),
88
    }
89
}
90
91
fn receipt(job: &str, pipeline_hash: &str, exit: u32) -> serde_json::Value {
92
    serde_json::json!({
93
        "job_name": job, "pipeline_hash": pipeline_hash, "scope_tree_hash": "11".repeat(32),
94
        "inputs": [], "environment": "22".repeat(32), "outputs": [], "exit_code": exit, "duration_ms": 640
95
    })
96
}
97
98
async fn finish(app: &Shared, id: i64, body: serde_json::Value) -> StatusCode {
99
    call(app, "POST", &format!("/api/v1/flow/jobs/{id}/finish"), Some("runner-secret"), Some(body.to_string())).await.0
100
}
101
102
async fn create(app: &Shared, owner: &str, name: &str) {
103
    app.repos.create(&RepoName::parse(&format!("{owner}/{name}")).unwrap(), None).unwrap();
104
    db::repos::create(&app.db, owner, name, "", hub_api::Visibility::Public).await.unwrap();
105
}
106
107
fn client(url: &str, work: &Path) -> Repo {
108
    let mut c = Repo::init(work).unwrap();
109
    c.config.set("remote.origin.url", url).unwrap();
110
    c.config.set("remote.origin.token", "site").unwrap();
111
    c.save_config().unwrap();
112
    c
113
}
114
115
fn pipeline(extra: &str) -> String {
116
    format!(
117
        "schema-version 1\nsandbox \"alpine\" {{\n    rootfs \"cas://blob/{ROOTFS}\"\n}}\njob \"build\" {{\n    sandbox \"alpine\"\n    exec \"make\"\n}}\njob \"test\" {{\n    sandbox \"alpine\"\n    depends-on \"build\"\n    exec \"sh\" \"-eu\" \"test.sh\"\n}}\njob \"lint\" {{\n    sandbox \"alpine\"\n    exec \"true\"\n}}\n{extra}"
118
    )
119
}
120
121
async fn runs_of(app: &Shared, owner: &str, name: &str) -> Vec<db::flow::Run> {
122
    let row = db::repos::get(&app.db, owner, name).await.unwrap().unwrap();
123
    for _ in 0..100 {
124
        let r = db::flow::runs(&app.db, row.id, 10, None).await.unwrap();
125
        if !r.is_empty() {
126
            return r;
127
        }
128
        tokio::time::sleep(std::time::Duration::from_millis(50)).await;
129
    }
130
    vec![]
131
}
132
133
/// The checks on a state once there are `n` of them (they follow the run).
134
async fn checks_when(app: &Shared, repo_id: i64, state: &str, n: usize) -> Vec<db::hooks::Check> {
135
    for _ in 0..100 {
136
        let c = db::hooks::checks_for_state(&app.db, repo_id, state).await.unwrap();
137
        if c.len() >= n {
138
            return c;
139
        }
140
        tokio::time::sleep(std::time::Duration::from_millis(50)).await;
141
    }
142
    db::hooks::checks_for_state(&app.db, repo_id, state).await.unwrap()
143
}
144
145
#[tokio::test(flavor = "multi_thread")]
146
async fn a_push_runs_the_pipeline_through_a_runner() {
147
    let h = hub().await;
148
    create(&h.app, "andy", "demo").await;
149
    create(&h.app, "andy", "secret").await;
150
    create(&h.app, "other", "plain").await;
151
    let url = format!("{}/andy/demo", h.base);
152
    let work = tempfile::tempdir().unwrap();
153
    let mut c = client(&url, work.path());
154
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
155
    write(work.path(), "test.sh", "echo ok\n");
156
    c.snapshot("test").unwrap();
157
    c.commit("Add a pipeline", &[]).unwrap();
158
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
159
160
    // The push started a run with three queued jobs, and checks for them.
161
    let runs = runs_of(&h.app, "andy", "demo").await;
162
    assert_eq!(runs.len(), 1);
163
    let run = &runs[0];
164
    assert_eq!((run.bookmark.as_str(), run.status.as_str(), run.actor.as_str()), ("main", "queued", "site token"));
165
    assert_eq!(run.pipeline_hash.len(), 64);
166
    let jobs = db::flow::jobs(&h.app.db, run.id).await.unwrap();
167
    assert_eq!(jobs.iter().map(|j| (j.name.as_str(), j.depth)).collect::<Vec<_>>(), [("build", 0), ("lint", 0), ("test", 1)]);
168
    // The checks are reported just after the run is recorded.
169
    let checks = checks_when(&h.app, run.repo_id, &run.state, 3).await;
170
    assert_eq!(
171
        checks.iter().map(|c| (c.name.as_str(), c.status.as_str())).collect::<Vec<_>>(),
172
        [("flow/build", "queued"), ("flow/lint", "queued"), ("flow/test", "queued")]
173
    );
174
175
    // Runners need a runner token.
176
    assert_eq!(
177
        call(&h.app, "POST", "/api/v1/flow/claim", Some("site"), Some(r#"{"runner":"x","runtimes":["microvm"]}"#.into())).await.0,
178
        StatusCode::UNAUTHORIZED
179
    );
180
    assert_eq!(
181
        call(&h.app, "POST", "/api/v1/flow/claim", None, Some(r#"{"runner":"x","runtimes":["microvm"]}"#.into())).await.0,
182
        StatusCode::UNAUTHORIZED
183
    );
184
    // A runner without the tier gets nothing.
185
    let (st, _) =
186
        call(&h.app, "POST", "/api/v1/flow/claim", Some("runner-secret"), Some(r#"{"runner":"x","runtimes":["wasm"]}"#.into())).await;
187
    assert_eq!(st, StatusCode::NO_CONTENT);
188
189
    // Claims come in dependency order; `test` waits for `build`.
190
    let a = claim(&h.app).await.unwrap();
191
    let b = claim(&h.app).await.unwrap();
192
    assert_eq!((a["job"]["name"].as_str(), b["job"]["name"].as_str()), (Some("build"), Some("lint")));
193
    assert!(claim(&h.app).await.is_none(), "test waits for build");
194
    assert_eq!(a["repo"], "andy/demo");
195
    assert_eq!(a["clone_url"], url.as_str());
196
    assert_eq!(a["sandbox"]["rootfs"], ROOTFS);
197
    assert_eq!(a["job"]["exec"], serde_json::json!(["make"]));
198
    assert_eq!(a["timeout_s"], 3600);
199
    let heads: Vec<String> = a["heads"].as_array().unwrap().iter().map(|v| v.as_str().unwrap().to_string()).collect();
200
    assert_eq!(heads.join("+"), run.heads);
201
    let checks = db::hooks::checks_for_state(&h.app.db, run.repo_id, &run.state).await.unwrap();
202
    assert_eq!(checks.iter().find(|c| c.name == "flow/build").unwrap().status, "running");
203
204
    // The job token reads this repository over the wire, and nothing else.
205
    let token = a["token"].as_str().unwrap().to_string();
206
    assert!(token.starts_with("flowjob_"));
207
    let opts = RemoteOptions { token: Some(token.clone()), ca: None, repo_id: None };
208
    open_remote(&url, &opts).unwrap().refs().unwrap();
209
    assert!(open_remote(&format!("{}/andy/secret", h.base), &opts).unwrap().refs().is_err(), "another repository");
210
    let bad = RemoteOptions { token: Some("flowjob_00".into()), ca: None, repo_id: None };
211
    assert!(open_remote(&url, &bad).unwrap().refs().is_err(), "an unknown job token");
212
    // … and cannot push.
213
    c.config.set("remote.origin.token", &token).unwrap();
214
    c.save_config().unwrap();
215
    write(work.path(), "more.txt", "x\n");
216
    c.snapshot("test").unwrap();
217
    c.commit("More", &[]).unwrap();
218
    let pushed = c.push("origin", false);
219
    assert!(pushed.is_err() || pushed.unwrap().iter().all(|r| !r.ok), "a job token cannot push");
220
    c.config.set("remote.origin.token", "site").unwrap();
221
    c.save_config().unwrap();
222
223
    // Logs, then results with receipts.
224
    let a_id = a["job_id"].as_i64().unwrap();
225
    let b_id = b["job_id"].as_i64().unwrap();
226
    let log = serde_json::json!({ "records": [
227
        { "t": 5, "stream": "flow", "text": "booting" },
228
        { "t": 120, "stream": "out", "text": "cc -o demo demo.c" },
229
        { "t": 130, "stream": "weird", "text": "x".repeat(20_000) },
230
    ]});
231
    assert_eq!(
232
        call(&h.app, "POST", &format!("/api/v1/flow/jobs/{a_id}/log"), Some("runner-secret"), Some(log.to_string())).await.0,
233
        StatusCode::NO_CONTENT
234
    );
235
    let lines = db::flow::log(&h.app.db, a_id, 0, 100).await.unwrap();
236
    assert_eq!(lines.len(), 3);
237
    assert_eq!((lines[2].stream.as_str(), lines[2].text.len()), ("console", 16 * 1024), "streams are known ones, text is capped");
238
    let ph = a["pipeline_hash"].as_str().unwrap();
239
    assert_eq!(
240
        finish(&h.app, a_id, serde_json::json!({ "exit_code": 0, "duration_ms": 700, "receipt": receipt("lint", ph, 0) })).await,
241
        StatusCode::BAD_REQUEST,
242
        "a receipt for another job"
243
    );
244
    assert_eq!(
245
        finish(&h.app, a_id, serde_json::json!({ "exit_code": 0, "duration_ms": 700, "receipt": receipt("build", ph, 0) })).await,
246
        StatusCode::NO_CONTENT
247
    );
248
    assert_eq!(finish(&h.app, a_id, serde_json::json!({ "exit_code": 0, "duration_ms": 700 })).await, StatusCode::CONFLICT, "only once");
249
    assert!(open_remote(&url, &opts).unwrap().refs().is_err(), "the token ends with its job");
250
    assert_eq!(
251
        finish(&h.app, b_id, serde_json::json!({ "exit_code": 0, "duration_ms": 300, "receipt": receipt("lint", ph, 0) })).await,
252
        StatusCode::NO_CONTENT
253
    );
254
    let t = claim(&h.app).await.unwrap();
255
    assert_eq!(t["job"]["name"], "test");
256
    let t_id = t["job_id"].as_i64().unwrap();
257
    assert_eq!(
258
        finish(&h.app, t_id, serde_json::json!({ "exit_code": 3, "duration_ms": 500, "receipt": receipt("test", ph, 3) })).await,
259
        StatusCode::NO_CONTENT
260
    );
261
262
    let run = db::flow::run_by_id(&h.app.db, run.id).await.unwrap().unwrap();
263
    assert_eq!(run.status, "failed");
264
    let jobs = db::flow::jobs(&h.app.db, run.id).await.unwrap();
265
    let build = jobs.iter().find(|j| j.name == "build").unwrap();
266
    assert_eq!((build.status.as_str(), build.exit_code, build.receipt_hash.len()), ("passed", Some(0), 64));
267
    assert_eq!(jobs.iter().find(|j| j.name == "test").unwrap().status, "failed");
268
    let checks = db::hooks::checks_for_state(&h.app.db, run.repo_id, &run.state).await.unwrap();
269
    assert_eq!(
270
        checks.iter().map(|c| (c.name.as_str(), c.status.as_str())).collect::<Vec<_>>(),
271
        [("flow/build", "passed"), ("flow/lint", "passed"), ("flow/test", "failed")]
272
    );
273
    assert!(checks[2].summary.contains("exit 3") && checks[2].url.ends_with(&format!("/andy/demo/flow/{}", run.number)));
274
275
    // Pages: the list, the run with its graph and logs, and the live view.
276
    let (st, list) = call(&h.app, "GET", "/andy/demo/flow", None, None).await;
277
    assert_eq!(st, StatusCode::OK);
278
    assert!(list.contains(&format!("/andy/demo/flow/{}", run.number)) && list.contains("st-failed"), "{list}");
279
    let (st, page) = call(&h.app, "GET", &format!("/andy/demo/flow/{}", run.number), None, None).await;
280
    assert_eq!(st, StatusCode::OK);
281
    assert!(page.contains("<svg class=\"flow-graph\""), "graph");
282
    assert_eq!(page.matches("data-job-node=").count(), 3);
283
    assert_eq!(page.matches("<path class=\"edge").count(), 1, "one dependency edge");
284
    assert!(page.contains("cc -o demo demo.c"), "log shown");
285
    assert!(!page.contains("data-flow-live"), "a finished run does not poll");
286
    let (st, live) = call(&h.app, "GET", &format!("/andy/demo/flow/{}/live?after={a_id}:1", run.number), None, None).await;
287
    assert_eq!(st, StatusCode::OK);
288
    let live: serde_json::Value = serde_json::from_str(&live).unwrap();
289
    assert_eq!(live["status"], "failed");
290
    let build_live = live["jobs"].as_array().unwrap().iter().find(|j| j["name"] == "build").unwrap().clone();
291
    assert_eq!(build_live["lines"].as_array().unwrap().len(), 2, "lines after seq 1");
292
    assert_eq!(call(&h.app, "GET", "/andy/demo/flow/999", None, None).await.0, StatusCode::NOT_FOUND);
293
294
    // A failed dependency skips what follows; an unrun job is an error.
295
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
296
    write(work.path(), "test.sh", "echo changed\n");
297
    c.snapshot("test").unwrap();
298
    c.commit("Change the test", &[]).unwrap();
299
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
300
    let mut second = None;
301
    for _ in 0..100 {
302
        let r = runs_of(&h.app, "andy", "demo").await;
303
        if r.len() == 2 {
304
            second = Some(r[0].clone());
305
            break;
306
        }
307
        tokio::time::sleep(std::time::Duration::from_millis(50)).await;
308
    }
309
    let second = second.expect("a second run");
310
    let x = claim(&h.app).await.unwrap();
311
    let y = claim(&h.app).await.unwrap();
312
    let (build_id, lint_id) = if x["job"]["name"] == "build" {
313
        (x["job_id"].as_i64().unwrap(), y["job_id"].as_i64().unwrap())
314
    } else {
315
        (y["job_id"].as_i64().unwrap(), x["job_id"].as_i64().unwrap())
316
    };
317
    assert_eq!(
318
        finish(&h.app, build_id, serde_json::json!({ "exit_code": null, "duration_ms": 10, "error": "rootfs is not on this runner" }))
319
            .await,
320
        StatusCode::NO_CONTENT
321
    );
322
    assert_eq!(finish(&h.app, lint_id, serde_json::json!({ "exit_code": 0, "duration_ms": 10 })).await, StatusCode::NO_CONTENT);
323
    assert!(claim(&h.app).await.is_none(), "test was skipped");
324
    let jobs = db::flow::jobs(&h.app.db, second.id).await.unwrap();
325
    assert_eq!(
326
        jobs.iter().map(|j| (j.name.as_str(), j.status.as_str())).collect::<Vec<_>>(),
327
        [("build", "error"), ("lint", "passed"), ("test", "skipped")]
328
    );
329
    assert_eq!(db::flow::run_by_id(&h.app.db, second.id).await.unwrap().unwrap().status, "failed");
330
331
    // An invalid pipeline is a run in error with the line.
332
    write(work.path(), ".flow/pipeline.kdl", &pipeline("job \"broken\" {\n    sandbox \"missing\"\n    exec \"x\"\n}\n"));
333
    c.snapshot("test").unwrap();
334
    c.commit("Break the pipeline", &[]).unwrap();
335
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
336
    let mut third = None;
337
    for _ in 0..100 {
338
        let r = runs_of(&h.app, "andy", "demo").await;
339
        if r.len() == 3 {
340
            third = Some(r[0].clone());
341
            break;
342
        }
343
        tokio::time::sleep(std::time::Duration::from_millis(50)).await;
344
    }
345
    let third = third.expect("a third run");
346
    assert_eq!(third.status, "error");
347
    assert!(third.error.contains("line 18") && third.error.contains("\"missing\""), "{}", third.error);
348
    let (_, page) = call(&h.app, "GET", &format!("/andy/demo/flow/{}", third.number), None, None).await;
349
    assert!(page.contains("The pipeline is not valid"));
350
351
    // State stamps (hub spec §13.2) and images in READMEs.
352
    write(work.path(), "README.md", "# Demo\n\n[![flow](.flow/stamp)](.flow/run)\n\n![logo](img/logo.png)\n");
353
    std::fs::create_dir_all(work.path().join("img")).unwrap();
354
    std::fs::write(work.path().join("img/logo.png"), b"\x89PNG\r\n\x1a\n\0\0\0\rIHDR\0\0\0\x01\0\0\0\x01\x08\x06\0\0\0\x1f\x15\xc4\x89")
355
        .unwrap();
356
    c.snapshot("test").unwrap();
357
    c.commit("A README with a stamp", &[]).unwrap();
358
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
359
    let mut fourth = None;
360
    for _ in 0..100 {
361
        let r = runs_of(&h.app, "andy", "demo").await;
362
        if r.len() == 4 {
363
            fourth = Some(r[0].clone());
364
            break;
365
        }
366
        tokio::time::sleep(std::time::Duration::from_millis(50)).await;
367
    }
368
    let fourth = fourth.expect("a fourth run");
369
    let (_, overview) = call(&h.app, "GET", "/andy/demo", None, None).await;
370
    assert!(overview.contains("src=\"/andy/demo/raw/main/.flow/stamp\""), "{overview}");
371
    assert!(overview.contains("href=\"/andy/demo/file/main/.flow/run\""));
372
    assert!(overview.contains("src=\"/andy/demo/raw/main/img/logo.png\""), "images use the raw route");
373
    let (st, _, ct) = head(&h.app, "/andy/demo/raw/main/img/logo.png").await;
374
    assert_eq!((st, ct.as_str()), (StatusCode::OK, "image/png"));
375
    let (st, loc, _) = head(&h.app, "/andy/demo/raw/main/.flow/stamp").await;
376
    assert!(st.is_redirection() && loc == "/andy/demo/flow/stamp/main", "{st} {loc}");
377
    let (st, loc, _) = head(&h.app, "/andy/demo/flow/stamp/main").await;
378
    assert!(st.is_redirection() && loc == format!("/andy/demo/flow/stamp/{}", fourth.heads), "a bookmark's stamp names its state: {loc}");
379
    let (st, _, ct) = head(&h.app, &loc).await;
380
    assert_eq!((st, ct.as_str()), (StatusCode::OK, "image/svg+xml; charset=utf-8"));
381
    let (_, svg) = call(&h.app, "GET", &loc, None, None).await;
382
    assert!(svg.starts_with("<svg") && svg.contains("error ·") && svg.contains(&fourth.heads[..12]), "{svg}");
383
    let (_, svg1) = call(&h.app, "GET", &format!("/andy/demo/flow/stamp/{}", run.heads), None, None).await;
384
    assert!(svg1.contains("failed ·") && svg1.contains(&format!("run #{} failed", run.id)), "an older state keeps its own result: {svg1}");
385
    assert!(svg1.contains(&build.receipt_hash), "receipt hashes in the metadata");
386
    assert_eq!(svg1.matches("text-anchor=\"middle\"").count(), 3, "one glyph per job");
387
    let (st, loc, _) = head(&h.app, "/andy/demo/file/main/.flow/run").await;
388
    assert!(st.is_redirection() && loc == "/andy/demo/flow/at/main", "{loc}");
389
    let (st, loc, _) = head(&h.app, "/andy/demo/flow/at/main").await;
390
    assert!(st.is_redirection() && loc == format!("/andy/demo/flow/{}", fourth.id), "{loc}");
391
392
    // A repository outside [flow] repos starts nothing.
393
    let work2 = tempfile::tempdir().unwrap();
394
    let c2 = client(&format!("{}/other/plain", h.base), work2.path());
395
    write(work2.path(), ".flow/pipeline.kdl", &pipeline(""));
396
    c2.snapshot("test").unwrap();
397
    c2.commit("Pipeline", &[]).unwrap();
398
    assert!(c2.push("origin", false).unwrap().iter().all(|r| r.ok));
399
    tokio::time::sleep(std::time::Duration::from_millis(500)).await;
400
    let row = db::repos::get(&h.app.db, "other", "plain").await.unwrap().unwrap();
401
    assert!(db::flow::runs(&h.app.db, row.id, 10, None).await.unwrap().is_empty());
402
    let (_, page) = call(&h.app, "GET", "/other/plain/flow", None, None).await;
403
    assert!(page.contains("not enabled for this repository"));
404
    let (_, loc, _) = head(&h.app, "/other/plain/flow/stamp/main").await;
405
    let (_, svg) = call(&h.app, "GET", &loc, None, None).await;
406
    assert!(svg.contains("no run ·"), "{svg}");
407
    let (_, loc, _) = head(&h.app, "/other/plain/flow/at/main").await;
408
    assert_eq!(loc, "/other/plain/flow");
409
}
410
411
#[tokio::test(flavor = "multi_thread")]
412
async fn claims_carry_pinned_subrepos_and_the_job_token_reads_only_those() {
413
    let h = hub().await;
414
    for n in ["base", "lib", "vault", "other", "app"] {
415
        create(&h.app, "andy", n).await;
416
    }
417
    let push = |name: &str, file: &str| {
418
        let work = tempfile::tempdir().unwrap();
419
        let c = client(&format!("{}/andy/{name}", h.base), work.path());
420
        write(work.path(), file, "x\n");
421
        c.snapshot("t").unwrap();
422
        c.commit("first", &[]).unwrap();
423
        assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
424
        let heads = c.bookmark_heads().unwrap();
425
        (work, heads)
426
    };
427
    let (_b, base_heads) = push("base", "base.rs");
428
    // lib pins base in turn: a subrepo of a subrepo.
429
    let lib_work = tempfile::tempdir().unwrap();
430
    let lib = client(&format!("{}/andy/lib", h.base), lib_work.path());
431
    lib.submodule_add(&format!("{}/andy/base", h.base), "deps/base", Some("main")).unwrap();
432
    write(lib_work.path(), "lib.rs", "x\n");
433
    lib.snapshot("t").unwrap();
434
    lib.commit("lib on base", &[]).unwrap();
435
    assert!(lib.push("origin", false).unwrap().iter().all(|r| r.ok));
436
    let lib_heads = lib.bookmark_heads().unwrap();
437
    let (_v, _) = push("vault", "secret.rs");
438
    let (_o, _) = push("other", "o.rs");
439
440
    // The app pins lib and vault as subrepos and pushes as the site token.
441
    let work = tempfile::tempdir().unwrap();
442
    let app = client(&format!("{}/andy/app", h.base), work.path());
443
    app.submodule_add(&format!("{}/andy/lib", h.base), "deps/lib", Some("main")).unwrap();
444
    // Vault is private: adding it takes the environment's token, as a clone does.
445
    sqlx::query("UPDATE repositories SET visibility = 'private' WHERE name = 'vault'").execute(&h.app.db).await.unwrap();
446
    assert!(app.submodule_add(&format!("{}/andy/vault", h.base), "deps/vault2", Some("main")).is_err(), "not without a token");
447
    std::env::set_var("OXY_TOKEN", "site");
448
    app.submodule_add(&format!("{}/andy/vault", h.base), "deps/vault", Some("main")).unwrap();
449
    std::env::remove_var("OXY_TOKEN");
450
    // The pusher below is the site token, which has no account: it cannot read vault.
451
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
452
    write(work.path(), "Makefile", "all:\n");
453
    app.snapshot("t").unwrap();
454
    app.commit("app with deps", &[]).unwrap();
455
    assert!(app.push("origin", false).unwrap().iter().all(|r| r.ok));
456
    assert!(!runs_of(&h.app, "andy", "app").await.is_empty());
457
458
    let job = claim(&h.app).await.unwrap();
459
    let subs = job["subrepos"].as_array().cloned().unwrap_or_default();
460
    assert_eq!(subs.len(), 2, "lib and what lib pins; vault is private and the pusher has no account: {subs:?}");
461
    assert_eq!(subs[1]["path"], "deps/lib/deps/base", "nested under its parent, after it");
462
    assert_eq!(subs[1]["heads"], serde_json::json!(base_heads.iter().map(|h| h.to_hex()).collect::<Vec<_>>()));
463
    let _ = std::fs::remove_dir_all(work.path().join("deps/vault2"));
464
    assert_eq!(subs[0]["path"], "deps/lib");
465
    assert_eq!(subs[0]["repo"], "andy/lib");
466
    assert_eq!(subs[0]["heads"], serde_json::json!(lib_heads.iter().map(|h| h.to_hex()).collect::<Vec<_>>()));
467
    assert!(subs[0]["clone_url"].as_str().unwrap().ends_with("/andy/lib"));
468
469
    // The job token reads its repository and the pinned lib, nothing else.
470
    let token = job["token"].as_str().unwrap().to_string();
471
    let read = |name: &str| {
472
        let opts = RemoteOptions { token: Some(token.clone()), ..Default::default() };
473
        open_remote(&format!("{}/andy/{name}", h.base), &opts).and_then(|r| r.refs()).is_ok()
474
    };
475
    assert!(read("app") && read("lib") && read("base"));
476
    assert!(!read("vault"), "not pinned for this pusher");
477
    assert!(!read("other"), "public, but not the job's to read");
478
}
479
480
#[tokio::test(flavor = "multi_thread", worker_threads = 8)]
481
async fn concurrent_log_appends_never_fail_on_a_locked_database() {
482
    let h = hub().await;
483
    create(&h.app, "andy", "demo").await;
484
    let work = tempfile::tempdir().unwrap();
485
    let c = client(&format!("{}/andy/demo", h.base), work.path());
486
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
487
    write(work.path(), "Makefile", "all:\n");
488
    c.snapshot("t").unwrap();
489
    c.commit("pipeline", &[]).unwrap();
490
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
491
    let run = runs_of(&h.app, "andy", "demo").await.remove(0);
492
    let job = db::flow::jobs(&h.app.db, run.id).await.unwrap().remove(0);
493
    // Many writers at once, each reading the count and then inserting: a
494
    // deferred transaction would fail with "database is locked".
495
    let mut tasks = Vec::new();
496
    for w in 0..16 {
497
        let pool = h.app.db.clone();
498
        tasks.push(tokio::spawn(async move {
499
            let records: Vec<flow_core::api::Record> =
500
                (0..20).map(|i| flow_core::api::Record { t: i, stream: "out".into(), text: format!("writer {w} line {i}") }).collect();
501
            db::flow::append_log(&pool, job.id, &records, 100_000).await
502
        }));
503
    }
504
    for t in tasks {
505
        assert_eq!(t.await.unwrap().unwrap(), 20, "every append succeeds");
506
    }
507
    let lines = db::flow::log(&h.app.db, job.id, 0, 1_000).await.unwrap();
508
    assert_eq!(lines.len(), 320);
509
    let seqs: std::collections::BTreeSet<i64> = lines.iter().map(|l| l.seq).collect();
510
    assert_eq!(seqs.len(), 320, "sequence numbers are unique");
511
}
512
513
/// A repository's own Flow setting overrides hub.toml either way.
514
#[tokio::test(flavor = "multi_thread")]
515
async fn a_repository_setting_turns_flow_on_or_off() {
516
    let h = hub().await;
517
    create(&h.app, "other", "plain").await;
518
    create(&h.app, "andy", "quiet").await;
519
    // A run elsewhere first, so hub-wide ids and per-repository numbers differ.
520
    create(&h.app, "andy", "first").await;
521
    {
522
        let work = tempfile::tempdir().unwrap();
523
        let c = client(&format!("{}/andy/first", h.base), work.path());
524
        write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
525
        write(work.path(), "test.sh", "echo ok\n");
526
        c.commit("Add a pipeline", &[]).unwrap();
527
        assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
528
        assert_eq!(runs_of(&h.app, "andy", "first").await.len(), 1);
529
    }
530
    let row = db::repos::get(&h.app.db, "other", "plain").await.unwrap().unwrap();
531
    db::repos::set_flow(&h.app.db, row.id, "on").await.unwrap();
532
    let quiet = db::repos::get(&h.app.db, "andy", "quiet").await.unwrap().unwrap();
533
    db::repos::set_flow(&h.app.db, quiet.id, "off").await.unwrap();
534
    for (owner, name) in [("other", "plain"), ("andy", "quiet")] {
535
        let work = tempfile::tempdir().unwrap();
536
        let c = client(&format!("{}/{owner}/{name}", h.base), work.path());
537
        write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
538
        write(work.path(), "test.sh", "echo ok\n");
539
        c.commit("Add a pipeline", &[]).unwrap();
540
        assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
541
    }
542
    let plain = runs_of(&h.app, "other", "plain").await;
543
    assert_eq!(plain.len(), 1, "turned on");
544
    // With andy/first's jobs ahead, plain's run says where it stands.
545
    let a = claim(&h.app).await.unwrap();
546
    assert_eq!(a["repo"], "andy/first");
547
    let (_, page) = call(&h.app, "GET", "/other/plain/flow/1", None, None).await;
548
    assert!(page.contains("Waiting for a runner: 3rd in line") && page.contains("Running now: andy/first #1"), "{page}");
549
    let (_, body) = call(&h.app, "GET", "/api/v1/repos/other/plain/flow/runs/1", None, None).await;
550
    assert_eq!(serde_json::from_str::<serde_json::Value>(&body).unwrap()["queue_position"], 3);
551
    let (_, list) = call(&h.app, "GET", "/other/plain/flow", None, None).await;
552
    assert!(list.contains("queued, 3rd in line"), "{list}");
553
    // Runs are numbered per repository: this is plain's first, whatever
554
    // other repositories ran before.
555
    assert_eq!(plain[0].number, 1);
556
    let checks = checks_when(&h.app, row.id, &plain[0].state, 3).await;
557
    assert!(checks.iter().all(|c| c.url.ends_with("/other/plain/flow/1")), "{checks:?}");
558
    let (st, page) = call(&h.app, "GET", "/other/plain/flow/1", None, None).await;
559
    assert!(st == StatusCode::OK && page.contains("Run #1"), "{st}");
560
    assert!(runs_of(&h.app, "andy", "quiet").await.is_empty(), "turned off despite andy/*");
561
}
562
563
/// "Run pipeline" and "Re-run" (hub spec §13.2): runs that move no
564
/// bookmark, through the API and the pages.
565
#[tokio::test(flavor = "multi_thread")]
566
async fn runs_start_without_a_push_and_finished_runs_re_run() {
567
    let h = hub().await;
568
    // The site token acts as the first site administrator.
569
    db::accounts::create_account(&h.app.db, "andy", "[email protected]", "x", "salt", true).await.unwrap();
570
    create(&h.app, "andy", "demo").await;
571
    let url = format!("{}/andy/demo", h.base);
572
    let work = tempfile::tempdir().unwrap();
573
    let c = client(&url, work.path());
574
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
575
    write(work.path(), "test.sh", "echo ok\n");
576
    c.commit("Add a pipeline", &[]).unwrap();
577
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
578
    let first = runs_of(&h.app, "andy", "demo").await;
579
    assert_eq!((first.len(), first[0].trigger.as_str()), (1, "push"));
580
581
    // Run pipeline on the default bookmark: a new run of the same state.
582
    let (st, body) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs", Some("site"), Some("{}".into())).await;
583
    assert_eq!(st, StatusCode::CREATED, "{body}");
584
    let v: serde_json::Value = serde_json::from_str(&body).unwrap();
585
    assert_eq!(v["number"], 2);
586
    assert!(v["url"].as_str().unwrap().ends_with("/andy/demo/flow/2"));
587
    let second = db::flow::run(&h.app.db, first[0].repo_id, 2).await.unwrap().unwrap();
588
    assert_eq!((second.trigger.as_str(), second.actor.as_str(), second.state.as_str()), ("manual", "andy", first[0].state.as_str()));
589
    assert_eq!(db::flow::jobs(&h.app.db, second.id).await.unwrap().len(), 3);
590
    let (_, page) = call(&h.app, "GET", "/andy/demo/flow/2", None, None).await;
591
    assert!(page.contains("started by andy"), "the run page says what started it");
592
593
    // A live run is not re-run; unknown bookmarks and runs are refused.
594
    let (st, body) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs/1/rerun", Some("site"), None).await;
595
    assert!(st == StatusCode::CONFLICT && body.contains("still queued"), "{st} {body}");
596
    let (st, _) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs", Some("site"), Some(r#"{"bookmark":"nope"}"#.into())).await;
597
    assert_eq!(st, StatusCode::CONFLICT);
598
    let (st, _) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs/99/rerun", Some("site"), None).await;
599
    assert_eq!(st, StatusCode::NOT_FOUND);
600
    // Anonymous callers cannot start runs.
601
    let (st, _) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs", None, Some("{}".into())).await;
602
    assert_ne!(st, StatusCode::CREATED);
603
604
    // A finished run re-runs as a new run of the same state.
605
    let row = db::repos::get(&h.app.db, "andy", "demo").await.unwrap().unwrap();
606
    for r in [&first[0], &second] {
607
        for j in db::flow::jobs(&h.app.db, r.id).await.unwrap() {
608
            sqlx::query("UPDATE flow_jobs SET status = 'passed' WHERE id = ?").bind(j.id).execute(&h.app.db).await.unwrap();
609
        }
610
        sqlx::query("UPDATE flow_runs SET status = 'passed', finished_ms = 1 WHERE id = ?").bind(r.id).execute(&h.app.db).await.unwrap();
611
    }
612
    let (st, body) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs/1/rerun", Some("site"), None).await;
613
    assert_eq!(st, StatusCode::CREATED, "{body}");
614
    let third = db::flow::run(&h.app.db, row.id, 3).await.unwrap().unwrap();
615
    assert_eq!((third.trigger.as_str(), third.status.as_str(), third.state.as_str()), ("rerun:1", "queued", first[0].state.as_str()));
616
    let checks = db::hooks::checks_for_state(&h.app.db, row.id, &third.state).await.unwrap();
617
    assert!(
618
        checks.iter().all(|c| c.status == "queued" && c.url.ends_with("/flow/3")),
619
        "the re-run's checks replace the old ones: {checks:?}"
620
    );
621
    let (_, page) = call(&h.app, "GET", "/andy/demo/flow/3", None, None).await;
622
    assert!(page.contains("re-run of #1 by andy"));
623
    assert!(!page.contains("RE-RUN"), "anonymous viewers get no button");
624
625
    // With Flow off, nothing starts.
626
    db::repos::set_flow(&h.app.db, row.id, "off").await.unwrap();
627
    let (st, body) = call(&h.app, "POST", "/api/v1/repos/andy/demo/flow/runs", Some("site"), Some("{}".into())).await;
628
    assert!(st == StatusCode::CONFLICT && body.contains("not enabled"), "{body}");
629
}
630
631
/// The Flow API (hub spec §13.2): runs, a run with its jobs, a job's log,
632
/// checks by the heads a client has, and JSON for unknown API routes.
633
#[tokio::test(flavor = "multi_thread")]
634
async fn runs_jobs_and_logs_are_in_the_api() {
635
    let h = hub().await;
636
    create(&h.app, "andy", "demo").await;
637
    let url = format!("{}/andy/demo", h.base);
638
    let work = tempfile::tempdir().unwrap();
639
    let c = client(&url, work.path());
640
    write(work.path(), ".flow/pipeline.kdl", &pipeline(""));
641
    write(work.path(), "test.sh", "echo ok\n");
642
    let head = c.commit("Add a pipeline", &[]).unwrap();
643
    assert!(c.push("origin", false).unwrap().iter().all(|r| r.ok));
644
    let run = runs_of(&h.app, "andy", "demo").await.remove(0);
645
646
    // A job runs and logs.
647
    let a = claim(&h.app).await.unwrap();
648
    let id = a["job_id"].as_i64().unwrap();
649
    let recs =
650
        serde_json::json!({ "records": [{ "t": 1, "stream": "stdout", "text": "one" }, { "t": 3, "stream": "stderr", "text": "three" }] });
651
    let (st, _) = call(&h.app, "POST", &format!("/api/v1/flow/jobs/{id}/log"), Some("runner-secret"), Some(recs.to_string())).await;
652
    assert!(st.is_success(), "{st}");
653
654
    let (st, body) = call(&h.app, "GET", "/api/v1/repos/andy/demo/flow/runs", None, None).await;
655
    assert_eq!(st, StatusCode::OK, "{body}");
656
    let runs: Vec<hub_api::FlowRun> = serde_json::from_str(&body).unwrap();
657
    assert_eq!(runs.len(), 1);
658
    assert_eq!((runs[0].number, runs[0].state.as_str(), runs[0].trigger.as_str()), (1, run.state.as_str(), "push"));
659
    assert!(runs[0].url.ends_with("/andy/demo/flow/1") && runs[0].jobs.is_empty());
660
661
    let (_, body) = call(&h.app, "GET", "/api/v1/repos/andy/demo/flow/runs/1", None, None).await;
662
    let one: hub_api::FlowRun = serde_json::from_str(&body).unwrap();
663
    let names: Vec<(&str, &str)> = one.jobs.iter().map(|j| (j.name.as_str(), j.status.as_str())).collect();
664
    assert_eq!(names.len(), 3);
665
    let running = one.jobs.iter().find(|j| j.status == "running").unwrap();
666
    assert_eq!(running.name, a["job"]["name"].as_str().unwrap());
667
    assert!(one.jobs.iter().any(|j| j.name == "test" && j.depends_on == ["build"]));
668
669
    let job = running.name.clone();
670
    let (st, body) = call(&h.app, "GET", &format!("/api/v1/repos/andy/demo/flow/runs/1/jobs/{job}/log"), None, None).await;
671
    assert_eq!(st, StatusCode::OK, "{body}");
672
    let lines: Vec<hub_api::FlowLogLine> = serde_json::from_str(&body).unwrap();
673
    assert!(lines.iter().any(|l| l.text == "three"), "{body}");
674
    let last = lines.last().unwrap().seq;
675
    let (_, body) = call(&h.app, "GET", &format!("/api/v1/repos/andy/demo/flow/runs/1/jobs/{job}/log?after={last}"), None, None).await;
676
    assert_eq!(body, "[]", "nothing after the last line");
677
    assert_eq!(call(&h.app, "GET", "/api/v1/repos/andy/demo/flow/runs/9", None, None).await.0, StatusCode::NOT_FOUND);
678
    assert_eq!(call(&h.app, "GET", "/api/v1/repos/andy/demo/flow/runs/1/jobs/nope/log", None, None).await.0, StatusCode::NOT_FOUND);
679
680
    // Checks by the state hash, by the head `oxy log` shows, and by bookmark.
681
    let by = |key: String| {
682
        let app = h.app.clone();
683
        async move {
684
            let (st, body) = call(&app, "GET", &format!("/api/v1/repos/andy/demo/checks/{key}"), None, None).await;
685
            assert_eq!(st, StatusCode::OK, "{key}: {body}");
686
            serde_json::from_str::<Vec<hub_api::Check>>(&body).unwrap().len()
687
        }
688
    };
689
    checks_when(&h.app, run.repo_id, &run.state, 3).await;
690
    assert_eq!(by(run.state.clone()).await, 3);
691
    assert_eq!(by(head.to_hex()).await, 3, "a single head names its state");
692
    assert_eq!(by("main".into()).await, 3);
693
    let (st, _) = call(&h.app, "GET", "/api/v1/repos/andy/demo/checks/no-such-bookmark", None, None).await;
694
    assert_eq!(st, StatusCode::NOT_FOUND);
695
696
    // An unknown API route answers with a problem document.
697
    let (st, body) = call(&h.app, "GET", "/api/v1/users/andy/repos", None, None).await;
698
    assert_eq!(st, StatusCode::NOT_FOUND);
699
    let v: serde_json::Value = serde_json::from_str(&body).unwrap();
700
    assert_eq!(v["status"], 404, "{body}");
701
}