Plugin for the Twilio CLI to locally develop, debug and deploy to Twilio Serverless. Part of the Serverless Toolkit
This plugin adds functionality to the Twilio CLI to locally develop, debug and deploy to Twilio Serverless. It's a part of the Serverless Toolkit and wraps twilio-run and create-twilio-function.
Via npm or yarn:
$ npm install -g twilio-cli
$ yarn global add twilio-cliVia homebrew:
$ brew tap twilio/brew && brew install twilio$ twilio plugins:install @twilio-labs/plugin-serverless
$ twilio --help serverless
USAGE
$ twilio serverless
...When deploying lots of Functions and Assets it is possible to run up against the enforced concurrency limits of the Twilio API. You can limit the concurrency and set how many times the library retries API requests using environment variables.
The default concurrency is 50 and the default number of retries is 10. You can change this by setting environment variables. The following would set concurrency to 1, only 1 live request at a time, and retries to 0, so if it fails it won't retry.
export TWILIO_SERVERLESS_API_CONCURRENCY=1
export TWILIO_SERVERLESS_API_RETRY_LIMIT=0twilio serverless:deploytwilio serverless:init NAMEtwilio serverless:list [TYPES]twilio serverless:list-templatestwilio serverless:logstwilio serverless:new [NAMESPACE]twilio serverless:promotetwilio serverless:start [DIR]
Deploys existing functions and assets to Twilio
USAGE
$ twilio serverless:deploy
OPTIONS
-c, --config=config [default: .twilio-functions] Location of the config file. Absolute path or
relative to current working directory (cwd)
-l, --logLevel=logLevel [default: info] Level of logging messages.
-n, --service-name=service-name Overrides the name of the Serverless project. Default: the name field in your
package.json
-p, --profile=profile Shorthand identifier for your profile.
-u, --account-sid=account-sid A specific account SID to be used for deployment. Uses fields in .env otherwise
--[no-]assets Upload assets. Can be turned off with --no-assets
--assets-folder=assets-folder Specific folder name to be used for static assets
--auth-token=auth-token Use a specific auth token for deployment. Uses fields from .env otherwise
--cwd=cwd Sets the directory from which to deploy
--env=env Path to .env file. If none, the local .env in the current working directory is
used.
--environment=environment [default: dev] The environment name (domain suffix) you want to use for your
deployment
--force Will run deployment in force mode. Can be dangerous.
--[no-]functions Upload functions. Can be turned off with --no-functions
--functions-folder=functions-folder Specific folder name to be used for static functions
--load-system-env Uses system environment variables as fallback for variables specified in your
.env file. Needs to be used with --env explicitly specified.
--override-existing-project Deploys Serverless project to existing service if a naming conflict has been
found.
--production Please prefer the "activate" command! Deploys to the production environment (no
domain suffix). Overrides the value passed via the environment flag.
See code: src/commands/serverless/deploy.js
Creates a new Twilio Function project
USAGE
$ twilio serverless:init NAME
ARGUMENTS
NAME Name of Serverless project and directory that will be created
OPTIONS
-a, --account-sid=account-sid The Account SID for your Twilio account
-p, --profile=profile Shorthand identifier for your profile.
-t, --auth-token=auth-token Your Twilio account Auth Token
--empty Initialize your new project with empty functions and assets directories
--import-credentials Import credentials from the environment variables TWILIO_ACCOUNT_SID and
TWILIO_AUTH_TOKEN
--skip-credentials Don't ask for Twilio account credentials or import them from the environment
--template=template Initialize your new project with a template from
github.com/twilio-labs/function-templates
--typescript Initialize your Serverless project with TypeScript
See code: src/commands/serverless/init.js
List existing services, environments, variables, deployments for your Twilio Serverless Account
USAGE
$ twilio serverless:list [TYPES]
ARGUMENTS
TYPES [default: services] Comma separated list of things to list (services,environments,functions,assets,variables)
OPTIONS
-c, --config=config [default: .twilio-functions] Location of the config file. Absolute path or relative
to current working directory (cwd)
-l, --logLevel=logLevel [default: info] Level of logging messages.
-n, --service-name=service-name Overrides the name of the Serverless project. Default: the name field in your
package.json
-p, --profile=profile Shorthand identifier for your profile.
-u, --account-sid=account-sid A specific account SID to be used for deployment. Uses fields in .env otherwise
--auth-token=auth-token Use a specific auth token for deployment. Uses fields from .env otherwise
--env=env Path to .env file for environment variables that should be installed
--environment=environment [default: dev] The environment to list variables for
--extended-output Show an extended set of properties on the output
--load-system-env Uses system environment variables as fallback for variables specified in your .env
file. Needs to be used with --env explicitly specified.
--service-sid=service-sid Specific Serverless Service SID to run list for
See code: src/commands/serverless/list.js
Lists the available Twilio Function templates
USAGE
$ twilio serverless:list-templates
OPTIONS
-l, --logLevel=logLevel [default: info] Level of logging messages.
See code: src/commands/serverless/list-templates.js
Print logs from your Twilio Serverless project
USAGE
$ twilio serverless:logs
OPTIONS
-c, --config=config [default: .twilio-functions] Location of the config file. Absolute path or relative
to current working directory (cwd)
-l, --logLevel=logLevel [default: info] Level of logging messages.
-o, --output-format=output-format Output the log in a different format
-p, --profile=profile Shorthand identifier for your profile.
-u, --account-sid=account-sid A specific account SID to be used for deployment. Uses fields in .env otherwise
--auth-token=auth-token Use a specific auth token for deployment. Uses fields from .env otherwise
--cwd=cwd Sets the directory of your existing Serverless project. Defaults to current
directory
--env=env Path to .env file for environment variables that should be installed
--environment=environment [default: dev] The environment to retrieve the logs for
--function-sid=function-sid Specific Function SID to retrieve logs for
--load-system-env Uses system environment variables as fallback for variables specified in your .env
file. Needs to be used with --env explicitly specified.
--service-sid=service-sid Specific Serverless Service SID to retrieve logs for
--tail Continuously stream the logs
See code: src/commands/serverless/logs.js
Creates a new Twilio Function based on an existing template
USAGE
$ twilio serverless:new [NAMESPACE]
ARGUMENTS
NAMESPACE The namespace your assets/functions should be grouped under
OPTIONS
-l, --logLevel=logLevel [default: info] Level of logging messages.
--template=template
See code: src/commands/serverless/new.js
Promotes an existing deployment to a new environment
USAGE
$ twilio serverless:promote
OPTIONS
-c, --config=config [default: .twilio-functions] Location of the config file. Absolute path
or relative to current working directory (cwd)
-f, --source-environment=source-environment SID or suffix of an existing environment you want to deploy from.
-f, --build-sid=build-sid An existing Build SID to deploy to the new environment
-l, --logLevel=logLevel [default: info] Level of logging messages.
-p, --profile=profile Shorthand identifier for your profile.
-t, --environment=environment The environment suffix or SID to deploy to.
-u, --account-sid=account-sid A specific account SID to be used for deployment. Uses fields in .env
otherwise
--auth-token=auth-token Use a specific auth token for deployment. Uses fields from .env otherwise
--create-environment Creates environment if it couldn't find it.
--cwd=cwd Sets the directory of your existing Serverless project. Defaults to
current directory
--env=env Path to .env file for environment variables that should be installed
--force Will run deployment in force mode. Can be dangerous.
--load-system-env Uses system environment variables as fallback for variables specified in
your .env file. Needs to be used with --env explicitly specified.
--production Promote build to the production environment (no domain suffix). Overrides
environment flag
--service-sid=service-sid SID of the Twilio Serverless Service to deploy to
ALIASES
$ twilio serverless:activate
See code: src/commands/serverless/promote.js
Starts local Twilio Functions development server
USAGE
$ twilio serverless:start [DIR]
ARGUMENTS
DIR Root directory to serve local Functions/Assets from
OPTIONS
-c, --config=config [default: .twilio-functions] Location of the config file. Absolute path or
relative to current working directory (cwd)
-e, --env=env Loads .env file, overrides local env variables
-f, --load-local-env Includes the local environment variables
-l, --logLevel=logLevel [default: info] Level of logging messages.
-p, --port=port (required) [default: 3000] Override default port of 3000
--assets-folder=assets-folder Specific folder name to be used for static assets
--cwd=cwd Alternative way to define the directory to start the server in. Overrides the
[dir] argument passed.
--detailed-logs Toggles detailed request logging by showing request body and query params
--experimental-fork-process Enable forking function processes to emulate production environment
--functions-folder=functions-folder Specific folder name to be used for static functions
--inspect=inspect Enables Node.js debugging protocol
--inspect-brk=inspect-brk Enables Node.js debugging protocol, stops executioin until debugger is attached
--legacy-mode Enables legacy mode, it will prefix your asset paths with /assets
--[no-]live Always serve from the current functions (no caching)
--[no-]logs Toggles request logging
--ngrok=ngrok Uses ngrok to create and outfacing url
ALIASES
$ twilio serverless:dev
$ twilio serverless:run
See code: src/commands/serverless/start.js
This project welcomes contributions from the community. Please see the CONTRIBUTING.md file for more details.
Please be aware that this project has a Code of Conduct. The tldr; is to just be excellent to each other ❤️
Thanks goes to these wonderful people (emoji key):
 Dominik Kundel 💻 📖 🤔 |
 childish-sambino 💻 🐛 |
 Elmer Thomas 🐛 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!
MIT