choria-mcorpc-support 2.21.1 → 2.23.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c7838c880fe400df6a4ba9cc315b99f8e53cf5ed
-  data.tar.gz: eb1af548ab4d9f79abf4accb138d6aa6becbe620
+  metadata.gz: 88cacd67cd1dd9b6289e5b896b920d3467e3a220
+  data.tar.gz: a7cf2dccf0ae9133abd81866296784fb6791b0e0
 SHA512:
-  metadata.gz: 8e1a3b75838b504abc5e16cd6a4e653ccc70eba34a5c2fb40ac39ff4d764f5960a4535b5e6eace6ab28fc75d839c7b57f9c67613d3886f3d37364ae873878df4
-  data.tar.gz: b0dadeac2193e6a043a00e6bc90592485db8bfdf35563787e024457b248c391b7fe5628510af7cb7d3a0ddf455359cf148968c43db0d3cd80b304ea3f97fd9b6
+  metadata.gz: 368859ec015b8605af21238d7c6d93aa4472c728948d61dcf07095a7728509f4fcdafb2d5867aef0b941a09572ce7ad43ec4ce54a91cde8e6de26fc48a888b9c
+  data.tar.gz: d1ce8dbd24f8f1a24163e4e5c69d9514d98372885bf14b6f3efd59b824c842d5ed2efee50df7551eec577e0dd15cfc7da36f66f732b6fd35ab74ca7f30f8d9cc

data/lib/mcollective.rb

@@ -40,7 +40,6 @@ module MCollective
   require "mcollective/facts"
   require "mcollective/logger"
   require "mcollective/log"
-  require "mcollective/matcher"
   require "mcollective/message"
   require "mcollective/optionparser"
   require "mcollective/generators"
@@ -54,7 +53,7 @@ module MCollective
   require "mcollective/util"
   require "mcollective/validator"
 
-  VERSION = "2.21.1".freeze
+  VERSION = "2.23.1".freeze
 
   def self.version
     VERSION

data/lib/mcollective/agent/bolt_tasks.ddl

