simpleapplication: new sketch; simpleapplication-deploy: new sketch

Author: tzz

sketches/applications/newrelic/README.md

@@ -5,7 +5,7 @@ Tags: cfdc, newrelic, enterprise_compatible
 Authors: Ted Zlatanov <[email protected]>
 
 ## Description
-Sketch for installing, configuring, and starting New Relic.
+Sketch for installing, configuring, and starting New Relic monitoring plugins (only server monitoring supported at the moment).
 
 ## Dependencies
 CFEngine::dclib, CFEngine::stdlib
@@ -16,9 +16,9 @@ CFEngine::dclib, CFEngine::stdlib
 
 * parameter _metadata_ *metadata* (default: none, description: none)
 
-* parameter _string_ *license_key* (default: `"not valid"`, description: none)
+* parameter _string_ *license_key* (default: `"not valid"`, description: New Relic license key)
 
-* parameter _boolean_ *ensure* (default: `true`, description: Ensure service is running.  Set to false to stop service.)
+* parameter _boolean_ *ensure* (default: `true`, description: Ensure server monitoring service is running.  Set to false to stop service.)
 
 * parameter _boolean_ *install* (default: `true`, description: Install packages.  Set to false to remove them.)
 

sketches/cfsketches.json

@@ -19,6 +19,8 @@ databases/mysql_install_simple	{"api":{"simple":[{"name":"runenv","type":"enviro
 databases/postgresql_install	{"api":{"ensure":[{"name":"runenv","type":"environment"},{"name":"mymetadata","type":"metadata"},{"name":"server","type":"boolean"},{"default":false,"name":"purge","type":"boolean"},{"default":[],"name":"extra_packages","type":"list"},{"default":false,"name":"use_only_extra_packages","type":"boolean"},{"name":"installed","type":"return"},{"name":"running","type":"return"}]},"interface":["main.cf"],"manifest":{"README.md":{"documentation":true},"main.cf":{"desc":"main file"},"params/demo_client.json":{"comment":"Install PostgreSQL client"},"params/demo_server.json":{"comment":"Install PostgreSQL server"}},"metadata":{"authors":["Nakarin Phooripoom <[email protected]>","Ted Zlatanov <[email protected]>"],"depends":{"CFEngine::dclib":{},"CFEngine::dclib::3.5.0":{},"CFEngine::stdlib":{"version":105},"cfengine":{"version":"3.5.0"},"os":["linux"]},"description":"Install and enable the PostgreSQL database engine","license":"MIT","name":"Database::Install::PostgreSQL","tags":["cfdc"],"version":1.1},"namespace":"cfdc_db_postgresql"}
 databases/postgresql_install_simple	{"api":{"simple":[{"name":"runenv","type":"environment"},{"name":"mymetadata","type":"metadata"},{"name":"installed","type":"return"},{"name":"running","type":"return"}]},"interface":["main.cf"],"manifest":{"README.md":{"documentation":true},"main.cf":{"desc":"main file"},"params/demo_client.json":{"comment":"Install PostgreSQL client"},"params/demo_server.json":{"comment":"Install PostgreSQL server"}},"metadata":{"authors":["Nakarin Phooripoom <[email protected]>","Ted Zlatanov <[email protected]>"],"depends":{"CFEngine::dclib":{},"CFEngine::dclib::3.5.0":{},"CFEngine::stdlib":{"version":105},"cfengine":{"version":"3.5.0"},"os":[{"redhat_6":"Red Hat 6","ubuntu_12_4":"Ubuntu 12.4"}]},"description":"Install and enable the PostgreSQL database engine","license":"MIT","name":"Database::Install::PostgreSQL::Simple","tags":["cfdc","database","postgresql","enterprise_compatible"],"version":1.1},"namespace":"cfdc_db_postgresql"}
 databases/sqlite_install	{"api":{"ensure":[{"name":"runenv","type":"environment"},{"name":"mymetadata","type":"metadata"},{"default":false,"name":"purge","type":"boolean"},{"default":[],"name":"extra_packages","type":"list"},{"default":false,"name":"use_only_extra_packages","type":"boolean"},{"name":"installed","type":"return"}]},"interface":["main.cf"],"manifest":{"README.md":{"documentation":true},"main.cf":{"desc":"main file"},"params/demo.json":{"comment":"Install SQLite"}},"metadata":{"authors":["Nakarin Phooripoom <[email protected]>","Ted Zlatanov <[email protected]>"],"depends":{"CFEngine::dclib":{},"CFEngine::dclib::3.5.0":{},"CFEngine::stdlib":{"version":105},"cfengine":{"version":"3.5.0"},"os":["linux"]},"description":"Install and enable the SQLite database engine","license":"MIT","name":"Database::Install::SQLite","tags":["cfdc"],"version":1.1},"namespace":"cfdc_db_sqlite"}
+demo/simpleapplication-deploy	{"api":{"deploy":[{"name":"runenv","type":"environment"},{"name":"mymetadata","type":"metadata"},{"description":"Number of web workers","name":"workers","type":"string"},{"default":true,"description":"Enable this deployment? (if disabled, destroy the VMs)","name":"enable","type":"boolean"}]},"interface":["deploy.cf"],"manifest":{"README.md":{"documentation":true},"deploy.cf":{"desc":"main file"},"params/demo.json":{"desc":"example parameters"}},"metadata":{"authors":["Ted Zlatanov <[email protected]>"],"depends":{"Cloud::Services::VMWare":{},"Demo::SimpleApplication":{},"cfengine":{"version":"3.5.0"},"os":[{"linux":"All Linux distributions"}]},"description":"Deploy a full infrastructure for a simple application","license":"MIT","name":"Demo::SimpleApplication::Deploy","tags":["vmware","ensure","deploy","demo","sketchify_generated","enterprise_compatible"],"version":"1.0"},"namespace":"cfdc_simpleapplication"}
+demo/simpleapplication	{"api":{"configure":[{"name":"runenv","type":"environment"},{"name":"metadata","type":"metadata"}]},"interface":["balance.cf"],"manifest":{"README.md":{"documentation":true},"balance.cf":{"desc":"main file"}},"metadata":{"authors":["Nick Anderson <[email protected]>","Ted Zlatanov <[email protected]>","Diego Zamboni <[email protected]>"],"depends":{"cfengine":{"version":"3.5.0"},"os":[{"centos":"CentOS Linux"}]},"description":"Configures hosts for a simple application consisting of webworkers (Apache + simple static content), haworkers (haproxy dynamically configured to use the existing webworkers) and mcworkers (memcached)","license":"MIT","name":"Demo::SimpleApplication","tags":["vmworld2013","demo","sketchify_generated","enterprise_compatible"],"version":"1.0"},"namespace":"cfdc_simpleapplication"}
 libraries/blueprint	{"api":{},"interface":["library.cf"],"manifest":{"README.md":{"documentation":true},"library.cf":{"desc":"Blueprint to Design Center glue library"},"test.pl":{"test":true}},"metadata":{"authors":["CFEngine AS"],"depends":{"cfengine":{"version":"3.5.0"}},"description":"Library to connect Blueprint sketches with Design Center","license":"MIT","name":"CFEngine::Blueprint","tags":["cfdc","blueprint"],"version":"1.0.0"}}
 libraries/copbl-3.5.0	{"api":{},"interface":["stdlib-350.cf"],"manifest":{"README.md":{"documentation":true},"stdlib-350.cf":{"desc":"COPBL"},"test.pl":{"test":true}},"metadata":{"authors":["CFEngine AS"],"depends":{"cfengine":{"version":"3.5.0"}},"description":"The portions of the CFEngine standard library (also known as COPBL) that are only compatible with 3.5.0 and higher","license":"LGPL","name":"CFEngine::stdlib::3.5.0","tags":["cfdc"],"version":110},"namespace":null}
 libraries/copbl	{"api":{},"interface":["cfengine_stdlib.cf"],"manifest":{"README.md":{"documentation":true},"cfengine_stdlib.cf":{"desc":"COPBL"},"test.pl":{"test":true}},"metadata":{"authors":["CFEngine AS","ahdinosaur"],"depends":{"cfengine":{"version":"3.4.0"}},"description":"The portions of the CFEngine standard library (also known as COPBL) that are compatible with 3.4.0 releases","license":"LGPL","name":"CFEngine::stdlib","tags":["cfdc"],"version":111},"namespace":null}

sketches/cloud/autobalance/main.cf

@@ -53,16 +53,16 @@ bundle agent autobalance(runenv, metadata, url, collector, thresholds, given_ec2
                                                                   $(common_options)),
       ifvarclass => "default:autobalance_$(threshold_names)";
 
-      "ensure VMWare" usebundle => cfdc_cloud_openstack:ensure($(runenv),
-                                                               "",
-                                                               "$($(thresholds)[$(threshold_names)][vmware])",
-                                                               nth("vmware_options", 0),
-                                                               nth("vmware_options", 1),
-                                                               nth("vmware_options", 2),
-                                                               nth("vmware_options", 3),
-                                                               nth("vmware_options", 4),
-                                                               nth("vmware_options", 5),
-                                                               $(common_options)),
+      "ensure VMWare" usebundle => cfdc_cloud_vmware:ensure($(runenv),
+                                                            "",
+                                                            "$($(thresholds)[$(threshold_names)][vmware])",
+                                                            nth("vmware_options", 0),
+                                                            nth("vmware_options", 1),
+                                                            nth("vmware_options", 2),
+                                                            nth("vmware_options", 3),
+                                                            nth("vmware_options", 4),
+                                                            nth("vmware_options", 5),
+                                                            $(common_options)),
       ifvarclass => "default:autobalance_$(threshold_names)";
 
   reports:

sketches/cloud/vmware/README.md

@@ -1,11 +1,11 @@
 # Cloud::Services::VMWare version 1
 
 License: MIT
-Tags: cfdc, cloud, vmware, vcli
+Tags: cfdc, cloud, vmware, vcli, enterprise_compatible
 Authors: Ted Zlatanov <[email protected]>
 
 ## Description
-Manage VMWare services through the vSphere Perl SDK
+Manage VMWare services through the vSphere Perl SDK and other external tools.
 
 ## Dependencies
 CFEngine::dclib, CFEngine::dclib::3.5.0, CFEngine::stdlib
@@ -16,11 +16,11 @@ CFEngine::dclib, CFEngine::dclib::3.5.0, CFEngine::stdlib
 
 * parameter _metadata_ *mymetadata* (default: none, description: none)
 
-* parameter _string_ *count* (default: none, description: none)
+* parameter _string_ *count* (default: none, description: Number of VMs you want to ensure are running.)
 
-* parameter _string_ *class* (default: none, description: Logical class to assign to machines)
+* parameter _string_ *class* (default: none, description: Logical class to assign to the created virtual machines)
 
-* parameter _boolean_ *install_cfengine* (default: none, description: none)
+* parameter _boolean_ *install_cfengine* (default: none, description: Whether CFEngine should be installed on the new VMs)
 
 * parameter _string_ *hub* (default: none, description: Hub from which the instances should bootstrap)
 
@@ -30,7 +30,7 @@ CFEngine::dclib, CFEngine::dclib::3.5.0, CFEngine::stdlib
 
 * parameter _string_ *count_command* (default: none, description: Command to count VMs.  Parameters: CLASS)
 
-* parameter _array_ *options* (default: none, description: Options)
+* parameter _array_ *options* (default: `{}`, description: Options)
 
 * returns _return_ *instance_count* (default: none, description: none)
 

sketches/demo/simpleapplication-deploy/README.md

@@ -0,0 +1,26 @@
+# Demo::SimpleApplication::Deploy version 1.0
+
+License: MIT
+Tags: vmware, ensure, deploy, demo, sketchify_generated, enterprise_compatible
+Authors: Ted Zlatanov <[email protected]>
+
+## Description
+Deploy a full infrastructure for a simple application
+
+## Dependencies
+Cloud::Services::VMWare, Demo::SimpleApplication
+
+## API
+### bundle: deploy
+* parameter _environment_ *runenv* (default: none, description: none)
+
+* parameter _metadata_ *mymetadata* (default: none, description: none)
+
+* parameter _string_ *workers* (default: none, description: Number of web workers)
+
+* parameter _boolean_ *enable* (default: `true`, description: Enable this deployment? (if disabled, destroy the VMs))
+
+
+## SAMPLE USAGE
+See `test.cf` or the example parameters provided
+

sketches/demo/simpleapplication-deploy/deploy.cf

@@ -0,0 +1,88 @@
+body file control
+{
+      namespace => "cfdc_simpleapplication";
+}
+
+bundle agent deploy(runenv, metadata, workers, enable)
+{
+
+  classes:
+      "$(vars)" expression => "default:runenv_$(runenv)_$(vars)";
+      "not_$(vars)" expression => "!default:runenv_$(runenv)_$(vars)";
+
+      "enable" expression => strcmp("$(enable)", "1");
+
+  vars:
+      "activation_id" string => canonify("$(this.bundle)_$($(metadata)[activation][identifier])_$($(metadata)[activation][timestamp])");
+
+      "vars" slist => { "@(default:$(runenv).env_vars)" };
+      "$(vars)" string => "$(default:$(runenv).$(vars))";
+
+      "singles" slist => { "haworker", "mcworker" };
+
+  classes:
+      "$(type)" expression => "any";
+
+  vars:
+      "host_marker" string => ".removal.marker";
+      "type" string => ifelse("am_policy_hub", "hub",
+                              classmatch("webworker.*"), "webworker",
+                              classmatch("mcworker.*"), "mcworker",
+                              classmatch("haworker.*"), "haworker",
+                              "unknown");
+
+  methods:
+    any::
+      "deploy" usebundle => cfdc_simpleapplication:configure(runenv, ""),
+      handle => "$(activation_id)_simpleapplication_deploy_configure";
+
+    hub.enable::
+      "ensure webworkers" usebundle => cfdc_cloud_vmware:ensure($(runenv),
+                                                                "",
+                                                                $(workers),
+                                                                "webworker",
+                                                                "1",
+                                                                $(sys.ipv4),
+                                                                "/var/cfengine/scripts/start_vm.sh",
+                                                                "/var/cfengine/scripts/stop_vm.sh",
+                                                                "/var/cfengine/scripts/count_vm.sh",
+                                                                "return"),
+      handle => "$(activation_id)_simpleapplication_ensure_webworkers";
+
+      "ensure singles" usebundle => cfdc_cloud_vmware:ensure($(runenv),
+                                                             "",
+                                                             "1",
+                                                             $(singles),
+                                                             "1",
+                                                             $(sys.ipv4),
+                                                             "/var/cfengine/scripts/start_vm.sh",
+                                                             "/var/cfengine/scripts/stop_vm.sh",
+                                                             "/var/cfengine/scripts/count_vm.sh",
+                                                             "return"),
+      handle => "$(activation_id)_simpleapplication_ensure_singles";
+
+    hub.!enable::
+      "ensure no webworkers" usebundle => cfdc_cloud_vmware:ensure($(runenv),
+                                                                "",
+                                                                "0",
+                                                                "webworker",
+                                                                "1",
+                                                                $(sys.ipv4),
+                                                                "/var/cfengine/scripts/start_vm.sh",
+                                                                "/var/cfengine/scripts/stop_vm.sh",
+                                                                "/var/cfengine/scripts/count_vm.sh",
+                                                                "return"),
+      handle => "$(activation_id)_simpleapplication_disable_webworkers";
+
+      "ensure no singles" usebundle => cfdc_cloud_vmware:ensure($(runenv),
+                                                             "",
+                                                             "0",
+                                                             $(singles),
+                                                             "1",
+                                                             $(sys.ipv4),
+                                                             "/var/cfengine/scripts/start_vm.sh",
+                                                             "/var/cfengine/scripts/stop_vm.sh",
+                                                             "/var/cfengine/scripts/count_vm.sh",
+                                                             "return"),
+      handle => "$(activation_id)_simpleapplication_disable_singles";
+}

sketches/demo/simpleapplication-deploy/params/demo.json

@@ -0,0 +1,6 @@
+{
+    "Demo::SimpleApplication::Deploy":
+    {
+        workers: 3
+    }
+}

sketches/demo/simpleapplication-deploy/sketch.json

@@ -0,0 +1,52 @@
+{
+   "api" : {
+      "deploy" : [
+          { type: "environment", name: "runenv", },
+          { type: "metadata", name: "mymetadata", },
+          {
+              "description" : "Number of web workers",
+              "name" : "workers",
+              "type" : "string"
+          },
+          {
+              "description" : "Enable this deployment? (if disabled, destroy the VMs)",
+              "name" : "enable",
+              "type" : "boolean",
+              "default": true
+          }
+      ]
+   },
+   "interface" : [
+      "deploy.cf"
+   ],
+   "manifest" : {
+       "params/demo.json": { desc: "example parameters" },
+      "README.md" : {
+         "documentation" : true
+      },
+      "deploy.cf" : {
+         "desc" : "main file"
+      }
+   },
+   "metadata" : {
+      "authors" : [
+         "Ted Zlatanov <[email protected]>"
+      ],
+      "description" : "Deploy a full infrastructure for a simple application",
+      "license" : "MIT",
+      "name" : "Demo::SimpleApplication::Deploy",
+      "tags" : [
+         "vmware",
+         "ensure",
+         "deploy",
+         "demo",
+         "sketchify_generated",
+         "enterprise_compatible"
+      ],
+       "version" : "1.0",
+       depends: { "Demo::SimpleApplication": { }, "Cloud::Services::VMWare": {}, cfengine: { version: "3.5.0" },
+                  "os" : [ {"linux" : "All Linux distributions"} ]
+                }
+   },
+   "namespace" : "cfdc_simpleapplication"
+}

sketches/demo/simpleapplication/README.md

@@ -0,0 +1,22 @@
+# Demo::SimpleApplication version 1.0
+
+License: MIT
+Tags: vmworld2013, demo, sketchify_generated, enterprise_compatible
+Authors: Nick Anderson <[email protected]>, Ted Zlatanov <[email protected]>, Diego Zamboni <[email protected]>
+
+## Description
+Configures hosts for a simple application consisting of webworkers (Apache + simple static content), haworkers (haproxy dynamically configured to use the existing webworkers) and mcworkers (memcached)
+
+## Dependencies
+none
+
+## API
+### bundle: configure
+* parameter _environment_ *runenv* (default: none, description: none)
+
+* parameter _metadata_ *metadata* (default: none, description: none)
+
+
+## SAMPLE USAGE
+See `test.cf` or the example parameters provided
+