aeolus-image 0.0.1

data/lib/push_command.rb

@@ -0,0 +1,72 @@
+require 'rest_client'
+
+module Aeolus
+  module Image
+    class PushCommand < BaseCommand
+      attr_accessor :console
+      def initialize(opts={}, logger=nil)
+        super(opts, logger)
+        default = {
+          :provider => [],
+          :id => '',
+          :build => ''
+        }
+        @options = default.merge(@options)
+        @console = ImageFactoryConsole.new()
+        @console.start
+      end
+      def run
+        begin
+          if combo_implemented?
+            if !@options[:id].empty? && pushed?(@options[:id])
+              puts "ERROR: This image has already been pushed, to push to another provider please push via build-id rather than image-id"
+              puts "e.g. aeolus-image push --provider <provider> --build <build-id>"
+              quit(1)
+            end
+
+            sleep(5)
+            @console.push(@options[:provider], get_creds, @options[:id], @options[:build]).each do |adaptor|
+              puts ""
+              puts "Provider Image: #{adaptor.image_id}"
+              puts "Image: #{adaptor.image}"
+              puts "Build: #{adaptor.build}"
+              puts "Status: #{adaptor.status}"
+              puts "Percent Complete: #{adaptor.percent_complete}"
+            end
+            quit(0)
+          end
+        rescue
+          puts "An Error occured whilst trying to push this build, please check aeolus-image --help for details on how to use this command"
+          quit(1)
+        end
+      end
+
+      def get_creds
+        conductor['provider_accounts'].get
+      end
+
+      def combo_implemented?
+        if @options[:provider].empty? || (@options[:build].empty? && @options[:id].empty?)
+          puts "This combination of parameters is not currently supported"
+          quit(1)
+        end
+        true
+      end
+
+      private
+      def quit(code)
+        @console.shutdown
+        exit(code)
+      end
+
+      def pushed?(image)
+        begin
+          uuid = Regexp.new('[\w]{8}[-][\w]{4}[-][\w]{4}[-][\w]{4}[-][\w]{12}')
+          uuid.match(iwhd["/images/" + image + "/latest_unpushed"].get).nil? ? true : false
+        rescue
+          true
+        end
+      end
+    end
+  end
+end

data/man/aeolus-image-build.1

@@ -0,0 +1,36 @@
+.TH aeolus-image 1  "July 07, 2011" "version 0.4" "USER COMMANDS"
+.SH NAME
+aeolus-image build \- command for building aeolus images
+.SH SYNOPSIS
+.B aeolus-image build [\-h|--help] [\-u|--username] [\-w|--password] [\-I|--image [image-id]] [\-e|--template [path-to-template]] [\-t|--targets [targets]] [\-d|--daemon]
+.SH DESCRIPTION
+aeolus-image build command allows users to build new images based on a given TDL template file for a set of specified targets such e.g. EC2, RHEVM etc...
+.SH OPTIONS
+.TP
+\-u, --user <username>
+Conductor username
+.TP
+\-w, --password <password>
+Conductor password
+.TP
+\-T, --target
+Provide a list of targets for the build
+.TP
+\-e, --template
+Provide path to a TDL template file for building against
+.TP
+\-d, --daemon
+Run as a background process
+.TP
+Get usage information for this command and associated commmands
+\-h, --help
+.SH EXAMPLES
+.TP
+Build a new image for ec2 based on the specified template TDL file template.tdl
+.B aeolus-image build
+\--targets ec2
+\--template ./template.tdl
+.TP
+Martyn Taylor (mtaylor@redhat.com), Jason Guiditta (jguiditta@redhat.com)
+.SH SEE ALSO
+aeolus-image-list(1), aeolus-image-push(1), aeolus-image-import(1)

data/man/aeolus-image-import.1

@@ -0,0 +1,57 @@
+.TH aeolus-image 1  "July 07, 2011" "version 0.4" "USER COMMANDS"
+.SH NAME
+aeolus-image import \- command for importing existing provider images into aeolus
+.SH SYNOPSIS
+.B aeolus-image import [\-h|--help] [\-u|--username] [\-w|--password] [\-r|--provider [provider-name]] [\--id [provider-image-id]] [--description [path-to-file|xml string]] [\T|--target [target]] [\-d|--daemon]
+.SH DESCRIPTION
+aeolus-image import allows users to import pre-existing images that exist in cloud provders for example AMI from EC2, into aeolus.
+.SH OPTIONS
+.TP
+\-u, --user <username>
+Conductor username
+.TP
+\-w, --password <password>
+Conductor password
+.TP
+\-r, --provider <provider-name>
+The provider name as it exists in conductor from where the importing image resides
+.TP
+\--id <provider-image-id>
+The providers ID given to the importing image
+.TP
+\-T, --target
+The target type for the given provider
+.TP
+\--description <path-to-xml-description|xml string>
+A user defined description to associate with the importing image
+.TP
+\-d, --daemon
+Run as a background process
+.TP
+Get usage information for this command and associated commmands
+\-h, --help
+.SH EXAMPLES
+.TP
+Import the AMI ami-1234567 from the provider ec2-us-east-1 into aeolus
+.B aeolus-image import
+\--provider ec2-us-east-1
+\--target ec2
+\--id ami-1234567
+.TP
+Import the AMI ami-1234567 from the provider ec2-us-west-1 into aeolus with a given xml description
+.B aeolus-image import
+\--provider ec2-us-west-1
+\--target ec2
+\--id ami-1234567
+\--description '<image><name>myAMI</name></image>'
+.TP
+Import the AMI ami-1234567 from the provider ec2-us-west-1 into aeolus providing a path to the description XML file
+.B aeolus-image import
+\--provider ec2-us-west-1
+\--target ec23
+\--id ami-1234567
+\--description /foo/bar/description.xml
+.SH AUTHOR
+Martyn Taylor (mtaylor@redhat.com), Jason Guiditta (jguiditta@redhat.com)
+.SH SEE ALSO
+aeolus-image-list(1), aeolus-image-push(1), aeolus-image-build(1)

data/man/aeolus-image-list.1

@@ -0,0 +1,80 @@
+.TH aeolus-image 1  "July 07, 2011" "version 0.4" "USER COMMANDS"
+.SH NAME
+aeolus-image \- command for listing aeolus image associated objects.
+.SH SYNOPSIS
+.B aeolus-image list [\-h|--help] [\-u|--username] [\-w|--password] [\-i|--images] [\-b|--builds [image id]] [\-t|--targetimages [build id]] [\-g|--targets] [\-a|--accounts] [\-p|--providers]
+.SH DESCRIPTION
+aeolus-image list commands allows users to list information on the contents of particular objects in image warehouse including:
+.P
+images: high level image representation associated with underlying provider and target images
+.br
+builds: an object representation of a particular build that has taken place for a high level image
+.br
+targets: particular targets available to build against, for example 'ec2'
+.br
+targetimages: represents builds of particular image against a target.  For example building against target 'ec2' would create an AMI specific image
+.br
+providerimages: represents the actual images that have been uploaded to a provider.  Similiar to a target image but specific to a particular provider
+.SH OPTIONS
+.TP
+\-u, --user <username>
+Conductor username
+.TP
+\-w, --password <password>
+Conductor password
+Get usage information for this command and associated commmands
+.TP
+\-i, --images
+Retrieve a list of images
+.TP
+\-b, --builds <image id>
+Retrieve the builds of an image
+.TP
+\-t, --targetimages <build id>
+Retrieve the target images from a build
+.TP
+\-P, --providerimages
+Retrieve the provider images from a target image
+.TP
+\-g, --targets
+Retrieve a list of available targets
+.TP
+\-p, --providers
+Retrieve a list of available providers
+.TP
+\-a, --accounts
+Retrieve a list of available accounts
+.TP
+\-d, --daemon
+Run as a background process
+.TP
+\-h, --help
+.SH EXAMPLES
+.TP
+List all images
+.B aeolus-image list
+\--images
+.TP
+List all builds for an image with id: 12345678-aaaa-1234--1234567890ab
+.B aeolus-image list
+\--builds 12345678-aaaa-1234--1234567890ab
+.TP
+List all target images for a given build with id: 12345678-bbbb-1234--1234567890ab
+.B aeolus-image list
+\--builds 12345678-bbbb-1234--1234567890ab
+.TP
+List all available targets
+.B aeolus-image list
+\--targets
+.TP
+List all available providers
+.B aeolus-image list
+\--providers
+.TP
+List all available accounts
+.B aeolus-image list
+\--account
+.SH AUTHOR
+Martyn Taylor (mtaylor@redhat.com), Jason Guiditta (jguiditta@redhat.com)
+.SH SEE ALSO
+aeolus-image-build(1), aeolus-image-push(1), aeolus-image-import(1), aeolus-image-delete(1)

