aeolus-image 0.0.1 → 0.4.0

data/man/aeolus-image-build.1

@@ -1,36 +0,0 @@
-.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

@@ -1,57 +0,0 @@
-.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

@@ -1,80 +0,0 @@
-.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

@@ -1,40 +0,0 @@
-.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

@@ -1,16 +0,0 @@
-.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

@@ -1,76 +0,0 @@
-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

@@ -1,63 +0,0 @@
-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

data/spec/config_parser_spec.rb

@@ -1,82 +0,0 @@
-require 'spec_helper'
-
-module Aeolus
-  module Image
-    describe ConfigParser do
-      it "should parse the specified command" do
-        config_parser = ConfigParser.new(%w(list  --images))
-        config_parser.process
-        config_parser.command.should == 'list'
-      end
-
-      it "should exit gracefully when a required subcommand is not provided" do
-        begin
-          silence_stream(STDOUT) do
-            config_parser = ConfigParser.new(%w(list))
-            config_parser.process
-            config_parser.should_receive(:exit).with(1)
-          end
-        rescue SystemExit => e
-          e.status.should == 1
-        end
-      end
-
-      it "should notify the user of an invalid command" do
-        config_parser = ConfigParser.new(%w(sparkle))
-        config_parser.should_receive(:exit).with(0)
-        silence_stream(STDOUT) do
-          config_parser.process
-        end
-      end
-
-      it "should exit gracefully with bad params" do
-        begin
-          silence_stream(STDOUT) do
-            ConfigParser.new(%w(delete --fred)).should_receive(:exit).with(1)
-          end
-        rescue SystemExit => e
-          e.status.should == 1
-        end
-      end
-
-      it "should set options hash for valid general options" do
-        config_parser = ConfigParser.new(%w(list --user joe --password cloud --images))
-        config_parser.options[:user].should == 'joe'
-        config_parser.options[:password].should == 'cloud'
-        config_parser.options[:subcommand].should == :images
-      end
-
-      it "should set options hash for valid list options" do
-        config_parser = ConfigParser.new(%w(list --builds 12345))
-        config_parser.options[:subcommand].should == :builds
-        config_parser.options[:id].should == '12345'
-      end
-
-      it "should set options hash for valid build options" do
-        config_parser = ConfigParser.new(%w(build --target ec2,rackspace --image 12345 --template my.tmpl))
-        config_parser.options[:target].should == ['ec2','rackspace']
-        config_parser.options[:image].should == '12345'
-        config_parser.options[:template].should == 'my.tmpl'
-      end
-
-      it "should set options hash for valid push options" do
-        config_parser = ConfigParser.new(%w(push --provider ec2-us-east1 --id 12345))
-        config_parser.options[:provider].should == ['ec2-us-east1']
-        config_parser.options[:id].should == '12345'
-      end
-
-      it "should set options hash for valid delete options" do
-        config_parser = ConfigParser.new(%w(delete --build 12345))
-        config_parser.options[:build].should == '12345'
-      end
-
-      it "should set options hash for valid import options" do
-        config_parser = ConfigParser.new(%w(import --provider ec2-us-east-1a --description /path/to/file --id ami-123456 --target ec2))
-        config_parser.options[:provider].should == ['ec2-us-east-1a']
-        config_parser.options[:target].should == ['ec2']
-        config_parser.options[:description].should == '/path/to/file'
-        config_parser.options[:id].should == 'ami-123456'
-      end
-    end
-  end
-end