Merge pull request #117 from refactor-group/debug_and_fix_backend_api_version

Author: jhodapp

.env

@@ -6,7 +6,7 @@
 # NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL="http"
 # NEXT_PUBLIC_BACKEND_SERVICE_PORT=4000
 # NEXT_PUBLIC_BACKEND_SERVICE_HOST="localhost"
-# NEXT_PUBLIC_BACKEND_API_VERSION="0.0.1"
+# NEXT_PUBLIC_BACKEND_API_VERSION="1.0.0-beta1"
 # NEXT_PUBLIC_TIPTAP_APP_ID="<tiptap-app-id>"
 
 # NEXT_PUBLIC_TIPTAP_APP_ID=""

.github/workflows/build_and_push_nonproduction_images.yml

@@ -7,6 +7,12 @@ on:
     branches: [main]
     types: [opened, synchronize, reopened]
   workflow_dispatch:
+    inputs:
+      enable_env_var_debugging:  # Optional debugging parameter useful to debug the build args and env vars
+        description: 'Enable build args & env vars debugging'  # Help text shown in UI
+        required: false  # Not required to run the workflow
+        default: false   # Disabled by default
+        type: boolean    # Simple checkbox in the UI
 
 env:
   REGISTRY: ghcr.io
@@ -15,7 +21,7 @@ env:
 
 jobs:
   build_and_push_amd64:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     permissions:
       contents: read
