mirror of
https://github.com/azaion/detections.git
synced 2026-04-22 11:56:31 +00:00
Oleksandr Bezdieniezhnykh
2c35e59a77
- Added Jetson-specific deployment instructions to `deploy_scripts.md`, detailing prerequisites and service management. - Updated `deploy_status_report.md` to reflect the completion of the AZ-180 cycle and the readiness of Jetson support. - Removed outdated task documentation for Jetson Orin Nano support from the todo list. Made-with: Cursor
87 lines
2.5 KiB
Markdown
87 lines
2.5 KiB
Markdown
# Deployment Scripts
|
|
|
|
All scripts are in `scripts/` at the project root. Each script is POSIX-compatible (`bash` with `set -euo pipefail`), sources `.env` from the project root, and supports `--help`.
|
|
|
|
## Script Reference
|
|
|
|
| Script | Purpose | Key Env Vars |
|
|
|--------|---------|-------------|
|
|
| `deploy.sh` | Orchestrates full deployment | REGISTRY, IMAGE_TAG, DEPLOY_HOST, DEPLOY_USER |
|
|
| `pull-images.sh` | Pulls Docker images from registry | REGISTRY, IMAGE_TAG |
|
|
| `start-services.sh` | Starts the detections container | REGISTRY, IMAGE_TAG, LOADER_URL, ANNOTATIONS_URL |
|
|
| `stop-services.sh` | Gracefully stops and removes container | — |
|
|
| `health-check.sh` | Verifies `/health` endpoint | HEALTH_CHECK_HOST, HEALTH_CHECK_PORT |
|
|
|
|
## Usage
|
|
|
|
### Full Deployment
|
|
|
|
```bash
|
|
REGISTRY=registry.example.com IMAGE_TAG=a1b2c3d bash scripts/deploy.sh
|
|
```
|
|
|
|
### Remote Deployment (via SSH)
|
|
|
|
```bash
|
|
REGISTRY=registry.example.com \
|
|
IMAGE_TAG=a1b2c3d \
|
|
DEPLOY_HOST=production-server.example.com \
|
|
DEPLOY_USER=deploy \
|
|
bash scripts/deploy.sh
|
|
```
|
|
|
|
### Rollback
|
|
|
|
```bash
|
|
bash scripts/deploy.sh --rollback
|
|
```
|
|
|
|
Redeploys the previous image tag (saved in `.deploy-previous-tag` by `stop-services.sh`).
|
|
|
|
### Local Development
|
|
|
|
```bash
|
|
docker compose -f docker-compose.yml up
|
|
```
|
|
|
|
Or using the e2e compose for testing:
|
|
|
|
```bash
|
|
cd e2e && COMPOSE_PROFILES=cpu docker compose -f docker-compose.test.yml up --build
|
|
```
|
|
|
|
### Jetson Orin Nano Deployment (AZ-180)
|
|
|
|
Jetson deployment uses `docker-compose.jetson.yml` directly — the standard CPU/GPU scripts are not used on Jetson.
|
|
|
|
**Prerequisites on target Jetson device**:
|
|
- JetPack 6.x installed
|
|
- NVIDIA Container Runtime configured (`runtime: nvidia` support in Docker)
|
|
- `docker compose` v2+
|
|
|
|
**Start service**:
|
|
```bash
|
|
docker compose -f docker-compose.jetson.yml up -d
|
|
```
|
|
|
|
**Stop service**:
|
|
```bash
|
|
docker compose -f docker-compose.jetson.yml down
|
|
```
|
|
|
|
**INT8 calibration cache**: Upload `azaion.int8_calib.cache` to the Loader service before first start to enable INT8 precision. If absent, the service falls back to FP16 automatically.
|
|
|
|
## Deployment Flow
|
|
|
|
```
|
|
deploy.sh
|
|
├── pull-images.sh → docker pull
|
|
├── stop-services.sh → docker stop (30s grace) + save previous tag
|
|
├── start-services.sh → docker run
|
|
└── health-check.sh → curl /health (10 retries, 3s interval)
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
All scripts source `.env` from the project root if it exists. Variables can also be passed directly via the environment. See `.env.example` for the full list.
|