Add better documentation and scripts for air-gapped deployment

Created new helper scripts:
- quickstart-airgap.sh: One-command deployment for restricted environments
- check-ready.sh: Validates that pre-built files exist before deployment

Updated documentation:
- Enhanced Dockerfile.frontend.prebuilt with clearer error messages
- Updated DEPLOYMENT.md with step-by-step quick start guide
- Updated README.md to distinguish standard vs air-gapped deployment

Key improvements:
- Clear warning that build must happen BEFORE docker-compose
- Helper script that combines build + deployment steps
- Readiness check to catch missing pre-built files early
- Better instructions for test environments with restricted npm access

This addresses the common error where Docker fails because
frontend/dist/frontend/browser doesn't exist yet.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-16 10:18:44 -05:00
parent bd6c2ce9c1
commit 9e3af1fc07
5 changed files with 182 additions and 6 deletions

View File

@@ -36,7 +36,7 @@ A lightweight, cloud-native API for storing and querying test artifacts includin
## Quick Start
### One-Command Setup
### Standard Deployment (Internet Access)
**Linux/macOS:**
```bash
@@ -53,6 +53,20 @@ A lightweight, cloud-native API for storing and querying test artifacts includin
quickstart.bat
```
### Air-Gapped/Restricted Environment Deployment
**For environments with restricted npm access:**
```bash
./quickstart-airgap.sh
```
This script:
1. Builds Angular locally (where npm works)
2. Packages pre-built files into Docker
3. Starts all services
See [DEPLOYMENT.md](DEPLOYMENT.md) for detailed instructions.
### Manual Setup with Docker Compose
1. Clone the repository: