feat(Docker): Added Docker file + compose for local dev

Author: timothystewart6

.devcontainer/devcontainer.json

@@ -0,0 +1,9 @@
+{
+    "name": "JetKVM Cloud API",
+    "image": "mcr.microsoft.com/devcontainers/base:debian",
+    "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+            "version": "21.1.0"
+        }
+    }
+}

.env.example

@@ -1,4 +1,4 @@
-DATABASE_URL="postgresql://jetkvm:jetkvm@localhost:5432/jetkvm?schema=public"
+DATABASE_URL="postgresql://jetkvm:mysecretpassword@localhost:5432/jetkvm?schema=public"
 
 GOOGLE_CLIENT_ID=XXX        # Google OIDC Client ID
 GOOGLE_CLIENT_SECRET=XXX    # Google OIDC Client Secret
@@ -20,4 +20,9 @@ R2_CDN_URL=XXX              # Any S3 compatible CDN URL
 CORS_ORIGINS=https://app.jetkvm.com,http://localhost:5173 # Allowed CORS Origins, split by comma
 
 REAL_IP_HEADER=XXX          # Real IP Header for the reverse proxy (e.g. X-Real-IP), leave empty if not needed
-ICE_SERVERS=XXX             # ICE Servers for WebRTC, split by comma (e.g. stun:stun.l.google.com:19302,stun:stun1.l.google.com:19302)
+ICE_SERVERS=XXX             # ICE Servers for WebRTC, split by comma (e.g. stun:stun.l.google.com:19302,stun:stun1.l.google.com:19302)
+
+# Uncomment these for development
+#POSTGRES_USER=jetkvm
+#POSTGRES_PASSWORD=mysecretpassword
+#POSTGRES_DB=jetkvm

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 .idea
-.env
+.env
+.env.development

Dockerfile

@@ -0,0 +1,23 @@
+FROM node:21.1.0
+
+WORKDIR /app
+
+# Define NODE_ENV as a build argument with a default value
+ARG NODE_ENV=production
+ENV NODE_ENV=${NODE_ENV}
+
+COPY package.json package-lock.json ./
+
+# Install dependencies
+RUN npm install
+
+# copy schemas and generate client
+COPY prisma ./prisma
+RUN npx prisma generate
+
+COPY . .
+
+EXPOSE 3000
+
+# migrate schemas, then start app
+CMD npx prisma migrate deploy && exec node -r ts-node/register ./src/index.ts

README.md

@@ -23,25 +23,32 @@ The best place to search for answers is our [Documentation](https://jetkvm.com/d
 
 If you've found an issue and want to report it, please check our [Issues](https://github.com/jetkvm/cloud-api/issues) page. Make sure the description contains information about the firmware version you're using, your platform, and a clear explanation of the steps to reproduce the issue.
 
-
 ## Development
 
 This project is built with Node.JS, Prisma and Express.
 
 To start the development server, run:
 
 ```bash
-# For local development, you can use the following command to start a postgres instanc
+# Copy the .env.example file to a new file .env.development and populate it with the correct values
+cp .env.example .env.development
+
+# For local development you can use docker compose to bring up your environment
+
+# this will run docker-compose.yml with docker-compose.override.yml applied
+
+docker compose up --build
+
+# Or you can run a postgres container only
+
 # Don't use in production
 docker run --name jetkvm-cloud-db \
     -e POSTGRES_USER=jetkvm \
     -e POSTGRES_PASSWORD=mysecretpassword \
     -e POSTGRES_DB=jetkvm \
+    -p 5432:5432 \
     -d postgres
 
-# Copy the .env.example file to .env and populate it with the correct values
-cp .env.example .env
-
 # Install dependencies
 npm install
 

docker-compose.override.yml

@@ -0,0 +1,21 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      args:
+        NODE_ENV: development
+    ports:
+      - "3000:3000"
+    env_file:
+      - .env.development
+    depends_on:
+      - postgres
+    volumes:
+      - .:/app
+      - /app/node_modules
+    command: ["sh", "-c", "npm install && npx prisma migrate dev && npm run dev"]
+
+  postgres:
+    env_file:
+      - .env.development

docker-compose.yml

@@ -0,0 +1,33 @@
+services:
+  postgres:
+    image: postgres:15
+    restart: always
+    env_file:
+      - .env
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U jetkvm"]
+      interval: 5s
+      retries: 5
+      timeout: 3s
+
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      args:
+        NODE_ENV: production
+    env_file:
+      - .env
+    depends_on:
+      postgres:
+        condition: service_healthy
+    expose:
+      - "3000:3000"
+    command: ["sh", "-c", "until pg_isready -h postgres -U jetkvm; do sleep 2; done && npx prisma migrate deploy && exec node -r ts-node/register ./src/index.ts"]
+
+volumes:
+  pgdata: