import { DockgeServer } from "./dockge-server"; import fs from "fs"; import { log } from "./log"; import yaml from "yaml"; import { DockgeSocket, ValidationError } from "./util-server"; import path from "path"; import { COMBINED_TERMINAL_COLS, COMBINED_TERMINAL_ROWS, CREATED_FILE, CREATED_STACK, EXITED, getCombinedTerminalName, getComposeTerminalName, PROGRESS_TERMINAL_ROWS, RUNNING, UNKNOWN } from "./util-common"; import { Terminal } from "./terminal"; import childProcess from "child_process"; export class Stack { name: string; protected _status: number = UNKNOWN; protected _composeYAML?: string; protected _configFilePath?: string; protected server: DockgeServer; protected combinedTerminal? : Terminal; protected static managedStackList: Map = new Map(); constructor(server : DockgeServer, name : string, composeYAML? : string) { this.name = name; this.server = server; this._composeYAML = composeYAML; } toJSON() : object { let obj = this.toSimpleJSON(); return { ...obj, composeYAML: this.composeYAML, }; } toSimpleJSON() : object { return { name: this.name, status: this._status, tags: [], isManagedByDockge: this.isManagedByDockge, }; } /** * Get the status of the stack from `docker compose ps --format json` */ ps() : object { let res = childProcess.execSync("docker compose ps --format json", { cwd: this.path }); return JSON.parse(res.toString()); } get isManagedByDockge() : boolean { if (this._configFilePath) { return this._configFilePath.startsWith(this.server.stackDirFullPath) && fs.existsSync(this.path) && fs.statSync(this.path).isDirectory(); } else { return false; } } get status() : number { return this._status; } validate() { // Check name, allows [a-z][A-Z][0-9] _ - only if (!this.name.match(/^[a-zA-Z0-9_-]+$/)) { throw new ValidationError("Stack name can only contain [a-z][A-Z][0-9] _ - only"); } // Check YAML format yaml.parse(this.composeYAML); } get composeYAML() : string { if (this._composeYAML === undefined) { try { this._composeYAML = fs.readFileSync(path.join(this.path, "compose.yaml"), "utf-8"); } catch (e) { this._composeYAML = ""; } } return this._composeYAML; } get path() : string { return path.join(this.server.stacksDir, this.name); } get fullPath() : string { let dir = this.path; // Compose up via node-pty let fullPathDir; // if dir is relative, make it absolute if (!path.isAbsolute(dir)) { fullPathDir = path.join(process.cwd(), dir); } else { fullPathDir = dir; } return fullPathDir; } /** * Save the stack to the disk * @param isAdd */ save(isAdd : boolean) { this.validate(); let dir = this.path; // Check if the name is used if isAdd if (isAdd) { if (fs.existsSync(dir)) { throw new ValidationError("Stack name already exists"); } // Create the stack folder fs.mkdirSync(dir); } else { if (!fs.existsSync(dir)) { throw new ValidationError("Stack not found"); } } // Write or overwrite the compose.yaml fs.writeFileSync(path.join(dir, "compose.yaml"), this.composeYAML); } async deploy(socket? : DockgeSocket) : Promise { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "up", "-d", "--remove-orphans" ], this.path); if (exitCode !== 0) { throw new Error("Failed to deploy, please check the terminal output for more information."); } return exitCode; } async delete(socket?: DockgeSocket) : Promise { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "down", "--remove-orphans", "--rmi", "all" ], this.path); if (exitCode !== 0) { throw new Error("Failed to delete, please check the terminal output for more information."); } // Remove the stack folder fs.rmSync(this.path, { recursive: true, force: true }); return exitCode; } static getStackList(server : DockgeServer, useCacheForManaged = false) : Map { let stacksDir = server.stacksDir; let stackList : Map; if (useCacheForManaged && this.managedStackList.size > 0) { stackList = this.managedStackList; } else { stackList = new Map(); // Scan the stacks directory, and get the stack list let filenameList = fs.readdirSync(stacksDir); for (let filename of filenameList) { try { let stack = this.getStack(server, filename); stack._status = CREATED_FILE; stackList.set(filename, stack); } catch (e) { log.warn("getStackList", `Failed to get stack ${filename}, error: ${e.message}`); } } // Cache by copying this.managedStackList = new Map(stackList); } // Also get the list from `docker compose ls --all --format json` let res = childProcess.execSync("docker compose ls --all --format json"); let composeList = JSON.parse(res.toString()); for (let composeStack of composeList) { let stack = stackList.get(composeStack.Name); // This stack probably is not managed by Dockge, but we still want to show it if (!stack) { stack = new Stack(server, composeStack.Name); stackList.set(composeStack.Name, stack); } stack._status = this.statusConvert(composeStack.Status); stack._configFilePath = composeStack.ConfigFiles; } return stackList; } /** * Get the status list, it will be used to update the status of the stacks * Not all status will be returned, only the stack that is deployed or created to `docker compose` will be returned */ static getStatusList() : Map { let statusList = new Map(); let res = childProcess.execSync("docker compose ls --all --format json"); let composeList = JSON.parse(res.toString()); for (let composeStack of composeList) { statusList.set(composeStack.Name, this.statusConvert(composeStack.Status)); } return statusList; } /** * Convert the status string from `docker compose ls` to the status number * @param status */ static statusConvert(status : string) : number { if (status.startsWith("created")) { return CREATED_STACK; } else if (status.startsWith("running")) { return RUNNING; } else if (status.startsWith("exited")) { return EXITED; } else { return UNKNOWN; } } static getStack(server: DockgeServer, stackName: string) : Stack { let dir = path.join(server.stacksDir, stackName); if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) { // Maybe it is a stack managed by docker compose directly let stackList = this.getStackList(server); let stack = stackList.get(stackName); if (stack) { return stack; } else { // Really not found throw new ValidationError("Stack not found"); } } let stack = new Stack(server, stackName); stack._status = UNKNOWN; stack._configFilePath = path.resolve(dir); return stack; } async start(socket: DockgeSocket) { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "up", "-d", "--remove-orphans" ], this.path); if (exitCode !== 0) { throw new Error("Failed to start, please check the terminal output for more information."); } return exitCode; } async stop(socket: DockgeSocket) : Promise { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "stop" ], this.path); if (exitCode !== 0) { throw new Error("Failed to stop, please check the terminal output for more information."); } return exitCode; } async restart(socket: DockgeSocket) : Promise { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "restart" ], this.path); if (exitCode !== 0) { throw new Error("Failed to restart, please check the terminal output for more information."); } return exitCode; } async update(socket: DockgeSocket) { const terminalName = getComposeTerminalName(this.name); let exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "pull" ], this.path); if (exitCode !== 0) { throw new Error("Failed to pull, please check the terminal output for more information."); } exitCode = await Terminal.exec(this.server, socket, terminalName, "docker-compose", [ "up", "-d", "--remove-orphans" ], this.path); if (exitCode !== 0) { throw new Error("Failed to restart, please check the terminal output for more information."); } return exitCode; } async startCombinedTerminal(socket: DockgeSocket) { const terminalName = getCombinedTerminalName(this.name); const terminal = Terminal.getOrCreateTerminal(this.server, terminalName, "docker-compose", [ "logs", "-f" ], this.path); terminal.rows = COMBINED_TERMINAL_ROWS; terminal.cols = COMBINED_TERMINAL_COLS; terminal.join(socket); terminal.start(); } }