import * as fs from "node:fs/promises"; import * as os from "node:os"; import { BACKEND_STATUS, type BackendConfig } from "~/schemas/volumes"; import { OPERATION_TIMEOUT } from "../../../core/constants"; import { toMessage } from "../../../utils/errors"; import { logger } from "@zerobyte/core/node"; import { getMountForPath } from "../../../utils/mountinfo"; import { withTimeout } from "../../../utils/timeout"; import type { VolumeBackend } from "../backend"; import { assertMounted, executeMount, executeUnmount } from "../utils/backend-utils"; const mount = async (config: BackendConfig, path: string) => { logger.debug(`Mounting volume ${path}...`); if (config.backend !== "nfs") { logger.error("Provided config is not for NFS backend"); return { status: BACKEND_STATUS.error, error: "Provided config is not for NFS backend", }; } if (os.platform() !== "linux") { logger.error("NFS mounting is only supported on Linux hosts."); return { status: BACKEND_STATUS.error, error: "NFS mounting is only supported on Linux hosts.", }; } const { status } = await checkHealth(path); if (status === "mounted") { return { status: BACKEND_STATUS.mounted }; } if (status === "error") { logger.debug(`Trying to unmount any existing mounts at ${path} before mounting...`); await unmount(path); } const run = async () => { await fs.mkdir(path, { recursive: true }); const source = `${config.server}:${config.exportPath}`; const options = [`vers=${config.version}`, `port=${config.port}`]; if (config.version === "3") { options.push("nolock"); } if (config.readOnly) { options.push("ro"); } const args = ["-t", "nfs", "-o", options.join(","), source, path]; logger.debug(`Mounting volume ${path}...`); logger.info(`Executing mount: mount ${args.join(" ")}`); try { await executeMount(args); } catch (error) { logger.warn(`Initial NFS mount failed, retrying with -i flag: ${toMessage(error)}`); // Fallback with -i flag if the first mount fails using the mount helper await executeMount(["-i", ...args]); } logger.info(`NFS volume at ${path} mounted successfully.`); return { status: BACKEND_STATUS.mounted }; }; try { return await withTimeout(run(), OPERATION_TIMEOUT, "NFS mount"); } catch (err) { logger.error("Error mounting NFS volume", { error: toMessage(err) }); return { status: BACKEND_STATUS.error, error: toMessage(err) }; } }; const unmount = async (path: string) => { if (os.platform() !== "linux") { logger.error("NFS unmounting is only supported on Linux hosts."); return { status: BACKEND_STATUS.error, error: "NFS unmounting is only supported on Linux hosts.", }; } const run = async () => { const mount = await getMountForPath(path); if (!mount || mount.mountPoint !== path) { logger.debug(`Path ${path} is not a mount point. Skipping unmount.`); return { status: BACKEND_STATUS.unmounted }; } await executeUnmount(path); await fs.rmdir(path).catch(() => {}); logger.info(`NFS volume at ${path} unmounted successfully.`); return { status: BACKEND_STATUS.unmounted }; }; try { return await withTimeout(run(), OPERATION_TIMEOUT, "NFS unmount"); } catch (err) { logger.error("Error unmounting NFS volume", { path, error: toMessage(err), }); return { status: BACKEND_STATUS.error, error: toMessage(err) }; } }; const checkHealth = async (path: string) => { const run = async () => { await assertMounted(path, (fstype) => fstype.startsWith("nfs")); logger.debug(`NFS volume at ${path} is healthy and mounted.`); return { status: BACKEND_STATUS.mounted }; }; try { return await withTimeout(run(), OPERATION_TIMEOUT, "NFS health check"); } catch (error) { const message = toMessage(error); if (message !== "Volume is not mounted") { logger.error("NFS volume health check failed:", message); } return { status: BACKEND_STATUS.error, error: message }; } }; export const makeNfsBackend = (config: BackendConfig, path: string): VolumeBackend => ({ mount: () => mount(config, path), unmount: () => unmount(path), checkHealth: () => checkHealth(path), });