Config hashref should be given to all backends

[p5sagit/Oyster.git] / lib / Oyster / Provision.pm

package Oyster::Provision;

use Moose;

has 'api_username' => ( is => 'ro', isa => 'Str');
has 'api_password' => ( is => 'ro', isa => 'Str');
has 'name'    => ( is => 'ro', isa => 'Str');
has 'size'    => ( is => 'ro', isa => 'Str');
has 'image'   => ( is => 'ro', isa => 'Str');
has 'pub_ssh' => ( is => 'ro', isa => 'Str');
has 'config'  => ( is => 'rw', isa => 'HashRef', required => 1 );
has 'provision_backend'  => (is => 'rw', isa => 'Str', required => 1, default => 'Oyster::Provision::Rackspace' );

# TODO after provision, add the server's name with "oyster-" prefixed to the
# user's ~/.ssh/ssh_config file so any part of Oyster can ssh there
# passwordlessly for deploying or whatnot

sub BUILD {

    my $self = shift;

    my $role = $self->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