@@ -0,0 +1,253 @@
+metadata :name => "bolt_tasks",
+         :description => "Downloads and runs Puppet Tasks",
+         :author => "R.I.Pienaar <rip@devco.net>",
+         :license => "Apache-2.0",
+         :version => "0.19.0",
+         :url => "https://choria.io",
+         :timeout => 60
+
+requires :mcollective => "2.11.0"
+
+action "download", :description => "Downloads a Puppet Task into a local cache" do
+  input :task,
+        :prompt      => "Task Name",
+        :description => "The name of a task, example apache or apache::reload",
+        :type        => :string,
+        :validation  => :bolt_task_name,
+        :optional    => false,
+        :maxlength   => 100
+
+  input :environment,
+        :prompt      => "Puppet Environment",
+        :description => "The environment the task should be fetched from",
+        :type        => :string,
+        :validation  => '\A[a-z][a-z0-9_]*\z',
+        :optional    => false,
+        :default     => "production",
+        :maxlength   => 100
+
+  input :files,
+        :prompt      => "Task Files Specification",
+        :description => "The specification of files to download according to v3 api in JSON format",
+        :type        => :string,
+        :optional    => false,
+        :validation  => '\A\[.+\]\z',
+        :maxlength   => 4000
+
+  output :downloads,
+         :description => "The number of files downloaded",
+         :display_as  => "Files Downloaded"
+
+  summarize do
+    aggregate summary(:downloads)
+  end
+end
+
+action "run_and_wait", :description => "Runs a Puppet Task that was previously downloaded, wait for it to finish" do
+  input :task,
+        :prompt      => "Task Name",
+        :description => "The name of a task, example apache or apache::reload",
+        :type        => :string,
+        :validation  => :bolt_task_name,
+        :optional    => false,
+        :maxlength   => 100
+
+  input :input_method,
+        :prompt      => "Input Method",
+        :description => "The input method to use",
+        :type        => :list,
+        :list        => ["powershell", "stdin", "environment", "both"],
+        :optional    => true,
+        :default     => nil
+
+  input :files,
+        :prompt      => "Task Files Specification",
+        :description => "The specification of files to download according to v3 api in JSON format",
+        :type        => :string,
+        :optional    => false,
+        :validation  => '\A\[.+\]\z',
+        :maxlength   => 4000
+
+  input :input,
+        :prompt      => "Task Input",
+        :description => "JSON String containing input variables",
+        :type        => :string,
+        :validation  => '^.+$',
+        :optional    => false,
+        :default     => "{}",
+        :maxlength   => 102400
+
+  input :run_as,
+        :prompt      => "Run As",
+        :description => "User to run the task as",
+        :type        => :string,
+        :validation  => ".+",
+        :optional    => true,
+        :default     => nil,
+        :maxlength   => 32
+
+  output :task_id,
+         :description => "The ID the task was created with",
+         :display_as  => "Task ID",
+         :default     => nil
+
+  output :task,
+         :description => "Task name",
+         :display_as  => "Task",
+         :default     => nil
+
+  output :callerid,
+         :description => "User who initiated the task",
+         :display_as  => "User",
+         :default     => nil
+
+  output :exitcode,
+         :description => "Task exit code",
+         :display_as  => "Exit Code",
+         :default     => 127
+
+  output :stdout,
+         :description => "Standard Output from the command",
+         :display_as  => "STDOUT",
+         :default     => nil
+
+  output :stderr,
+         :description => "Standard Error from the command",
+         :display_as  => "STDERR",
+         :default     => nil
+
+  output :completed,
+         :description => "Did the task complete",
+         :display_as  => "Completed",
+         :default     => false
+
+  output :runtime,
+         :description => "Time taken to run the command",
+         :display_as  => "Runtime",
+         :default     => 0
+
+  output :start_time,
+         :description => "When the task was started in UTC time",
+         :display_as  => "Start Time"
+
+  summarize do
+    aggregate average(:runtime)
+    aggregate summary(:task)
+    aggregate summary(:callerid)
+    aggregate summary(:exitcode)
+    aggregate summary(:completed)
+    aggregate summary(:task_id)
+  end
+end
+
+action "run_no_wait", :description => "Runs a Puppet Task that was previously downloaded do not wait for it to finish" do
+  input :task,
+        :prompt      => "Task Name",
+        :description => "The name of a task, example apache or apache::reload",
+        :type        => :string,
+        :validation  => :bolt_task_name,
+        :optional    => false,
+        :maxlength   => 100
+
+  input :input_method,
+        :prompt      => "Input Method",
+        :description => "The input method to use",
+        :type        => :list,
+        :list        => ["powershell", "stdin", "environment", "both"],
+        :optional    => true,
+        :default     => nil
+
+  input :files,
+        :prompt      => "Task Files Specification",
+        :description => "The specification of files to download according to v3 api in JSON format",
+        :type        => :string,
+        :optional    => false,
+        :validation  => '\A\[.+\]\z',
+        :maxlength   => 4000
+
+  input :input,
+        :prompt      => "Task Input",
+        :description => "JSON String containing input variables",
+        :type        => :string,
+        :validation  => '^.+$',
+        :optional    => true,
+        :default     => "{}",
+        :maxlength   => 102400
+
+  input :run_as,
+        :prompt      => "Run As",
+        :description => "User to run the task as",
+        :type        => :string,
+        :validation  => ".+",
+        :optional    => true,
+        :default     => nil,
+        :maxlength   => 32
+
+  output :task_id,
+         :description => "The ID the task was created with",
+         :display_as  => "Task ID",
+         :default     => nil
+
+  summarize do
+    aggregate summary(:task_id)
+  end
+end
+
+action "task_status", :description => "Request the status of a previously ran task" do
+  display :always
+
+  input :task_id,
+        :prompt      => "Task ID",
+        :description => "The Task ID to retrieve",
+        :type        => :string,
+        :validation  => '^[a-z,0-9]{32}$',
+        :optional    => false,
+        :maxlength   => 32
+
+  output :task,
+         :description => "Task name",
+         :display_as  => "Task",
+         :default     => nil
+
+  output :callerid,
+         :description => "User who initiated the task",
+         :display_as  => "User",
+         :default     => nil
+
+  output :exitcode,
+         :description => "Task exit code",
+         :display_as  => "Exit Code",
+         :default     => 127
+
+  output :stdout,
+         :description => "Standard Output from the command",
+         :display_as  => "STDOUT",
+         :default     => nil
+
+  output :stderr,
+         :description => "Standard Error from the command",
+         :display_as  => "STDERR",
+         :default     => nil
+
+  output :completed,
+         :description => "Did the task complete",
+         :display_as  => "Completed",
+         :default     => false
+
+  output :runtime,
+         :description => "Time taken to run the command",
+         :display_as  => "Runtime",
+         :default     => 0
+
+  output :start_time,
+         :description => "When the task was started in UTC time",
+         :display_as  => "Start Time"
+
+  summarize do
+    aggregate average(:runtime)
+    aggregate summary(:task)
+    aggregate summary(:callerid)
+    aggregate summary(:exitcode)
+    aggregate summary(:completed)
+  end
+end

