Summary by CodeRabbit

• New Features
  • More consistent option handling across Azure Event Hubs, Service Bus, Couchbase, etcd, Firestore, and Docker MCP Gateway modules, leading to clearer errors and smoother container startup.
• Bug Fixes
  • Corrected Couchbase admin password validation message to require “at least 6 characters,” improving guidance during setup.
• Refactor
  • Reordered initialization to apply user options earlier in the startup sequence across multiple modules, improving reliability and surfacing misconfigurations sooner without changing external APIs.

Walkthrough

Refactors multiple module Run functions to apply options/settings before constructing default module options, then append user customizations and invoke Run. Adjusts control flow in Azure Event Hubs/Service Bus, Couchbase, Docker MCP Gateway, etcd, and GCloud Firestore without altering public APIs.

Changes

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Caller
  participant RunFn as Module.Run
  participant Opts as Option(s)
  participant Settings as Settings/Config
  participant ModuleOpts as moduleOpts
  participant Runtime as testcontainers.Run

  Caller->>RunFn: Invoke Run(ctx, ..., opts...)
  RunFn->>Opts: Apply each Option (mutate default settings)
  alt Option error
    Opts-->>RunFn: error
    RunFn-->>Caller: return error
  else Options ok
    Opts-->>Settings: Populate settings
    RunFn->>ModuleOpts: Build defaults (ports, wait, CMD)
    RunFn->>ModuleOpts: Append user opts
    RunFn->>Runtime: Run(ctx, image, ModuleOpts...)
    Runtime-->>RunFn: Container / error
    RunFn-->>Caller: Return result
  end

sequenceDiagram
  autonumber
  actor Caller
  participant RunETCD as etcd.Run
  participant Opts as ContainerCustomizer(s)
  participant Cluster as configureCluster
  participant ModuleOpts as moduleOpts
  participant Runtime as testcontainers.Run

  Caller->>RunETCD: Run(ctx, nodes, opts...)
  RunETCD->>Opts: Apply to settings
  alt Option error
    RunETCD-->>Caller: error
  else
    RunETCD->>Cluster: Prepare network + per-node opts
    Cluster-->>RunETCD: cluster options
    RunETCD->>ModuleOpts: Build defaults + hooks
    RunETCD->>ModuleOpts: Append cluster opts + user opts
    RunETCD->>Runtime: Run(...)
    Runtime-->>RunETCD: Container(s)
    RunETCD-->>Caller: Return
  end

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• chore(azurite): use Run function #3318: Refactors Azure Event Hubs and Service Bus modules to an option-first Run flow, closely matching the Azure changes in this PR.
• chore(etcd)!: use Run function #3409: Reworks etcd to consolidate option handling and Run invocation, overlapping with this PR’s etcd cluster preparation changes.
• chore(gcloud): use Run function #3411: Adjusts gcloud modules to extract settings first and build moduleOpts afterward, directly related to the Firestore changes here.

Suggested reviewers

• stevenh

Poem

I tweaked my hops and ordered my options first,
Then built my nests of ports and waits well-versed.
From clouds to hubs, I line them in a row—
A tidy warren where containers grow.
Thump-thump! says the bunny, CI lights aglow. 🐇✨

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}