Contents

[![Build Status](https://secure.travis-ci.org/brettweavnet/sdbport.png)](http://travis-ci.org/brettweavnet/sdbport)

# Sdbport

Sdbport exports & imports data from AWS SimpleDB domains. It can be used as a class or stand alone CLI.

## Installation

gem install sdbport

## Getting Started

Set your AWS credentials:

```
export AWS_ACCESS_KEY_ID=your_aws_key
export AWS_SECRET_ACCESS_KEY=your_aws_secret
```

Export SimpleDB domain from us-west-1:

```
sdbport export -a $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n data -o /tmp/test-domain-dump
```

Import into domain in us-east-1

```
sdbport import -a $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n data -i /tmp/test-domain-dump

## Exporting and importing from multiple accounts.

You can specify your credentials on the command line, however it is best to add them to a configuration file.

By default, sdbport look for .sdbport.yml in your home directory. To get started, add you AWS keys.

```
cat > ~/.sdbport.yml << EOF
default:
  access_key: your_aws_key
  secret_key: your_aws_secert
EOF
```

You can add multiple account credentials and specify the account with --account (-a).

```
cat > ~/.sdbport.yml << EOF
prod:
  access_key: your_aws_key
  secret_key: your_aws_secert
preprod:
  access_key: your_aws_key
  secret_key: your_aws_secert
EOF
```

Export SimpleDB domain data from prod account in us-west-1:

```
sdbport export -a prod -r us-west-1 -n data -o /tmp/data-domain-dump
```

Import into preprod account in us-east-1:

```
sdbport import -a preprod -r us-east-1 -n data -i /tmp/data-domain-dump
```

To list CLI subcommands:

```
sdbport -h
```

For details help on specific subcommand:

```
sdbport export -h
```

## Known Limitations

* Only supports importing into empty domain.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
sdbport-0.3.0	README.md