initial commit - node function

.forgejo/workflows/deploy.yml

@@ -0,0 +1,83 @@
+# FnKit Deploy — Forgejo Actions
+# Builds and deploys this function container on every push to main
+# Requires: Forgejo runner with Docker socket access (fnkit deploy runner)
+#
+# Pipeline: git push → build image → deploy container → health check
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build image
+        run: |
+          FUNCTION_NAME="fn-node"
+          IMAGE_NAME="fnkit-fn-${FUNCTION_NAME}:latest"
+          IMAGE_PREV="fnkit-fn-${FUNCTION_NAME}:prev"
+
+          echo "🔨 Building ${FUNCTION_NAME}..."
+          docker build -t $IMAGE_NAME .
+
+          echo "IMAGE_NAME=$IMAGE_NAME" >> $GITHUB_ENV
+          echo "IMAGE_PREV=$IMAGE_PREV" >> $GITHUB_ENV
+          echo "FUNCTION_NAME=$FUNCTION_NAME" >> $GITHUB_ENV
+
+      - name: Deploy container
+        run: |
+          echo "🌐 Ensuring fnkit-network exists..."
+          docker network create fnkit-network 2>/dev/null || true
+
+          # Tag current image as :prev for rollback
+          docker tag $IMAGE_NAME $IMAGE_PREV 2>/dev/null || true
+
+          echo "♻️  Replacing running container..."
+          docker stop $FUNCTION_NAME 2>/dev/null || true
+          docker rm $FUNCTION_NAME 2>/dev/null || true
+
+          echo "🚀 Starting ${FUNCTION_NAME}..."
+          docker run -d \
+            --name $FUNCTION_NAME \
+            --network fnkit-network \
+            --label fnkit.fn=true \
+            --label fnkit.deployed="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+            --restart unless-stopped \
+            $IMAGE_NAME
+
+      - name: Health check
+        run: |
+          echo "🏥 Checking container health..."
+          sleep 3
+
+          if docker ps --filter "name=$FUNCTION_NAME" --filter "status=running" -q | grep -q .; then
+            echo "✅ ${FUNCTION_NAME} is running"
+            echo "🌐 Available at gateway: /${FUNCTION_NAME}"
+          else
+            echo "❌ Container failed to start — rolling back..."
+            docker logs $FUNCTION_NAME 2>&1 || true
+
+            # Rollback to previous image if available
+            if docker image inspect $IMAGE_PREV >/dev/null 2>&1; then
+              echo "🔄 Rolling back to previous image..."
+              docker rm $FUNCTION_NAME 2>/dev/null || true
+              docker run -d \
+                --name $FUNCTION_NAME \
+                --network fnkit-network \
+                --label fnkit.fn=true \
+                --label fnkit.deployed="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+                --label fnkit.rollback=true \
+                --restart unless-stopped \
+                $IMAGE_PREV
+              echo "⚠️  Rolled back to previous version"
+            fi
+            exit 1
+          fi
+
+      - name: Cleanup old images
+        run: |
+          echo "🧹 Cleaning up dangling images..."
+          docker image prune -f --filter "label=fnkit.fn=true" 2>/dev/null || true

.gitignore

@@ -0,0 +1,17 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+Dockerfile.local
+# Node.js
+node_modules/
+npm-debug.log
+yarn-error.log
+.env

Dockerfile

@@ -0,0 +1,7 @@
+FROM node:20-slim
+LABEL fnkit.fn="true"
+WORKDIR /usr/src/app
+COPY package*.json ./
+RUN npm install --only=production
+COPY . .
+CMD ["npm", "start"]

docker-compose.yml

@@ -0,0 +1,36 @@
+# Docker Compose for FnKit function with gateway integration
+# Requires: docker network create fnkit-network
+# Requires: fnkit-gateway running (fnkit gateway init && fnkit gateway build && fnkit gateway start)
+
+version: '3.8'
+
+services:
+  fn-node:
+    build: .
+    container_name: fn-node
+    networks:
+      - fnkit-network
+    depends_on:
+      fnkit-gateway:
+        condition: service_started
+    restart: unless-stopped
+
+  # Uncomment to include gateway in this compose file
+  # fnkit-gateway:
+  #   image: fnkit-gateway:latest
+  #   container_name: fnkit-gateway
+  #   ports:
+  #     - "8080:8080"
+  #   environment:
+  #     - FNKIT_AUTH_TOKEN=${FNKIT_AUTH_TOKEN:-}
+  #   networks:
+  #     - fnkit-network
+
+networks:
+  fnkit-network:
+    name: fnkit-network
+    external: true
+
+# Usage:
+#   docker-compose up -d
+#   curl -H "Authorization: Bearer <token>" http://localhost:8080/fn-node

index.js

@@ -0,0 +1,5 @@
+const functions = require('@google-cloud/functions-framework');
+
+functions.http('helloWorld', (req, res) => {
+  res.send('Hello, World!');
+});

package.json

@@ -0,0 +1,11 @@
+{
+  "name": "fn-node",
+  "version": "1.0.0",
+  "main": "index.js",
+  "scripts": {
+    "start": "functions-framework --target=helloWorld"
+  },
+  "dependencies": {
+    "@google-cloud/functions-framework": "^3.0.0"
+  }
+}