@@ -36,7 +42,19 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Set image tag
+      - name: Debug Environment Variables
+        if: ${{ inputs.enable_env_var_debugging == true }}  # Only run when debugging is enabled
+        run: |
+          echo "Building with the following environment variables:" && \
+          echo "NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL: ${NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL}" && \
+          echo "NEXT_PUBLIC_BACKEND_SERVICE_HOST: ${NEXT_PUBLIC_BACKEND_SERVICE_HOST}" && \
+          echo "NEXT_PUBLIC_BACKEND_SERVICE_PORT: ${NEXT_PUBLIC_BACKEND_SERVICE_PORT}" && \
+          echo "NEXT_PUBLIC_BACKEND_API_VERSION: ${NEXT_PUBLIC_BACKEND_API_VERSION}" && \
+          echo "FRONTEND_SERVICE_INTERFACE: ${FRONTEND_SERVICE_INTERFACE}" && \
+          echo "FRONTEND_SERVICE_PORT: ${FRONTEND_SERVICE_PORT}"
+
+
+      - name: Set Image Tag
         id: vars
         run: |
           BRANCH_NAME=${GITHUB_HEAD_REF:-${GITHUB_REF##*/}}
@@ -66,7 +84,7 @@ jobs:
           cache-to: type=gha,mode=max,scope=amd64
 
   build_and_push_arm64:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     permissions:
       contents: read
@@ -87,7 +105,7 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Set image tag
+      - name: Set Image Tag
         id: vars
         run: |
           BRANCH_NAME=${GITHUB_HEAD_REF:-${GITHUB_REF##*/}}

.github/workflows/deploy_to_do.yml

@@ -8,10 +8,11 @@ on:
 jobs:
   deploy:
     name: Deploy Frontend to DigitalOcean # Job name for display
-    runs-on: ubuntu-24.04 # Use latest Ubuntu runner
-    permissions:         # job-level permissions necessary for Tailscale
-      contents: read     # Read repository contents
-      id-token: write    # Required for OIDC token operations (Tailscale)
+    runs-on: ubuntu-24.04
+    environment: production               # Use the production environment settings
+    permissions:                          # job-level permissions necessary for Tailscale
+      contents: read                      # Read repository contents
+      id-token: write                     # Required for OIDC token operations (Tailscale)
 
     steps:
       # Set up Tailscale connection to securely access the droplet

Dockerfile

@@ -5,6 +5,14 @@ FROM node:22-alpine3.19 AS base
 ARG BUILDPLATFORM
 ARG TARGETPLATFORM
 
+# Build-time args from docker-compose or GitHub Actions
+ARG NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL
+ARG NEXT_PUBLIC_BACKEND_SERVICE_HOST
+ARG NEXT_PUBLIC_BACKEND_SERVICE_PORT
+ARG NEXT_PUBLIC_BACKEND_API_VERSION
+ARG FRONTEND_SERVICE_INTERFACE
+ARG FRONTEND_SERVICE_PORT
+
 # Optional diagnostics (doesn't affect final image)
 RUN echo "Build Platform: ${BUILDPLATFORM} -> Target Platform: ${TARGETPLATFORM}"
 
@@ -23,29 +31,12 @@ WORKDIR /app
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
 
-# Build-time args from docker-compose or GitHub Actions
-ARG NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL
-ARG NEXT_PUBLIC_BACKEND_SERVICE_HOST
-ARG NEXT_PUBLIC_BACKEND_SERVICE_PORT
-ARG NEXT_PUBLIC_BACKEND_API_VERSION
-ARG FRONTEND_SERVICE_INTERFACE
-ARG FRONTEND_SERVICE_PORT
-
 # Pass them as ENV so Next.js static build can access
 ENV NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL=$NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL
 ENV NEXT_PUBLIC_BACKEND_SERVICE_HOST=$NEXT_PUBLIC_BACKEND_SERVICE_HOST
 ENV NEXT_PUBLIC_BACKEND_SERVICE_PORT=$NEXT_PUBLIC_BACKEND_SERVICE_PORT
 ENV NEXT_PUBLIC_BACKEND_API_VERSION=$NEXT_PUBLIC_BACKEND_API_VERSION
 
-# Optional: Print the values to verify they are set correctly
-RUN echo "Building with the following environment variables:" && \
-    echo "NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL: ${NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL}" && \
-    echo "NEXT_PUBLIC_BACKEND_SERVICE_HOST: ${NEXT_PUBLIC_BACKEND_SERVICE_HOST}" && \
-    echo "NEXT_PUBLIC_BACKEND_SERVICE_PORT: ${NEXT_PUBLIC_BACKEND_SERVICE_PORT}" && \
-    echo "NEXT_PUBLIC_BACKEND_API_VERSION: ${NEXT_PUBLIC_BACKEND_API_VERSION}" && \
-    echo "FRONTEND_SERVICE_INTERFACE: ${FRONTEND_SERVICE_INTERFACE}" && \
-    echo "FRONTEND_SERVICE_PORT: ${FRONTEND_SERVICE_PORT}"
-
 # Build the Next.js application
 # Note: Use `next build` to build the application for production
 RUN npm run build
@@ -69,8 +60,10 @@ USER nextjs
 # Expose the port
 EXPOSE 3000
 
-ARG FRONTEND_SERVICE_INTERFACE
-ARG FRONTEND_SERVICE_PORT
+ENV NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL=$NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL
+ENV NEXT_PUBLIC_BACKEND_SERVICE_HOST=$NEXT_PUBLIC_BACKEND_SERVICE_HOST
+ENV NEXT_PUBLIC_BACKEND_SERVICE_PORT=$NEXT_PUBLIC_BACKEND_SERVICE_PORT
+ENV NEXT_PUBLIC_BACKEND_API_VERSION=$NEXT_PUBLIC_BACKEND_API_VERSION
 
 # Runtime ENV for Compose
 ENV HOSTNAME=$FRONTEND_SERVICE_INTERFACE

README.md

@@ -23,7 +23,7 @@ When running locally on a development machine you can manually set the applicati
 NEXT_PUBLIC_BACKEND_SERVICE_PROTOCOL="http"
 NEXT_PUBLIC_BACKEND_SERVICE_PORT=4000
 NEXT_PUBLIC_BACKEND_SERVICE_HOST="localhost"
-NEXT_PUBLIC_BACKEND_API_VERSION="0.0.1"
+NEXT_PUBLIC_BACKEND_API_VERSION="1.0.0-beta1"
 
 # TIPTAP_APP_ID originates from your TipTap Cloud Dashboard
 NEXT_PUBLIC_TIPTAP_APP_ID="<TIPTAP_APP_ID>"