docs: add manual runner management workflow to testing documentation

This commit is contained in:
adilallo
2025-08-29 08:24:13 -06:00
parent 9d7e0095f2
commit f87bff4675
5 changed files with 145 additions and 0 deletions
+48
View File
@@ -90,6 +90,17 @@ tests/
└── visual-regression.spec.ts # 23 tests per browser
```
## 🚀 Runner Management Scripts
```
community-rule/
├── start-runner.sh # Start Gitea Actions runner
├── stop-runner.sh # Stop Gitea Actions runner
├── status-runner.sh # Check runner status
├── config.yaml # Runner configuration
└── act_runner # Gitea Actions runner binary
```
## 🧪 Unit & Integration Testing
### Framework
@@ -423,6 +434,43 @@ git add .
git commit -m "feat: add new component with tests"
```
### 2. Manual Runner Management
The Gitea Actions runner is managed manually to save resources and provide control over when CI runs.
#### Start Runner (Before Creating PR)
```bash
# Start the runner to execute CI jobs
./start-runner.sh
```
#### Check Runner Status
```bash
# Check if runner is running and see recent logs
./status-runner.sh
```
#### Stop Runner (After PR Complete)
```bash
# Stop the runner to free up resources
./stop-runner.sh
```
#### Complete PR Workflow
```bash
# 1. Start runner
./start-runner.sh
# 2. Create Pull Request
# Go to repository → New Pull Request
# 3. Monitor CI progress
./status-runner.sh
# Or check Gitea Actions page
# 4. Stop runner when done
./stop-runner.sh
```
### 2. Pull Request Process
1. **Create PR** → CI pipeline starts automatically
+13
View File
@@ -18,6 +18,19 @@ npm run e2e
npm run lhci
```
### Manual Runner Management
```bash
# Start runner (before creating PR)
./start-runner.sh
# Check runner status
./status-runner.sh
# Stop runner (after PR complete)
./stop-runner.sh
```
### Visual Regression
```bash