expose local web server using ngrok

README.md

@@ -106,6 +106,37 @@ Open Prisma studio:
 npx prisma studio
 ```
 
+## Ngrok
+### Set-up
+1. Create an [ngrok](https://dashboard.ngrok.com/signup) account
+
+2. Store your personal ngrok authentication token as an environment variable in the .env file of the root directory:
+```bash
+NGROK_AUTHTOKEN=${authtoken}
+```
+
+3. Run the application:
+```bash
+docker compose up --build
+```
+
+### Troubleshooting
+
+If another service is occupying port 5001, identify the PID of the service:
+```bash
+sudo lsof -i :5001
+```
+
+Kill the occupying service:
+```bash
+sudo kill <PID>
+```
+
+Run the application again:
+```bash
+docker compose up --build
+```
+
 ## The Team
 ### Term 1 (W24):
 **Project Lead:** N/A<br>

backend/typescript/Dockerfile

@@ -9,14 +9,20 @@ COPY package.json yarn.lock tsconfig.json ./
 
 RUN echo "deb http://archive.debian.org/debian stretch main" > /etc/apt/sources.list
 
-# libcurl3 is required for mongodb-memory-server, which is used for testing
-RUN apt-get update && apt-get install -y libcurl3
+# Install dependencies
+RUN apt-get update && apt-get install -y libcurl4 curl unzip
+
+# Install ngrok using curl
+RUN curl -o ngrok-stable-linux-amd64.zip https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-linux-amd64.zip && \
+    unzip ngrok-stable-linux-amd64.zip && \
+    mv ngrok /usr/local/bin/ && \
+    rm ngrok-stable-linux-amd64.zip
 
 RUN yarn install
 
 COPY . ./
 
 RUN npx prisma generate
 
-EXPOSE 5000
+EXPOSE 5001
 ENTRYPOINT ["yarn", "dev"]

backend/typescript/package.json

@@ -13,7 +13,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@prisma/client": "^5.11.0",
+    "@prisma/client": "^5.14.0",
     "@types/graphql-upload": "^8.0.6",
     "@types/json2csv": "^5.0.3",
     "@types/multer": "^1.4.6",
@@ -74,7 +74,7 @@
     "mongodb-memory-server": "^6.9.6",
     "nodemon": "^2.0.7",
     "prettier": "^2.2.1",
-    "prisma": "^5.11.0",
+    "prisma": "^5.14.0",
     "ts-jest": "^27.0.3",
     "typescript": "^4.1.5"
   },

backend/typescript/prisma/schema.prisma

@@ -1,5 +1,6 @@
 generator client {
   provider = "prisma-client-js"
+  binaryTargets = ["native", "linux-arm64-openssl-3.0.x"]
 }
 
 datasource db {

backend/typescript/server.ts

@@ -57,7 +57,7 @@ firebaseAdmin.initializeApp({
   }),
 });
 
-app.listen({ port: process.env.PORT || 5000 }, () => {
+app.listen({ port: process.env.PORT || 5001 }, () => {
   /* eslint-disable-next-line no-console */
-  console.info(`Server is listening on port ${process.env.PORT || 5000}!`);
+  console.info(`Server is listening on port ${process.env.PORT || 5001}!`);
 });

docker-compose.yml

@@ -10,11 +10,12 @@ services:
       - ./frontend:/app
       - /app/node_modules
     ports:
-      - 3000:3000
+      - "3000:3000"
     environment:
       - CHOKIDAR_USEPOLLING=true
     env_file:
       - ./frontend/.env
+
   ts-backend:
     container_name: de_ts_backend
     build:
@@ -24,7 +25,7 @@ services:
       - ./backend/typescript:/app
       - /app/node_modules
     ports:
-      - 5000:5000
+      - "5001:5001"
     dns:
       - 8.8.8.8
     depends_on:
@@ -33,11 +34,12 @@ services:
     env_file:
       - ./.env
       - ./backend/typescript/.env
+
   db:
     container_name: de_db
     image: postgres:12-alpine
     ports:
-      - 5432:5432
+      - "5432:5432"
     volumes:
       - postgres_data:/var/lib/postgresql/data/
       - ./db-init:/docker-entrypoint-initdb.d
@@ -46,10 +48,20 @@ services:
     environment:
       - POSTGRES_MULTIPLE_DATABASES=${POSTGRES_DB_DEV},${POSTGRES_DB_TEST}
     healthcheck:
-      test: [ "CMD-SHELL", "pg_isready -U postgres" ]
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
       interval: 5s
       timeout: 5s
       retries: 5
 
+  ngrok:
+    image: ngrok/ngrok:latest
+    platform: linux/arm64
+    command: ngrok http ts-backend:5001
+    ports:
+      - "4040:4040"  # ngrok web interface
+    depends_on:
+      - ts-backend
+    environment:
+      - NGROK_AUTHTOKEN=${authtoken}
 volumes:
   postgres_data: