Maintenance Mode - Import / Export SimpleDB Domains.
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
lib
spec
.gitignore
.ruby-gemset
.ruby-version
.travis.yml
CHANGELOG
Gemfile
LICENSE.txt
README.md
Rakefile
sdbport.gemspec

README.md

Build Status

sdbport is in maintenance mode!

We will continue to provide best effort support for bug fix requests, however new features will not be added.


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 sample from us-west-1:

sdbport export -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n sample -o /tmp/dump.sdbport

To export larger SimpleDB domains, add -w. This writes each chunk to file as it is received rather than storing in memory:

sdbport export -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-west-1 -n sample -o /tmp/dump.sdbport -w

Import into domain sample in us-east-1:

sdbport import -k $AWS_ACCESS_KEY_ID -s $AWS_SECRET_ACCESS_KEY -r us-east-1 -n sample -i /tmp/dump.sdbport

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, create the file ~/.sdbport.yml:

default:
  access_key: your_aws_key
  secret_key: your_aws_secert

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

prod:
  access_key: your_aws_key
  secret_key: your_aws_secert
preprod:
  access_key: your_aws_key
  secret_key: your_aws_secert

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

sdbport export -a prod -r us-west-1 -n sample -o /tmp/dump.sdbport

Import into domain sample in preprod account in us-east-1:

sdbport import -a preprod -r us-east-1 -n sample -i /tmp/dump.sdbport

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