Skip to content

Feature/lab18#20

Open
pepegx wants to merge 41 commits into
masterfrom
feature/lab18
Open

Feature/lab18#20
pepegx wants to merge 41 commits into
masterfrom
feature/lab18

Conversation

@pepegx
Copy link
Copy Markdown
Owner

@pepegx pepegx commented May 3, 2026

Summary

This PR completes Lab 18 by implementing reproducible builds for the Python DevOps Info Service using Nix and Nix
Flakes, plus reproducible Docker image generation with dockerTools.

What is included

  • Added Nix packaging for the app:
    • labs/lab18/app_python/default.nix
  • Added reproducible Docker image build via Nix:
    • labs/lab18/app_python/docker.nix
  • Added Flakes setup and lock file:
    • labs/lab18/app_python/flake.nix
    • labs/lab18/app_python/flake.lock
  • Added Lab 18 app sources/config:
    • labs/lab18/app_python/app.py
    • labs/lab18/app_python/config/config.json
    • labs/lab18/app_python/requirements.txt
    • labs/lab18/app_python/data/.gitkeep
  • Added full submission report:
    • labs/submission18.md
  • Added proof artifacts/screenshots:
    • labs/lab18/screenshots/*

Verification performed

  • nix build .#default succeeds.
  • App runtime check via /health endpoint succeeds.
  • Repeated Nix builds produce stable output path.
  • Mutable runtime state is excluded from derivation source to preserve reproducibility.
  • Nix Docker image reproducibility was validated via Linux Nix container workflow (documented in submission).

Notes

  • On macOS, direct nix build .#dockerImage may fail due to Darwin/fakeroot limitations; Linux-container workaround
    and proof are documented in labs/submission18.md.

pepega and others added 30 commits January 28, 2026 13:08
- Implement Flask-based DevOps Info Service (Python)
- Add GET / endpoint with service, system, runtime, and request info
- Add GET /health endpoint for monitoring
- Implement environment variable configuration (HOST, PORT, DEBUG)
- Add comprehensive documentation (README.md and LAB01.md)
- Include best practices: PEP 8, error handling, logging
- Add GitHub Community engagement section
- Implement bonus task: Go version of the service
- Add testing screenshots and evidence
- Pin dependencies in requirements.txt
- Configure .gitignore for Python and Go
- Add pytest unit tests (15 tests covering all endpoints)
- Add GitHub Actions workflow with matrix testing (Python 3.11, 3.12)
- Add ruff linter integration
- Add Docker build/push with CalVer versioning
- Add status badge to README
- Add LAB03.md documentation

Best practices:
- Dependency caching via setup-python
- Docker layer caching via Buildx
- Job dependencies (docker needs lint-test)
- Fail-fast matrix strategy
- Concurrency with cancel-in-progress
- Path filters for monorepo efficiency
- Docker build always runs (validates Dockerfile)
- Docker push only when DOCKERHUB secrets are configured
- Graceful handling when secrets not available
- Add .github/workflows/go-ci.yml for Go application
- Language-specific linting with golangci-lint
- Go testing with race detector and coverage
- Snyk security scanning for Go dependencies
- Docker build and push with CalVer versioning
- Path-based triggers for monorepo optimization
- Separate Docker image: pepegx/devops-info-service-go
- Parallel execution with Python CI workflow
…i-app support

Completes all main tasks (10pts) and bonus tasks (2.5pts):

MAIN TASKS (10pts):
- Unit Testing (3pts): pytest framework, 15 tests, 80% coverage
- GitHub Actions CI (4pts): python-ci.yml with matrix build, linting, testing, Docker push
- CI Best Practices (3pts): status badge, caching, Snyk security scanning

BONUS (2.5pts):
- Multi-App CI: go-ci.yml with path-based triggers
- Test Coverage: codecov integration with XML reporting

All requirements verified locally and ready for GitHub Actions execution.
- Fix codecov action file path (app_python/coverage.xml)
- Add CODECOV_TOKEN secret to codecov action
- Fix Snyk actions with proper file paths for both Python and Go
- Add Go CI status badge to app_go/README.md
- Fix codecov badge URL in app_python/README.md (remove token param)

All Lab03 requirements verified:
- 15 unit tests passing with 80% coverage
- Matrix builds for Python 3.11/3.12
- Snyk security scanning configured
- CalVer versioning implemented
- Path filters for monorepo
- Add main_test.go with 12 comprehensive unit tests
- Test all endpoints: /, /health, 404 handler
- Test helper functions: getEnv, getUptime, getSystemInfo
- Test custom mux wrapper with subtests
- Update README with unit testing documentation
- Update LAB03.md with test details

Coverage: 67.2% of statements
- Add pyproject.toml with 70% coverage threshold
- Configure pytest-cov fail-under for CI enforcement
- Add codecov upload for Go workflow
- Update LAB03.md with new coverage stats (98%)
- Simplify pytest command to use pyproject.toml config

Coverage improvements:
- Python: 98% coverage with 70% threshold
- Go: 67.2% coverage with codecov integration
- Refactor main.go: extract setupRouter() and printStartupBanner()
- Add TestSetupRouter to test router configuration
- Add TestPrintStartupBanner to test startup output
- Add TestDebugMode to test handlers with debug=true
- Coverage increased from 67.2% to 87.3% (above 70% threshold)
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 92.78846% with 15 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
app_python/app.py 92.78% 15 Missing ⚠️

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants