forked from tfgrid/zosbuilder
build: remove testing.sh in favor of runit.sh; add claude.md reference
Replace inline boot testing with standalone runit.sh runner for clarity: - Remove scripts/lib/testing.sh source and boot_tests stage from build.sh - Remove --skip-tests option from build.sh and rebuild-after-zinit.sh - Update all docs to reference runit.sh for QEMU/cloud-hypervisor testing - Add comprehensive claude.md as AI assistant entry point with guidelines Testing is now fully decoupled from build pipeline; use ./runit.sh for QEMU/cloud-hypervisor validation after builds complete.
This commit is contained in:
@@ -176,9 +176,12 @@ Stage System and Incremental Rebuilds
|
||||
- Shows stage status before/after marker removal; no --rebuild-from is passed by default (relies on markers only).
|
||||
- Manual minimal rebuild:
|
||||
- Remove relevant .done files, e.g.: initramfs_create.done initramfs_test.done validation.done
|
||||
- Rerun: DEBUG=1 ./scripts/build.sh --skip-tests
|
||||
- Rerun: DEBUG=1 ./scripts/build.sh
|
||||
- Show status:
|
||||
- ./scripts/build.sh --show-stages
|
||||
- Test built kernel:
|
||||
- ./runit.sh --hypervisor qemu
|
||||
- ./runit.sh --hypervisor ch --disks 5 --reset
|
||||
|
||||
Key Decisions (current)
|
||||
- Firmware selection for initramfs comes exclusively from [config/firmware.conf](config/firmware.conf); firmware hints in modules.conf are ignored to avoid duplication/mismatch.
|
||||
|
||||
@@ -107,7 +107,7 @@ Diagnostics-first workflow (strict)
|
||||
- For any failure, first collect specific logs:
|
||||
- Enable DEBUG=1 for verbose logs.
|
||||
- Re-run only the impacted stage if possible:
|
||||
- Example: rm -f .build-stages/validation.done && DEBUG=1 ./scripts/build.sh --skip-tests
|
||||
- Example: rm -f .build-stages/validation.done && DEBUG=1 ./scripts/build.sh
|
||||
- Use existing diagnostics:
|
||||
- Branding debug lines: [bash.initramfs_finalize_customization()](scripts/lib/initramfs.sh:575)
|
||||
- Validation debug lines (input, PWD, PROJECT_ROOT, INSTALL_DIR, resolved): [bash.initramfs_validate()](scripts/lib/initramfs.sh:799)
|
||||
@@ -119,12 +119,15 @@ Common tasks and commands
|
||||
- DEBUG=1 ./scripts/build.sh
|
||||
- Minimal rebuild of last steps:
|
||||
- rm -f .build-stages/initramfs_create.done .build-stages/initramfs_test.done .build-stages/validation.done
|
||||
- DEBUG=1 ./scripts/build.sh --skip-tests
|
||||
- DEBUG=1 ./scripts/build.sh
|
||||
- Validation only:
|
||||
- rm -f .build-stages/validation.done
|
||||
- DEBUG=1 ./scripts/build.sh --skip-tests
|
||||
- DEBUG=1 ./scripts/build.sh
|
||||
- Show stage status:
|
||||
- ./scripts/build.sh --show-stages
|
||||
- Test built kernel:
|
||||
- ./runit.sh --hypervisor qemu
|
||||
- ./runit.sh --hypervisor ch --disks 5
|
||||
|
||||
Checklists and helpers
|
||||
|
||||
@@ -154,7 +157,7 @@ C) Minimal rebuild after zinit/init/modules.conf changes
|
||||
- Stage status is printed before/after marker removal; the helper avoids --rebuild-from by default to prevent running early stages.
|
||||
- Manual fallback:
|
||||
- rm -f .build-stages/initramfs_create.done .build-stages/initramfs_test.done .build-stages/validation.done
|
||||
- DEBUG=1 ./scripts/build.sh --skip-tests
|
||||
- DEBUG=1 ./scripts/build.sh
|
||||
|
||||
D) INITRAMFS_ARCHIVE unbound during kernel build stage
|
||||
- stage_kernel_build now defaults INITRAMFS_ARCHIVE if unset:
|
||||
|
||||
@@ -57,7 +57,7 @@ This canonical checklist is the single source of truth for ongoing work. It mirr
|
||||
- Create: [bash.initramfs_create_cpio()](../scripts/lib/initramfs.sh:691)
|
||||
- Validate: [bash.initramfs_validate()](../scripts/lib/initramfs.sh:820)
|
||||
- [ ] QEMU / cloud-hypervisor smoke tests
|
||||
- Test suite: [bash.testing_run_all()](../scripts/lib/testing.sh:299)
|
||||
- Test runner: [runit.sh](../runit.sh)
|
||||
- [ ] Kernel embed path and versioning sanity
|
||||
- Embed config: [bash.kernel_modify_config_for_initramfs()](../scripts/lib/kernel.sh:130)
|
||||
- Full version logic: [bash.kernel_get_full_version()](../scripts/lib/kernel.sh:14)
|
||||
|
||||
@@ -13,7 +13,6 @@ Key sourced libraries:
|
||||
- [initramfs.sh](scripts/lib/initramfs.sh)
|
||||
- [stages.sh](scripts/lib/stages.sh)
|
||||
- [docker.sh](scripts/lib/docker.sh)
|
||||
- [testing.sh](scripts/lib/testing.sh)
|
||||
|
||||
Main stages executed (incremental via [stage_run()](scripts/lib/stages.sh:99)):
|
||||
1) alpine_extract, alpine_configure, alpine_packages
|
||||
|
||||
Reference in New Issue
Block a user