data/lib/mcollective/agent/bolt_tasks.json

@@ -0,0 +1,365 @@
+{
+  "$schema": "https://choria.io/schemas/mcorpc/ddl/v1/agent.json",
+  "metadata": {
+    "name": "bolt_tasks",
+    "description": "Downloads and runs Puppet Tasks",
+    "author": "R.I.Pienaar <rip@devco.net>",
+    "license": "Apache-2.0",
+    "version": "0.19.0",
+    "url": "https://choria.io",
+    "timeout": 60
+  },
+  "actions": [
+    {
+      "action": "download",
+      "input": {
+        "task": {
+          "prompt": "Task Name",
+          "description": "The name of a task, example apache or apache::reload",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "bolt_task_name",
+          "maxlength": 100
+        },
+        "environment": {
+          "prompt": "Puppet Environment",
+          "description": "The environment the task should be fetched from",
+          "type": "string",
+          "default": "production",
+          "optional": false,
+          "validation": "\\A[a-z][a-z0-9_]*\\z",
+          "maxlength": 100
+        },
+        "files": {
+          "prompt": "Task Files Specification",
+          "description": "The specification of files to download according to v3 api in JSON format",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "\\A\\[.+\\]\\z",
+          "maxlength": 4000
+        }
+      },
+      "output": {
+        "downloads": {
+          "description": "The number of files downloaded",
+          "display_as": "Files Downloaded",
+          "default": null
+        }
+      },
+      "display": "failed",
+      "description": "Downloads a Puppet Task into a local cache",
+      "aggregate": [
+        {
+          "function": "summary",
+          "args": [
+            "downloads"
+          ]
+        }
+      ]
+    },
+    {
+      "action": "run_and_wait",
+      "input": {
+        "task": {
+          "prompt": "Task Name",
+          "description": "The name of a task, example apache or apache::reload",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "bolt_task_name",
+          "maxlength": 100
+        },
+        "input_method": {
+          "prompt": "Input Method",
+          "description": "The input method to use",
+          "type": "list",
+          "default": null,
+          "optional": true,
+          "list": [
+            "powershell",
+            "stdin",
+            "environment",
+            "both"
+          ]
+        },
+        "files": {
+          "prompt": "Task Files Specification",
+          "description": "The specification of files to download according to v3 api in JSON format",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "\\A\\[.+\\]\\z",
+          "maxlength": 4000
+        },
+        "input": {
+          "prompt": "Task Input",
+          "description": "JSON String containing input variables",
+          "type": "string",
+          "default": "{}",
+          "optional": false,
+          "validation": "^.+$",
+          "maxlength": 102400
+        },
+        "run_as": {
+          "prompt": "Run As",
+          "description": "User to run the task as",
+          "type": "string",
+          "default": null,
+          "optional": true,
+          "validation": ".+",
+          "maxlength": 32
+        }
+      },
+      "output": {
+        "task_id": {
+          "description": "The ID the task was created with",
+          "display_as": "Task ID",
+          "default": null
+        },
+        "task": {
+          "description": "Task name",
+          "display_as": "Task",
+          "default": null
+        },
+        "callerid": {
+          "description": "User who initiated the task",
+          "display_as": "User",
+          "default": null
+        },
+        "exitcode": {
+          "description": "Task exit code",
+          "display_as": "Exit Code",
+          "default": 127
+        },
+        "stdout": {
+          "description": "Standard Output from the command",
+          "display_as": "STDOUT",
+          "default": null
+        },
+        "stderr": {
+          "description": "Standard Error from the command",
+          "display_as": "STDERR",
+          "default": null
+        },
+        "completed": {
+          "description": "Did the task complete",
+          "display_as": "Completed",
+          "default": false
+        },
+        "runtime": {
+          "description": "Time taken to run the command",
+          "display_as": "Runtime",
+          "default": 0
+        },
+        "start_time": {
+          "description": "When the task was started in UTC time",
+          "display_as": "Start Time",
+          "default": null
+        }
+      },
+      "display": "failed",
+      "description": "Runs a Puppet Task that was previously downloaded, wait for it to finish",
+      "aggregate": [
+        {
+          "function": "average",
+          "args": [
+            "runtime"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "task"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "callerid"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "exitcode"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "completed"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "task_id"
+          ]
+        }
+      ]
+    },
+    {
+      "action": "run_no_wait",
+      "input": {
+        "task": {
+          "prompt": "Task Name",
+          "description": "The name of a task, example apache or apache::reload",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "bolt_task_name",
+          "maxlength": 100
+        },
+        "input_method": {
+          "prompt": "Input Method",
+          "description": "The input method to use",
+          "type": "list",
+          "default": null,
+          "optional": true,
+          "list": [
+            "powershell",
+            "stdin",
+            "environment",
+            "both"
+          ]
+        },
+        "files": {
+          "prompt": "Task Files Specification",
+          "description": "The specification of files to download according to v3 api in JSON format",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "\\A\\[.+\\]\\z",
+          "maxlength": 4000
+        },
+        "input": {
+          "prompt": "Task Input",
+          "description": "JSON String containing input variables",
+          "type": "string",
+          "default": "{}",
+          "optional": true,
+          "validation": "^.+$",
+          "maxlength": 102400
+        },
+        "run_as": {
+          "prompt": "Run As",
+          "description": "User to run the task as",
+          "type": "string",
+          "default": null,
+          "optional": true,
+          "validation": ".+",
+          "maxlength": 32
+        }
+      },
+      "output": {
+        "task_id": {
+          "description": "The ID the task was created with",
+          "display_as": "Task ID",
+          "default": null
+        }
+      },
+      "display": "failed",
+      "description": "Runs a Puppet Task that was previously downloaded do not wait for it to finish",
+      "aggregate": [
+        {
+          "function": "summary",
+          "args": [
+            "task_id"
+          ]
+        }
+      ]
+    },
+    {
+      "action": "task_status",
+      "input": {
+        "task_id": {
+          "prompt": "Task ID",
+          "description": "The Task ID to retrieve",
+          "type": "string",
+          "default": null,
+          "optional": false,
+          "validation": "^[a-z,0-9]{32}$",
+          "maxlength": 32
+        }
+      },
+      "output": {
+        "task": {
+          "description": "Task name",
+          "display_as": "Task",
+          "default": null
+        },
+        "callerid": {
+          "description": "User who initiated the task",
+          "display_as": "User",
+          "default": null
+        },
+        "exitcode": {
+          "description": "Task exit code",
+          "display_as": "Exit Code",
+          "default": 127
+        },
+        "stdout": {
+          "description": "Standard Output from the command",
+          "display_as": "STDOUT",
+          "default": null
+        },
+        "stderr": {
+          "description": "Standard Error from the command",
+          "display_as": "STDERR",
+          "default": null
+        },
+        "completed": {
+          "description": "Did the task complete",
+          "display_as": "Completed",
+          "default": false
+        },
+        "runtime": {
+          "description": "Time taken to run the command",
+          "display_as": "Runtime",
+          "default": 0
+        },
+        "start_time": {
+          "description": "When the task was started in UTC time",
+          "display_as": "Start Time",
+          "default": null
+        }
+      },
+      "display": "always",
+      "description": "Request the status of a previously ran task",
+      "aggregate": [
+        {
+          "function": "average",
+          "args": [
+            "runtime"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "task"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "callerid"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "exitcode"
+          ]
+        },
+        {
+          "function": "summary",
+          "args": [
+            "completed"
+          ]
+        }
+      ]
+    }
+  ]
+}