@marinoscar/platform-cli 0.1.0-next.13 → 0.1.0-next.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/dist/deploy/index.d.ts +1 -1
  3. package/dist/deploy/index.d.ts.map +1 -1
  4. package/dist/engine/commands/deploy.d.ts +7 -0
  5. package/dist/engine/commands/deploy.d.ts.map +1 -1
  6. package/dist/engine/commands/deploy.js +7 -2
  7. package/dist/engine/commands/deploy.js.map +1 -1
  8. package/dist/engine/deploy/checks/compose.d.ts +10 -1
  9. package/dist/engine/deploy/checks/compose.d.ts.map +1 -1
  10. package/dist/engine/deploy/checks/compose.js +4 -4
  11. package/dist/engine/deploy/checks/compose.js.map +1 -1
  12. package/dist/engine/deploy/checks/index.d.ts +1 -0
  13. package/dist/engine/deploy/checks/index.d.ts.map +1 -1
  14. package/dist/engine/deploy/checks/index.js +4 -0
  15. package/dist/engine/deploy/checks/index.js.map +1 -1
  16. package/dist/engine/deploy/checks/stack-ports.d.ts +4 -0
  17. package/dist/engine/deploy/checks/stack-ports.d.ts.map +1 -0
  18. package/dist/engine/deploy/checks/stack-ports.js +261 -0
  19. package/dist/engine/deploy/checks/stack-ports.js.map +1 -0
  20. package/dist/engine/deploy/checks/types.d.ts +16 -0
  21. package/dist/engine/deploy/checks/types.d.ts.map +1 -1
  22. package/dist/engine/deploy/checks/types.js.map +1 -1
  23. package/dist/engine/deploy/compose-command.d.ts +16 -0
  24. package/dist/engine/deploy/compose-command.d.ts.map +1 -0
  25. package/dist/engine/deploy/compose-command.js +40 -0
  26. package/dist/engine/deploy/compose-command.js.map +1 -0
  27. package/dist/engine/deploy/compose-containers.d.ts +30 -1
  28. package/dist/engine/deploy/compose-containers.d.ts.map +1 -1
  29. package/dist/engine/deploy/compose-containers.js +79 -13
  30. package/dist/engine/deploy/compose-containers.js.map +1 -1
  31. package/dist/engine/deploy/compose-port-variables.d.ts +58 -0
  32. package/dist/engine/deploy/compose-port-variables.d.ts.map +1 -0
  33. package/dist/engine/deploy/compose-port-variables.js +184 -0
  34. package/dist/engine/deploy/compose-port-variables.js.map +1 -0
  35. package/dist/engine/deploy/compose-ports.d.ts +98 -0
  36. package/dist/engine/deploy/compose-ports.d.ts.map +1 -0
  37. package/dist/engine/deploy/compose-ports.js +204 -0
  38. package/dist/engine/deploy/compose-ports.js.map +1 -0
  39. package/dist/engine/deploy/compose-project.d.ts +1 -1
  40. package/dist/engine/deploy/compose-project.d.ts.map +1 -1
  41. package/dist/engine/deploy/compose-project.js.map +1 -1
  42. package/dist/engine/deploy/free-ports.d.ts +145 -0
  43. package/dist/engine/deploy/free-ports.d.ts.map +1 -0
  44. package/dist/engine/deploy/free-ports.js +235 -0
  45. package/dist/engine/deploy/free-ports.js.map +1 -0
  46. package/dist/engine/deploy/install.d.ts +16 -10
  47. package/dist/engine/deploy/install.d.ts.map +1 -1
  48. package/dist/engine/deploy/install.js +136 -26
  49. package/dist/engine/deploy/install.js.map +1 -1
  50. package/dist/engine/deploy/stack-ports-gate.d.ts +19 -0
  51. package/dist/engine/deploy/stack-ports-gate.d.ts.map +1 -0
  52. package/dist/engine/deploy/stack-ports-gate.js +54 -0
  53. package/dist/engine/deploy/stack-ports-gate.js.map +1 -0
  54. package/dist/engine/deploy/steps/registry.d.ts +2 -2
  55. package/dist/engine/deploy/steps/registry.d.ts.map +1 -1
  56. package/dist/engine/deploy/steps/registry.js +2 -0
  57. package/dist/engine/deploy/steps/registry.js.map +1 -1
  58. package/dist/engine/deploy/testing/fake-containers.d.ts +13 -2
  59. package/dist/engine/deploy/testing/fake-containers.d.ts.map +1 -1
  60. package/dist/engine/deploy/testing/fake-containers.js +9 -2
  61. package/dist/engine/deploy/testing/fake-containers.js.map +1 -1
  62. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -1
  63. package/dist/engine/deploy/testing/fake-vps.js +6 -0
  64. package/dist/engine/deploy/testing/fake-vps.js.map +1 -1
  65. package/dist/engine/deploy/update.d.ts +2 -0
  66. package/dist/engine/deploy/update.d.ts.map +1 -1
  67. package/dist/engine/deploy/update.js +79 -1
  68. package/dist/engine/deploy/update.js.map +1 -1
  69. package/dist/engine/index.d.ts +1 -1
  70. package/dist/engine/index.d.ts.map +1 -1
  71. package/dist/engine/index.js.map +1 -1
  72. package/dist/engine/tui/screens/deploy/doctor.js +1 -0
  73. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -1
  74. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -1
  75. package/dist/engine/tui/screens/deploy/install.js +4 -0
  76. package/dist/engine/tui/screens/deploy/install.js.map +1 -1
  77. package/package.json +3 -3
@@ -15,19 +15,28 @@ const COMPOSE_WORKING_DIR_LABEL = 'com.docker.compose.project.working_dir';
15
15
  /** Short by design: a wedged Docker socket must cost seconds, not the command. */
16
16
  const DOCKER_QUERY_TIMEOUT_MS = 10_000;
17
17
  /**
18
- * One line per container: name, running state, published host ports, compose
18
+ * One line per container: name, running state, host port bindings, compose
19
19
  * project, then compose working directory.
20
20
  *
21
+ * The bindings are `{{json .HostConfig.PortBindings}}`, one compact JSON object
22
+ * (`{"4003/tcp":[{"HostIp":"127.0.0.1","HostPort":"14003"}]}`, `null` for none).
23
+ * `json` is the template function the Docker CLI ships, so the field NAMES are
24
+ * the API's JSON ones whichever way the CLI renders (typed, or the raw-JSON
25
+ * fallback it takes when a typed field is missing): a bare `.HostIp` would
26
+ * fail on a CLI whose typed struct calls it `HostIP`, and a failed inspect is a
27
+ * skipped check. The JSON holds no `|` and no newline. A wildcard publish has an
28
+ * empty `HostIp`.
29
+ *
21
30
  * `{{if .Config.Labels}}` guards a container created without any labels, whose
22
31
  * `Labels` is null rather than an empty map (`index` on nil renders
23
32
  * `<no value>` into the line otherwise); the separators sit outside the guards
24
33
  * so every line has all five fields. `PortBindings` is the CONFIGURED publish,
25
- * present on a stopped or merely created container too, and a nil map ranges
26
- * over nothing. The working directory comes last so a path containing the
27
- * separator survives; none of the fields before it can contain one.
34
+ * present on a stopped or merely created container too. The working directory
35
+ * comes last so a path containing the separator survives; none of the fields
36
+ * before it can contain one.
28
37
  */
29
38
  const INSPECT_FORMAT = '{{.Name}}|{{.State.Running}}|' +
30
- '{{range $port, $bindings := .HostConfig.PortBindings}}{{range $bindings}}{{.HostPort}},{{end}}{{end}}|' +
39
+ '{{json .HostConfig.PortBindings}}|' +
31
40
  `{{if .Config.Labels}}{{index .Config.Labels "${COMPOSE_PROJECT_LABEL}"}}{{end}}|` +
32
41
  `{{if .Config.Labels}}{{index .Config.Labels "${COMPOSE_WORKING_DIR_LABEL}"}}{{end}}`;
33
42
  /**
@@ -56,21 +65,76 @@ export function isPathUnder(path, root) {
56
65
  export function freshComposeProject(deployRoot) {
57
66
  return basename(deployRoot);
58
67
  }
68
+ /** Whether two host addresses can be bound at once: a wildcard (`''`, `0.0.0.0`, `::`) overlaps every address. */
69
+ export function hostIpsOverlap(left, right) {
70
+ const wildcard = (ip) => ip === '' || ip === '0.0.0.0' || ip === '::' || ip === '[::]';
71
+ return wildcard(left) || wildcard(right) || left === right;
72
+ }
73
+ /** Whether `port` is `entry` (`3535`) or inside it (`8000-8010`). */
74
+ function entryCovers(entry, port) {
75
+ const [first = '', last = first] = entry.split('-');
76
+ const low = Number(first);
77
+ const high = Number(last);
78
+ return Number.isInteger(low) && Number.isInteger(high) && low <= port && port <= high;
79
+ }
59
80
  /**
60
81
  * Whether `container` is configured to publish host port `port`. An empty
61
82
  * `HostPort` (Docker picks one) is no claim; a range claims every port in it.
62
83
  *
84
+ * Without `match` any address and protocol counts, which is what the bind-port
85
+ * checks want (a promise of port 3535 on ANY address is a promise of 3535). With
86
+ * `match.hostIp` only a binding whose address can be bound at the same time
87
+ * counts (`127.0.0.1` against `0.0.0.0` overlaps, against `127.0.0.2` does not);
88
+ * with `match.protocol` only that protocol counts (a binding that recorded none
89
+ * counts for every protocol).
90
+ *
63
91
  * @param container - The container.
64
92
  * @param port - The host port.
93
+ * @param match - Narrow the claim to an address and/or protocol.
65
94
  * @returns true when the container publishes it.
66
95
  */
