feat: python serverless api with serverless gateway

README.md

@@ -46,6 +46,7 @@ Table of Contents:
 | **[PostgreSQL Python](functions/postgre-sql-python/README.md)** <br/> A Python function to perform a query on a PostgreSQL managed database.       | python310 | [Serverless Framework] |
 | **[Terraform Python](functions/terraform-python-example/README.md)** <br/> A Python function deployed with Terraform.                              | python310 | [Terraform]            |
 | **[Typescript with Node runtime](functions/typescript-with-node/README.md)** <br/> A Typescript function using Node runtime.                       | node18    | [Serverless Framework]            |
+| **[Serverless Gateway Python Example](functions/serverless-gateway-python/README.md)** <br/> A Python serverless API using Serverless Gateway.     | python310    | [Python API Framework]            |
 
 ### 📦 Containers
 
@@ -60,6 +61,7 @@ Table of Contents:
 | Example                                                                                                                                   | Services    | Language | Deployment             |
 |-------------------------------------------------------------------------------------------------------------------------------------------|-------------|----------|------------------------|
 | **[Kong API Gateway](projects/kong-api-gateway/README.md)** <br/> Deploying a Kong Gateway on containers to provide routing to functions. | CaaS & FaaS | Python   | [Serverless Framework] |
+| **[Serverless Gateway](https://github.com/scaleway/serverless-gateway)** <br/> Our serverless gateway for functions and containers.       | API Gateway | Python   | [Python API Framework] |
 | **[Monitoring Glaciers](projects/blogpost-glacier/README.md)** <br/> A project to monitor glaciers and the impact of global warming.      | S3 & RDB    | Golang   | [Serverless Framework] |
 
 [Serverless Framework]: https://github.com/scaleway/serverless-scaleway-functions

functions/serverless-gateway-python/README.md

@@ -0,0 +1,55 @@
+# Using Serverless Gateway and Serverless APIs
+
+This example shows how to serve a Serverless API composed of many functions through our serverless gateway.
+
+## Requirements
+
+This example uses:
+* [Python API Framework](https://github.com/scaleway/serverless-api-project) to deploy the functions.
+* [Serverless Gateway](https://github.com/scaleway/serverless-gateway) to deploy a serverless gateway container.
+
+## Gateway set-up
+
+Deploy the serverless gateway as a container following the Serverless Gateway project instructions.
+
+Make sure to export your gateway base URL (`GATEWAY_URL`) and an authentication token (`GATEWAY_TOKEN`)
+
+## Running 
+
+### Deploy your serverless API
+
+Deploy your functions using:
+
+```
+pip install -r requirements.txt
+scw_serverless deploy app.py
+```
+
+### Add routes to your functions in the gateway
+
+You can add your function to the gateway with a chosen relative path using:
+```
+./scripts/add_function_to_gateway.sh http://<function_domain_name> /<chosen_relative_path>
+```
+
+### Check your route has been added
+
+You can use:
+```
+./list_gateway_endpoints.sh
+```
+
+### Call your functions via the routes
+
+You can use:
+```
+curl http://${GATEWAY_URL}/<chosen_relative_path>
+```
+
+### Delete your routes
+
+You can use:
+```
+./scripts/delete_function_to_gateway.sh http://<function_domain_name> /<chosen_relative_path>
+```
+

functions/serverless-gateway-python/app.py

@@ -0,0 +1,15 @@
+from  scw_serverless import Serverless
+
+app = Serverless("serverless-api")
+
+@app.func()
+def func_a(_event, _context):
+    return "Hello from function A"
+
+@app.func()
+def func_b(_event, _context):
+    return "Hello from function B"
+
+@app.func()
+def func_c(_event, _context):
+    return "Hello from function C"

functions/serverless-gateway-python/requirements.txt

@@ -0,0 +1 @@
+scw-serverless~=0.0.4

functions/serverless-gateway-python/scripts/add_function_to_gateway.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -e
+
+curl -X POST http://${GATEWAY_URL}/scw \
+             -H 'X-Auth-Token: ${GATEWAY_TOKEN}' \
+             -H 'Content-Type: application/json' \
+             -d '{"target":"$1","relative_url":"$2"}'

functions/serverless-gateway-python/scripts/delete_function_from_gateway.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -e
+
+curl -X POST http://${GATEWAY_URL}/scw \
+             -H 'X-Auth-Token: ${GATEWAY_TOKEN}' \
+             -H 'Content-Type: application/json' \
+             -d '{"target":"$1","relative_url":"$2"}'

functions/serverless-gateway-python/scripts/list_gateway_endpoints.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -e
+
+curl http://${GATEWAY_URL}/scw -H 'X-Auth-Token: ${GATEWAY_TOKEN}'