38 lines
1.5 KiB
TypeScript
38 lines
1.5 KiB
TypeScript
/**
|
|
* Pure helpers for how `docker compose` is told which daemon to talk to.
|
|
*
|
|
* The daemon MUST be passed via the `docker -H` CLI flag, NOT via DOCKER_HOST in the
|
|
* spawn env: shell env leaks into services that pass through (`- DOCKER_HOST`) or
|
|
* interpolate (`${DOCKER_HOST}`) that variable - e.g. a socket-proxy sidecar -
|
|
* overriding the value the stack set for itself (#1393). `-H` connects compose to the
|
|
* right daemon without polluting the compose interpolation env. Kept dependency-free
|
|
* so it unit-tests without spinning up the stack machinery.
|
|
*/
|
|
|
|
/**
|
|
* Resolves the daemon endpoint for a compose invocation: the per-environment
|
|
* dockerHost if given, else Dockhand's own DOCKER_HOST (socket-proxy setups), else
|
|
* undefined (plain local socket - compose uses the default). `ownDockerHost` is
|
|
* `process.env.DOCKER_HOST` (passed in so the resolver stays pure/testable).
|
|
*/
|
|
export function resolveComposeDockerHost(
|
|
dockerHost: string | undefined | null,
|
|
ownDockerHost: string | undefined | null
|
|
): string | undefined {
|
|
return dockerHost || ownDockerHost || undefined;
|
|
}
|
|
|
|
/**
|
|
* Builds the argv for `docker compose`, putting the daemon on the GLOBAL `-H` flag
|
|
* (before `compose`) so it never enters the shell env. Returns the base args; callers
|
|
* append the compose subcommand + flags.
|
|
*/
|
|
export function buildComposeBaseArgs(
|
|
stackName: string,
|
|
composeDockerHost: string | undefined
|
|
): string[] {
|
|
return composeDockerHost
|
|
? ['docker', '-H', composeDockerHost, 'compose', '-p', stackName]
|
|
: ['docker', 'compose', '-p', stackName];
|
|
}
|