feat(cli): remove --base-image-node flag

The `--base-image-node` CLI option was a simple alternative to the more
flexible `--containerfile-module` for swapping the per-deploy base image.
We don't use it anywhere; `--containerfile-module` covers the same use
case and more (the `custom-base-image.mjs` example shows the migration
pattern).

Drop:
  - `baseImageNode` zod schema field on DeployCommandOptions
  - `--base-image-node` Commander flag
  - `baseImageNode` field on BuildImageOptions, DepotBuildImageOptions,
    SelfHostedBuildImageOptions, GenerateContainerfileOptions, and
    BuildWorkerOptions
  - `baseImageNode` plumbing through buildImage / writeContainerfile
  - The override branch in parseGenerateOptions
  - All references in examples/README.md (point users at
    --containerfile-module + the custom-base-image.mjs example instead)

Author: Conner Aldrich

packages/cli-v3/examples/README.md

@@ -42,7 +42,6 @@ export default {
     // - image: Image configuration with packages and instructions
     // - indexScript: Path to the indexing script
     // - entrypoint: Path to the runtime entrypoint
-    // - baseImageNode: Custom base image if provided via --base-image-node
     // - containerfileModule: Path to this module
 
     return `FROM your-base-image:latest
@@ -96,7 +95,6 @@ The `options` parameter passed to your `generate` function contains:
   },
   indexScript: string,  // e.g., ".trigger/index.mjs"
   entrypoint: string,   // e.g., ".trigger/run.mjs"
-  baseImageNode?: string,  // If --base-image-node was provided
   containerfileModule?: string  // Path to your module
 }
 ```
@@ -112,10 +110,9 @@ When using custom base images:
 
 ## Quick Start
 
-For simple base image replacement, you can also use the `--base-image-node` flag without a custom module:
+To swap the base image (or do anything more invasive), create a containerfile
+module like the examples above and pass it via `--containerfile-module`:
 
 ```bash
-npx trigger.dev@latest deploy --base-image-node node:20-alpine
+npx trigger.dev@latest deploy --containerfile-module ./containerfile.mjs
 ```
-
-For full control, create a custom module and use `--containerfile-module`. 

packages/cli-v3/src/build/buildWorker.ts

@@ -36,7 +36,6 @@ export type BuildWorkerOptions = {
   rewritePaths?: boolean;
   forcedExternals?: string[];
   plain?: boolean;
-  baseImageNode?: string;
   containerfileModule?: string;
 };
 
@@ -111,7 +110,6 @@ export async function buildWorker(options: BuildWorkerOptions) {
       resolvedConfig,
       outputPath: options.destination,
       bundleResult,
-      baseImageNode: options.baseImageNode,
       containerfileModule: options.containerfileModule,
     });
   }
