Execution environment security

Every function runs on top of a versioned runtime image within the Cloud Functions secure execution environment. Runtime images contain operating system libraries, language runtimes and other system packages. Google maintains all Cloud Functions runtime images, releasing security patches and maintenance updates after a period of stability testing.

Runtime images

Each runtime has an associated runtime image (also known as a run image) in a public repository on gcr.io. For a of list runtime IDs and their runtime images, see runtimes.

Identify your runtime image

You can identify the runtime image used to create your function by inspecting the build logs for your function.

Within the build logs, search for google.run-image. This gives you the log entry from the build step that describes the version of the runtime image used to build your function. For example, a log entry for a Nodejs function might look like this:

{
  ...
  "textPayload": "Step #2 - \"build\": Adding image label google.run-image:
    us.gcr.io/gae-runtimes/buildpacks/nodejs20/run:nodejs20_20230924_20_6_1_RC00",
  ...
}

Security update policy

Cloud Functions offers two security update policies:

  • Automatic updates: Updates and security patches to the runtime environment are published in new versions of the runtime image. After a period of testing for stability and reliability, the updated runtime is rolled out to all functions resulting in a zero downtime update. Automatic security updates are only available with Cloud Functions (1st gen).

  • On deployment updates: Updates and security patches are applied to runtimes only when functions are deployed or redeployed, unless otherwise noted. Updates on deployment are available on both Cloud Functions (1st gen) and Cloud Functions (2nd gen).

Set your function's update policy

If you're using Cloud Functions (1st gen), you can change your function's update policy by including the --runtime-update-policy flag in your gcloud deploy command as shown here:

  gcloud functions deploy FUNCTION_NAME \
    --runtime-update-policy=POLICY ...

Replace:

  • FUNCTION_NAME with the name of your function
  • POLICY with automatic or on-deploy

Inspect your function's update policy

You can inspect your function's update policy with the following command:

  gcloud functions describe FUNCTION_NAME \

Where FUNCTION_NAME is the name of your function

  • Functions with automatic security updates enabled will have the key automaticUpdatePolicy
  • Functions that update on deployment will have the key onDeployUpdatePolicy

Identify the runtime image used after an automatic update

When you enable automatic updates, Cloud Functions swaps your function's runtime image with a newer revision containing additional security patches and updates. This change appears in your function's runtime logs.

Inside the runtime logs the runtime_version label tells you when a new runtime image is being used on your function. A log entry for a Nodejs function that has been automatically updated might look like this:

{
  ...
  "labels:" {
    runtime_version: nodejs20_20230924_20_6_1_RC00
    execution_id: ...
  }
  ...
}