Login
Hex Artifact Content
Login

Artifact 8ea141cc52df1fc08858015a132a9d04c0933a6ae03873b72744cf941bcbbd5b:

Attachment "run-bq2-build.md" to tech note [51f68a2d75] added by opus-ocx2 2026-10-20 06:06:09.
0000: 62 71 32 27 73 20 62 75 69 6c 64 20 6f 66 20 6f  bq2's build of o
0010: 6e 65 20 63 68 65 63 6b 2d 69 6e 2c 20 61 73 20  ne check-in, as 
0020: 61 20 6a 6f 62 2c 20 68 6f 6c 64 69 6e 67 20 6e  a job, holding n
0030: 6f 20 63 72 65 64 65 6e 74 69 61 6c 3a 20 69 74  o credential: it
0040: 73 20 66 69 6c 65 73 3b 20 74 68 65 0a 62 75 69  s files; the.bui
0050: 6c 64 27 73 20 77 68 6f 6c 65 20 6f 75 74 70 75  ld's whole outpu
0060: 74 20 6b 65 70 74 20 61 73 20 60 6a 6f 62 2e 6c  t kept as `job.l
0070: 6f 67 60 20 69 6e 20 74 68 65 20 72 75 6e 27 73  og` in the run's
0080: 20 77 6f 72 6b 73 70 61 63 65 3b 20 6f 6e 20 61   workspace; on a
0090: 20 66 61 69 6c 75 72 65 2c 0a 74 68 65 20 6c 61   failure,.the la
00a0: 73 74 20 31 30 30 20 6c 69 6e 65 73 20 6f 66 20  st 100 lines of 
00b0: 65 61 63 68 20 66 69 6c 65 20 74 68 65 20 62 75  each file the bu
00c0: 69 6c 64 20 77 72 6f 74 65 20 75 6e 64 65 72 20  ild wrote under 
00d0: 69 74 73 20 72 65 70 6f 72 74 73 20 64 69 72 65  its reports dire
00e0: 63 74 6f 72 79 2c 0a 74 68 65 6e 20 74 68 65 20  ctory,.then the 
00f0: 6c 6f 67 27 73 20 6c 61 73 74 20 31 30 30 20 6c  log's last 100 l
0100: 69 6e 65 73 2c 20 70 6f 73 74 65 64 20 77 68 65  ines, posted whe
0110: 72 65 20 74 68 65 20 72 75 6e 20 69 73 2e 20 45  re the run is. E
0120: 76 65 72 79 20 72 75 6e 20 69 73 20 75 73 65 72  very run is user
0130: 0a 60 62 71 32 2d 62 75 69 6c 64 60 27 73 2c 20  .`bq2-build`'s, 
0140: 77 68 69 63 68 20 68 61 73 20 6e 6f 20 61 63 63  which has no acc
0150: 6f 75 6e 74 2c 20 73 6f 20 69 74 73 20 6e 6f 64  ount, so its nod
0160: 65 20 72 75 6e 73 20 6f 6e 65 20 61 74 20 61 20  e runs one at a 
0170: 74 69 6d 65 2e 20 49 74 20 68 61 73 20 6e 6f 0a  time. It has no.
0180: 6c 69 6d 69 74 3a 20 60 6f 63 78 32 20 73 74 6f  limit: `ocx2 sto
0190: 70 20 52 55 4e 60 20 65 6e 64 73 20 6f 6e 65 2e  p RUN` ends one.
01a0: 20 45 61 63 68 20 72 75 6e 20 62 75 69 6c 64 73   Each run builds
01b0: 20 60 64 61 74 61 2f 73 79 73 72 6f 6f 74 60 20   `data/sysroot` 
01c0: 61 66 72 65 73 68 2c 20 75 6e 74 69 6c 20 61 0a  afresh, until a.
01d0: 75 73 65 72 27 73 20 63 61 63 68 65 20 6b 65 65  user's cache kee
01e0: 70 73 20 69 74 20 62 65 74 77 65 65 6e 20 72 75  ps it between ru
01f0: 6e 73 2e 20 63 72 65 61 74 65 20 61 64 64 73 20  ns. create adds 
0200: 74 68 65 20 6e 6f 64 65 20 61 6e 64 20 74 68 65  the node and the
0210: 20 6f 62 6a 65 63 74 69 76 65 3b 0a 60 2d 2d 6f   objective;.`--o
0220: 66 60 20 6e 61 6d 65 73 20 74 68 65 20 63 68 65  f` names the che
0230: 63 6b 2d 69 6e 2e 0a 0a 60 60 60 6a 73 6f 6e 0a  ck-in...```json.
0240: 7b 0a 20 20 22 77 6f 72 6b 73 70 61 63 65 22 3a  {.  "workspace":
0250: 20 5b 0a 20 20 20 20 7b 22 73 74 65 70 22 3a 20   [.    {"step": 
0260: 22 64 69 72 65 63 74 6f 72 79 22 2c 20 22 61 74  "directory", "at
0270: 22 3a 20 22 24 24 72 6f 6f 74 24 24 2f 24 24 75  ": "$$root$$/$$u
0280: 73 65 72 24 24 2f 70 72 6f 6a 65 63 74 73 2f 24  ser$$/projects/$
0290: 24 70 72 6f 6a 65 63 74 24 24 2f 24 24 72 75 6e  $project$$/$$run
02a0: 24 24 22 7d 2c 0a 20 20 20 20 7b 22 73 74 65 70  $$"},.    {"step
02b0: 22 3a 20 22 66 69 6c 65 73 22 2c 20 22 6f 66 22  ": "files", "of"
02c0: 3a 20 22 74 72 75 6e 6b 22 2c 20 22 69 6e 74 6f  : "trunk", "into
02d0: 22 3a 20 22 24 24 77 6f 72 6b 73 70 61 63 65 24  ": "$$workspace$
02e0: 24 2f 74 72 65 65 22 7d 0a 20 20 5d 2c 0a 20 20  $/tree"}.  ],.  
02f0: 22 73 61 6e 64 62 6f 78 22 3a 20 7b 0a 20 20 20  "sandbox": {.   
0300: 20 22 75 69 64 22 3a 20 31 30 30 30 2c 20 22 67   "uid": 1000, "g
0310: 69 64 22 3a 20 31 30 30 30 2c 20 22 63 61 70 61  id": 1000, "capa
0320: 62 69 6c 69 74 69 65 73 22 3a 20 5b 5d 2c 20 22  bilities": [], "
0330: 6e 65 74 77 6f 72 6b 22 3a 20 74 72 75 65 2c 0a  network": true,.
0340: 20 20 20 20 22 6f 77 6e 5f 73 65 73 73 69 6f 6e      "own_session
0350: 22 3a 20 74 72 75 65 2c 20 22 65 6e 64 73 5f 77  ": true, "ends_w
0360: 69 74 68 5f 6e 6f 64 65 22 3a 20 74 72 75 65 2c  ith_node": true,
0370: 0a 20 20 20 20 22 72 65 61 64 5f 6f 6e 6c 79 22  .    "read_only"
0380: 3a 20 5b 22 2f 75 73 72 22 2c 20 22 2f 62 69 6e  : ["/usr", "/bin
0390: 22 2c 20 22 2f 73 62 69 6e 22 2c 20 22 2f 6c 69  ", "/sbin", "/li
03a0: 62 22 2c 20 22 2f 6c 69 62 36 34 22 2c 20 22 2f  b", "/lib64", "/
03b0: 65 74 63 2f 72 65 73 6f 6c 76 2e 63 6f 6e 66 22  etc/resolv.conf"
03c0: 2c 20 22 2f 65 74 63 2f 68 6f 73 74 73 22 2c 0a  , "/etc/hosts",.
03d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
03e0: 20 20 22 2f 65 74 63 2f 6e 73 73 77 69 74 63 68    "/etc/nsswitch
03f0: 2e 63 6f 6e 66 22 2c 20 22 2f 65 74 63 2f 73 73  .conf", "/etc/ss
0400: 6c 22 2c 20 22 2f 65 74 63 2f 70 6b 69 22 5d 2c  l", "/etc/pki"],
0410: 0a 20 20 20 20 22 72 65 61 64 5f 77 72 69 74 65  .    "read_write
0420: 22 3a 20 5b 22 24 24 77 6f 72 6b 73 70 61 63 65  ": ["$$workspace
0430: 24 24 22 5d 2c 0a 20 20 20 20 22 68 6f 6d 65 73  $$"],.    "homes
0440: 22 3a 20 5b 5d 2c 0a 20 20 20 20 22 66 69 6c 65  ": [],.    "file
0450: 73 22 3a 20 5b 7b 22 61 74 22 3a 20 22 2f 65 74  s": [{"at": "/et
0460: 63 2f 70 61 73 73 77 64 22 2c 20 22 74 65 78 74  c/passwd", "text
0470: 22 3a 20 22 24 24 75 73 65 72 24 24 3a 78 3a 31  ": "$$user$$:x:1
0480: 30 30 30 3a 31 30 30 30 3a 3a 24 24 77 6f 72 6b  000:1000::$$work
0490: 73 70 61 63 65 24 24 3a 2f 62 69 6e 2f 73 68 5c  space$$:/bin/sh\
04a0: 6e 22 7d 5d 2c 0a 20 20 20 20 22 70 72 6f 63 22  n"}],.    "proc"
04b0: 3a 20 22 2f 70 72 6f 63 22 2c 20 22 64 65 76 22  : "/proc", "dev"
04c0: 3a 20 22 2f 64 65 76 22 2c 20 22 74 6d 70 22 3a  : "/dev", "tmp":
04d0: 20 22 2f 74 6d 70 22 0a 20 20 7d 2c 0a 20 20 22   "/tmp".  },.  "
04e0: 70 72 6f 63 65 73 73 22 3a 20 7b 0a 20 20 20 20  process": {.    
04f0: 22 75 73 65 72 22 3a 20 22 62 71 32 2d 62 75 69  "user": "bq2-bui
0500: 6c 64 22 2c 0a 20 20 20 20 22 63 6f 6d 6d 61 6e  ld",.    "comman
0510: 64 22 3a 20 5b 22 73 68 22 2c 20 22 2d 63 22 2c  d": ["sh", "-c",
0520: 20 22 7b 20 73 68 61 72 64 73 20 62 75 69 6c 64   "{ shards build
0530: 20 26 26 20 62 69 6e 2f 73 79 73 72 6f 6f 74 2d   && bin/sysroot-
0540: 62 75 69 6c 64 65 72 20 26 26 20 62 69 6e 2f 73  builder && bin/s
0550: 79 73 72 6f 6f 74 2d 72 75 6e 6e 65 72 3b 20 7d  ysroot-runner; }
0560: 20 3e 20 24 24 77 6f 72 6b 73 70 61 63 65 24 24   > $$workspace$$
0570: 2f 6a 6f 62 2e 6c 6f 67 20 32 3e 26 31 3b 20 73  /job.log 2>&1; s
0580: 3d 24 3f 3b 20 5b 20 24 73 20 3d 20 30 20 5d 20  =$?; [ $s = 0 ] 
0590: 7c 7c 20 7b 20 66 69 6e 64 20 64 61 74 61 2f 73  || { find data/s
05a0: 79 73 72 6f 6f 74 2f 73 65 65 64 2d 72 6f 6f 74  ysroot/seed-root
05b0: 66 73 2f 62 71 32 2d 72 6f 6f 74 66 73 2f 77 6f  fs/bq2-rootfs/wo
05c0: 72 6b 73 70 61 63 65 2f 73 79 73 72 6f 6f 74 2d  rkspace/sysroot-
05d0: 62 75 69 6c 64 2d 72 65 70 6f 72 74 73 20 2d 74  build-reports -t
05e0: 79 70 65 20 66 20 2d 65 78 65 63 20 74 61 69 6c  ype f -exec tail
05f0: 20 2d 76 20 2d 6e 20 31 30 30 20 7b 7d 20 2b 3b   -v -n 100 {} +;
0600: 20 74 61 69 6c 20 2d 6e 20 31 30 30 20 24 24 77   tail -n 100 $$w
0610: 6f 72 6b 73 70 61 63 65 24 24 2f 6a 6f 62 2e 6c  orkspace$$/job.l
0620: 6f 67 3b 20 7d 3b 20 65 78 69 74 20 24 73 22 5d  og; }; exit $s"]
0630: 2c 0a 20 20 20 20 22 63 77 64 22 3a 20 22 24 24  ,.    "cwd": "$$
0640: 74 72 65 65 24 24 22 2c 0a 20 20 20 20 22 65 6e  tree$$",.    "en
0650: 76 22 3a 20 7b 22 48 4f 4d 45 22 3a 20 22 24 24  v": {"HOME": "$$
0660: 77 6f 72 6b 73 70 61 63 65 24 24 22 2c 20 22 55  workspace$$", "U
0670: 53 45 52 22 3a 20 22 24 24 75 73 65 72 24 24 22  SER": "$$user$$"
0680: 2c 20 22 50 41 54 48 22 3a 20 22 2f 75 73 72 2f  , "PATH": "/usr/
0690: 6c 6f 63 61 6c 2f 62 69 6e 3a 2f 75 73 72 2f 62  local/bin:/usr/b
06a0: 69 6e 3a 2f 62 69 6e 22 7d 0a 20 20 7d 0a 7d 0a  in:/bin"}.  }.}.
06b0: 60 60 60 0a                                      ```.