Plugin for using Scaleway Serverless Functions and Serverless Containers with Serverless Framework.
- Serverless Framework CLI installed on your local computer (e.g. run
npm install serverless -g) - Scaleway CLI installed on your local computer
If you are using Scaleway IAM, you need to be the Owner of the Scaleway Organization in which the deployment will take place, or be an IAM user of the Organization with a policy granting you the necessary Permission Sets. See the IAM Overview for more information.
- Export the template you wish to use (see the list here). We will use
python3:
export TEMPLATE=python3- Create a function from this template:
serverless create \
--path ${TEMPLATE}-func \
--template-url https://github.com/scaleway/serverless-scaleway-functions/tree/master/examples/${TEMPLATE}- Install dependencies:
cd ${TEMPLATE}-func
npm i- Deploy the function:
serverless deploy- Invoke the function (note that
firstis the function name in this example):
serverless invoke --function firstMore detailed documentation can be found in the docs folder, including:
- Managing containers
- Configuring custom domains
- Handling events (e.g. CRONs)
- Security and secret management
- Troubleshooting
There are also language-specific notes for Serverless Functions:
With Serverless Framework, your functions and containers are defined in a serverless.yml file.
Each serverless.yml file corresponds to one function or container namespace.
The following configuration is common to both functions and containers:
# The name of your namespace
service: my-namespace
# Read environment variables from a .env file
useDotenv: false
# Use of this plugin. This must not be changed
plugins:
- serverless-scaleway-functions
# Scaleway-specific configuration
provider:
# Must not change
name: scaleway
# Runtime used for functions (unless overridden)
# List: https://www.scaleway.com/en/docs/serverless/functions/reference-content/functions-lifecycle/#available-runtimes
runtime: python310
# Global environment variables, used in every function/container in this namespace
env:
MY_VAR: "some var"
MY_OTHER_VAR: "some other var"
# Global secrets, used in every function/container in this namespace
secret:
MY_SECRET: "some secret"
MY_OTHER_SECRET: "some other secret"
# Optional override of Scaleway credentials
scwToken: <scw-token>
scwProject: <scw-project-id>
# Scaleway region for the deploy
scwRegion: fr-par
# Include/exclude directories
package:
patterns:
- "!node_modules/**"
- "!.gitignore"
- "!.git/**"To define functions, you can include a functions block:
functions:
my-func:
# Handler entrypoint
handler: handler.py
# Minimum and maximum number of instances
minScale: 0
maxScale: 10
# Memory limit (in MiB)
# Limits: https://www.scaleway.com/en/docs/serverless/functions/reference-content/functions-limitations/
memoryLimit: 1024
# Maximum duration a request will wait to be served before it times out (in seconds)
# Value in string format ex: "300s" (default: 300 seconds)
timeout: 300s
# Runtime for this function, allows overriding provider.runtime
runtime: node20
# How to handle HTTP. Options: enabled (allow HTTP), disabled (block HTTP), or redirected (redirect HTTP -> HTTPS)
httpOption: enabled
# Controls privacy of the function. Options: public (no authentication), private (token-based authentication)
privacy: public
# Local environment variables, used only in this function
env:
LOCAL_VAR: "local var"
# Local secrets, used only in this function
secret:
LOCAL_SECRET: "local secret"
# Custom domains configured for the function
# https://www.scaleway.com/en/docs/compute/functions/how-to/add-a-custom-domain-name-to-a-function/
custom_domains:
- my-func.some.domain.com
# List of events to trigger the function
events:
- schedule:
rate: "1 * * * *"
# Data passed as input in the request
input:
key-a: "value-a"
key-b: "value-b"To define containers, you can include a custom.containers block (note that you can only have functions or custom.containers).
custom:
containers:
my-container:
# Subdirectory holding the Dockerfile, cannot be used with registryImage
directory: container/
# Name of the registry image, cannot be used with directory
registryImage: nginx:latest
# Minimum and maximum number of instances
minScale: 0
maxScale: 10
# Number of simultaneous requests to handle simultaneously
maxConcurrency: 20
# Memory limit (in MiB)
# Limits: https://www.scaleway.com/en/docs/serverless/containers/reference-content/containers-limitations/
memoryLimit: 1024
# CPU limit for the container in mvCPU, chosen based on resource tiers if not set
# Limits and tiers: https://www.scaleway.com/en/docs/serverless/containers/reference-content/containers-limitations/
cpuLimit: 1000
# Maximum duration a request will wait to be served before it times out (in seconds)
# Value in string format ex: "300s" (default: 300 seconds)
timeout: 300s
# How to handle HTTP. Options: enabled (allow HTTP), disabled (block HTTP), or redirected (redirect HTTP -> HTTPS)
httpOption: enabled
# Controls privacy of the container. Options: public (no authentication), private (token-based authentication)
privacy: public
# Local environment variables, used only in this container
env:
LOCAL_VAR: "local var"
# Local secrets, used only in this container
secret:
LOCAL_SECRET: "local secret"
# Custom domains configured for the function
# https://www.scaleway.com/en/docs/serverless/containers/how-to/add-a-custom-domain-to-a-container/
custom_domains:
- my-container.some.domain.com
# List of events to trigger the container
events:
- schedule:
rate: "1 * * * *"
# Data passed as input in the request
input:
key-a: "value-a"
key-b: "value-b"Note that by default serverless deploy applies the configuration located in your serverless.yml and removes functions in that namespace that are not in the file.
This can be switched off by setting the singleSource option to false.
Warning
This command is deprecated and will be removed on March 12, 2024. Please refer to the documentation (for functions and containers) to continue getting your logs. TL;DR: You can still access function and container logs conveniently via the Cockpit interface. Dedicated dashboards called "Serverless Functions Logs" and "Serverless Containers Logs" are accessible there.
The serverless logs command lets you watch the logs of a specific function or container.
You can fetch the logs of a specific function for with the --function option. You must specify the name of your function in the command.
serverless logs --function <function_or_container_name>The serverless info command gives you information about your functions' or containers' current deployement state in JSON format.
serverless invoke local is not supported directly but instead we provide additional packages to install close to your handler.
Documentation is available through runtimes frameworks for:
- Scaleway Serverless Functions Documentation
- Scaleway Serverless Containers Documentation
- Serverless Framework documentation
- Scaleway Serverless example projects
This plugin is developed and maintained by the Scaleway Serverless Team, but we welcome pull requests and issues, and are available to chat on our Community Slack Channels: #serverless-containers and #serverless-functions.
If you are looking for a way to contribute please read CONTRIBUTING.md. You can also look at the development documentation.
For general information about developing Serverless Framework, refer to the Serverless Framework plugins documentation.
- Scaleway support is available on Scaleway Console.
- Additionally, you can join our Slack Community
We love feedback. Feel free to:
- Open a Github issue
- Send us a message on the Scaleway Slack community, in the #serverless-functions channel.
This project is MIT licensed.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent