# The Ruby Runtime

## Overview

Your Cloud Run 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 Run functions execution
environment](https://docs.cloud.google.com/functions/1stgendocs/concepts/execution-environment#ruby).

## Select your runtime

Cloud Run functions supports several versions of Ruby, listed on the
[Runtime support](https://docs.cloud.google.com/functions/1stgendocs/runtime-support.md.txt#ruby) 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. <var translate="no">NAME</var> specifies the
function name. For example:

```bash
gcloud functions deploy NAME --no-gen2 --runtime ruby40 --trigger-http
```

For more deployment parameters, see [Deploy a Cloud Run function](https://docs.cloud.google.com/functions/1stgendocs/deploy.md.txt#basics).

## Source code structure

For Cloud Run functions to find your function's definition, your
source code must follow a specific structure. See
[Writing Cloud Run functions](https://docs.cloud.google.com/functions/1stgendocs/writing.md.txt#structuring_source_code)
for more information.

## Function preparation

You can write a function on your local machine and upload it.
To prepare your local machine for Ruby
development, see [Setting up a Ruby development environment](https://docs.cloud.google.com/ruby/docs/setup.md.txt).
The library that invokes your function is the
[Ruby Functions Framework](https://docs.cloud.google.com/functions/1stgendocs/functions-framework.md.txt).

> [!NOTE]
> **Note:** The only type of [event-driven functions](https://docs.cloud.google.com/functions/1stgendocs/writing.md.txt#types_of_cloud_functions) Ruby supports are [CloudEvent functions](https://docs.cloud.google.com/functions/1stgendocs/writing.md.txt#cloudevent_functions).

## Specifying dependencies

You can specify dependencies for your function by adding them to a project file.
For more information, see [Specifying dependencies in
Ruby](https://docs.cloud.google.com/functions/1stgendocs/writing/specifying-dependencies-ruby).

## What's next

- [Create your first Ruby function](https://docs.cloud.google.com/functions/1stgendocs/create-deploy-http-ruby-1st-gen.md.txt) from scratch.