From 464b733e67ee68954215be19e2d0ce1c553088f1 Mon Sep 17 00:00:00 2001 From: fnkit Date: Tue, 17 Feb 2026 16:45:11 +0000 Subject: [PATCH] initial commit - python function --- .forgejo/workflows/deploy.yml | 83 +++++++++++++++++++++++++++++++++++ .gitignore | 18 ++++++++ Dockerfile | 7 +++ docker-compose.yml | 36 +++++++++++++++ main.py | 18 ++++++++ requirements.txt | 1 + 6 files changed, 163 insertions(+) create mode 100644 .forgejo/workflows/deploy.yml create mode 100644 .gitignore create mode 100644 Dockerfile create mode 100644 docker-compose.yml create mode 100644 main.py create mode 100644 requirements.txt diff --git a/.forgejo/workflows/deploy.yml b/.forgejo/workflows/deploy.yml new file mode 100644 index 0000000..83033c7 --- /dev/null +++ b/.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-python" + 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 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..8512365 --- /dev/null +++ b/.gitignore @@ -0,0 +1,18 @@ +# IDE +.idea/ +.vscode/ +*.swp +*.swo + +# OS +.DS_Store +Thumbs.db + +# Docker +Dockerfile.local +# Python +__pycache__/ +*.py[cod] +.env +venv/ +.venv/ diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..3449c2c --- /dev/null +++ b/Dockerfile @@ -0,0 +1,7 @@ +FROM python:3.11-slim +LABEL fnkit.fn="true" +WORKDIR /app +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt +COPY . . +CMD ["functions-framework", "--target=hello", "--port=8080"] diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..2ec99cc --- /dev/null +++ b/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-python: + build: . + container_name: fn-python + 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 " http://localhost:8080/fn-python diff --git a/main.py b/main.py new file mode 100644 index 0000000..6fde9f7 --- /dev/null +++ b/main.py @@ -0,0 +1,18 @@ +import flask +import functions_framework + + +@functions_framework.http +def hello(request: flask.Request) -> flask.typing.ResponseReturnValue: + """HTTP Cloud Function. + + Args: + request: The request object. + + + Returns: + The response text, or any set of values that can be turned into a + Response object using `make_response`. + + """ + return "Hello, World!" diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..a675cdd --- /dev/null +++ b/requirements.txt @@ -0,0 +1 @@ +functions-framework==3.*