Activity

The qaskx-cli run activity command is used to run activities defined in the rediOps devops.json file. If a rediOps file is not specified then the command will try and find the project .well-known directory and locate the rediOps file in there.

The command help is shown below.

Usage: qaskx-cli run activity -a=<activity> [-d=<devops file>] [--tag=<name>] [--platform=<platform>] [-o=<output file>] [--overwrite][-v | --vv | --vvv | --silent] [-c=<conf file>] [--colourCLI] [--offline] [--env=<environment file>]


The run activity is the commad to execute defined activity in the rediOps 
definition file (devops.json).

For more details see the documentation at https://docs.qaskx.one/qaskx-cli/cmd/run/activity/ .
                    
Options:            
  -d, --devops      rediOps (devops.json) file path
  -a, --activity    Definition activity (e.g. BUILD,TEST,INSTALL)
      --tag         Definition identifier (default "*ANY")
      --platform    Platform for execution (default "windows")
  -o, --output      Output file name (default "CONSOLE")
      --overwrite   Overwrite existing output
  -v, --verbose     Verbose logging
      --vv          Verbose logging level 3
      --vvv         Verbose logging level 5
      --silent      Silent running
      --colourCLI   Colour terminal and command line (env $QASKX_COLOUR_CLI)
  -c, --conf        Configuration file (env $QASKX_CONFIG_FILE)
      --offline     Offline mode (env $QASKX_OFFLINE)
      --env         Environment file to use (default ".env")

Details

While the run activity command is simple to call, the actual setup of the job definition needs understanding. The activity does need to be specified on the rediOps file, and you should ensure it can be executed as expected.

As the rediOps file is essential to running activties, either it must be specified or the command needs to find one in a well known locations.

The run activity can only detect process exits codes and cannot process messages issued by the activity execution. All matching activities are processed regardless if a prior item failed.

As the run activiity does know the current platform then it will only execute activities related to platform based on the other filters if supplied. A special value of *any for a platform entry in rediOps will also be executed.

The –tag argument is used to supply an indetifier if you require filtering on the activity where there are multiples for the same activity and platform.