promotion 1.0.7 → 1.0.8

data/CHANGELOG

@@ -0,0 +1,3 @@
+Version 1.0.8
+    Added extension to install executables: promote, evolve, devolve.
+    Added mkdeploy executable to create a template deployment descriptor.

data/README

@@ -68,17 +68,8 @@ to suit your system's paths.
 
  DO NOT USE ON A PRODUCTION SYSTEM without rigorous testing in a virtual machine first.
 
-Create the staging area (and set permissions appropriately):
-
-  $ sudo mkdir /var/staging
-
-Check out the promotion app into staging, and bootstrap promotion
-  $ sudo wget http://rubyforge.org/frs/download.php/76463/promotion-x.y.z.zip
-  $ sudo unzip promotion-x.y.z.zip -d promotion     # creates the promotion sub-directory
-  $ cd promotion
-  $ sudo ruby bin/bootstrap
-  Promoting promotion...OK.
-  $ cd /var/staging
+Installing promotion automatically creates the /var/staging directory
+  $ sudo gem install promotion
 Now you are ready to use Promotion to deploy other applications.
 
 == Usage
@@ -106,6 +97,17 @@ If you want to revert to an earlier version of the database schema:
 which will execute the schema migration scripts in the +devolve+ folder,
 in reverse order from 1023 down to 1017.
 
+To make it easier to create a deployment descriptor, use the +mkdeploy+ command:
+  $ cd /var/staging
+  $ mkdir myapp
+  $ cd myapp
+  $ mkdeploy
+  Deployment descriptor template written to deploy.xml.
+
+If you already have a deploy.xml file, +mkdeploy+ will *not* overwrite it:
+  $ mkdeploy
+  deploy.xml already exists in the current directory. Exiting.
+
 == Deployment descriptor syntax
 The deployment descriptor is typically named <code>deploy.xml</code> and placed at the top
 of the application's staging folder (eg. <code>/var/staging/myapp</code>).

data/bin/mkdeploy

@@ -0,0 +1,54 @@
+#!/usr/local/bin/ruby
+
+if File.exists?("deploy.xml")
+    puts("deploy.xml already exists in the current directory. Exiting.")
+    exit 1
+end
+
+template =<<-EOT
+<?xml version="1.0" encoding="UTF-8" ?>
+<Specification Name="myapp" Title="My Test App"
+  xmlns="http://finalstep.com.au/promotion/v100"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://finalstep.com.au/schema/promotion.v100.xsd ../promotion/promotion.xsd">
+    <Description></Description>
+    <Groups>
+        <Group Gid="502" Name="_mysql" />
+    </Groups>
+    <Users>
+        <User Name="richard" Class="staff" Gecos="Richard Kernahan" Uid="1002" Gid="1002"
+            Home="/home/richard" Shell="/bin/ksh" Groups="wheel webadmin"/>
+        <User Name="_mysql" Class="daemon" Gecos="MySQL Account" Uid="502"Gid="502"
+            Home="/nonexistent" Shell="/sbin/nologin"  />
+    </Users>
+    <Folders Mode="0750" Owner="root" Group="wheel">
+        <Folder Owner="_mysql" Group="_mysql">/var/mysql</Folder>
+        <Folder>/home/myapp</Folder>
+        <Folder>/var/myapp</Folder>
+    </Folders>
+    <Files Owner="root" Group="wheel" Mode="0644" Source="conf">
+        <File>/etc/my.cnf</File>
+        <File>/etc/myapp.conf</File>
+    </Files>
+    <Files Owner="root" Group="wheel" Mode="0750" Source="sbin">
+        <File>/usr/local/sbin/up!</File>
+        <File>/usr/local/sbin/down!</File>
+        <File>/usr/local/sbin/push!</File>
+    </Files>
+    <Allfiles Group="bin" Mode="0644" Owner="root" Source="conf">/var/axonsec/conf</Allfiles>
+    <Daemon Flags="" Priority="10" User="_myapp" />
+    <Crontab>
+        <Schedule User="root" Hour="2" Minute="7"
+            Comment="Backup the entire database at 2:07am each morning">
+            <Command><![CDATA[/usr/local/sbin/myappbak]]></Command>
+        </Schedule>
+    </Crontab>
+    <Database>/usr/local/bin/mysql</Database>
+</Specification>
+EOT
+
+deploy = File.new("deploy.xml", "w")
+deploy.puts(template)
+deploy.close()
+
+puts("Deployment descriptor template written to deploy.xml.")

data/bin/promote

@@ -1,4 +1,4 @@
-#!/usr/local/bin/ruby -I/usr/local/
+#!/usr/local/bin/ruby
 # This script starts the promotion application
 
 #______________________

data/ext/promotion/extconf.rb

@@ -13,6 +13,8 @@ install :
 	install -m 0750 -o root -g wheel #{source}/promote #{target}/sbin
 	install -m 0750 -o root -g wheel #{source}/evolve  #{target}/sbin
 	install -m 0750 -o root -g wheel #{source}/devolve #{target}/sbin
+	install -m 0750 -o root -g wheel #{source}/mkdeploy #{target}/sbin
+	install -m 0750 -o root -g wheel -d /var/staging
 EOT
 makefile = File.new("Makefile", "w")
 makefile.puts(makeContents)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: promotion
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 7
   prerelease: 
   segments: 
   - 1
   - 0
-  - 7
-  version: 1.0.7
+  - 8
+  version: 1.0.8
 platform: ruby
 authors: 
 - Richard Kernahan
@@ -31,7 +31,7 @@ description: "\t\tThe Promotion tool is designed to make it easy and quick to de
   \t\tPromotion handles all of this based on an XML deployment descriptor for each application,\n\
   \t\tallowing rapid, reliable redeployment with a single line command. It also manages database\n\
   \t\tschema migration.\n"
-email: rec.dev@finalstep.com.au
+email: dev.promotion@finalstep.com.au
 executables: []
 
 extensions: 
@@ -42,6 +42,7 @@ files:
 - bin/promote
 - bin/evolve
 - bin/devolve
+- bin/mkdeploy
 - ext/promotion/extconf.rb
 - lib/promotion.rb
 - lib/promotion/application.rb
@@ -58,11 +59,10 @@ files:
 - promotion.xsd
 - CHANGELOG
 - README
-- VERSION
 homepage: http://rubygems.org/gems/promotion
 licenses: []
 
-post_install_message: "\n    Executables have been installed in /usr/local/sbin:\n    * promote\n    * evolve\n    * devolve\n  "
+post_install_message: "\n  Executables have been installed in /usr/local/sbin:\n    promote\n    evolve\n    devolve\n    mkdeploy\n  "
 rdoc_options: []
 
 require_paths: 

data/VERSION

@@ -1 +0,0 @@
-1.0.7