@lakutata/containerd 0.0.0-stage → 3.0.0-beta.1

package/dist/cjs/client/Networks.js

@@ -0,0 +1,630 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkStore = exports.HOOK_SCRIPT = exports.DEFAULT_NETWORK = void 0;
+exports.parseSubnet = parseSubnet;
+exports.parseIPv6Subnet = parseIPv6Subnet;
+const node_crypto_1 = require("node:crypto");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_net_1 = require("node:net");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * The default network of nerdctl
+ */
+exports.DEFAULT_NETWORK = 'bridge';
+const DEFAULT_SUBNET = '10.4.0.0/24';
+const DEFAULT_BRIDGE = 'nerdctl0';
+/**
+ * The directory of the leases of the addresses of the networks created (in /run: released at the boots, when the
+ * containers of the last one did not stop)
+ */
+const IPAM_DATA_DIR = '/run/lakutata/cni/ipam';
+/**
+ * The script of the networks of the containers, run by runc as their hooks: add (createRuntime, the networks of CNI
+ * added to the namespace of the container, its /etc/hosts given its address), del (poststop, the networks deleted, their
+ * addresses released). The plugins of each network are chained as libcni chains them (the result of each one is the
+ * previous result of the next one); their configurations are the files written for the container
+ */
+exports.HOOK_SCRIPT = `#!/bin/sh
+# The networks of a container (CNI), run by runc: add (createRuntime), del (poststop); the state of the container on the
+# standard input
+command="$1"
+dir="$2"
+state=$(cat)
+. "$dir/network/env"
+pid=$(printf '%s' "$state" | tr -d '\\n' | sed -n 's/.*"pid": *\\([0-9][0-9]*\\).*/\\1/p')
+# The namespace of the network of the container, kept by a bind mount until its networks are deleted (the plugins delete
+# their rules from the namespace, gone with the container otherwise)
+netns="$dir/network/netns"
+
+mounted() {
+    awk -v target="$netns" '$5 == target { found = 1 } END { exit !found }' /proc/self/mountinfo
+}
+
+plugin() {
+    old_ifs=$IFS
+    IFS=:
+    for directory in $CNI_PATH; do
+        if [ -x "$directory/$1" ]; then
+            IFS=$old_ifs
+            printf '%s' "$directory/$1"
+            return 0
+        fi
+    done
+    IFS=$old_ifs
+    return 1
+}
+
+# The input of a plugin: its configuration, the previous result
+input() {
+    if [ -n "$2" ]; then printf '%s,"prevResult":%s}' "$(cat "$1")" "$2"; else printf '%s}' "$(cat "$1")"; fi
+}
+
+add() {
+    net="$1"
+    export CNI_COMMAND=ADD CNI_CONTAINERID CNI_NETNS="$netns" CNI_IFNAME="$(cat "$net/ifname")" CNI_ARGS="$(cat "$net/args")" CNI_PATH
+    count=$(cat "$net/count")
+    previous=""
+    i=1
+    while [ "$i" -le "$count" ]; do
+        type=$(cat "$net/$i.type")
+        binary=$(plugin "$type") || { echo "the CNI plugin $type is not in $CNI_PATH" >&2; return 1; }
+        if ! previous=$(input "$net/$i.conf" "$previous" | "$binary"); then
+            echo "the CNI plugin $type of the network $(cat "$net/name") failed: $previous" >&2
+            return 1
+        fi
+        i=$((i + 1))
+    done
+    printf '%s' "$previous" > "$net/result.json"
+}
+
+del() {
+    net="$1"
+    export CNI_COMMAND=DEL CNI_CONTAINERID CNI_NETNS="$netns" CNI_IFNAME="$(cat "$net/ifname")" CNI_ARGS="$(cat "$net/args")" CNI_PATH
+    count=$(cat "$net/count")
+    previous=$(cat "$net/result.json" 2>/dev/null)
+    i=$count
+    while [ "$i" -ge 1 ]; do
+        type=$(cat "$net/$i.type")
+        if binary=$(plugin "$type"); then
+            input "$net/$i.conf" "$previous" | "$binary" > /dev/null 2>&1 || echo "the CNI plugin $type of the network $(cat "$net/name") failed to delete" >&2
+        fi
+        i=$((i - 1))
+    done
+    rm -f "$net/result.json"
+}
+
+networks=$(ls -d "$dir"/network/[0-9]* 2>/dev/null)
+case "$command" in
+    add)
+        if ! mounted; then
+            if [ -z "$pid" ] || [ ! -e "/proc/$pid/ns/net" ]; then echo "the container has no process (its state: $state)" >&2; exit 1; fi
+            : > "$netns"
+            mount --bind "/proc/$pid/ns/net" "$netns" || exit 1
+        fi
+        for net in $networks; do
+            if ! add "$net"; then
+                for added in $networks; do del "$added"; done
+                umount "$netns" 2>/dev/null
+                rm -f "$netns"
+                exit 1
+            fi
+        done
+        first=$(printf '%s\\n' $networks | head -n 1)
+        address=$(sed -n 's/.*"address": *"\\([0-9a-fA-F.:]*\\)\\/.*/\\1/p' "$first/result.json" | head -n 1)
+        { cat "$dir/hosts.base"; if [ -n "$address" ]; then printf '%s\\t%s\\n' "$address" "$(cat "$dir/hostname")"; fi; } > "$dir/hosts"
+        ;;
+    del)
+        mounted || netns=""
+        for net in $(printf '%s\\n' $networks | sort -r); do del "$net"; done
+        if [ -n "$netns" ]; then umount "$netns" 2>/dev/null || umount -l "$netns" 2>/dev/null; fi
+        rm -f "$dir/network/netns"
+        ;;
+esac
+exit 0
+`;
+/**
+ * The integer of an address of IPv4
+ * @param address
+ */
+function iPv4ToNumber(address) {
+    const parts = address.split('.').map(Number);
+    if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255))
+        throw new Error(`The address ${address} is not an address of IPv4`);
+    return ((parts[0] << 24) >>> 0) + (parts[1] << 16) + (parts[2] << 8) + parts[3];
+}
+function numberToIPv4(value) {
+    return [value >>> 24, (value >>> 16) & 255, (value >>> 8) & 255, value & 255].join('.');
+}
+/**
+ * The first and the last addresses of a subnet (CIDR of IPv4)
+ * @param cidr
+ */
+function parseSubnet(cidr) {
+    const [address, prefixText] = cidr.split('/');
+    const prefix = Number(prefixText);
+    if (!Number.isInteger(prefix) || prefix < 8 || prefix > 30)
+        throw new Error(`The subnet ${cidr} is not a CIDR of IPv4 (/8 to /30)`);
+    const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
+    const network = (iPv4ToNumber(address) & mask) >>> 0;
+    return { network: network, broadcast: (network | (~mask >>> 0)) >>> 0, prefix: prefix, cidr: `${numberToIPv4(network)}/${prefix}` };
+}
+/**
+ * The integer of an address of IPv6
+ * @param address
+ */
+function iPv6ToBigInt(address) {
+    if (!(0, node_net_1.isIPv6)(address))
+        throw new Error(`The address ${address} is not an address of IPv6`);
+    const [head, tail] = address.split('::');
+    //An address of IPv4 at its end (::ffff:1.2.3.4)
+    const ipv4 = (part) => part.includes('.') ? [(iPv4ToNumber(part) >>> 16).toString(16), (iPv4ToNumber(part) & 0xffff).toString(16)] : [part];
+    const headGroups = head ? head.split(':').flatMap(ipv4) : [];
+    const tailGroups = tail ? tail.split(':').flatMap(ipv4) : [];
+    const groups = tail === undefined ? headGroups : [...headGroups, ...Array(8 - headGroups.length - tailGroups.length).fill('0'), ...tailGroups];
+    return groups.reduce((value, group) => (value << 16n) | BigInt(parseInt(group || '0', 16)), 0n);
+}
+function bigIntToIPv6(value) {
+    const groups = [];
+    for (let index = 7; index >= 0; index--)
+        groups.push(((value >> BigInt(index * 16)) & 0xffffn).toString(16));
+    //The longest run of zeros compressed
+    let best = [-1, 0];
+    for (let start = 0; start < 8; start++) {
+        let length = 0;
+        while (start + length < 8 && groups[start + length] === '0')
+            length++;
+        if (length > best[1])
+            best = [start, length];
+    }
+    if (best[1] < 2)
+        return groups.join(':');
+    return `${groups.slice(0, best[0]).join(':')}::${groups.slice(best[0] + best[1]).join(':')}`;
+}
+/**
+ * A subnet of IPv6 (CIDR): its network, its prefix, its first address
+ * @param cidr
+ */
+function parseIPv6Subnet(cidr) {
+    const [address, prefixText] = cidr.split('/');
+    const prefix = Number(prefixText);
+    if (!Number.isInteger(prefix) || prefix < 8 || prefix > 126)
+        throw new Error(`The subnet ${cidr} is not a CIDR of IPv6 (/8 to /126)`);
+    const mask = ((1n << 128n) - 1n) ^ ((1n << BigInt(128 - prefix)) - 1n);
+    const network = iPv6ToBigInt(address) & mask;
+    return { cidr: `${bigIntToIPv6(network)}/${prefix}`, first: bigIntToIPv6(network + 1n), network: network, last: network | (((1n << 128n) - 1n) ^ mask) };
+}
+/**
+ * Whether two subnets overlap
+ * @param a
+ * @param b
+ */
+function overlap(a, b) {
+    try {
+        const [x, y] = [parseSubnet(a), parseSubnet(b)];
+        return x.network <= y.broadcast && y.network <= x.broadcast;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Remove a bridge of the host: the rules of the firewall plugin isolating it (iptables), its interface (ip of iproute2,
+ * or of busybox); what the system cannot remove is left
+ * @param bridge
+ */
+function removeBridge(bridge) {
+    for (const chain of ['CNI-ISOLATION-STAGE-1', 'CNI-ISOLATION-STAGE-2']) {
+        const rules = (0, node_child_process_1.spawnSync)('iptables', ['-w', '-S', chain], { encoding: 'utf8' });
+        if (rules.error || rules.status !== 0)
+            continue;
+        for (const rule of rules.stdout.split('\n')) {
+            //The rules naming the bridge: deleted as iptables writes them (their comments quoted)
+            if (!rule.startsWith('-A ') || !new RegExp(`(^| )-[io] ${bridge.replace(/\./g, '\\.')}( |$)`).test(rule))
+                continue;
+            (0, node_child_process_1.spawnSync)('/bin/sh', ['-c', `iptables -w -D ${rule.slice(3)}`], { stdio: 'ignore' });
+        }
+    }
+    if ((0, node_fs_1.existsSync)(`/sys/class/net/${bridge}`))
+        (0, node_child_process_1.spawnSync)('ip', ['link', 'delete', bridge], { stdio: 'ignore' });
+}
+/**
+ * The networks of CNI of the machine (the configuration lists of its directory), the ones of nerdctl created and
+ * removed, the configurations of the networks of the containers written for their hooks
+ */
+class NetworkStore {
+    #cniVersion;
+    constructor(confDir, cniPath) {
+        this.confDir = confDir;
+        this.cniPath = cniPath;
+    }
+    /**
+     * The directories of the plugins which exist
+     */
+    pluginDirectories() {
+        return this.cniPath.filter((directory) => (0, node_fs_1.existsSync)(directory));
+    }
+    /**
+     * The path of a plugin, undefined when it is not installed
+     * @param type
+     */
+    plugin(type) {
+        for (const directory of this.pluginDirectories()) {
+            const file = node_path_1.default.join(directory, type);
+            try {
+                (0, node_fs_1.accessSync)(file, node_fs_1.constants.X_OK);
+                return file;
+            }
+            catch {
+                //Not there
+            }
+        }
+        return undefined;
+    }
+    /**
+     * The version of CNI of the configurations written: the newest one of the plugins (1.0.0, or 0.4.0)
+     */
+    cniVersion() {
+        if (this.#cniVersion)
+            return this.#cniVersion;
+        const bridge = this.plugin('bridge') ?? this.plugin('macvlan');
+        let versions = [];
+        if (bridge) {
+            try {
+                const result = (0, node_child_process_1.spawnSync)(bridge, [], { input: '', env: { ...process.env, CNI_COMMAND: 'VERSION' }, encoding: 'utf8', timeout: 10000 });
+                versions = JSON.parse(result.stdout).supportedVersions ?? [];
+            }
+            catch {
+                //An older plugin
+            }
+        }
+        this.#cniVersion = versions.includes('1.0.0') ? '1.0.0' : '0.4.0';
+        return this.#cniVersion;
+    }
+    /**
+     * A network of a configuration list
+     * @param file
+     * @param content
+     */
+    parse(file, content) {
+        let list;
+        try {
+            list = JSON.parse(content);
+        }
+        catch {
+            return undefined;
+        }
+        if (typeof list.name !== 'string')
+            return undefined;
+        const plugins = Array.isArray(list.plugins) ? list.plugins : [list];
+        const subnets = [];
+        const gateways = [];
+        for (const plugin of plugins) {
+            for (const range of plugin.ipam?.ranges ?? []) {
+                for (const item of range) {
+                    if (item.subnet)
+                        subnets.push(item.subnet);
+                    if (item.gateway)
+                        gateways.push(item.gateway);
+                }
+            }
+            if (plugin.ipam?.subnet)
+                subnets.push(plugin.ipam.subnet);
+            if (plugin.ipam?.gateway)
+                gateways.push(plugin.ipam.gateway);
+        }
+        return {
+            name: list.name,
+            id: typeof list.nerdctlID === 'string' ? list.nerdctlID : (0, node_crypto_1.createHash)('sha256').update(list.name).digest('hex'),
+            file: file,
+            labels: list.nerdctlLabels ?? {},
+            cniVersion: list.cniVersion ?? '0.4.0',
+            driver: plugins[0]?.type ?? '',
+            subnets: subnets,
+            gateways: gateways,
+            plugins: plugins,
+            managed: node_path_1.default.basename(file).startsWith('nerdctl-')
+        };
+    }
+    /**
+     * The networks of CNI of the machine
+     */
+    async list() {
+        let files;
+        try {
+            files = (await (0, promises_1.readdir)(this.confDir)).filter((file) => file.endsWith('.conflist') || file.endsWith('.conf')).sort();
+        }
+        catch {
+            return [];
+        }
+        const networks = [];
+        for (const file of files) {
+            const network = this.parse(node_path_1.default.join(this.confDir, file), await (0, promises_1.readFile)(node_path_1.default.join(this.confDir, file), 'utf8').catch(() => ''));
+            if (network && !networks.some((known) => known.name === network.name))
+                networks.push(network);
+        }
+        return networks;
+    }
+    /**
+     * A network, by its name or its identifier (or a prefix of it); the default one of nerdctl created when it is asked
+     * @param nameOrId
+     */
+    async get(nameOrId) {
+        const networks = await this.list();
+        const found = networks.find((network) => network.name === nameOrId)
+            ?? networks.find((network) => network.id === nameOrId)
+            ?? (nameOrId.length >= 3 ? networks.find((network) => network.id.startsWith(nameOrId)) : undefined);
+        if (found || nameOrId !== exports.DEFAULT_NETWORK)
+            return found;
+        return await this.createDefault();
+    }
+    /**
+     * The plugins added after the main one, as nerdctl adds them (the ones installed)
+     * @param driver
+     * @protected
+     */
+    chainedPlugins(driver) {
+        const plugins = [{ type: 'portmap', capabilities: { portMappings: true } }];
+        if (driver === 'bridge' && this.plugin('firewall'))
+            plugins.push({ type: 'firewall', ingressPolicy: 'same-bridge' });
+        if (this.plugin('tuning'))
+            plugins.push({ type: 'tuning' });
+        return plugins;
+    }
+    /**
+     * Write a configuration list
+     * @param name
+     * @param id
+     * @param labels
+     * @param plugins
+     * @protected
+     */
+    async write(name, id, labels, plugins) {
+        const file = node_path_1.default.join(this.confDir, `nerdctl-${name}.conflist`);
+        const content = JSON.stringify({ cniVersion: this.cniVersion(), name: name, nerdctlID: id, nerdctlLabels: labels, plugins: plugins }, null, 2);
+        await (0, promises_1.mkdir)(this.confDir, { recursive: true });
+        await (0, promises_1.writeFile)(file, content + '\n', { flag: 'wx' });
+        return this.parse(file, content);
+    }
+    /**
+     * Create the default network of nerdctl (bridge, nerdctl0, 10.4.0.0/24)
+     * @protected
+     */
+    async createDefault() {
+        try {
+            return await this.write(exports.DEFAULT_NETWORK, (0, node_crypto_1.createHash)('sha256').update(exports.DEFAULT_NETWORK).digest('hex'), { 'nerdctl/default-network': 'true' }, [
+                {
+                    type: 'bridge',
+                    bridge: DEFAULT_BRIDGE,
+                    isGateway: true,
+                    ipMasq: true,
+                    hairpinMode: true,
+                    ipam: { ranges: [[{ gateway: '10.4.0.1', subnet: DEFAULT_SUBNET }]], routes: [{ dst: '0.0.0.0/0' }], type: 'host-local', dataDir: IPAM_DATA_DIR }
+                },
+                ...this.chainedPlugins('bridge')
+            ]);
+        }
+        catch (error) {
+            //Created meanwhile
+            if (error.code === 'EEXIST')
+                return (await this.list()).find((network) => network.name === exports.DEFAULT_NETWORK);
+            throw error;
+        }
+    }
+    /**
+     * A free subnet of 10.4.0.0/16 (the ones of nerdctl)
+     * @param used
+     * @protected
+     */
+    freeSubnet(used) {
+        for (let third = 1; third < 256; third++) {
+            const subnet = `10.4.${third}.0/24`;
+            if (!used.some((other) => overlap(subnet, other)))
+                return subnet;
+        }
+        throw new Error('No subnet of 10.4.0.0/16 is free: give the subnet of the network');
+    }
+    /**
+     * Create a network (bridge, macvlan, ipvlan), as nerdctl network create does
+     * @param options
+     */
+    async create(options) {
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(options.name))
+            throw new Error(`The name of a network "${options.name}" is not valid ([a-zA-Z0-9][a-zA-Z0-9_.-]*)`);
+        if (['host', 'none', exports.DEFAULT_NETWORK].includes(options.name))
+            throw Object.assign(new Error(`The network ${options.name} is the one of the system`), { code: 'CONFLICT' });
+        const networks = await this.list();
+        if (networks.some((network) => network.name === options.name))
+            throw Object.assign(new Error(`The network ${options.name} exists`), { code: 'CONFLICT' });
+        const driver = options.driver ?? 'bridge';
+        if (!this.plugin(driver))
+            throw new Error(`The CNI plugin ${driver} is not installed (${this.cniPath.join(', ')})`);
+        const used = [DEFAULT_SUBNET, ...networks.flatMap((network) => network.subnets)];
+        const subnet = parseSubnet(options.subnet ?? this.freeSubnet(used));
+        const overlapping = used.find((other) => overlap(subnet.cidr, other));
+        if (options.subnet && overlapping)
+            throw Object.assign(new Error(`The subnet ${subnet.cidr} overlaps the one of another network (${overlapping})`), { code: 'CONFLICT' });
+        const gateway = options.gateway ?? numberToIPv4(subnet.network + 1);
+        const gatewayNumber = iPv4ToNumber(gateway);
+        if (gatewayNumber <= subnet.network || gatewayNumber >= subnet.broadcast)
+            throw new Error(`The gateway ${gateway} is not in the subnet ${subnet.cidr}`);
+        const range = { gateway: gateway, subnet: subnet.cidr };
+        if (options.ipRange) {
+            const ipRange = parseSubnet(options.ipRange);
+            if (ipRange.network < subnet.network || ipRange.broadcast > subnet.broadcast)
+                throw new Error(`The range ${options.ipRange} is not in the subnet ${subnet.cidr}`);
+            range.rangeStart = numberToIPv4(Math.max(ipRange.network + 1, subnet.network + 1));
+            range.rangeEnd = numberToIPv4(Math.min(ipRange.broadcast - 1, subnet.broadcast - 1));
+        }
+        const ipam = { ranges: [[range]], routes: options.internal ? [] : [{ dst: '0.0.0.0/0' }], type: 'host-local', dataDir: IPAM_DATA_DIR };
+        if (options.ipv6Subnet) {
+            const ipv6 = parseIPv6Subnet(options.ipv6Subnet);
+            const ipv6Gateway = options.ipv6Gateway ?? ipv6.first;
+            const gateway6 = iPv6ToBigInt(ipv6Gateway);
+            if (gateway6 <= ipv6.network || gateway6 > ipv6.last)
+                throw new Error(`The gateway ${ipv6Gateway} is not in the subnet ${ipv6.cidr}`);
+            const overlapping6 = networks.find((network) => network.subnets.some((other) => {
+                try {
+                    const known = parseIPv6Subnet(other);
+                    return known.network <= ipv6.last && ipv6.network <= known.last;
+                }
+                catch {
+                    return false;
+                }
+            }));
+            if (overlapping6)
+                throw Object.assign(new Error(`The subnet ${ipv6.cidr} overlaps the one of the network ${overlapping6.name}`), { code: 'CONFLICT' });
+            ipam.ranges.push([{ subnet: ipv6.cidr, gateway: ipv6Gateway }]);
+            if (!options.internal)
+                ipam.routes.push({ dst: '::/0' });
+        }
+        const id = (0, node_crypto_1.randomBytes)(32).toString('hex');
+        let main;
+        if (driver === 'bridge') {
+            main = { type: 'bridge', bridge: `br-${id.slice(0, 12)}`, isGateway: !options.internal, ipMasq: !options.internal, hairpinMode: true, ipam: ipam };
+        }
+        else {
+            if (!options.parent)
+                throw new Error(`The ${driver} network ${options.name} needs the interface of the host (parent)`);
+            main = driver === 'macvlan' ? { type: 'macvlan', master: options.parent, mode: 'bridge', ipam: ipam } : { type: 'ipvlan', master: options.parent, mode: 'l2', ipam: ipam };
+        }
+        if (options.mtu)
+            main.mtu = options.mtu;
+        try {
+            return await this.write(options.name, id, options.labels ?? {}, [main, ...this.chainedPlugins(driver)]);
+        }
+        catch (error) {
+            if (error.code === 'EEXIST')
+                throw Object.assign(new Error(`The network ${options.name} exists`), { code: 'CONFLICT' });
+            throw error;
+        }
+    }
+    /**
+     * Remove a network (one of nerdctl): its configuration, its bridge and the rules of its firewall, the leases of its
+     * addresses, as nerdctl network rm does
+     * @param network
+     */
+    async remove(network) {
+        if (!network.managed)
+            throw new Error(`The network ${network.name} is not one of nerdctl (${network.file}): remove its configuration`);
+        if (network.labels['nerdctl/default-network'] === 'true')
+            throw Object.assign(new Error(`The network ${network.name} is the default one`), { code: 'CONFLICT' });
+        await (0, promises_1.rm)(network.file, { force: true });
+        const main = network.plugins[0] ?? {};
+        if (main.type === 'bridge' && typeof main.bridge === 'string' && /^[\w.-]+$/.test(main.bridge))
+            removeBridge(main.bridge);
+        if (main.ipam?.dataDir === IPAM_DATA_DIR)
+            await (0, promises_1.rm)(node_path_1.default.join(IPAM_DATA_DIR, network.name), { recursive: true, force: true });
+    }
+    /**
+     * Write the configurations of the networks of a container for its hooks (the configurations of their plugins, their
+     * runtime configurations: the ports published on the first one)
+     * @param stateDir
+     * @param containerId
+     * @param networks
+     * @param ports
+     */
+    async render(stateDir, containerId, networks, ports) {
+        const directory = node_path_1.default.join(stateDir, 'network');
+        await (0, promises_1.rm)(directory, { recursive: true, force: true });
+        await (0, promises_1.mkdir)(directory, { recursive: true });
+        const pluginPath = this.pluginDirectories().join(':');
+        await (0, promises_1.writeFile)(node_path_1.default.join(directory, 'env'), [
+            `CNI_PATH='${pluginPath}'`,
+            `CNI_CONTAINERID='${containerId}'`,
+            `PATH='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${pluginPath}'`,
+            'export CNI_PATH CNI_CONTAINERID PATH',
+            ''
+        ].join('\n'));
+        await (0, promises_1.writeFile)(node_path_1.default.join(directory, 'hook.sh'), exports.HOOK_SCRIPT, { mode: 0o755 });
+        for (let index = 0; index < networks.length; index++) {
+            const { network, ip, ipv6 } = networks[index];
+            const net = node_path_1.default.join(directory, String(index).padStart(2, '0'));
+            await (0, promises_1.mkdir)(net);
+            await (0, promises_1.writeFile)(node_path_1.default.join(net, 'name'), network.name);
+            await (0, promises_1.writeFile)(node_path_1.default.join(net, 'ifname'), `eth${index}`);
+            const addresses = [ip, ipv6].filter((address) => !!address);
+            await (0, promises_1.writeFile)(node_path_1.default.join(net, 'args'), ['IgnoreUnknown=1', ...addresses.length ? [`IP=${addresses.join(',')}`] : []].join(';'));
+            await (0, promises_1.writeFile)(node_path_1.default.join(net, 'count'), String(network.plugins.length));
+            for (let position = 0; position < network.plugins.length; position++) {
+                const plugin = { ...network.plugins[position], name: network.name, cniVersion: network.cniVersion };
+                //The runtime configuration of the capabilities of the plugin (the ports on the first network)
+                if (plugin.capabilities?.portMappings && index === 0 && ports.length) {
+                    plugin.runtimeConfig = { portMappings: ports.map((port) => ({ hostPort: port.hostPort, containerPort: port.containerPort, protocol: port.protocol, hostIP: port.hostIP ?? '' })) };
+                }
+                delete plugin.capabilities;
+                //Without its closing brace: the previous result is added by the hook
+                await (0, promises_1.writeFile)(node_path_1.default.join(net, `${position + 1}.conf`), JSON.stringify(plugin).slice(0, -1));
+                await (0, promises_1.writeFile)(node_path_1.default.join(net, `${position + 1}.type`), String(plugin.type));
+            }
+        }
+    }
+    /**
+     * Delete the networks of a container whose hook did not (its task killed with its shim): the hook run as runc runs
+     * it
+     * @param stateDir
+     */
+    async teardown(stateDir) {
+        const hook = node_path_1.default.join(stateDir, 'network', 'hook.sh');
+        if (!(0, node_fs_1.existsSync)(hook))
+            return;
+        const results = (await (0, promises_1.readdir)(node_path_1.default.join(stateDir, 'network')).catch(() => []))
+            .filter((entry) => /^\d+$/.test(entry) && (0, node_fs_1.existsSync)(node_path_1.default.join(stateDir, 'network', entry, 'result.json')));
+        if (!results.length && !(0, node_fs_1.existsSync)(node_path_1.default.join(stateDir, 'network', 'netns')))
+            return;
+        await new Promise((resolve) => {
+            const child = (0, node_child_process_1.spawn)('/bin/sh', [hook, 'del', stateDir], { stdio: ['pipe', 'ignore', 'ignore'] });
+            child.on('error', () => resolve());
+            child.on('close', () => resolve());
+            child.stdin.end('{}');
+        });
+    }
+    /**
+     * The interfaces of a container on its networks (their results of CNI)
+     * @param stateDir
+     */
+    async interfaces(stateDir) {
+        const directory = node_path_1.default.join(stateDir, 'network');
+        const entries = (await (0, promises_1.readdir)(directory).catch(() => [])).filter((entry) => /^\d+$/.test(entry)).sort();
+        const interfaces = [];
+        for (const entry of entries) {
+            const net = node_path_1.default.join(directory, entry);
+            const name = await (0, promises_1.readFile)(node_path_1.default.join(net, 'name'), 'utf8').catch(() => '');
+            const ifname = await (0, promises_1.readFile)(node_path_1.default.join(net, 'ifname'), 'utf8').catch(() => '');
+            const item = { network: name, interface: ifname };
+            let result;
+            try {
+                result = JSON.parse(await (0, promises_1.readFile)(node_path_1.default.join(net, 'result.json'), 'utf8'));
+            }
+            catch {
+                //Not added (the container is not running)
+            }
+            if (result) {
+                const index = (result.interfaces ?? []).findIndex((candidate) => candidate.name === ifname && !!candidate.sandbox);
+                if (index >= 0)
+                    item.mac = result.interfaces[index].mac;
+                for (const ip of result.ips ?? []) {
+                    if (ip.interface !== undefined && index >= 0 && ip.interface !== index)
+                        continue;
+                    const [address, prefix] = String(ip.address).split('/');
+                    if (address.includes(':')) {
+                        item.ipv6 ??= address;
+                        item.ipv6Gateway ??= ip.gateway;
+                    }
+                    else if (!item.ip) {
+                        item.ip = address;
+                        item.prefixLength = Number(prefix);
+                        item.gateway = ip.gateway;
+                    }
+                }
+            }
+            interfaces.push(item);
+        }
+        return interfaces;
+    }
+}
+exports.NetworkStore = NetworkStore;

package/dist/cjs/client/Platforms.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A platform of the images (OCI): its system, its architecture, its variant
+ */
+export type Platform = {
+    os: string;
+    architecture: string;
+    variant?: string;
+};
+/**
+ * The platforms of the ELF binaries an entry of binfmt_misc runs (by the machine of the ELF header of its magic): the
+ * emulators of QEMU, Rosetta, whatever their names
+ * @param entry the content of the entry
+ */
+export declare function binfmtPlatforms(entry: string): Platform[];
+/**
+ * A platform written as OCI writes it (linux/arm64/v8)
+ * @param platform
+ */
+export declare function formatPlatform(platform: Platform): string;
+/**
+ * The variant of an architecture given without it: the one its images are matched to (arm64 is v8, arm v7)
+ * @param platform
+ */
+export declare function normalizePlatform(platform: Platform): Platform;
+/**
+ * Parse a platform: linux/arm64, linux/arm/v7, or an architecture (arm64), on Linux
+ * @param value
+ */
+export declare function parsePlatform(value: string): Platform;
+/**
+ * The platform of the machine running Node.js
+ */
+export declare function hostPlatform(): Platform;
+/**
+ * Whether a platform of an image runs on a platform: the same system and architecture, a variant up to the one of the
+ * platform (an arm/v7 runs the images of arm/v6 and arm/v5)
+ * @param image
+ * @param platform
+ */
+export declare function matchPlatform(image: Platform, platform: Platform): boolean;
+/**
+ * How much a platform of an image suits a platform: the exact one first (lower is better), undefined when it does not
+ * run there
+ * @param image
+ * @param platform
+ */
+export declare function platformRank(image: Platform, platform: Platform): number | undefined;
+/**
+ * The platforms the machine runs the containers of: its own one, and the ones of the emulators registered in
+ * binfmt_misc (enabled)
+ * @param binfmt the directory of binfmt_misc
+ */
+export declare function supportedPlatforms(binfmt?: string): Platform[];