Prototype Tool to Create Cloud Run Apps with Firebase CLI

package.json

@@ -44,6 +44,7 @@
     "test:functions-discover": "bash ./scripts/functions-discover-tests/run.sh",
     "test:hosting": "bash ./scripts/hosting-tests/run.sh",
     "test:hosting-rewrites": "bash ./scripts/hosting-tests/rewrites-tests/run.sh",
+    "test:run-deploy": "bash ./scripts/run-deploy-tests/run.sh",
     "test:import-export": "bash ./scripts/emulator-import-export-tests/run.sh",
     "test:triggers-end-to-end": "bash ./scripts/triggers-end-to-end-tests/run.sh",
     "test:triggers-end-to-end:inspect": "bash ./scripts/triggers-end-to-end-tests/run.sh inspect",

schema/firebase-config.json

@@ -1221,6 +1221,59 @@
             ],
             "type": "object"
         },
+        "RunSingle": {
+            "additionalProperties": false,
+            "properties": {
+                "ignore": {
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "postdeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "predeploy": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ]
+                },
+                "region": {
+                    "type": "string"
+                },
+                "rootDir": {
+                    "type": "string"
+                },
+                "serviceAccount": {
+                    "type": "string"
+                },
+                "serviceId": {
+                    "type": "string"
+                }
+            },
+            "required": [
+                "serviceId"
+            ],
+            "type": "object"
+        },
         "StorageSingle": {
             "additionalProperties": false,
             "properties": {
@@ -2008,6 +2061,19 @@
         "remoteconfig": {
             "$ref": "#/definitions/RemoteConfigConfig"
         },
+        "run": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/RunSingle"
+                },
+                {
+                    "items": {
+                        "$ref": "#/definitions/RunSingle"
+                    },
+                    "type": "array"
+                }
+            ]
+        },
         "storage": {
             "anyOf": [
                 {

scripts/integration-helpers/cli.ts

@@ -32,11 +32,11 @@
     this.process = p;
 
     this.process.stdout?.on("data", (data: unknown) => {
       process.stdout.write(`[${this.name} stdout] ` + data);
     });
 
     this.process.stderr?.on("data", (data: unknown) => {
       console.log(`[${this.name} stderr] ` + data);
     });
 
     let started: Promise<void>;
@@ -56,7 +56,7 @@
         p.stdout?.on("data", customCallback);
         p.stdout?.on("close", customFailure);
         p.stderr?.on("data", (data) => {
           console.error(`[${this.name} stderr]`, data.toString());
         });
       });
     } else {
@@ -88,3 +88,74 @@
     return stopped;
   }
 }
+
+export interface Result {
+  proc: ChildProcess;
+  stdout: string;
+  stderr: string;
+  exitCode?: number | null;
+}
+
+/**
+ * Execute a Firebase CLI command in a target directory with specified arguments and environment.
+ */
+export function exec(
+  cmd: string,
+  project?: string,
+  additionalArgs: string[] = [],
+  cwd: string = process.cwd(),
+  quiet = true,
+  extraEnv: Record<string, string> = {},
+): Promise<Result> {
+  const args = [cmd];
+  if (project) {
+    args.push("--project", project);
+  }
+
+  if (additionalArgs && additionalArgs.length > 0) {
+    args.push(...additionalArgs);
+  }
+
+  const env = {
+    ...process.env,
+    ...extraEnv,
+  };
+
+  const proc = spawn("firebase", args, { cwd, env });
+  if (!proc) {
+    throw new Error("Failed to start firebase CLI");
+  }
+
+  const cli: Result = {
+    proc,
+    stdout: "",
+    stderr: "",
+    exitCode: null,
+  };
+
+  proc.stdout?.on("data", (data: Buffer) => {
+    const s = data.toString();
+    if (!quiet) {
+      process.stdout.write(s);
+    }
+    cli.stdout += s;
+  });
+
+  proc.stderr?.on("data", (data: Buffer) => {
+    const s = data.toString();
+    if (!quiet) {
+      process.stderr.write(s);
+    }
+    cli.stderr += s;
+  });
+
+  return new Promise((resolve, reject) => {
+    proc.on("error", (err) => {
+      reject(err);
+    });
+    proc.on("close", (code) => {
+      cli.exitCode = code;
+      resolve(cli);
+    });
+  });
+}

scripts/run-deploy-tests/run.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -e # Immediately exit on failure
+
+# Globally link the CLI for the testing framework
+./scripts/clean-install.sh
+
+if [ -f "scripts/set-default-credentials.sh" ]; then
+  source scripts/set-default-credentials.sh
+fi
+
+echo "======================================"
+echo "Starting Cloud Run E2E Test Suite"
+echo "======================================"
+
+mocha scripts/run-deploy-tests/tests.ts --timeout 600000