X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FOyster%2FProvision.pm;h=36cd7cc4769d9149c33a9164110bc03c40a10c5e;hb=10d26b8dcd7ce5a0a6ecdb76e2ac361964f272b2;hp=4da50bcebeb8343ea83fe304e88b800bb6c5219e;hpb=3ded63474d7f715bb3c6be48ad6c39cb63f726df;p=p5sagit%2FOyster.git

diff --git a/lib/Oyster/Provision.pm b/lib/Oyster/Provision.pm
index 4da50bc..36cd7cc 100644
--- a/lib/Oyster/Provision.pm
+++ b/lib/Oyster/Provision.pm
@@ -2,6 +2,12 @@ package Oyster::Provision;
 
 use Moose;
 
+has 'name'    => ( is => 'ro', isa => 'Str', required => 1 );
+has 'size'    => ( is => 'ro', isa => 'Str', required => 1 );
+has 'image'   => ( is => 'ro', isa => 'Str', required => 1 );
+has 'pub_ssh' => ( is => 'ro', isa => 'Str', required => 1 );
+
+
 sub config {
     return {provision_backend => 'Oyster::Provision::Rackspace'};
 }
@@ -12,7 +18,59 @@ sub BUILD {
 
     my $role = $self->config()->{provision_backend};
 
+    eval "use $role";
     "$role"->meta->apply($self);
 }
 
 1;
+
+__END__
+
+=head1 NAME
+
+Oyster::Provision - Provision an Oyster
+
+=head1 SYNOPSIS
+
+    my $server = Oyster::Provision->new(
+        name => 'Ostrica',
+        size => '256',
+        image => 'Meerkat',
+        pub_ssh => "$ENV{HOME}/.ssh/id_rsa.pub",
+    );
+    $server->create;
+
+=head1 BACKENDS
+
+By default, the L<Oyster::Provision::Rackspace> backend
+will be used.
+
+Each backend needs to accept at least the C<name>,
+C<size>, C<image> and C<pub_ssh> parameters. The meaning
+of these parameters may differ from one backend to another.
+
+=head1 METHOS
+
+Each backend usually implements the following C<required>
+methods:
+
+=over
+
+=item create
+
+Creates a new server by given name, if such server does
+not exist.
+
+Installs the required packages for the distribution
+
+=item delete
+
+Gets rid of the server instance
+
+=item resize
+
+Hopefully scales the server
+
+=back
+
+=cut