data/man/aeolus-image-push.1

@@ -0,0 +1,40 @@
+.TH aeolus-image 1  "July 07, 2011" "version 0.4" "USER COMMANDS"
+.SH NAME
+aeolus-image push \- command for pushing aeolus images to back end providers
+.SH SYNOPSIS
+.B aeolus-image push [\-h|--help] [\-u|--username] [\-w|--password] [\-id [image-id]] [-r|--provider [provider-name]]
+.SH DESCRIPTION
+aeolus-image push allows users to push built images to a particular backend provider
+.SH OPTIONS
+.TP
+\-u, --user <username>
+Conductor username
+.TP
+\-w, --password <password>
+Conductor password
+.TP
+\-r|--provider
+The provider name this image should be pushed to
+.TP
+\--id <id>
+The id of the image for pushing
+.TP
+\-d, --daemon
+Run as a background process
+.TP
+Get usage information for this command and associated commmands
+\-h, --help
+.SH EXAMPLES
+.TP
+Initial push of an image with id 12345678-bbbb-1234--1234567890ab to provider ec2-us-east-1
+.B aeolus-image push
+\--id 12345678-bbbb-1234--1234567890ab
+\--provider ec2-us-east-1
+Push a build with id 12345678-bbbb-1234--1234567890ab to provider ec2-us-east-1
+.B aeolus-image push
+\--build 12345678-bbbb-1234--1234567890ab
+\--provider ec2-us-east-1
+.SH AUTHOR
+Martyn Taylor (mtaylor@redhat.com), Jason Guiditta (jguiditta@redhat.com)
+.SH SEE ALSO
+aeolus-image-list(1), aeolus-image-build(1), aeolus-image-import(1)

data/man/aeolus-image.1

@@ -0,0 +1,16 @@
+.TH aeolus-image 1  "July 07, 2011" "version 0.4" "USER COMMANDS"
+.SH NAME
+aeolus-image \- command line tool for managing aeolus images
+.SH SYNOPSIS
+.B aeolus-image
+[\-h]
+.SH DESCRIPTION
+aeolus-image is a tool that allows users to control their aeolus images through image builder and aeolus conductor.  aeolus-image offers four commands options; list, build, push, import.  For more information on each command please run man aeolus-image <command> or aeolus-image --help
+.SH OPTIONS
+.TP
+\-h, --help
+Get usage information for this tool and subcommands
+.SH AUTHOR
+Martyn Taylor (mtaylor@redhat.com), Jason Guiditta (jguiditta@redhat.com)
+.SH SEE ALSO
+aeolus-image-build(1), aeolus-image-push(1), aeolus-image-list(1), aeolus-image-import(1)

