Class RunCLI

java.lang.Object

com.scivicslab.actoriac.cli.RunCLI

All Implemented Interfaces:

Callable<Integer>

public class RunCLI
extends Object
implements Callable<Integer>

CLI subcommand to execute actor-IaC workflows.

This is the main workflow execution command. It supports executing workflows defined in YAML, JSON, or XML format with optional overlay configuration.

Usage

actor-iac run -d /path/to/workflows -w main-workflow.yaml
actor-iac run --dir ./workflows --workflow deploy --threads 8
actor-iac run -d ./workflows -w deploy -i inventory.ini -g webservers

Since:

2.10.0

Author:

devteam@scivics-lab.com

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	RunCLI.WorkflowDisplay	Record for displaying workflow information.

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	askPass
private FileHandler	fileHandler	File handler for logging
private String	groupName
private File	inventoryFile
private String	limitHosts
private boolean	listWorkflows
private static final Logger	LOG
private File	logDbPath
private File	logFile
private String	logServer
private DistributedLogStore	logStore	Distributed log store (H2 database)
private boolean	noLog
private boolean	noLogDb
private File	overlayDir
private boolean	quiet
private File	renderToDir
private long	sessionId	Current session ID for distributed logging
private int	threads
private boolean	verbose
private final Map<String,File>	workflowCache	Cache of discovered workflow files: name -> File
private File	workflowDir
private String	workflowName

Constructor Summary

Constructors

Constructor	Description
RunCLI()

Method Summary

Modifier and Type	Method	Description
Integer	call()	Executes the workflow.
private void	configureLogLevel(boolean verbose)	Configures log level based on verbose flag.
private void	endSession(SessionStatus status)	Ends the current session with the given status.
private Integer	executeMain()	Main execution logic.
private Integer	executeWorkflow(File mainWorkflowFile)	Executes workflow with node-based execution.
private static String	extractNameFromJson(File file)	Extracts name field from JSON file.
private static String	extractNameFromYaml(File file)	Extracts name field from YAML file using simple line parsing.
private static String	extractWorkflowName(File file)	Extracts the workflow name from a YAML/JSON/XML file.
File	findWorkflowFile(String name)	Finds a workflow file by name.
private static String	getBaseName(String fileName)
private boolean	isWorkflowFile(Path path)	Checks if a file is a workflow file (YAML, JSON, or XML).
private com.scivicslab.pojoactor.core.ActionResult	loadMainWorkflow(NodeGroupIIAR nodeGroupActor, File workflowFile, File overlayDir)	Loads the main workflow file with optional overlay support.
private void	logToDb(String nodeId, LogLevel level, String message)	Logs a message to the distributed log store if available.
private void	printWorkflowList()
private String	promptForPassword(String prompt)	Prompts for a password from the console.
private void	registerWorkflowFile(Path path)	Registers a workflow file in the cache.
private static String	relativize(Path base, Path target)
private Integer	renderOverlayWorkflows()	Renders overlay-applied workflows to the specified directory.
private void	scanWorkflowDirectory(Path dir)	Scans the directory recursively for workflow files.
private static List<RunCLI.WorkflowDisplay>	scanWorkflowsForDisplay(File directory)
private void	setupFileLogging()	Sets up file logging with default or specified log file.
private void	setupLogDatabase()	Sets up H2 database for distributed logging.
private void	suppressConsoleOutput()	Suppresses all console output (stdout/stderr) for quiet mode.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOG

private static final Logger LOG

workflowDir

private File workflowDir

workflowName

private String workflowName

inventoryFile

private File inventoryFile

groupName

private String groupName

threads

private int threads

verbose

private boolean verbose

overlayDir

private File overlayDir

logFile

private File logFile

noLog

private boolean noLog

logDbPath

private File logDbPath

noLogDb

private boolean noLogDb

logServer

private String logServer

askPass

private boolean askPass

limitHosts

private String limitHosts

listWorkflows

private boolean listWorkflows

quiet

private boolean quiet

renderToDir

private File renderToDir

workflowCache

private final Map<String,File> workflowCache

Cache of discovered workflow files: name -> File

fileHandler

private FileHandler fileHandler

File handler for logging

logStore

private DistributedLogStore logStore

Distributed log store (H2 database)

sessionId

private long sessionId

Current session ID for distributed logging

Constructor Details

RunCLI

public RunCLI()

Method Details

call

public Integer call()

Executes the workflow.

Specified by:

call in interface Callable<Integer>

Returns:

exit code (0 for success, non-zero for failure)

suppressConsoleOutput

private void suppressConsoleOutput()

Suppresses all console output (stdout/stderr) for quiet mode.

setupLogDatabase

private void setupLogDatabase()
                       throws SQLException

Sets up H2 database for distributed logging.

Throws:

SQLException

setupFileLogging

private void setupFileLogging()
                       throws IOException

Sets up file logging with default or specified log file.

Throws:

IOException

configureLogLevel

private void configureLogLevel(boolean verbose)

Configures log level based on verbose flag.

executeMain

private Integer executeMain()

Main execution logic.

renderOverlayWorkflows

private Integer renderOverlayWorkflows()

Renders overlay-applied workflows to the specified directory.

executeWorkflow

private Integer executeWorkflow(File mainWorkflowFile)

Executes workflow with node-based execution.

logToDb

private void logToDb(String nodeId,
 LogLevel level,
 String message)

Logs a message to the distributed log store if available.

endSession

private void endSession(SessionStatus status)

Ends the current session with the given status.

promptForPassword

private String promptForPassword(String prompt)

Prompts for a password from the console.

scanWorkflowDirectory

private void scanWorkflowDirectory(Path dir)

Scans the directory recursively for workflow files.

isWorkflowFile

private boolean isWorkflowFile(Path path)

Checks if a file is a workflow file (YAML, JSON, or XML).

registerWorkflowFile

private void registerWorkflowFile(Path path)

Registers a workflow file in the cache.

findWorkflowFile

public File findWorkflowFile(String name)

Finds a workflow file by name.

loadMainWorkflow

private com.scivicslab.pojoactor.core.ActionResult loadMainWorkflow(NodeGroupIIAR nodeGroupActor,
 File workflowFile,
 File overlayDir)

Loads the main workflow file with optional overlay support.

printWorkflowList

private void printWorkflowList()

getBaseName

private static String getBaseName(String fileName)

relativize

private static String relativize(Path base,
 Path target)

scanWorkflowsForDisplay

private static List<RunCLI.WorkflowDisplay> scanWorkflowsForDisplay(File directory)

extractWorkflowName

private static String extractWorkflowName(File file)

Extracts the workflow name from a YAML/JSON/XML file.

extractNameFromYaml

private static String extractNameFromYaml(File file)

Extracts name field from YAML file using simple line parsing.

extractNameFromJson

private static String extractNameFromJson(File file)

Extracts name field from JSON file.