initial commit - ruby 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-ruby"
+          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,16 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+Dockerfile.local
+# Ruby
+vendor/bundle/
+.bundle/
+Gemfile.lock

Dockerfile

@@ -0,0 +1,7 @@
+FROM ruby:3.2-slim
+LABEL fnkit.fn="true"
+WORKDIR /app
+COPY Gemfile Gemfile.lock ./
+RUN bundle install
+COPY . .
+CMD ["bundle", "exec", "functions-framework-ruby", "--target=hello"]

Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "functions_framework", "~> 1.0"

app.rb

@@ -0,0 +1,5 @@
+require "functions_framework"
+
+FunctionsFramework.http("hello") do |request|
+  "Hello, World!\n"
+end

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-ruby:
+    build: .
+    container_name: fn-ruby
+    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-ruby