Function getDockerPublishedPortOwners

packages/setupWizard/src/index.ts:212–247

()

// Best-effort: maps a host port to the running Docker container(s) publishing it, so
// a conflict can name the offender. Returns an empty map if Docker isn't available.
async function getDockerPublishedPortOwners(): Promise<Map<number, string[]>> {
    return new Promise<Map<number, string[]>>((resolve) => {
        const child = spawn('docker', ['ps', '--format', '{{.Names}}\t{{.Ports}}'], {
            stdio: ['ignore', 'pipe', 'ignore'],
        });
        let out = '';
        child.stdout?.on('data', (chunk: Buffer) => {
            out += chunk.toString();
        });
        child.on('exit', (code) => {
            const map = new Map<number, string[]>();
            if (code !== 0) {
                resolve(map);
                return;
            }
            for (const line of out.split('\n')) {
                const [name, portsStr] = line.split('\t');
                if (!name || !portsStr) {
                    continue;
                }
                // e.g. "0.0.0.0:5432->5432/tcp, :::5432->5432/tcp" — the number before
                // each "->" is the published host port.
                for (const m of portsStr.matchAll(/(\d+)->/g)) {
                    const port = Number(m[1]);
                    const list = map.get(port) ?? [];
                    if (!list.includes(name)) {
                        list.push(name);
                    }
                    map.set(port, list);
                }
            }
            resolve(map);
        });
        child.on('error', () => resolve(new Map<number, string[]>()));
    });
}

// Stops the given containers (by name). Returns true only if all stopped cleanly.
async function stopDockerContainers(names: string[]): Promise<boolean> {