From 6f4dc3d993ff4255cba09915d95296386d8d45f6 Mon Sep 17 00:00:00 2001 From: Eliel Sousa Date: Fri, 18 Sep 2026 09:42:07 -0300 Subject: [PATCH] docs: documentar validacao com testcontainers e politica de retencao no readme --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ac11344..efe5241 100644 --- a/README.md +++ b/README.md @@ -158,7 +158,7 @@ side of the mapping in the compose file — the right side is the internal port, the one the process listens on. -Official multi-architecture Docker images (`linux/amd64` and `linux/arm64`) are published automatically to the GitHub Container Registry (GHCR): +Official multi-architecture Docker images (`linux/amd64` and `linux/arm64`) are published automatically to the GitHub Container Registry (GHCR) on pushes to `master` with changes in `src/`. The registry enforces an automated retention policy keeping strictly the last 3 versions: ```bash docker pull ghcr.io/pathbit/litellmrtksync:latest @@ -395,6 +395,18 @@ make test PYTHONPATH=src python3 -m unittest discover -s tests -p "test_*.py" ``` +### Option 3. Automated Docker Image Validation with Testcontainers + +Validates that the generated Docker image boots cleanly, exposes the web dashboard on port 9090, responds on `/login` (200 OK) and `/healthz`, and executes CLI commands: + +```bash +# Install package with test dependencies +pip install ".[test]" + +# Run Testcontainers validation suite +python3 -m unittest tests/test_container.py -v +``` + --- ## Security posture