- Standardize Python SDK (`datastack`) documentation with a new multi-file suite. - Update `datastack-sdk` to serve as a backward-compatible shim for the canonical `datastack` package. - Update project manifest and memory map to reflect current SDK structure and v2.2.0 features.
72 lines
2.2 KiB
Markdown
72 lines
2.2 KiB
Markdown
# Building, Packaging & Production Containers
|
|
|
|
This guide outlines compilation commands, linter checks, test suite execution, and Docker container packaging for DataStack.
|
|
|
|
---
|
|
|
|
## 1. Production Web Compilation
|
|
|
|
DataStack uses Next.js 15 App Router configured for **Standalone Output** (`output: "standalone"` in `next.config.ts`), which bundles only the required Node.js runtime files into `.next/standalone`.
|
|
|
|
### Compiling the Web App
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
### Build Verification Checklist
|
|
- Compiles TypeScript without type errors (`tsc --noEmit`).
|
|
- Generates serverless routes and static assets under `.next/`.
|
|
- Prepares standalone bundle under `.next/standalone/server.js`.
|
|
|
|
---
|
|
|
|
## 2. Code Quality & Linting
|
|
|
|
DataStack uses ESLint 9 with `eslint-config-next`:
|
|
|
|
```bash
|
|
npm run lint
|
|
```
|
|
|
|
Ensure this command exits cleanly (`code: 0`) with zero warnings or errors prior to committing code or opening a pull request.
|
|
|
|
---
|
|
|
|
## 3. Docker Container Builds
|
|
|
|
DataStack provides optimized, multi-stage Dockerfiles under `docker/`:
|
|
|
|
### 1. Build the Web Container (Port 3000)
|
|
```bash
|
|
docker build -f docker/Dockerfile.web -t datastack-web:latest .
|
|
```
|
|
- **Base**: `node:22-alpine`.
|
|
- **Stage 1 (Builder)**: Installs dependencies deterministically (`npm ci`) and runs `npm run build`.
|
|
- **Stage 2 (Runner)**: Copies `.next/standalone`, public assets, and sets non-root user `nextjs` (UID 1001).
|
|
|
|
### 2. Build the Ingestion Container (Port 4000)
|
|
```bash
|
|
docker build -f docker/Dockerfile.server -t datastack-ingestion:latest .
|
|
```
|
|
- **Base**: `node:22-alpine`.
|
|
- Installs production dependencies and runs `node server/index.js` under a dedicated non-root user.
|
|
|
|
### 3. Build the Nginx Proxy Container (Port 80)
|
|
```bash
|
|
docker build -f docker/Dockerfile.proxy -t datastack-proxy:latest .
|
|
```
|
|
- **Base**: `nginx:1.27-alpine`.
|
|
- Mounts custom reverse proxy configuration (`nginx/nginx.conf`) routing `/` to Port 3000 and `/socket.io/` to Port 4000.
|
|
|
|
### 4. Build & Run the Entire Stack with Compose
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml build
|
|
docker compose -f docker/docker-compose.yml up -d
|
|
```
|
|
|
|
Verify container health:
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml ps
|
|
```
|
|
All containers (`web`, `ingestion`, `proxy`, `postgres`, `redis`) should display `(healthy)`.
|