TestArena Deployment & Testing Guide

This guide explains how to deploy and test the TestArena backend application on your Ubuntu Server.

🚀 Deployment Steps

1. Clone the Repository

Ensure you have the code on your server in a directory like /home/asf/testarena_pc_backend.

2. Run the Deployment Script

The deployment script automates Nginx configuration and dependency installation.

sudo chmod +x deploy.sh
sudo ./deploy.sh

3. Start the Application Services

You should run these in the background or using a process manager like pm2 or systemd.

Start the API Server:

source venv/bin/activate
uvicorn testarena_app.main:app --host 0.0.0.0 --port 8000

Start the Background Worker:

source venv/bin/activate
python3 -m testarena_app.worker

🧪 Testing the System

1. Verify Dashboard Access

Open your browser and navigate to: http://asf-server.duckdns.org:8080/ You should see the modern, colorful TestArena dashboard.

2. Verify Results Browsing

Navigate to: http://asf-server.duckdns.org:8080/results/ You should see an automatic directory listing of /home/asf/testarena/.

3. Test the Queue API

Run the following curl command to queue a test task:

curl -X POST http://asf-server.duckdns.org:8080/api/queue \
-H "Content-Type: application/json" \
-d '{
    "test_queue_001": [
        "staging",
        {
            "task_1": "/home/asf/scenarios/test1.py",
            "task_2": "/home/asf/scenarios/test2.py"
        }
    ]
}'

4. Verify Worker Execution

Check the dashboard; you should see the new queue appear and its status change from Waiting to Running and then Finished.
Check the filesystem:
```
ls -R /home/asf/testarena/test_queue_001
```
You should see queue_status.json and any results generated by tpf_execution.py.

5. Test Abortion

Queue another task and click the Abort button on the dashboard. Verify that the status changes to Aborted in both the dashboard and the queue_status.json file.

🛠️ Troubleshooting

Nginx Errors: Check logs with sudo tail -f /var/log/nginx/error.log.
FastAPI Errors: Check the terminal where uvicorn is running.
Permission Issues: Ensure /home/asf/testarena is writable by the user running the app.
Port 8080 Blocked: Ensure your firewall (ufw) allows traffic on port 8080: sudo ufw allow 8080.

2.4 KiB Raw Permalink Blame History