deployment-devops

Files (1)

• SKILL.md

SKILL.md (first lines)

# Deployment / DevOps

## Docker Patterns

### Multi-stage Dockerfile (Node)

```dockerfile
# Stage 1: Build
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# Stage 2: Production (minimal image)
FROM node:20-alpine AS runner
WORKDIR /app
RUN addgroup --system app && adduser --system -G app app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package*.json ./
USER app
EXPOSE 3000
ENV NODE_ENV=production
CMD ["node", "dist/main.js"]
```

### Layered Dockerfile for Fast Builds

```dockerfile
# Leverage Docker layer caching — least-changing layers first
FROM node:20-alpine
WORKDIR /app

# 1. Dependencies (rarely changes)
COPY package*.json ./
RUN npm ci --only=production

# 2. Build deps (changes occasionally)
RUN npm ci --only=development
COPY tsconfig.json ./
COPY prisma ./prisma
RUN npx prisma generate

# 3. App code (changes most frequently)
COPY src ./src
RUN npm run build

EXPOSE 3000
CMD ["node", "dist/main.js"]
```

### docker-compose for Development

```yaml
version: '3.8'
services:
  app:
    build: .
    ports: ['3000:3000']
    env_file: .env
    volumes:
      - .:/app          # hot reload
      - /app/node_modules
    depends_on:
      - db
      - redis

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: myapp
      POSTGRES_PASSWORD: devpassword
    ports: ['5432:5432']
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    ports: ['6379:6379']

volumes:
  pgdata:
```

## Environment Configuration

### File Structure

```
.env              # local dev (gitignored)
.env.example      # template (committed)
.env.production   # production secrets (deployed via CI, not in repo)
```

### Validation Pattern

```typescript
// env.ts — validated and typed
import 'dotenv/config';

function requireEnv(key: string): string {
  const value = process.env[key];
  if (!value) throw new Error(`Missing required env: ${key}`);
  return value;
}

export const env = {
  NODE_ENV: process.env.NODE_ENV ?? 'development',
  PORT: parseInt(process.env.PORT ?? '3000', 10),
  DATABASE_URL: requireEnv('DATABASE_URL'),
  JWT_ACCESS_SECRET: requireEnv('JWT_ACCESS_SECRET'),
  JWT_REFRESH_SECRET: requireEnv('JWT_REFRESH_SECRET'),
  REDIS_URL: process.env.REDIS_URL,
  CORS_ORIGIN: process.env.CORS_ORIGIN ?? 'http://localhost:5173',
} as const;
```

From UgochukwuChidera/Opencode-Agents, GPL-3.0.

More from UgochukwuChidera/Opencode-Agents