mongodb-runner 6.8.5 → 6.10.0

package/README.md

@@ -70,6 +70,16 @@ try {
 }
 ```
 
+## Environment variables
+
+Any CLI option can also be set through a `MONGODB_RUNNER_`-prefixed environment
+variable, e.g. `MONGODB_RUNNER_DOWNLOAD_DIR` for `--downloadDir`. Explicitly
+passed options take precedence.
+
+`MONGODB_RUNNER_DOWNLOAD_DIR` is additionally honored when using `MongoCluster`
+programmatically, which is useful for caching server binaries in CI without
+having to change each call site.
+
 ## Config file
 
 You can specify a config file for the CLI using `--config`:
@@ -99,6 +109,13 @@ You can specify a config file for the CLI using `--config`:
 $ npx mongodb-runner start --config <path/to/config.json>
 ```
 
+## DSC clusters
+
+mongodb-runner can launch clusters that use DSC, backed by an SLS storage
+layer, managing the storage backend's docker compose project alongside the
+mongod processes. See
+[docs/disaggregated-storage.md](./docs/disaggregated-storage.md).
+
 ## License
 
 Apache 2.0

package/dist/.esm-wrapper.mjs

@@ -1,10 +1,19 @@
 import mod from "./index.js";
 
 export default mod;
+export const DockerComposeProject = mod.DockerComposeProject;
 export const MongoCluster = mod.MongoCluster;
 export const MongoServer = mod.MongoServer;
+export const SLS_CELL1 = mod.SLS_CELL1;
+export const SLS_CELL2 = mod.SLS_CELL2;
+export const SLS_CELL3 = mod.SLS_CELL3;
+export const SLS_HOSTNAME = mod.SLS_HOSTNAME;
+export const createSLSDisaggregatedStorageConfig = mod.createSLSDisaggregatedStorageConfig;
+export const createSLSDisaggregatedStorageOptions = mod.createSLSDisaggregatedStorageOptions;
+export const createSLSMultiCellEnvironment = mod.createSLSMultiCellEnvironment;
 export const exec = mod.exec;
 export const instances = mod.instances;
+export const parseSLSComposeServices = mod.parseSLSComposeServices;
 export const prune = mod.prune;
 export const start = mod.start;
 export const stop = mod.stop;

package/dist/cli.js