data/spec/base_command_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+module Aeolus
+  module Image
+    describe BaseCommand do
+
+      it "should determine the correct credentials for HTTP Authentication" do
+        basec = BaseCommand.new
+        iwhd = basec.send :iwhd
+        iwhd.user.should == nil
+
+        conductor = basec.send :conductor
+        conductor.user.should == "admin"
+        conductor.password.should == "password"
+
+        basec = BaseCommand.new({:username => "testusername", :password=> "testpassword"})
+        conductor = basec.send :conductor
+        conductor.user.should == "testusername"
+        conductor.password.should == "testpassword"
+      end
+
+      describe "#read_file" do
+
+        it "should return nil when it cannot find file" do
+          b = BaseCommand.new
+          b.send(:read_file, "foo.fake").should be_nil
+        end
+
+        it "should read file content into string variable" do
+          b = BaseCommand.new
+          template_str = b.send(:read_file, "#{File.dirname(__FILE__)}" + "/../examples/custom_repo.tdl")
+          template_str.should include("<template>")
+        end
+      end
+
+      describe "#is_file?" do
+        it "should return false if no file found" do
+          b = BaseCommand.new
+          b.send(:is_file?, "foo.fake").should be_false
+        end
+        it "should return true if file found" do
+          b = BaseCommand.new
+          valid_file = "#{File.dirname(__FILE__)}" + "/../examples/aeolus-cli"
+          b.instance_eval {@config_location = valid_file}
+          b.send(:is_file?, valid_file).should be_true
+        end
+      end
+
+      describe "#write_file" do
+        it "should write a new file" do
+          b = BaseCommand.new
+          new_file = "/tmp/foo.fake"
+          b.instance_eval {@config_location = new_file}
+          b.send(:write_file)
+          conf = YAML::load(File.open(File.expand_path(new_file)))
+          conf.has_key?(:iwhd).should be_true
+          File.delete(new_file)
+        end
+      end
+
+      describe "#validate_xml_document?" do
+        it "should return errors given non compliant xml" do
+          b = BaseCommand.new
+          errors = b.send(:validate_xml_document, "examples/tdl.rng", File.read("spec/fixtures/invalid_template.tdl"))
+          errors.length.should > 0
+        end
+
+        it "should return no errors" do
+          b = BaseCommand.new
+          errors = b.send(:validate_xml_document, "examples/tdl.rng", File.read("spec/fixtures/valid_template.tdl"))
+          errors.length.should == 0
+        end
+      end
+    end
+  end
+end

data/spec/build_command_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+module Aeolus
+  module Image
+    describe BuildCommand do
+      before(:each) do
+        @options[:target] = ['mock','ec2']
+        @options[:template] = "#{File.dirname(__FILE__)}" + "/../examples/custom_repo.tdl"
+      end
+
+      describe "#run" do
+        it "should kick off a build with valid options" do
+          b = BuildCommand.new(@options, @output)
+          begin
+            b.run
+          rescue SystemExit => e
+            e.status.should == 0
+          end
+          $stdout.string.should include("Image:")
+          $stdout.string.should include("Target Image:")
+          $stdout.string.should include("Build:")
+        end
+        it "should exit with a message if only image id is provided" do
+          @options.delete(:template)
+          @options.delete(:target)
+          @options[:image] = '825c94d1-1353-48ca-87b9-36f02e069a8d'
+          b = BuildCommand.new(@options, @output)
+          begin
+            b.run
+          rescue SystemExit => e
+            e.status.should == 1
+          end
+          $stdout.string.should include("This combination of parameters is not currently supported")
+        end
+        it "should exit with appropriate message when a non compliant template is given" do
+          @options[:template] = "spec/fixtures/invalid_template.tdl"
+          @options[:image] = '825c94d1-1353-48ca-87b9-36f02e069a8d'
+          b = BuildCommand.new(@options, @output)
+          begin
+            b.run
+          rescue SystemExit => e
+            e.status.should == 1
+          end
+          $stdout.string.should include("ERROR: The given Template does not conform to the TDL Schema")
+        end
+      end
+
+      describe "#combo_implemented?" do
+        it "should give useful feedback if no template or target is specified" do
+          @options[:template] = ''
+          @options[:target] = []
+          b = BuildCommand.new(@options, @output)
+          begin
+            b.combo_implemented?
+          rescue SystemExit => e
+            e.status.should == 1
+          end
+          $stdout.string.should include("This combination of parameters is not currently supported")
+        end
+      end
+    end
+  end
+end