Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
67 lines (51 loc) · 1.49 KB

DEPLOYMENT.md

File metadata and controls

67 lines (51 loc) · 1.49 KB

Deployment Guide — IT-Stack SNIPEIT

Prerequisites

  • Ubuntu 24.04 Server on lab-mgmt1 (10.0.50.*)
  • Docker 24+ and Docker Compose v2
  • Phase 1 complete: FreeIPA, Keycloak, PostgreSQL, Redis, Traefik running
  • DNS entry: snipeit.it-stack.lab → lab-mgmt1

Deployment Steps

1. Create Database (PostgreSQL on lab-db1)

CREATE USER snipeit_user WITH PASSWORD 'CHANGE_ME';
CREATE DATABASE snipeit_db OWNER snipeit_user;

2. Configure Keycloak Client

Create OIDC client $Module in realm it-stack:

3. Configure Traefik

Add to Traefik dynamic config:

http:
  routers:
    snipeit:
      rule: Host(\$Module.it-stack.lab\)
      service: snipeit
      tls: {}
  services:
    snipeit:
      loadBalancer:
        servers:
          - url: http://lab-mgmt1:80

4. Deploy

# Copy production compose to server
scp docker/docker-compose.production.yml admin@lab-mgmt1:~/

# Deploy
ssh admin@lab-mgmt1 'docker compose -f docker-compose.production.yml up -d'

5. Verify

curl -I https://snipeit.it-stack.lab/health

Environment Variables

Variable Description Default
DB_HOST PostgreSQL host lab-db1
DB_PORT PostgreSQL port 5432
REDIS_HOST Redis host lab-db1
KEYCLOAK_URL Keycloak base URL https://lab-id1:8443
KEYCLOAK_REALM Keycloak realm it-stack