@@ -172,14 +170,12 @@ async function writeDeployFiles({
   resolvedConfig,
   outputPath,
   bundleResult,
-  baseImageNode,
   containerfileModule,
 }: {
   buildManifest: BuildManifest;
   resolvedConfig: ResolvedConfig;
   outputPath: string;
   bundleResult: BundleResult;
-  baseImageNode?: string;
   containerfileModule?: string;
 }) {
   // Step 1. Read the package.json file
@@ -217,7 +213,7 @@ async function writeDeployFiles({
   );
 
   await writeJSONFile(join(outputPath, "build.json"), buildManifestToJSON(buildManifest));
-  await writeContainerfile(outputPath, buildManifest, baseImageNode, containerfileModule);
+  await writeContainerfile(outputPath, buildManifest, containerfileModule);
 }
 
 async function readProjectPackageJson(packageJsonPath: string) {
@@ -226,7 +222,11 @@ async function readProjectPackageJson(packageJsonPath: string) {
   return packageJson;
 }
 
-async function writeContainerfile(outputPath: string, buildManifest: BuildManifest, baseImageNode?: string, containerfileModule?: string) {
+async function writeContainerfile(
+  outputPath: string,
+  buildManifest: BuildManifest,
+  containerfileModule?: string
+) {
   if (!buildManifest.runControllerEntryPoint || !buildManifest.indexControllerEntryPoint) {
     throw new Error("Something went wrong with the build. Aborting deployment. [code 7789]");
   }
@@ -237,7 +237,6 @@ async function writeContainerfile(outputPath: string, buildManifest: BuildManife
     build: buildManifest.build,
     image: buildManifest.image,
     indexScript: buildManifest.indexControllerEntryPoint,
-    baseImageNode,
     containerfileModule,
   });
 

packages/cli-v3/src/commands/deploy.ts

@@ -95,7 +95,6 @@ const DeployCommandOptions = CommonCommandOptions.extend({
   repository: z.string().optional(),
   buildOnly: z.boolean().default(false),
   registerOnly: z.boolean().default(false),
-  baseImageNode: z.string().optional(),
   containerfileModule: z.string().optional(),
   skipDigest: z.boolean().default(false),
 });
@@ -152,10 +151,6 @@ export function configureDeployCommand(program: Command) {
           "--repository <repository>",
           "Docker repository path to use for build-only mode (defaults to trigger/<project>)"
         )
-        .option(
-          "--base-image-node <image>",
-          "Custom base image for Node.js runtime (e.g., my-registry/node:21-slim)"
-        )
         .option(
           "--containerfile-module <module>",
           "Path to a JavaScript/TypeScript module that exports a containerfile template"
@@ -442,7 +437,6 @@ async function _deployCommand(dir: string, options: DeployCommandOptions) {
       envVars: serverEnvVars.success ? serverEnvVars.data.variables : {},
       forcedExternals,
       plain: options.plain,
-      baseImageNode: options.baseImageNode,
       containerfileModule: options.containerfileModule,
       listener: {
         onBundleStart() {
@@ -1615,7 +1609,6 @@ async function buildOnlyDeploy(projectPath: string, dir: string, options: Deploy
     rewritePaths: true,
     envVars: {}, // No server env vars in build-only mode
     forcedExternals: alwaysExternal,
-    baseImageNode: options.baseImageNode,
     containerfileModule: options.containerfileModule,
     listener: {
       onBundleStart() {

packages/cli-v3/src/deploy/buildImage.ts

@@ -53,7 +53,6 @@ export interface BuildImageOptions {
   buildEnvVars?: Record<string, string | undefined>;
   indexEnvVars?: Record<string, string>; // Environment variables for indexing
   onLog?: (log: string) => void;
-  baseImageNode?: string; // Custom base image for Node.js runtime
 }
 
 export async function buildImage(options: BuildImageOptions): Promise<BuildImageResults> {
@@ -90,7 +89,6 @@ export async function buildImage(options: BuildImageOptions): Promise<BuildImage
     compressionLevel,
     forceCompression,
     onLog,
-    baseImageNode,
   } = options;
 
   if (isLocalBuild) {
@@ -122,7 +120,6 @@ export async function buildImage(options: BuildImageOptions): Promise<BuildImage
       compressionLevel,
       forceCompression,
       onLog,
-      baseImageNode,
     });
   }
 
@@ -156,7 +153,6 @@ export async function buildImage(options: BuildImageOptions): Promise<BuildImage
     forceCompression,
     indexEnvVars,
     onLog,
-    baseImageNode,
   });
 }
 
@@ -184,7 +180,6 @@ export interface DepotBuildImageOptions {
   forceCompression?: boolean;
   indexEnvVars?: Record<string, string>;
   onLog?: (log: string) => void;
-  baseImageNode?: string;
 }
 
 type BuildImageSuccess = {
@@ -362,7 +357,6 @@ interface SelfHostedBuildImageOptions {
   compressionLevel?: number;
   forceCompression?: boolean;
   onLog?: (log: string) => void;
-  baseImageNode?: string;
 }
 
 async function localBuildImage(options: SelfHostedBuildImageOptions): Promise<BuildImageResults> {
@@ -974,7 +968,6 @@ export type GenerateContainerfileOptions = {
   image: BuildManifest["image"];
   indexScript: string;
   entrypoint: string;
-  baseImageNode?: string;
   containerfileModule?: string;
 };
 
@@ -1002,12 +995,8 @@ export const parseGenerateOptions = (options: GenerateContainerfileOptions) => {
   const packages = Array.from(new Set(DEFAULT_PACKAGES.concat(options.image?.pkgs || []))).join(
     " "
   );
-  
-  // Use custom base image for Node.js runtimes if provided
-  let baseImage = BASE_IMAGE[options.runtime];
-  if (options.baseImageNode && (options.runtime === "node" || options.runtime === "node-22")) {
-    baseImage = options.baseImageNode;
-  }
+
+  const baseImage = BASE_IMAGE[options.runtime];
 
   return {
     baseImage,