Configuration Migration · Extension To Functions Codebase · firebase/agent-skills · Skills Docs

Configuration Migration · Extension To Functions Codebase · firebase/agent-skills · Skills Docs

firebase-functions/v2

.runWith()

import * as functions from "firebase-functions";

export const processOrder = functions
  .runWith({ memory: "2GB" })
  .pubsub.topic("orders")
  .onPublish((message, context) => { ... });

import { onMessagePublished } from "firebase-functions/v2/pubsub";

export const processOrder = onMessagePublished(
  {
    topic: "orders",
    memory: "2GiB", // Options passed as the first argument!
  },
  ({ message, context }) => { ... } // Destructuring shim pattern
);

import * as functions from "firebase-functions";

export const myFn = functions
  .runWith({
    memory: "1GB",
    timeoutSeconds: 120,
    serviceAccount: "custom-sa@my-project.iam.gserviceaccount.com",
  })
  .https.onRequest((req, res) => { ... });

import { setGlobalOptions } from "firebase-functions/v2";
import { onRequest } from "firebase-functions/v2/https";

// Set global defaults for all functions defined after this call in this file
setGlobalOptions({
  memory: "1GiB", // Note: GiB instead of GB is preferred in V2 types
  timeoutSeconds: 120,
  serviceAccount: "custom-sa@my-project.iam.gserviceaccount.com",
});

export const myFn = onRequest((req, res) => { ... });

V1 Property	V2 Property	Notes
`memory`	`memory`	Use `"1GiB"` instead of `"1GB"`.
`timeoutSeconds`	`timeoutSeconds`	Same.
`ingressSettings`	`ingressSettings`	Same.
`vpcConnector`	`vpcConnector`	Same.
`vpcConnectorEgressSettings`	`vpcConnectorEgressSettings`	Same.
`serviceAccount`	`serviceAccount`	Same.
`secrets`	`secrets`	Same.
`failurePolicy`	`retry`	Renamed to boolean `retry: true/false` in V2 Eventarc triggers.

Global Initialization: If a variable was initialized globally in V1 (e.g., const client = new Client(functions.config().key)), you must split it to have declaration at global scope and initialization inside onInit:
```
import { onInit } from "firebase-functions/v2";

const myKey = defineSecret("MY_KEY");
let client: Client;

onInit(() => {
  client = new Client(myKey.value());
});
```