Linux Practice - DevOps Command Training

🚀 Launch Practice App →

An interactive web application to master 175+ Linux, Docker, Kubernetes, AWS, Azure, and Terraform commands through hands-on quizzes. Build muscle memory for DevOps commands with progressive hints, instant feedback, and smart validation.

Features

• 175+ Practice Challenges across Linux, Docker, Kubernetes, AWS, Azure, Terraform, and Ansible
• 3-Level Progressive Hints: Get help without giving away the answer
• Smart Validation: Accepts multiple correct command variations with partial credit
• Interactive Web UI: Terminal-style interface in your browser
• RESTful API: Flask backend with session management
• 95 Tests: Comprehensive test coverage for reliability
• Docker Support: Containerized deployment
• Category & Difficulty Filters: Practice exactly what you need

Quick Start

Option 1: Docker (Recommended)

docker build -t linux-practice .
docker run -p 8000:8000 linux-practice

Open your browser to: http://localhost:8000

Option 2: Python (Development)

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Open your browser to: http://localhost:8000

API Endpoints

Start Quiz

POST /api/quiz/start
{
  "num_questions": 10,
  "category": "linux",      # Optional
  "difficulty": "beginner"  # Optional
}

Validate Answer

POST /api/quiz/validate
{
  "session_id": "xxx",
  "command": "ls -la"
}

Get Hint

POST /api/quiz/hint
{
  "session_id": "xxx"
}

Skip Question

POST /api/quiz/skip
{
  "session_id": "xxx"
}

Get Next Question

POST /api/quiz/next
{
  "session_id": "xxx"
}

Get Stats

GET /api/quiz/stats/<session_id>

Project Structure

linux-practice/
├── app.py                      # Flask application
├── run.py                      # Application runner
├── challenges.json             # Quiz questions database
├── requirements.txt            # Python dependencies
├── requirements-test.txt       # Test dependencies
├── pytest.ini                  # Test configuration
├── Dockerfile                  # Docker build file
├── docker-compose.yml          # Docker Compose config
├── linux_practice/             # Main package
│   ├── core/                   # Business logic
│   │   ├── challenge.py        # Challenge data model
│   │   └── quiz.py             # Quiz engine
│   └── validators/             # Command validators
│       ├── base.py             # Base validator
│       ├── linux/              # Linux commands
│       ├── docker/             # Docker commands
│       ├── kubernetes/         # Kubernetes/Helm
│       ├── aws/                # AWS CLI
│       ├── azure/              # Azure CLI
│       ├── terraform/          # Terraform
│       └── ansible/            # Ansible
├── tests/                      # Test suite (95 tests)
│   ├── conftest.py            # Test fixtures
│   ├── test_app.py            # API tests
│   ├── test_quiz_engine.py   # Engine tests
│   ├── test_validators.py    # Validator tests
│   └── test_security.py       # Security tests
└── web/                        # Web interface
    ├── index.html             # Main page
    ├── quiz.html              # Quiz interface
    └── assets/                # Static assets

Development

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=linux_practice --cov=app

# Run specific test file
pytest tests/test_app.py

# Run specific test
pytest tests/test_app.py::TestClass::test_method

Code Quality

# Linting
flake8 .

# Security scan
bandit -r linux_practice/ app.py

# Dependency check
safety check

Adding New Commands

1. Create validator in linux_practice/validators/<category>/
2. Register in linux_practice/validators/__init__.py
3. Add challenges to challenges.json
4. Write tests in tests/test_validators.py

See CLAUDE.md for detailed development guidelines.

Categories

• Linux: File operations, text processing, system monitoring, networking, archives, processes
• Docker: Container lifecycle, networking, volumes, Compose
• Kubernetes: kubectl, Helm charts, deployments
• AWS: S3, EC2, Lambda, IAM, CloudFormation, EKS, RDS, ECS, ECR, SSM, DynamoDB, SNS, SQS, CloudWatch
• Azure: VM, Storage, AKS, ACR, Network, Resource Groups
• Terraform: init, plan, apply, destroy, state, workspace
• Ansible: Playbooks, vault, galaxy, inventory

Requirements

• Python 3.11+
• Flask 3.0+
• pytest 7.4+ (for development)

Docker

The application includes:

• Multi-stage build for optimized image size
• Health checks for container monitoring
• Non-root user for security
• Efficient caching for faster builds

# Build
docker build -t linux-practice .

# Run
docker run -p 8000:8000 linux-practice

# Using docker-compose
docker-compose up

Contributing

1. Fork the repository
2. Create a feature branch
3. Write tests for new features
4. Ensure all tests pass: pytest
5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues or questions, please open an issue on GitHub.

Built for DevOps engineers who want to master command-line tools through practice, not memorization.