Skip to content

Commit 04d272a

Browse files
committed
README update
1 parent b700e4b commit 04d272a

File tree

1 file changed

+37
-15
lines changed

1 file changed

+37
-15
lines changed

README-MAINTAINER.md

Lines changed: 37 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -410,25 +410,24 @@ location (like
410410
<https://github.com/xpack-dev-tools/files-cache/tree/master/libs>),
411411
place them in the XBB cache (`Work/cache`) and restart the build.
412412

413-
### Push the build scripts
414-
415-
- push the `xpack-develop` branch to GitHub
416-
- possibly push the helper project too
417-
418-
From here it'll be cloned on the production machines.
419-
420413
## Run the CI build
421414

422415
The automation is provided by GitHub Actions and three self-hosted runners.
423416

417+
### Temporarily disable multi-lib
418+
424419
It is recommended to do **a first run without the multi-libs**
425-
(see the `defs-source.sh` file), test it,
420+
(see the `application.sh` file), test it,
426421
and, when ready, rerun the full build.
427422

423+
### Generate the GitHub workflows
424+
428425
Run the `generate-workflows` to re-generate the
429426
GitHub workflow files; commit and push if necessary.
430427

431-
- on a permanently running machine (`berry`) open ssh sessions to the build
428+
### Start the self-hosted runners
429+
430+
- on the development machine (`wksi`) open ssh sessions to the build
432431
machines (`xbbma`, `xbbli`, `xbbla64` and `xbbla32`):
433432

434433
```sh
@@ -455,9 +454,16 @@ For `xbbli` & `xbbla64` start two runners:
455454
~/actions-runners/xpack-dev-tools/2/run.sh &
456455
```
457456

458-
Check that the project is pushed to GitHub.
457+
### Push the build scripts
458+
459+
- push the `xpack-develop` branch to GitHub
460+
- possibly push the helper project too
461+
462+
From here it'll be cloned on the production machines.
463+
464+
### Manually trigger the build GitHub Actions
459465

460-
To trigger the GitHub Actions build, use the xPack actions:
466+
To trigger the GitHub Actions builds, use the xPack actions:
461467

462468
- `trigger-workflow-build-xbbli`
463469
- `trigger-workflow-build-xbbla64`
@@ -483,13 +489,29 @@ page.
483489

484490
These commands use the `xpack-develop` branch of this repo.
485491

492+
### Re-enable multi-lib
493+
494+
- comment out `XBB_APPLICATION_WITHOUT_MULTILIB` in `application.sh`
495+
- commit and push the repo
496+
497+
#### Test multilib builds
498+
499+
Multilib builds take too long to run tests on all platforms,
500+
run them only on the fast machines, like `xbbma` and `xbbli`.
501+
502+
### Manually trigger the multilib build GitHub Actions
503+
504+
To trigger the GitHub Actions builds, use the same xPack actions as before.
505+
506+
## Durations & results
507+
486508
The full builds take about 14 hours (3h30 without multilib):
487509

488510
- `xbbmi`: 6h20 (1h00)
489-
- `xbbma`: 2h41 (23m)
490-
- `xbbli`: 3h30 (3h30 Linux, 3h30 Windows; without multi-lib: 37m Linux, 33m Windows)
491-
- `xbbla64`: 12h51 (3h27)
492-
- `xbbla32`: 13h30 (3h20)
511+
- `xbbma`: 2h22 (23m)
512+
- `xbbli`: 5h00 (2h40 Linux, 0h44 Windows; without multi-lib: 37m Linux, 33m Windows)
513+
- `xbbla64`: 13h33 (3h30)
514+
- `xbbla32`: 14h00 (3h15)
493515

494516
The workflows results and logs are available from the
495517
[Actions](https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/actions/) page.

0 commit comments

Comments
 (0)