@@ -73,6 +73,10 @@ const mongodb_connection_string_url_1 = require("mongodb-connection-string-url")
         .option('version', {
         type: 'string',
         describe: 'MongoDB server version to use',
+    })
+        .option('downloadUrl', {
+        type: 'string',
+        describe: 'Direct URL to a MongoDB tarball to download (takes precedence over --version)',
     })
         .option('logDir', {
         type: 'string',
@@ -111,6 +115,15 @@ const mongodb_connection_string_url_1 = require("mongodb-connection-string-url")
         .option('oidc', {
         type: 'string',
         describe: 'Configure OIDC authentication on the server',
+    })
+        .option('slsCompose', {
+        type: 'string',
+        describe: 'Path to an SLS multi-cell docker-compose.yml; launches the SLS DSC project and configures mongod to use it (requires a DSC-capable mongod via --binDir or --downloadUrl)',
+        implies: 'slsImageTag',
+    })
+        .option('slsImageTag', {
+        type: 'string',
+        describe: 'SLS docker image tag to use with --slsCompose (e.g. the pinned_sls_commit from the server repo manifest)',
     })
         .option('debug', { type: 'boolean', describe: 'Enable debug output' })
         .option('verbose', { type: 'boolean', describe: 'Enable verbose output' })
@@ -126,10 +139,10 @@ const mongodb_connection_string_url_1 = require("mongodb-connection-string-url")
         args.push(...argv.args.map(String));
     }
     if (argv.debug || argv.verbose) {
-        debug_1.default.enable('mongodb-runner');
+        debug_1.default.enable('mongodb-runner,mongodb-downloader');
     }
     if (argv.verbose) {
-        debug_1.default.enable('mongodb-runner:*');
+        debug_1.default.enable('mongodb-runner*,mongodb-downloader*');
     }
     if (argv.oidc && process.platform !== 'linux') {
         console.warn('OIDC authentication is currently only supported on Linux platforms.');
@@ -138,7 +151,19 @@ const mongodb_connection_string_url_1 = require("mongodb-connection-string-url")
         console.warn('OIDC authentication is currently only supported on Enterprise server versions.');
     }
     async function start() {
-        const { cluster, id } = await utilities.start(argv, args);
+        const disaggregatedStorage = argv.slsCompose
+            ? await utilities.createSLSDisaggregatedStorageOptions({
+                composeFile: argv.slsCompose,
+                imageTag: argv.slsImageTag,
+            })
+            : undefined;
+        if (disaggregatedStorage && 'sls' in disaggregatedStorage) {
+            console.error('Allocated SLS service ports:');
+            for (const [serviceName, { addr }] of Object.entries(disaggregatedStorage.sls.services)) {
+                console.error(`  ${serviceName}: ${addr}`);
+            }
+        }
+        const { cluster, id } = await utilities.start({ ...argv, disaggregatedStorage }, args);
         const cs = new mongodb_connection_string_url_1.ConnectionString(cluster.connectionString);
         console.error(`Server started and running at ${cs.toString()}`);
         if (cluster.oidcIssuer) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,kDAA0B;AAC1B,2CAAwC;AACxC,4CAAoB;AACpB,gDAAwB;AACxB,kDAAgC;AAChC,mDAAqC;AACrC,iFAAiE;AAGjE,CAAC,KAAK;IACJ,MAAM,gBAAgB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,IAAA,eAAK,EAAC,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC5C,OAAO,CAAC,KAAK,CAAC;SACd,UAAU,CAAC,gBAAgB,CAAC;SAC5B,GAAG,CAAC,gBAAgB,CAAC;SACrB,MAAM,EAAE;SACR,MAAM,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CAAU;QACtD,OAAO,EAAE,YAAqB;QAC9B,QAAQ,EAAE,wBAAwB;KACnC,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,8CAA8C;KACzD,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,4CAA4C;KACvD,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,MAAM,CAAC,GAAG;YACR,OAAO,GAAG,CAAC;QACb,CAAC;QACD,QAAQ,EAAE,uCAAuC;KAClD,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,+BAA+B;KAC1C,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,+EAA+E;KAClF,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,wCAAwC;KACnD,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,6CAA6C;KACxD,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,YAAE,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,+BAA+B;KAC1C,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,uFAAuF;KAC1F,CAAC;SACD,MAAM,CAAC,WAAW,EAAE;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,wCAAwC;KACnD,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,iDAAiD;KAC5D,CAAC;SACD,MAAM,CAAC,IAAI,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,uCAAuC;KAClD,CAAC;SACD,MAAM,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,+BAA+B;KAC1C,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,6CAA6C;KACxD,CAAC;SACD,MAAM,CAAC,YAAY,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,0KAA0K;QAC5K,OAAO,EAAE,aAAa;KACvB,CAAC;SACD,MAAM,CAAC,aAAa,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,QAAQ,EACN,0GAA0G;KAC7G,CAAC;SACD,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;SACrE,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC;SACzE,OAAO,CAAC,OAAO,EAAE,0BAA0B,CAAC;SAC5C,OAAO,CAAC,MAAM,EAAE,yBAAyB,CAAC;SAC1C,OAAO,CAAC,OAAO,EAAE,kDAAkD,CAAC;SACpE,OAAO,CAAC,IAAI,EAAE,0CAA0C,CAAC;SACzD,OAAO,CACN,MAAM,EACN,gEAAgE,CACjE;SACA,aAAa,CAAC,CAAC,EAAE,gCAAgC,CAAC;SAClD,IAAI,EAAE,CAAC,IAAI,CAAC;IACf,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,eAAW,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,eAAW,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9C,OAAO,CAAC,IAAI,CACV,qEAAqE,CACtE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CACV,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,MAAM,oBAAoB,GAAG,IAAI,CAAC,UAAU;YAC1C,CAAC,CAAC,MAAM,SAAS,CAAC,oCAAoC,CAAC;gBACnD,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,QAAQ,EAAE,IAAI,CAAC,WAAY;aAC5B,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,oBAAoB,IAAI,KAAK,IAAI,oBAAoB,EAAE,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC9C,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAClD,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAClC,EAAE,CAAC;gBACF,OAAO,CAAC,KAAK,CAAC,KAAK,WAAW,KAAK,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,CAC3C,EAAE,GAAG,IAAI,EAAE,oBAAoB,EAAE,EACjC,IAAI,CACL,CAAC;QACF,MAAM,EAAE,GAAG,IAAI,gDAAgB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAG1D,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,EAAE,CAAC,iBAAiB,EAAsB,CAAC,GAAG,CAC5C,eAAe,EACf,cAAc,CACf,CAAC;YACF,OAAO,CAAC,KAAK,CACX,wCAAwC,OAAO,CAAC,UAAU,EAAE,CAC7D,CAAC;YACF,OAAO,CAAC,KAAK,CACX,4CAA4C,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CACX,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE,EAAE;YAC1B,CAAC,IAAI,CAAC,SAAS,KAAK,gBAAgB;gBAClC,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE;gBACjC,CAAC,CAAC,EAAE,CAAC,CACV,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3B,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,UAAU,EAAE;QACf,IAAI,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,gBAAgB,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAGD,KAAK,UAAU,OAAO;QACpB,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,UAAU,IAAI,CAAC,EAAE,gCAAgC,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE;QACpB,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/docker-compose.d.ts

@@ -0,0 +1,15 @@
+export interface DockerComposeProjectOptions {
+    env?: Record<string, string>;
+    projectName?: string;
+}
+export declare class DockerComposeProject {
+    private readonly composeFile;
+    private readonly projectName;
+    private readonly env?;
+    private constructor();
+    static start(composeFile: string, options?: DockerComposeProjectOptions): Promise<DockerComposeProject>;
+    close(): Promise<void>;
+    serialize(): unknown;
+    static deserialize(serialized: any): DockerComposeProject;
+}
+//# sourceMappingURL=docker-compose.d.ts.map

package/dist/docker-compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-compose.d.ts","sourceRoot":"","sources":["../src/docker-compose.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,2BAA2B;IAK1C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAM7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqCD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IAHvB,OAAO;WAMM,KAAK,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC;IAqB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,SAAS,IAAI,OAAO;IAQpB,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,oBAAoB;CAO1D"}

package/dist/docker-compose.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DockerComposeProject = void 0;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+const util_1 = require("./util");
+async function runDockerCompose(composeFile, projectName, env, args) {
+    const proc = (0, child_process_1.spawn)('docker', ['compose', '-f', composeFile, '-p', projectName, ...args], {
+        stdio: ['inherit', 'pipe', 'pipe'],
+        env: { ...process.env, ...env },
+    });
+    await (0, events_1.once)(proc, 'spawn');
+    (0, util_1.debug)('docker compose: spawned', { pid: proc.pid, args });
+    let stderr = '';
+    proc.stderr.setEncoding('utf8');
+    proc.stderr.on('data', (chunk) => {
+        stderr += chunk;
+        for (const line of chunk.split('\n')) {
+            if (line.trim())
+                (0, util_1.debug)('docker compose stderr:', line);
+        }
+    });
+    proc.stdout.setEncoding('utf8');
+    proc.stdout.on('data', (chunk) => {
+        for (const line of chunk.split('\n')) {
+            if (line.trim())
+                (0, util_1.debug)('docker compose stdout:', line);
+        }
+    });
+    const [code] = await (0, events_1.once)(proc, 'exit');
+    (0, util_1.debug)('docker compose: exited', { code });
+    return { code: code, stderr };
+}
+class DockerComposeProject {
+    constructor(composeFile, projectName, env) {
+        this.composeFile = composeFile;
+        this.projectName = projectName;
+        this.env = env;
+    }
+    static async start(composeFile, options = {}) {
+        const projectName = options.projectName ??
+            options.env?.COMPOSE_PROJECT_NAME ??
+            `mongodb-runner-${(0, util_1.uuid)()}`;
+        (0, util_1.debug)('starting docker compose project', { composeFile, projectName });
+        const { code, stderr } = await runDockerCompose(composeFile, projectName, options.env, ['up', '-d']);
+        if (code !== 0) {
+            throw new Error(`docker compose up failed with exit code ${String(code)}: ${stderr}`);
+        }
+        (0, util_1.debug)('docker compose project started');
+        return new DockerComposeProject(composeFile, projectName, options.env);
+    }
+    async close() {
+        (0, util_1.debug)('stopping docker compose project', {
+            composeFile: this.composeFile,
+            projectName: this.projectName,
+        });
+        const { code, stderr } = await runDockerCompose(this.composeFile, this.projectName, this.env, ['down', '--volumes']);
+        if (code !== 0) {
+            (0, util_1.debug)('docker compose down failed', { code: String(code), stderr });
+        }
+        (0, util_1.debug)('docker compose project stopped');
+    }
+    serialize() {
+        return {
+            composeFile: this.composeFile,
+            projectName: this.projectName,
+            env: this.env,
+        };
+    }
+    static deserialize(serialized) {
+        return new DockerComposeProject(serialized.composeFile, serialized.projectName, serialized.env);
+    }
+}
+exports.DockerComposeProject = DockerComposeProject;
+//# sourceMappingURL=docker-compose.js.map

package/dist/docker-compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-compose.js","sourceRoot":"","sources":["../src/docker-compose.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { MongoServer, type MongoServerEvents, MongoServerOptions, } from './mongoserver';
-export { MongoCluster, type MongoClusterEvents, MongoClusterOptions, MongoDBUserDoc, RSMemberOptions as MongoClusterRSMemberOptions, RSOptions as MongoClusterRSOptions, CommonOptions as MongoClusterCommonOptions, ShardedOptions as MongoClusterShardedOptions, } from './mongocluster';
+export { MongoCluster, type MongoClusterEvents, MongoClusterOptions, MongoDBUserDoc, RSMemberOptions as MongoClusterRSMemberOptions, RSOptions as MongoClusterRSOptions, CommonOptions as MongoClusterCommonOptions, ShardedOptions as MongoClusterShardedOptions, type ShardDescriptor, type DisaggregatedStorageOptions, } from './mongocluster';
+export { createSLSMultiCellEnvironment, createSLSDisaggregatedStorageConfig, createSLSDisaggregatedStorageOptions, type SLSDisaggregatedStorageConfigOptions, type SLSDisaggregatedStorageSetupOptions, parseSLSComposeServices, SLS_HOSTNAME, SLS_CELL1, SLS_CELL2, SLS_CELL3, type SLSCell, type SLSServiceInfo, type SLSMultiCellEnvironment, type SLSMultiCellEnvironmentOptions, } from './sls';
+export { DockerComposeProject, type DockerComposeProjectOptions, } from './docker-compose';
 export type { LogEntry } from './mongologreader';
 export type { ConnectionString } from 'mongodb-connection-string-url';
 export { prune, start, stop, exec, instances } from './runner-helpers';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EACtB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,cAAc,EACd,eAAe,IAAI,2BAA2B,EAC9C,SAAS,IAAI,qBAAqB,EAClC,aAAa,IAAI,yBAAyB,EAC1C,cAAc,IAAI,0BAA0B,GAC7C,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EACtB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,cAAc,EACd,eAAe,IAAI,2BAA2B,EAC9C,SAAS,IAAI,qBAAqB,EAClC,aAAa,IAAI,yBAAyB,EAC1C,cAAc,IAAI,0BAA0B,EAC5C,KAAK,eAAe,EACpB,KAAK,2BAA2B,GACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,oCAAoC,EACpC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,uBAAuB,EACvB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,GACpC,MAAM,OAAO,CAAC;AACf,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,10 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.instances = exports.exec = exports.start = exports.prune = exports.MongoCluster = exports.MongoServer = void 0;
+exports.instances = exports.exec = exports.start = exports.prune = exports.DockerComposeProject = exports.SLS_CELL3 = exports.SLS_CELL2 = exports.SLS_CELL1 = exports.SLS_HOSTNAME = exports.parseSLSComposeServices = exports.createSLSDisaggregatedStorageOptions = exports.createSLSDisaggregatedStorageConfig = exports.createSLSMultiCellEnvironment = exports.MongoCluster = exports.MongoServer = void 0;
 var mongoserver_1 = require("./mongoserver");
 Object.defineProperty(exports, "MongoServer", { enumerable: true, get: function () { return mongoserver_1.MongoServer; } });
 var mongocluster_1 = require("./mongocluster");
 Object.defineProperty(exports, "MongoCluster", { enumerable: true, get: function () { return mongocluster_1.MongoCluster; } });
+var sls_1 = require("./sls");
+Object.defineProperty(exports, "createSLSMultiCellEnvironment", { enumerable: true, get: function () { return sls_1.createSLSMultiCellEnvironment; } });
+Object.defineProperty(exports, "createSLSDisaggregatedStorageConfig", { enumerable: true, get: function () { return sls_1.createSLSDisaggregatedStorageConfig; } });
+Object.defineProperty(exports, "createSLSDisaggregatedStorageOptions", { enumerable: true, get: function () { return sls_1.createSLSDisaggregatedStorageOptions; } });
+Object.defineProperty(exports, "parseSLSComposeServices", { enumerable: true, get: function () { return sls_1.parseSLSComposeServices; } });
+Object.defineProperty(exports, "SLS_HOSTNAME", { enumerable: true, get: function () { return sls_1.SLS_HOSTNAME; } });
+Object.defineProperty(exports, "SLS_CELL1", { enumerable: true, get: function () { return sls_1.SLS_CELL1; } });
+Object.defineProperty(exports, "SLS_CELL2", { enumerable: true, get: function () { return sls_1.SLS_CELL2; } });
+Object.defineProperty(exports, "SLS_CELL3", { enumerable: true, get: function () { return sls_1.SLS_CELL3; } });
+var docker_compose_1 = require("./docker-compose");
+Object.defineProperty(exports, "DockerComposeProject", { enumerable: true, get: function () { return docker_compose_1.DockerComposeProject; } });
 var runner_helpers_1 = require("./runner-helpers");
 Object.defineProperty(exports, "prune", { enumerable: true, get: function () { return runner_helpers_1.prune; } });
 Object.defineProperty(exports, "start", { enumerable: true, get: function () { return runner_helpers_1.start; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAIuB;AAHrB,0GAAA,WAAW,OAAA;AAIb,+CASwB;AARtB,4GAAA,YAAY,OAAA;AAWd,mDAAuE;AAA9D,uGAAA,KAAK,OAAA;AAAE,uGAAA,KAAK,OAAA;AAAE,sGAAA,IAAI,OAAA;AAAE,sGAAA,IAAI,OAAA;AAAE,2GAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAIuB;AAHrB,0GAAA,WAAW,OAAA;AAIb,+CAWwB;AAVtB,4GAAA,YAAY,OAAA;AAWd,6BAee;AAdb,oHAAA,6BAA6B,OAAA;AAC7B,0HAAA,mCAAmC,OAAA;AACnC,2HAAA,oCAAoC,OAAA;AAGpC,8GAAA,uBAAuB,OAAA;AACvB,mGAAA,YAAY,OAAA;AACZ,gGAAA,SAAS,OAAA;AACT,gGAAA,SAAS,OAAA;AACT,gGAAA,SAAS,OAAA;AAMX,mDAG0B;AAFxB,sHAAA,oBAAoB,OAAA;AAKtB,mDAAuE;AAA9D,uGAAA,KAAK,OAAA;AAAE,uGAAA,KAAK,OAAA;AAAE,sGAAA,IAAI,OAAA;AAAE,sGAAA,IAAI,OAAA;AAAE,2GAAA,SAAS,OAAA"}

package/dist/mongocluster.d.ts

@@ -25,10 +25,12 @@ export interface CommonOptions {
     downloadOptions?: DownloadOptions;
     oidc?: string;
     version?: string;
+    downloadUrl?: string;
     users?: MongoDBUserDoc[];
     tlsAddClientKey?: boolean;
     requireApiVersion?: number;
     topology: 'standalone' | 'replset' | 'sharded';
+    disaggregatedStorage?: DisaggregatedStorageOptions;
 }
 export type RSOptions = {
     arbiters?: number;
@@ -39,6 +41,25 @@ export type ShardedOptions = {
     mongosArgs?: string[][];
     shards?: number | Partial<MongoClusterOptions>[];
 };
+export interface ShardMemberDescriptor {
+    host: string;
+    port: number;
+    priority: number;
+    arbiterOnly: boolean;
+}
+export interface ShardDescriptor {
+    index: number;
+    isConfigServer: boolean;
+    replSetName?: string;
+    members: ShardMemberDescriptor[];
+}
+export interface DisaggregatedStorageOptions {
+    composeFile: string;
+    env?: Record<string, string>;
+    config: string | Record<string, unknown> | ((shard: ShardDescriptor) => string | Record<string, unknown>);
+    waitForReady?: () => Promise<void>;
+    setupShard?: (shard: ShardDescriptor) => Promise<void>;
+}
 export type MongoClusterOptions = Pick<MongoServerOptions, 'logDir' | 'tmpDir' | 'args' | 'binDir' | 'docker' | 'internalClientOptions' | 'host' | 'detached'> & CommonOptions & RSOptions & ShardedOptions;
 export type MongoClusterEvents = {
     [k in keyof MongoServerEvents]: [serverUUID: string, ...MongoServerEvents[k]];
@@ -52,6 +73,7 @@ export declare class MongoCluster extends EventEmitter<MongoClusterEvents> {
     private servers;
     private shards;
     private oidcMockProviderProcess?;
+    private dockerComposeProject?;
     private defaultConnectionOptions;
     private users;
     private constructor();
@@ -65,7 +87,9 @@ export declare class MongoCluster extends EventEmitter<MongoClusterEvents> {
     get connectionStringUrl(): ConnectionString;
     get serverVersion(): string;
     get serverVariant(): 'enterprise' | 'community';
-    static start({ ...options }: MongoClusterOptions): Promise<MongoCluster>;
+    static start(options: MongoClusterOptions): Promise<MongoCluster>;
+    private static _start;
+    private static _startServers;
     private children;
     private allServers;
     assertAllServersHaveInsertedLocalMetadata(): Promise<void>;

package/dist/mongocluster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mongocluster.d.ts","sourceRoot":"","sources":["../src/mongocluster.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mongocluster.d.ts","sourceRoot":"","sources":["../src/mongocluster.ts"],"names":[],"mappings":"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"}

package/dist/mongocluster.js

@@ -10,6 +10,7 @@ const mongodb_downloader_1 = require("@mongodb-js/mongodb-downloader");
 const mongodb_1 = require("mongodb");
 const util_1 = require("./util");
 const oidc_1 = require("./oidc");
+const docker_compose_1 = require("./docker-compose");
 const events_1 = require("events");
 const assert_1 = __importDefault(require("assert"));
 const tls_helpers_1 = require("./tls-helpers");
@@ -65,6 +66,29 @@ function processRSMembers(options) {
         replSetName,
     };
 }
+function buildDisaggregatedArgs(ds, shard, baseArgs) {
+    const raw = typeof ds.config === 'function' ? ds.config(shard) : ds.config;
+    const value = typeof raw === 'string' ? raw : JSON.stringify(raw);
+    return [
+        ...baseArgs,
+        '--setParameter',
+        `disaggregatedStorageConfig=${value}`,
+        '--setParameter',
+        'disaggregatedStorageEnabled=true',
+    ];
+}
+function stripPortArg(args) {
+    return removePortArg(args).filter((arg) => arg !== '--port');
+}
+function getPortArg(args) {
+    if (!args)
+        return undefined;
+    const splitArgIndex = args.indexOf('--port');
+    if (splitArgIndex !== -1)
+        return +args[splitArgIndex + 1] || undefined;
+    const arg = args.find((a) => a.startsWith('--port='));
+    return arg ? +arg.split('=')[1] || undefined : undefined;
+}
 function processShardOptions(options) {
     const shards = typeof options.shards === 'number' || !options.shards
         ? (0, util_1.range)((options.shards ?? 3) + 1).map(() => ({}))
@@ -110,12 +134,13 @@ class MongoCluster extends events_1.EventEmitter {
             }
         });
     }
-    static downloadMongoDb(tmpdir, targetVersionSemverSpecifier, options) {
+    static downloadMongoDb(tmpdir, targetVersionSemverSpecifier, options, downloadUrl) {
         return (0, mongodb_downloader_1.downloadMongoDb)({
             directory: tmpdir,
             version: targetVersionSemverSpecifier,
             downloadOptions: options,
             useLockfile: true,
+            downloadUrl,
         });
     }
     serialize() {
@@ -125,13 +150,14 @@ class MongoCluster extends events_1.EventEmitter {
             servers: this.servers.map((srv) => srv.serialize()),
             shards: this.shards.map((shard) => shard.serialize()),
             oidcMockProviderProcess: this.oidcMockProviderProcess?.serialize(),
+            dockerComposeProject: this.dockerComposeProject?.serialize(),
             defaultConnectionOptions: (0, util_1.jsonClone)(this.defaultConnectionOptions ?? {}),
             users: (0, util_1.jsonClone)(this.users),
         };
     }
     isClosed() {
         for (const _ of this.children())
-            return true;
+            return false;
         return true;
     }
     static async deserialize(serialized) {
@@ -145,6 +171,9 @@ class MongoCluster extends events_1.EventEmitter {
         cluster.oidcMockProviderProcess = serialized.oidcMockProviderProcess
             ? oidc_1.OIDCMockProviderProcess.deserialize(serialized.oidcMockProviderProcess)
             : undefined;
+        cluster.dockerComposeProject = serialized.dockerComposeProject
+            ? docker_compose_1.DockerComposeProject.deserialize(serialized.dockerComposeProject)
+            : undefined;
         return cluster;
     }
     get hostport() {
@@ -165,14 +194,19 @@ class MongoCluster extends events_1.EventEmitter {
     get serverVariant() {
         return this.servers[0].serverVariant;
     }
-    static async start({ ...options }) {
+    static async start(options) {
+        return await MongoCluster._start(options, undefined);
+    }
+    static async _start({ ...options }, parentClusterContext) {
         options = { ...options, ...(await (0, tls_helpers_1.handleTLSClientKeyOptions)(options)) };
         const cluster = new MongoCluster();
         cluster.topology = options.topology;
         cluster.users = options.users ?? [];
         cluster.defaultConnectionOptions = { ...options.internalClientOptions };
         if (!options.binDir) {
-            options.binDir = await this.downloadMongoDb(options.downloadDir ?? options.tmpDir, options.version, options.downloadOptions);
+            options.binDir = await this.downloadMongoDb(options.downloadDir ??
+                process.env.MONGODB_RUNNER_DOWNLOAD_DIR ??
+                options.tmpDir, options.version, options.downloadOptions, options.downloadUrl);
         }
         if (options.oidc !== undefined) {
             cluster.oidcMockProviderProcess = await oidc_1.OIDCMockProviderProcess.start(options.oidc || '--port=0');
@@ -196,7 +230,62 @@ class MongoCluster extends events_1.EventEmitter {
                 'enableTestCommands=true',
             ];
         }
+        let disaggregatedStorage = parentClusterContext?.disaggregatedStorage;
+        if (!disaggregatedStorage && options.disaggregatedStorage) {
+            disaggregatedStorage = options.disaggregatedStorage;
+            delete options.disaggregatedStorage;
+            cluster.dockerComposeProject = await docker_compose_1.DockerComposeProject.start(disaggregatedStorage.composeFile, { env: disaggregatedStorage.env });
+        }
+        try {
+            if (disaggregatedStorage) {
+                if (cluster.dockerComposeProject) {
+                    await disaggregatedStorage.waitForReady?.();
+                }
+                if (options.secondaries === undefined)
+                    options.secondaries = 1;
+            }
+            return await this._startServers(cluster, options, disaggregatedStorage, parentClusterContext?.shardContext ?? {
+                index: 0,
+                isConfigServer: false,
+            });
+        }
+        catch (err) {
+            if (cluster.dockerComposeProject) {
+                try {
+                    await cluster.dockerComposeProject.close();
+                }
+                catch {
+                }
+            }
+            throw err;
+        }
+    }
+    static async _startServers(cluster, options, disaggregatedStorage, shardContext) {
         if (options.topology === 'standalone') {
+            if (disaggregatedStorage) {
+                let port = getPortArg(options.args);
+                if (!port) {
+                    port = await (0, util_1.allocatePort)();
+                    options.args = [
+                        ...stripPortArg(options.args ?? []),
+                        '--port',
+                        String(port),
+                    ];
+                }
+                const descriptor = {
+                    ...shardContext,
+                    members: [
+                        {
+                            host: options.host ?? '127.0.0.1',
+                            port,
+                            priority: 1,
+                            arbiterOnly: false,
+                        },
+                    ],
+                };
+                await disaggregatedStorage.setupShard?.(descriptor);
+                options.args = buildDisaggregatedArgs(disaggregatedStorage, descriptor, options.args ?? []);
+            }
             cluster.servers.push(await mongoserver_1.MongoServer.start({
                 ...options,
                 binary: 'mongod',
@@ -204,6 +293,35 @@ class MongoCluster extends events_1.EventEmitter {
         }
         else if (options.topology === 'replset') {
             const { rsMembers, replSetName } = processRSMembers(options);
+            if (disaggregatedStorage) {
+                const members = [];
+                for (const member of rsMembers) {
+                    let port = getPortArg(member.args);
+                    if (!port) {
+                        port = await (0, util_1.allocatePort)();
+                        member.args = [
+                            ...stripPortArg(member.args ?? []),
+                            '--port',
+                            String(port),
+                        ];
+                    }
+                    members.push({
+                        host: options.host ?? '127.0.0.1',
+                        port,
+                        priority: member.priority ?? 0,
+                        arbiterOnly: member.arbiterOnly ?? false,
+                    });
+                }
+                const descriptor = {
+                    ...shardContext,
+                    replSetName,
+                    members,
+                };
+                await disaggregatedStorage.setupShard?.(descriptor);
+                for (const member of rsMembers) {
+                    member.args = buildDisaggregatedArgs(disaggregatedStorage, descriptor, member.args ?? []);
+                }
+            }
             (0, util_1.debug)('Starting replica set nodes', {
                 replSetName,
                 secondaries: rsMembers.filter((m) => !m.arbiterOnly).length - 1,
@@ -225,24 +343,26 @@ class MongoCluster extends events_1.EventEmitter {
             cluster.servers.push(...nodes.map(([srv]) => srv));
             const primary = cluster.servers[primaryIndex];
             await primary.withClient(async (client) => {
-                (0, util_1.debug)('Running rs.initiate');
-                const rsConf = {
-                    _id: replSetName,
-                    configsvr: rsMembers.some((m) => m.args?.includes('--configsvr')),
-                    members: nodes.map(([srv, member], i) => {
-                        return {
-                            _id: i,
-                            host: srv.hostport,
-                            arbiterOnly: member.arbiterOnly ?? false,
-                            priority: member.priority ?? (i === primaryIndex ? 1 : 0),
-                            tags: member.tags || {},
-                        };
-                    }),
-                };
-                (0, util_1.debugVerbose)('replSetInitiate:', rsConf);
-                await client.db('admin').command({
-                    replSetInitiate: rsConf,
-                });
+                if (!disaggregatedStorage) {
+                    (0, util_1.debug)('Running rs.initiate');
+                    const rsConf = {
+                        _id: replSetName,
+                        configsvr: rsMembers.some((m) => m.args?.includes('--configsvr')),
+                        members: nodes.map(([srv, member], i) => {
+                            return {
+                                _id: i,
+                                host: srv.hostport,
+                                arbiterOnly: member.arbiterOnly ?? false,
+                                priority: member.priority ?? (i === primaryIndex ? 1 : 0),
+                                tags: member.tags || {},
+                            };
+                        }),
+                    };
+                    (0, util_1.debugVerbose)('replSetInitiate:', rsConf);
+                    await client.db('admin').command({
+                        replSetInitiate: rsConf,
+                    });
+                }
                 for (let i = 0; i < 60; i++) {
                     const status = await client.db('admin').command({
                         replSetGetStatus: 1,
@@ -260,16 +380,19 @@ class MongoCluster extends events_1.EventEmitter {
         else if (options.topology === 'sharded') {
             const { shards, mongosArgs } = processShardOptions(options);
             (0, util_1.debug)('starting config server and shard servers', shards);
-            const allShards = await (0, util_1.safePromiseAll)(shards.map(async (s) => {
-                const isConfig = s.args?.includes('--configsvr');
-                const cluster = await MongoCluster.start({
+            const allShards = await (0, util_1.safePromiseAll)(shards.map(async (s, i) => {
+                const isConfigServer = s.args?.includes('--configsvr') ?? false;
+                const shardCluster = await MongoCluster._start({
                     ...options,
                     ...s,
                     topology: 'replset',
                     requireApiVersion: undefined,
-                    users: isConfig ? undefined : options.users,
+                    users: isConfigServer ? undefined : options.users,
+                }, {
+                    disaggregatedStorage,
+                    shardContext: { index: i, isConfigServer },
                 });
-                return [cluster, isConfig];
+                return [shardCluster, isConfigServer];
             }));
             const configsvr = allShards.find(([, isConfig]) => isConfig)[0];
             const shardsvrs = allShards
@@ -370,6 +493,7 @@ class MongoCluster extends events_1.EventEmitter {
     }
     async close() {
         await (0, util_1.safePromiseAll)([...this.children(), this.oidcMockProviderProcess].map((closable) => closable?.close()));
+        await this.dockerComposeProject?.close();
         this.servers = [];
         this.shards = [];
     }