qjudge-env-compose-owner

Run environment-specific Docker Compose commands inside QJudge containers.

31|1|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/quan0715/QJudge --skill qjudge-env-compose-owner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qjudge-env-compose-owner
Source: https://github.com/quan0715/QJudge/tree/main/.codex/skills/qjudge-env-compose-owner
Command: npx skills add https://github.com/quan0715/QJudge --skill qjudge-env-compose-owner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docker, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a single, environment-aware wrapper and owner discipline for running Docker Compose operations for the QJudge project so that backend and frontend commands run inside their containers rather than on the host, reducing environment drift and test flakiness.

Core Features & Use Cases

  • Env selector: Maps main/dev/test to the correct compose file automatically.
  • Exec-first policy: Enforces running manage.py, pytest, and npm commands inside the appropriate backend or frontend container.
  • Operational tooling: Standardizes up, ps, logs, and container debugging workflows to simplify migrations, CI-local testing, and developer workflows.
  • Use Case: Run migrations in the backend container for the dev environment, execute frontend tests inside the frontend container for CI debugging, or collect logs from test-specific services.

Quick Start

Run the qjudge-dc.sh wrapper with the chosen environment and the desired docker compose arguments to start, exec, or inspect services.

Frequently Asked Questions about qjudge-env-compose-owner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Django migrations inside a Docker Compose container for a specific environment?

Run Django migrations inside a Docker Compose container by using an environment-aware wrapper that maps main, dev, or test to the correct compose file and executes manage.py commands within the backend service, preventing host-level environment drift.

Why should I execute pytest and npm scripts inside containers instead of on the host?

Executing pytest and npm scripts inside containers enforces an exec-first policy that standardizes the testing environment, reducing environment drift and test flakiness caused by differences between host and container dependencies.

How do I manage multiple Docker Compose files for dev and test environments without manual selection?

Manage multiple Docker Compose files by using an environment selector that automatically maps dev and test environments to their respective compose files, then routes commands to the correct services like backend-test and frontend-test.

Do I need Docker Compose installed locally to run environment-specific backend and frontend commands?

Yes, you need Docker Compose available on your host to execute environment-specific commands. The wrapper relies on this dependency to run scripts that manage service orchestration and execute commands inside the containers.

What is the best way to collect logs from test-specific services in a Dockerized Django application?

Collect logs from test-specific services by using a standardized wrapper that targets the test environment's compose file, allowing you to run docker compose logs against mapped services like backend-test and frontend-test for container debugging.

Can I use this wrapper to run npm scripts for frontend debugging in a CI pipeline?

Yes, you can run npm scripts for frontend debugging in CI by targeting the test environment, which routes the execution inside the frontend-test container to ensure the scripts operate within the isolated Docker environment.