RepoScalewayScalewaypublished Dec 19, 2022seen 5d

scaleway/serverless-gateway

Python

Open original ↗

Captured source

source ↗
published Dec 19, 2022seen 5dcaptured 8hhttp 200method plain

scaleway/serverless-gateway

Description: Serverless API Gateway running on Scaleway

Language: Python

License: MIT

Stars: 19

Forks: 0

Open issues: 1

Created: 2022-12-19T12:56:08Z

Pushed: 2026-02-26T08:36:08Z

Default branch: main

Fork: no

Archived: yes

README: > [!WARNING] > Project Deprecated > > This project is deprecated and will soon be replaced by Scaleway Edge Services, a fully managed API gateway solution compatible with Serverless Functions and Serverless Containers. > > Scaleway Edge Services will provide enhanced features, better performances, and seamless integration with the Scaleway ecosystem. The product is expected to be released soon.

Scaleway Serverless Gateway

![PyPI version](https://badge.fury.io/py/scw-gateway) ![Documentation Status](https://serverless-gateway.readthedocs.io/en/latest/?badge=latest) ![Build status](https://github.com/scaleway/serverless-gateway/actions/workflows/build.yml/badge.svg)

The Scaleway Serverless Gateway is a self-hosted API gateway that runs on Scaleway Serverless Containers.

It lets you manage routing from a single base URL, as well as handling transversal concerns such as CORS and authentication.

It is built on Kong Gateway, giving you access to the Kong plugin ecosystem to customize your deployments.

You can read all about it in this blog post.

If you would like to join in the discussion on how we continue developing the project, or give us feedback, then join us on the #api-gateway-beta channel on the Scaleway Community Slack.

📃 Contents

  • [Scaleway Serverless Gateway](#-scaleway-serverless-gateway)
  • [📃 Contents](#-contents)
  • [💻 Quickstart](#-quickstart)
  • [Deploy your gateway](#deploy-your-gateway)
  • [Add a route](#add-a-route)
  • [Delete your gateway](#delete-your-gateway)
  • [🎓 Contributing](#-contributing)
  • [📬 Reach us](#-reach-us)

Please see the docs for full documentation and features.

💻 Quickstart

To deploy your gateway you need to install and configure the Scaleway CLI, and the Gateway CLI via `pip`:

pip install scw-gateway

Once done, the following steps can be run from the root of the project, and will deploy the gateway as a Serverless Container in your Scaleway account.

The gateway image itself is packaged via our public Serverless Gateway Docker image.

Deploy your gateway

To deploy your gateway, you can run:

scwgw infra deploy

For more information on the deployment process, see the deployment docs.

Add a route

To check your gateway is working, you can add and remove a route:

# Check no routes are configured initially
scwgw route ls

# Check the response directly from a given URL
TARGET_URL=http://worldtimeapi.org/api/timezone/Europe/Paris
curl $TARGET_URL

# Add a route to this URL in your gateway
scwgw route add /time $TARGET_URL

# List routes to see that it's been configured
scwgw route ls

# Curl the URL via the gateway
GATEWAY_ENDPOINT=$(scwgw infra endpoint)
curl https://${GATEWAY_ENDPOINT}/time

Delete your gateway

To delete your gateway, you can run:

scwgw infra delete

🎓 Contributing

We welcome all contributions to our open-source projects, please see our [contributing guidelines](./.github/CONTRIBUTING.md).

Do not hesitate to raise issues and pull requests we will have a look at them.

📬 Reach us

We love feedback. Feel free to:

Excerpt shown — open the source for the full document.