Configuration File

File Structure

wukong-deploy uses config/config.mjs as its main configuration file. This is an ES Module file that should export a configuration object.

Basic structure:

export default {
  showCommandLog: true,  // Show command execution logs
  servers: {
    dev: {  // Server configuration key
      name: "Development Server",  // Server description
      host: "192.168.1.100",  // Server address
      username: "root",  // SSH username
      passwordEnv: "SERVER_PASSWORD",  // Password environment variable
      commands: [  // List of commands to execute
        {
          cmd: "git pull",  // Command to execute
          cwd: "/path/to/project",  // Working directory
          description: "Update code",  // Command description
          exitOnStdErr: false,  // Exit on error
          errorMatch: /Permission denied/  // Error matching pattern
        }
      ],
      finishMsg: "🎉 Deployment complete"  // Completion message
    }
  }
}

Server Configuration

Each server configuration contains the following fields:

Field Name	Type	Description	Required
name	string	Server description	Yes
host	string	Server address	Yes
username	string	SSH username	Yes
passwordEnv	string	Password environment variable	Yes
commands	array	Command list	Yes
finishMsg	string	Completion message	No

Command Configuration

Each command object supports the following configuration:

Field Name	Type	Description	Default
cmd	string	Command to execute	-
cwd	string	Working directory	-
description	string	Command description	-
exitOnStdErr	boolean	Exit on error	true
errorMatch	RegExp	Error matching pattern	-
isLocal	boolean	Execute locally	false

Complete Example

export default {
  showCommandLog: true,
  servers: {
    dev: {
      name: "Development Server",
      host: "192.168.1.100",
      username: "root",
      passwordEnv: "SERVER_DEV_PASSWORD",
      commands: [
        {
          cmd: "git pull",
          cwd: "/var/www/app",
          description: "Update code",
          exitOnStdErr: false
        },
        {
          cmd: "npm install",
          cwd: "/var/www/app",
          description: "Install dependencies"
        },
        {
          cmd: "npm run build",
          cwd: "/var/www/app",
          description: "Build project"
        },
        {
          cmd: "pm2 restart app",
          cwd: "/var/www/app",
          description: "Restart service"
        }
      ],
      finishMsg: "🎉 Development environment deployment complete!"
    },
    prod: {
      name: "Production Server",
      host: "10.0.0.1",
      username: "deploy",
      passwordEnv: "SERVER_PROD_PASSWORD",
      commands: [
        {
          cmd: "git pull origin main",
          cwd: "/var/www/production",
          description: "Update main branch code"
        },
        {
          cmd: "npm ci",
          cwd: "/var/www/production",
          description: "Install dependencies (production)"
        }
      ],
      finishMsg: "🚀 Production environment deployment complete!"
    }
  }
}