feat: add README.md to each lab with startup instructions and remove obsolete version from compose files

This commit is contained in:
Luca Sacchi Ricciardi
2026-04-09 14:30:22 +02:00
parent b5ccb3c149
commit 89c8e6ae07
28 changed files with 235 additions and 145 deletions
@@ -9,8 +9,8 @@ files_modified:
- labs/lab-03-compute/tests/02-healthcheck-test.sh
- labs/lab-03-compute/tests/03-enforcement-test.sh
- labs/lab-03-compute/tests/99-final-verification.sh
- labs/lab-03-compute/tests/run-all-tests.sh
- labs/lab-03-compute/tests/quick-test.sh
- labs/lab-03-compute/tests/99-final-verification.sh
- labs/lab-03-compute/tests/99-final-verification.sh
autonomous: true
requirements:
- TEST-01
@@ -39,10 +39,10 @@ must_haves:
- path: "labs/lab-03-compute/tests/99-final-verification.sh"
provides: "Student double-check command"
min_lines: 100
- path: "labs/lab-03-compute/tests/run-all-tests.sh"
- path: "labs/lab-03-compute/tests/99-final-verification.sh"
provides: "Test orchestration with fail-fast"
min_lines: 50
- path: "labs/lab-03-compute/tests/quick-test.sh"
- path: "labs/lab-03-compute/tests/99-final-verification.sh"
provides: "Quick validation for development"
min_lines: 30
key_links:
@@ -85,7 +85,7 @@ Output: 6 bash test scripts covering resource limits validation, healthcheck tes
# Test Patterns from Phase 2 and 3
From labs/lab-01-iam/tests/run-all-tests.sh:
From labs/lab-01-iam/tests/99-final-verification.sh:
- Use `set -euo pipefail` for error handling
- Color-coded output (GREEN for pass, RED for fail, BLUE for info)
- Summary with pass/fail counts
@@ -162,8 +162,8 @@ labs/lab-03-compute/
│ ├── 02-healthcheck-test.sh
│ ├── 03-enforcement-test.sh
│ ├── 99-final-verification.sh
│ ├── run-all-tests.sh
│ └── quick-test.sh
│ ├── 99-final-verification.sh
│ └── 99-final-verification.sh
├── docker-compose.yml (created in 04-03)
└── README.md
```
@@ -194,7 +194,7 @@ Plan 04-01 is complete when:
1. All 6 test scripts created
2. Each script meets minimum line requirements
3. Tests fail when executed on empty/non-existent lab-03-compute
4. run-all-tests.sh executes all tests in sequence
4. 99-final-verification.sh executes all tests in sequence
5. Tests cover: resource limits, healthchecks, enforcement, INF-03
</context>
@@ -218,11 +218,11 @@ Plan 04-01 is complete when:
- INF-03 compliance report
- Healthcheck status report
- Clear pass/fail summary
6. Create run-all-tests.sh (50+ lines)
6. Create 99-final-verification.sh (50+ lines)
- Execute all test scripts in sequence
- Fail-fast on first failure
- Summary report
7. Create quick-test.sh (30+ lines)
7. Create 99-final-verification.sh (30+ lines)
- Fast validation (< 30 seconds)
- Essential checks only
</tasks>
@@ -25,8 +25,8 @@ Plan 04-01 established the test infrastructure foundation for Lab 03 (Compute &
| `labs/lab-03-compute/tests/03-enforcement-test.sh` | 287 | Ensure INF-03 compliance: resource limits enforcement with docker stats |
| `labs/lab-03-compute/tests/04-verify-infrastructure.sh` | 84 | Infrastructure verification script |
| `labs/lab-03-compute/tests/99-final-verification.sh` | 331 | Student "double check" command for end-to-end validation |
| `labs/lab-03-compute/tests/run-all-tests.sh` | 138 | Test suite orchestration with fail-fast behavior |
| `labs/lab-03-compute/tests/quick-test.sh` | 79 | Quick validation for development |
| `labs/lab-03-compute/tests/99-final-verification.sh` | 138 | Test suite orchestration with fail-fast behavior |
| `labs/lab-03-compute/tests/99-final-verification.sh` | 79 | Quick validation for development |
**Total:** 1,389 lines of bash test code
@@ -64,7 +64,7 @@ Plan 04-01 established the test infrastructure foundation for Lab 03 (Compute &
## Requirements Covered
- **TEST-01:** Test scripts validate resource limits and healthchecks
- **TEST-05:** Test harness can be executed with single command (`run-all-tests.sh`)
- **TEST-05:** Test harness can be executed with single command (`99-final-verification.sh`)
- **INF-03:** All containers have resource limits (cpus, mem_limit)
- **LAB-03:** Docker resource limits and healthchecks simulate EC2
@@ -45,7 +45,7 @@ We verify that Phase 4 achieves its goals by checking the success criteria from
**Verification Command:**
```bash
cd labs/lab-03-compute
bash tests/run-all-tests.sh
bash tests/99-final-verification.sh
```
**Expected Result:** All tests FAIL initially (RED phase), then PASS after implementation (GREEN phase)