Add Docker Compose setup for local development

.env

@@ -0,0 +1,11 @@
+WORKSPACE_ = "/home/jenkins/agent/workspace" 
+NODE_ENV = 'production'
+TZ = "UTC"
+# // Amount of available vCPUs, to avoid OOM - https://www.gatsbyjs.com/docs/how-to/performance/resolving-out-of-memory-issues/#try-reducing-the-number-of-cores
+# // https://github.com/jenkins-infra/jenkins-infra/tree/production/hieradata/clients/controller.ci.jenkins.io.yaml#L327
+GATSBY_CPU_COUNT = "4"
+# // Added the below to fix permissions issue with the cache
+GATSBY_CACHE_DIR = "${WORKSPACE_}/.gatsby-cache"
+GATSBY_INTERNAL_CACHE_DIR = "${WORKSPACE_}/.cache"
+GATSBY_TELEMETRY_DISABLED = "1"
+NODE_OPTIONS = "--no-warnings"

Jenkinsfile

@@ -5,76 +5,101 @@ pipeline {
     disableConcurrentBuilds(abortPrevious: true)
     buildDiscarder logRotator(artifactDaysToKeepStr: '', artifactNumToKeepStr: '', daysToKeepStr: '5', numToKeepStr: '5')
   }
-
+  
   agent {
     label 'linux-arm64-docker || arm64linux'
   }
