The Ruby Runtime


Your Cloud Function runs in an environment consisting of an operating system version plus add-on packages, language support, and the Functions Framework library that supports and invokes your function. This environment is identified by the language version, and is known as the runtime.

For information about runtimes in general, and to learn which Ubuntu version each Ruby runtime uses, see the Cloud Functions execution environment.

Select your runtime

Cloud Functions supports several versions of Ruby, listed on the Runtime support page. You can select the preferred Ruby runtime for your function during deployment.


If you're using the Google Cloud CLI, specify the runtime by using the --runtime parameter. NAME specifies the function name. For example:

gcloud functions deploy NAME --runtime ruby32 --trigger-http FLAGS...

FLAGS... refers to arguments passed during the first deployment of your function. For more information regarding required and optional arguments, see Deploy using the Google Cloud CLI.


If you're using the Google Cloud console, see the Google Cloud console quickstart for detailed instructions.

Source code structure

For Cloud Functions to find your function's definition, your source code must follow a specific structure. See Writing Cloud Functions for more information.

Function preparation

You can prepare a function directly from the Google Cloud console or write it on your local machine and upload it. To prepare your local machine for Ruby development, see Setting up a Ruby development environment. The library that invokes your function is the Ruby Functions Framework.

Specifying dependencies

You can specify dependencies for your function by adding them to a project file. For more information, see Specifying dependencies in Ruby.

What's next