# REQUIRED Group name: e.g., /v1/pal/run/deploy deploy: - # REQUIRED Action name: e.g., /v1/pal/run/deploy/app action: app # Description of action desc: Deploy app # Auth header: e.g., curl -H'X-Pal-Auth: secret_string_here' auth_header: X-Pal-Auth secret_string_here # Show command output (default: false) output: true # Set a default input if not set at request time input: # Run in background (default: false) background: false # Run concurrently (default: false) concurrent: true # Run in podman/docker container (default: null) container: # Run as sudo if not running pal with root or docker group perms sudo: false # Container image to use image: alpine:latest # Run options options: --security-opt=no-new-privileges:true --cap-drop=ALL --net=none # Run command inside podman container not using os/exec and instead use podman socket (default: null) image: alpine:latest # Set action to run multiple cron style schedules crons: - "*****" # Set command timeout in seconds (default: 600 seconds/10 mins) timeout: 600 # Set custom HTTP Response Headers headers: - header: value: # Validate input provided to run, valid options can be found here https://github.com/go-playground/validator?tab=readme-ov-file#baked-in-validations input_validate: required # Register / Put a key and value in the DB register: key: "$PAL_GROUP-$PAL_ACTION" value: "input=$PAL_INPUT status=$PAL_STATUS output=$PAL_OUTPUT" secret: false on_error: # Send notification when an error occurs using built-in vars $PAL_GROUP $PAL_ACTION $PAL_INPUT $PAL_OUTPUT notification: "deploy failed group=$PAL_GROUP action=$PAL_ACTION input=$PAL_INPUT status=$PAL_STATUS output=$PAL_OUTPUT" # Try cmd number of times retries: 1 # Pause in seconds before running the next retry retry_interval: 10 # Trigger webhook HTTP request with the name defined in the pal.yml file webhooks: - webhook_name_defined_in_pal.yml # Run action(s) on_error run: - group: group_name action: action_name # Input for run action on_error input: $PAL_OUTPUT on_success: # Send notification when no errors occurs using built-in vars $PAL_GROUP $PAL_ACTION $PAL_INPUT $PAL_OUTPUT notification: "deploy failed group=$PAL_GROUP action=$PAL_ACTION input=$PAL_INPUT status=$PAL_STATUS output=$PAL_OUTPUT" # Trigger webhook HTTP request with the name defined in the pal.yml file webhooks: - webhook_name_defined_in_pal.yml # Run action(s) when no errors occurs run: - group: group_name action: action_name # Input for run action when no errors occurs input: $PAL_OUTPUT # Command prefix can be anything e.g. python -c, pwsh -Command, etc. Default is /bin/sh -c cmd_prefix: /bin/sh -c # REQUIRED Command or script (use $PAL_INPUT for variables) cmd: echo "GROUP=$PAL_GROUP ACTION=$PAL_ACTION INPUT=$PAL_INPUT REQUEST=$PAL_REQUEST UPLOAD_DIR=$PAL_UPLOAD_DIR"

Usage: pal [options] <args> -c,	Set configuration file path location, default is ./pal.yml -d,	Set action definitions file directory location, default is ./actions Example: pal -c ./pal.yml -d ./actions

monitor: - action: system desc: Get primary system stats for monitoring auth_header: X-Monitor-System q1w2e3r4t5 output: true cmd: |  echo '|===/ DOCKER STATS \===|'  command -v docker 1>/dev/null && sudo docker stats --no-stream; echo   echo '|===/ FREE MEMORY \===|'  free -hbvtw; echo   echo '|===/ DISK SPACE \===|'  df -hT; echo   echo '|===/ TOP CPU \===|'  ps -eo pid,ppid,cmd,%mem,%cpu --sort=-%cpu | head; echo   echo '|===/ TOP MEMORY \===|'  ps -eo pid,ppid,cmd,%mem,%cpu --sort=-%mem | head; echo   echo '|===/ TOP OPEN FILES \===|'  lsof 2>/dev/null | cut -d" " -f1 | sort | uniq -c | sort -r -n | head; echo   echo '|===/ UPTIME AND LOAD \===|'  uptime