-
-  environment {
-    NODE_ENV = 'production'
-    TZ = "UTC"
-    // Amount of available vCPUs, to avoid OOM - https://www.gatsbyjs.com/docs/how-to/performance/resolving-out-of-memory-issues/#try-reducing-the-number-of-cores
-    // https://github.com/jenkins-infra/jenkins-infra/tree/production/hieradata/clients/controller.ci.jenkins.io.yaml#L327
-    GATSBY_CPU_COUNT = "4"
-    // Added the below to fix permissions issue with the cache
-    GATSBY_CACHE_DIR = "${env.WORKSPACE}/.gatsby-cache"
-    GATSBY_INTERNAL_CACHE_DIR = "${env.WORKSPACE}/.cache"
-    GATSBY_TELEMETRY_DISABLED = "1"
-    NODE_OPTIONS = "--no-warnings"
-  }
-
+
   stages {
-    stage('Check for typos') {
+    stage('load env file') {
       steps {
+        // Load environment variables from .env file.
         sh '''
-          curl -qsL https://github.com/crate-ci/typos/releases/download/v1.33.1/typos-v1.33.1-x86_64-unknown-linux-musl.tar.gz | tar xvzf - ./typos
-          ./typos --format sarif > typos.sarif || true
+          set -a
+          source ./.env
+          set +a
         '''
       }
-      post {
-        always {
-          recordIssues(tools: [sarif(id: 'typos', name: 'Typos', pattern: 'typos.sarif')])
-        }
-      }
     }
-
-    stage('Install Dependencies') {
-      environment {
-        NODE_ENV = 'development'
-      }
-      steps {
-        sh 'asdf install'
-        sh 'npm install'
-      }
-    }
-
-    stage('Lint and Test') {
-      environment {
-        NODE_ENV = "development"
-      }
-      steps {
-        sh 'npm run lint && npx eslint --format checkstyle > eslint.xml'
-      }
-      post {
-        always {
-          recordIssues(tools: [checkStyle(pattern: 'eslint.xml')])
+
+    stage('Parallel Stage') {
+      parallel {
+        stage('Branch A') {
+          stages {
+            stage('Check for typos') {
+              steps {
+               sh '''
+                 curl - qsL https: //github.com/crate-ci/typos/releases/download/v1.33.1/typos-v1.33.1-x86_64-unknown-linux-musl.tar.gz | tar xvzf - ./typos
+                 . / typos--format sarif > typos.sarif || true 
+               '''
+              }
+              post {
+                always {
+                  recordIssues(tools: [sarif(id: 'typos', name: 'Typos', pattern: 'typos.sarif')])
+                }
+              }
+            }
+
+            stage('Install Dependencies') {
+              environment {
+                NODE_ENV = 'development'
+              }
+              steps {
+                sh 'asdf install'
+                sh 'npm install'
+              }
+            }
+
+            stage('Lint and Test') {
+              environment {
+                NODE_ENV = "development"
+              }
+              steps {
+                sh 'npm run lint && npx eslint --format checkstyle > eslint.xml'
+              }
+              post {
+                always {
+                  recordIssues(tools: [checkStyle(pattern: 'eslint.xml')])
+                }
+              }
+            }
+
+            stage('Build PR') {
+              when {
+                changeRequest()
+              }
+              environment {
+                NODE_ENV = 'development'
+              }
+              steps {
+                sh 'npm run build'
+              }
+            }
+          }
+        }
+
+        stage('Branch B') {
+          agent {
+            label 'linux-arm64-docker || arm64linux'
+          }
+          steps {
+            echo 'Test Docker Compose'
+            sh 'docker compose up --detach --wait'
+            sh 'docker compose run --rm stories_webapp env'
+            sh 'docker compose down'
+          }
+          post {
+            always {
+              sh 'docker compose down || true'
+            }
+          }
         }
       }
     }
-
-    stage('Build PR') {
-      when { changeRequest() }
-      environment {
-        NODE_ENV = 'development'
-      }
-      steps {
-        sh 'npm run build'
-      }
-    }
-
+
     stage('Deploy PR to preview site') {
       when {
-        allOf{
+        allOf {
           changeRequest target: 'main'
           // Only deploy to production from infra.ci.jenkins.io
           expression { infra.isInfra() }
@@ -95,7 +120,7 @@ pipeline {
         }
       }
     }
-
+    
     stage('Build Production') {
       when {
         branch "main"
@@ -104,7 +129,7 @@ pipeline {
         sh 'npm run build'
       }
     }
-
+    
     stage('Deploy Production') {
       when {
         allOf {

README.md

@@ -48,6 +48,19 @@ npm run develop
 
 Open [http://localhost:8000](http://localhost:8000) on your browser to see the result
 
+## Alternative Development Setup: Docker Compose
+
+You can also use Docker Compose for local development.
+
+### How to Use
+
+1. Ensure you have [Docker](https://www.docker.com/products/docker-desktop/) and [Docker Compose](https://docs.docker.com/compose/) installed.
+2. In the project **root**, run:
+	```bash
+	docker compose up
+	```
+3. Open [http://localhost:8000](http://localhost:8000) in your browser.
+
 ## Code Quality Tools
 
 ### Formatting

docker-compose.yml

@@ -0,0 +1,33 @@
+services:
+  stories_webapp:
+    # TODO: track version with updatecli - ref. https://github.com/jenkins-infra/jenkins-infra/blob/efe90908529525bb3c9e61c2eb920ada3b968f1a/updatecli/updatecli.d/jenkinscontroller-tools-maven.yaml#L17-L22
+    image: jenkinsciinfra/jenkins-agent-ubuntu-22.04:2.91.1
+
+    ports:
+      - "8000:8000"
+
+    # Load environment variables 
+    env_file:
+      - .env
+    # Add docker-compose-specific env vars
+    environment:
+      CHOKIDAR_USEPOLLING: "true"
+      PATH: /home/jenkins/.asdf/shims:/home/jenkins/.asdf/bin:$PATH
+      NODE_ENV: development
+
+    volumes:
+      - .:${WORKSPACE_}
+
+    working_dir: ${WORKSPACE_}
+
+    user: jenkins
+
+    entrypoint: []
+    command: bash -c "asdf install && asdf current && npm install && npm run develop"
+
+    networks:
+      - stories_network
+
+networks:
+  stories_network:
+    driver: bridge