67
- export function publishesPort(container, port) {
68
- return container.hostPorts.some((entry) => {
69
- const [first = '', last = first] = entry.split('-');
70
- const low = Number(first);
71
- const high = Number(last);
72
- return Number.isInteger(low) && Number.isInteger(high) && low <= port && port <= high;
73
- });
96
+ export function publishesPort(container, port, match) {
97
+ if (match === undefined || container.bindings === undefined) {
98
+ return container.hostPorts.some((entry) => entryCovers(entry, port));
99
+ }
100
+ return container.bindings.some((binding) => entryCovers(binding.hostPort, port) &&
101
+ (match.hostIp === undefined || hostIpsOverlap(binding.hostIp, match.hostIp)) &&
102
+ (match.protocol === undefined || binding.protocol === '' || binding.protocol === match.protocol));
103
+ }
104
+ /**
105
+ * Reads the third field of an inspect line: the JSON of `PortBindings`, keyed
106
+ * by `<containerPort>/<protocol>`. An empty `HostPort` is Docker picking one: no
107
+ * claim. Anything unreadable claims nothing (an unreadable line is not a reason
108
+ * to fail an update).
109
+ */
110
+ function parseBindings(field) {
111
+ const text = field.trim();
112
+ if (text === '' || text === 'null')
113
+ return [];
114
+ let parsed;
115
+ try {
116
+ parsed = JSON.parse(text);
117
+ }
118
+ catch {
119
+ return [];
120
+ }
121
+ if (typeof parsed !== 'object' || parsed === null)
122
+ return [];
123
+ const bindings = [];
124
+ for (const [containerPort, list] of Object.entries(parsed)) {
125
+ if (!Array.isArray(list))
126
+ continue;
127
+ const slash = containerPort.indexOf('/');
128
+ const protocol = slash === -1 ? '' : containerPort.slice(slash + 1).trim().toLowerCase();
129
+ for (const entry of list) {
130
+ const binding = entry;
131
+ const hostPort = typeof binding?.HostPort === 'string' ? binding.HostPort.trim() : '';
132
+ if (hostPort === '')
133
+ continue;
134
+ bindings.push({ hostIp: typeof binding?.HostIp === 'string' ? binding.HostIp.trim() : '', hostPort, protocol });
135
+ }
136
+ }
137
+ return bindings;
74
138
  }
75
139
  /**
76
140
  * Every container Docker knows, in any state, with its compose labels and the
@@ -108,10 +172,12 @@ export async function listComposeContainers(run) {
108
172
  if (fields.length < 4)
109
173
  continue;
110
174
  const [name = '', running = '', ports = '', project = ''] = fields;
175
+ const bindings = parseBindings(ports);
111
176
  containers.push({
112
177
  name: name.replace(/^\//, '').trim(),
113
178
  running: running.trim() === 'true',
114
- hostPorts: ports.split(',').map((port) => port.trim()).filter((port) => port !== ''),
179
+ hostPorts: bindings.map((binding) => binding.hostPort),
180
+ bindings,
115
181
  project: project.trim(),
116
182
  workingDir: rest.trim(),
117
183
  });
@@ -1 +1 @@
1
- {"version":3,"file":"compose-containers.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-containers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compose-containers.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-containers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import { type PublishedPort } from './compose-ports.js';
2
+ /**
3
+ * The environment variable that sets the host port compose reported, or
4
+ * `undefined` when the port is a literal in the files (or cannot be traced).
5
+ *
6
+ * @param options - The port, the compose files' text in the order compose
7
+ * merges them, and the environment compose interpolates with (the
8
+ * deployment's `.env`, then the process environment).
9
+ * @returns the variable name, such as `GREPTIME_BIND_PG_PORT`.
10
+ * @stability experimental
11
+ */
12
+ export declare function portVariableFor(options: {
13
+ port: PublishedPort;
14
+ /** The text of each compose file, in merge order. */
15
+ files: readonly string[];
16
+ env: ReadonlyMap<string, string>;
17
+ }): string | undefined;
18
+ /**
19
+ * One environment variable that sets a published host port, with every place
20
+ * the stack publishes it.
21
+ *
22
+ * @stability experimental
23
+ */
24
+ export interface PortVariable {
25
+ /** The variable name, such as `GREPTIME_BIND_PG_PORT`. */
26
+ variable: string;
27
+ /** Each short-syntax entry that publishes the variable's port, in file order. */
28
+ claims: Array<{
29
+ service: string;
30
+ hostIp: string;
31
+ protocol: string;
32
+ }>;
33
+ /** The compose file's own default (`${VAR:-14003}`), when it names one. */
34
+ defaultPort: number | undefined;
35
+ }
36
+ /**
37
+ * Every environment variable that sets ONE published host port, derived from
38
+ * the compose files the run uses (the same raw scan as `portVariableFor`, in the
39
+ * other direction: from the files to the variables, with no compose render
40
+ * needed, so it works before the `.env` is complete).
41
+ *
42
+ * Only a published side that is exactly one variable counts. A literal port, a
43
+ * range, or a token that mixes text and a variable (`${A}0`) has no single
44
+ * variable an installer could pick a value for, and is left to the
45
+ * `stack-ports-free` check. A variable that publishes the same port twice (TCP
46
+ * and UDP) is one entry with two claims.
47
+ *
48
+ * @param options - The compose files' text in merge order, and the environment
49
+ * used to interpolate the host address (`${BIND_ADDRESS:-127.0.0.1}`).
50
+ * @returns the variables, by the order in which the files first list their services.
51
+ * @stability experimental
52
+ */
53
+ export declare function publishedPortVariables(options: {
54
+ /** The text of each compose file, in merge order. */
55
+ files: readonly string[];
56
+ env: ReadonlyMap<string, string>;
57
+ }): PortVariable[];
58
+ //# sourceMappingURL=compose-port-variables.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-port-variables.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-port-variables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAkJvE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAerB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,qDAAqD;IACrD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,YAAY,EAAE,CAuBjB"}
@@ -0,0 +1,184 @@
1
+ import { splitPortSpec } from './compose-ports.js';
2
+ /** The `${NAME}` / `${NAME:-default}` / `$NAME` forms compose interpolates. */
3
+ const INTERPOLATION = /\$\$|\$\{([A-Za-z_][A-Za-z0-9_]*)(?:(:?)([-?+])([^}]*))?\}|\$([A-Za-z_][A-Za-z0-9_]*)/g;
4
+ /**
5
+ * Compose's interpolation of one token against an environment. `${V:-d}` takes
6
+ * `d` when V is unset OR empty, `${V-d}` only when unset, `${V:?m}` and
7
+ * `${V?m}` keep the value (the failure is compose's to report), `${V:+a}`
8
+ * yields `a` when V is set and non-empty.
9
+ */
10
+ function interpolate(token, env) {
11
+ return token.replace(INTERPOLATION, (match, braced, colon, operator, argument, bare) => {
12
+ if (match === '$$')
13
+ return '$';
14
+ const name = braced ?? bare ?? '';
15
+ const value = env.get(name);
16
+ const unset = value === undefined || (colon === ':' && value === '');
17
+ if (operator === '-')
18
+ return unset ? (argument ?? '') : (value ?? '');
19
+ if (operator === '+')
20
+ return unset ? '' : (argument ?? '');
21
+ return value ?? '';
22
+ });
23
+ }
24
+ /** The first variable a token reads, if any. */
25
+ function variableOf(token) {
26
+ for (const match of token.matchAll(INTERPOLATION)) {
27
+ const name = match[1] ?? match[5];
28
+ if (name !== undefined)
29
+ return name;
30
+ }
31
+ return undefined;
32
+ }
33
+ /** The leading whitespace width of a line. */
34
+ function indentOf(line) {
35
+ return line.length - line.trimStart().length;
36
+ }
37
+ /** A list item's value: the quoted string, else the text up to a trailing comment. */
38
+ function itemValue(line) {
39
+ const body = line.trimStart();
40
+ if (!body.startsWith('-'))
41
+ return undefined;
42
+ const rest = body.slice(1).trim();
43
+ const quoted = /^(["'])(.*?)\1/.exec(rest);
44
+ if (quoted !== null)
45
+ return quoted[2] ?? '';
46
+ return rest.replace(/\s+#.*$/, '').trim();
47
+ }
48
+ /**
49
+ * The raw `ports:` entries of every service after applying every file in order:
50
+ * `ports: !override` / `!reset` drops what the earlier files listed (as compose
51
+ * does), a plain `ports:` adds to it. Services appear in the order they are
52
+ * first seen with a `ports:` key.
53
+ */
54
+ function rawPortsByService(texts) {
55
+ const byService = new Map();
56
+ for (const text of texts) {
57
+ let inServices = false;
58
+ let serviceIndent = -1;
59
+ let current;
60
+ let entries; // the list being filled while inside a `ports:` list
61
+ let portsIndent = -1; // >= 0 while inside a service's `ports:` list
62
+ for (const line of text.split(/\r?\n/)) {
63
+ const trimmed = line.trim();
64
+ if (trimmed === '' || trimmed.startsWith('#'))
65
+ continue;
66
+ const indent = indentOf(line);
67
+ if (indent === 0) {
68
+ inServices = /^services:\s*(#.*)?$/.test(trimmed);
69
+ current = undefined;
70
+ portsIndent = -1;
71
+ continue;
72
+ }
73
+ if (!inServices)
74
+ continue;
75
+ // Leaving a `ports:` list: the first line that is not deeper than its key
76
+ // (an item may sit at the key's own indent, which YAML allows).
77
+ if (portsIndent >= 0 && (indent < portsIndent || (indent === portsIndent && !trimmed.startsWith('-')))) {
78
+ portsIndent = -1;
79
+ }
80
+ if (portsIndent >= 0) {
81
+ const value = itemValue(line);
82
+ const split = value === undefined ? undefined : splitPortSpec(value);
83
+ if (split !== undefined)
84
+ entries?.push(split);
85
+ continue;
86
+ }
87
+ // The first key under `services:` fixes the indent of the service names.
88
+ if (serviceIndent === -1)
89
+ serviceIndent = indent;
90
+ if (indent === serviceIndent) {
91
+ current = /^([A-Za-z0-9_.-]+):/.exec(trimmed)?.[1];
92
+ continue;
93
+ }
94
+ if (current === undefined)
95
+ continue;
96
+ const ports = /^ports:\s*(!override|!reset)?\s*(\[\s*\])?\s*(#.*)?$/.exec(trimmed);
97
+ if (ports === null)
98
+ continue;
99
+ if (ports[1] !== undefined || !byService.has(current))
100
+ byService.set(current, []);
101
+ entries = byService.get(current);
102
+ if (ports[2] === undefined)
103
+ portsIndent = indent;
104
+ }
105
+ }
106
+ return byService;
107
+ }
108
+ /** The raw `ports:` entries of one service after applying every file in order. */
109
+ function rawPortsOf(service, texts) {
110
+ return rawPortsByService(texts).get(service) ?? [];
111
+ }
112
+ /** Whether an interpolated published token (`14003`, `8000-8010`) covers `port`. */
113
+ function covers(published, port) {
114
+ const [first = '', last = first] = published.trim().split('-');
115
+ const low = Number(first);
116
+ const high = Number(last);
117
+ return Number.isInteger(low) && Number.isInteger(high) && low <= port && port <= high;
118
+ }
119
+ /**
120
+ * The environment variable that sets the host port compose reported, or
121
+ * `undefined` when the port is a literal in the files (or cannot be traced).
122
+ *
123
+ * @param options - The port, the compose files' text in the order compose
124
+ * merges them, and the environment compose interpolates with (the
125
+ * deployment's `.env`, then the process environment).
126
+ * @returns the variable name, such as `GREPTIME_BIND_PG_PORT`.
127
+ * @stability experimental
128
+ */
129
+ export function portVariableFor(options) {
130
+ const { port, files, env } = options;
131
+ const wildcard = (ip) => ip === '' || ip === '0.0.0.0' || ip === '::';
132
+ const matching = rawPortsOf(port.service, files).filter((entry) => {
133
+ const hostIp = interpolate(entry.hostIp, env).replace(/^\[|\]$/g, '');
134
+ return (covers(interpolate(entry.published, env), port.port) &&
135
+ entry.protocol === port.protocol &&
136
+ (hostIp === port.hostIp || (wildcard(hostIp) && wildcard(port.hostIp))));
137
+ });
138
+ // The last file wins, so the last matching entry names the variable.
139
+ const last = matching[matching.length - 1];
140
+ return last === undefined ? undefined : variableOf(last.published);
141
+ }
142
+ // A published token that is exactly one variable: ${NAME}, ${NAME:-14003}, ${NAME-14003}, ${NAME:?message} or $NAME.
143
+ const WHOLE_VARIABLE = /^(?:\$\{([A-Za-z_][A-Za-z0-9_]*)(?:(:?)([-?])([^}]*))?\}|\$([A-Za-z_][A-Za-z0-9_]*))$/;
144
+ /**
145
+ * Every environment variable that sets ONE published host port, derived from
146
+ * the compose files the run uses (the same raw scan as `portVariableFor`, in the
147
+ * other direction: from the files to the variables, with no compose render
148
+ * needed, so it works before the `.env` is complete).
149
+ *
150
+ * Only a published side that is exactly one variable counts. A literal port, a
151
+ * range, or a token that mixes text and a variable (`${A}0`) has no single
152
+ * variable an installer could pick a value for, and is left to the
153
+ * `stack-ports-free` check. A variable that publishes the same port twice (TCP
154
+ * and UDP) is one entry with two claims.
155
+ *
156
+ * @param options - The compose files' text in merge order, and the environment
157
+ * used to interpolate the host address (`${BIND_ADDRESS:-127.0.0.1}`).
158
+ * @returns the variables, by the order in which the files first list their services.
159
+ * @stability experimental
160
+ */
161
+ export function publishedPortVariables(options) {
162
+ const found = new Map();
163
+ for (const [service, entries] of rawPortsByService(options.files)) {
164
+ for (const entry of entries) {
165
+ const match = WHOLE_VARIABLE.exec(entry.published.trim());
166
+ const variable = match?.[1] ?? match?.[5];
167
+ if (match === null || variable === undefined)
168
+ continue;
169
+ const argument = (match[4] ?? '').trim();
170
+ const defaultPort = match[3] === '-' && /^[0-9]+$/.test(argument) ? Number(argument) : undefined;
171
+ const hostIp = interpolate(entry.hostIp, options.env).replace(/^\[|\]$/g, '');
172
+ const known = found.get(variable);
173
+ if (known === undefined) {
174
+ found.set(variable, { variable, claims: [{ service, hostIp, protocol: entry.protocol }], defaultPort });
175
+ }
176
+ else {
177
+ known.claims.push({ service, hostIp, protocol: entry.protocol });
178
+ known.defaultPort ??= defaultPort;
179
+ }
180
+ }
181
+ }
182
+ return [...found.values()];
183
+ }
184
+ //# sourceMappingURL=compose-port-variables.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-port-variables.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-port-variables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AA4BvE,+EAA+E;AAC/E,MAAM,aAAa,GAAG,wFAAwF,CAAC;AAE/G;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAa,EAAE,GAAgC;IAClE,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAe,EAAE,KAAc,EAAE,QAAiB,EAAE,QAAiB,EAAE,IAAa,EAAE,EAAE;QAClI,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACrE,IAAI,QAAQ,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACtE,IAAI,QAAQ,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gDAAgD;AAChD,SAAS,UAAU,CAAC,KAAa;IAC/B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8CAA8C;AAC9C,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,sFAAsF;AACtF,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,KAAwB;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC;QACvB,IAAI,OAA2B,CAAC;QAChC,IAAI,OAAmC,CAAC,CAAC,qDAAqD;QAC9F,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,8CAA8C;QAEpE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE9B,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjB,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClD,OAAO,GAAG,SAAS,CAAC;gBACpB,WAAW,GAAG,CAAC,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,0EAA0E;YAC1E,gEAAgE;YAChE,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvG,WAAW,GAAG,CAAC,CAAC,CAAC;YACnB,CAAC;YAED,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9B,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrE,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC9C,SAAS;YACX,CAAC;YAED,yEAAyE;YACzE,IAAI,aAAa,KAAK,CAAC,CAAC;gBAAE,aAAa,GAAG,MAAM,CAAC;YACjD,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBAC7B,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACnD,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YAEpC,MAAM,KAAK,GAAG,sDAAsD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAClF,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,WAAW,GAAG,MAAM,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,SAAS,UAAU,CAAC,OAAe,EAAE,KAAwB;IAC3D,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,oFAAoF;AACpF,SAAS,MAAM,CAAC,SAAiB,EAAE,IAAY;IAC7C,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,IAAI,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;AACxF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAK/B;IACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;IAEvF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACtE,OAAO,CACL,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC;YACpD,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAChC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,qEAAqE;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrE,CAAC;AAiBD,qHAAqH;AACrH,MAAM,cAAc,GAAG,uFAAuF,CAAC;AAE/G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAItC;IACC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE9C,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;gBAAE,SAAS;YAEvD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjG,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAE9E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1G,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjE,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC"}
@@ -0,0 +1,98 @@
1
+ import type { ComposeProjectCommandRunner } from './compose-containers.js';
2
+ /**
3
+ * One host port the composed stack publishes.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export interface PublishedPort {
8
+ /** The compose service that publishes it. */
9
+ service: string;
10
+ /** The host address; `''` when none was given, which is every interface. */
11
+ hostIp: string;
12
+ /** The host port. A published range is one entry per port. */
13
+ port: number;
14
+ /** `tcp`, `udp` or `sctp`. */
15
+ protocol: string;
16
+ }
17
+ /** `docker compose config --format json` output that is not the stack this module can read. */
18
+ export declare class ComposeConfigError extends Error {
19
+ constructor(message: string);
20
+ }
21
+ /**
22
+ * Splits a short-syntax port spec (`127.0.0.1:14003:4003/tcp`) at the colons
23
+ * that are not inside `${...}` or an IPv6 `[...]`, and returns the host side.
24
+ *
25
+ * Shared by the rendered-config fallback and the raw-file variable scan, so
26
+ * both read one grammar.
27
+ *
28
+ * @param spec - The spec, quotes and whitespace already removed.
29
+ * @returns the host address (`''` when none), the published token (which may
30
+ * still hold `${VAR:-default}`), and the protocol; `undefined` for a spec
31
+ * with no published side (`"80"`, a container-only port).
32
+ */
33
+ export declare function splitPortSpec(spec: string): {
34
+ hostIp: string;
35
+ published: string;
36
+ protocol: string;
37
+ } | undefined;
38
+ /**
39
+ * Every host port a rendered compose project publishes, from the JSON of
40
+ * `docker compose config --format json`.
41
+ *
42
+ * `published` is a string for compose v2 and a number elsewhere, and a range
43
+ * (`"8000-8002"`) is one entry per port; no `published` (or `0`) is a port
44
+ * Docker picks and is no claim; no `host_ip` is every interface; the protocol
45
+ * defaults to `tcp`. A service that lists a short-syntax string instead of the
46
+ * long form is read too. A range wider than 1024 ports is cut at 1024.
47
+ *
48
+ * @param json - The command's stdout.
49
+ * @returns the ports, deduplicated, in service order.
50
+ * @throws ComposeConfigError when the text is not a compose project. The
51
+ * message never quotes the text: it holds the stack's secrets.
52
+ * @stability experimental
53
+ */
54
+ export declare function parseComposePorts(json: string): PublishedPort[];
55
+ /**
56
+ * What asking compose for the stack's ports came to.
57
+ *
58
+ * @stability experimental
59
+ */
60
+ export type StackPortsResult =
61
+ /** The ports the stack publishes. */
62
+ {
63
+ status: 'ok';
64
+ ports: PublishedPort[];
65
+ }
66
+ /** Docker could not be reached at all (no `docker`, no daemon, no socket access): nothing was learned. */
67
+ | {
68
+ status: 'docker-unreachable';
69
+ message: string;
70
+ }
71
+ /** Compose refused to render the stack (a missing required variable, an invalid file) or printed something unreadable. */
72
+ | {
73
+ status: 'render-failed';
74
+ message: string;
75
+ };
76
+ /**
77
+ * Renders the deployment's compose project exactly as `up -d` would and lists
78
+ * the host ports it publishes, with `docker compose config --format json` run
79
+ * under the run's project and files, in the checkout's compose directory. That
80
+ * directory is where compose finds the deployment's `.env`: no `--env-file` is
81
+ * passed by any `up`, so none is passed here, and the process environment
82
+ * overrides the file the same way. Never runs anything that changes a container.
83
+ *
84
+ * @param options - The command seam, the deployment and the project.
85
+ * @returns the ports, or why they could not be read.
86
+ * @stability experimental
87
+ */
88
+ export declare function readStackPorts(options: {
89
+ /** The command seam; the engine's `runCommand`. */
90
+ run: ComposeProjectCommandRunner;
91
+ /** The deployment folder. */
92
+ deployRoot: string;
93
+ /** The compose project the run passes to `-p`. */
94
+ project: string;
95
+ /** The deployment's groups; the always-on ones are added. */
96
+ groups?: readonly string[] | undefined;
97
+ }): Promise<StackPortsResult>;
98
+ //# sourceMappingURL=compose-ports.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose-ports.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-ports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAgC3E;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA2B/G;AAmBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAyC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB;AAC1B,qCAAqC;AACnC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE;AAC1C,0GAA0G;GACxG;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACnD,0HAA0H;GACxH;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAcjD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,mDAAmD;IACnD,GAAG,EAAE,2BAA2B,CAAC;IACjC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB5B"}