Project

heroku-rds

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
heroku-rdswegowise/heroku-rdsHomepageDocumentationSource CodeBug Tracker
Heroku plugin to aid working with RDS databases
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
7,941
Stars
10
Forks
3
Watchers
12
 Releases
Current version
0.5.0
Total releases
2
First release
2011-06-01
Latest release
2011-06-03
 Issues
Open Issues
1
Closed Issues
0
Total Issues
1
Issue Closure Rate
0%
 Development
Primary Language
Ruby
Average date of last 50 commits
2011-06-06
Reverse Dependencies
0

 Dependencies

Runtime

fog
>= 0.7.0
heroku
~> 2.0
 Project Readme

heroku-rds

Forewarning: Heroku RDS is not designed to work on Windows.

Installation

gem install fog
heroku plugins:install https://github.com/wegowise/heroku-rds

Re-install to update.

Optional Packages

  • Commands involving data transfer support a progress bar using Pipe Viewer. Most package managers have a pv package:
brew install pv      # OS X
apt-get install pv   # linux/fink
port install pv      # BSD/macports</pre>
  • rds:access will use hirb if available to format the results. gem install hirb to see it.

Usage

Access the command list at any time by typing heroku help rds:

Usage: heroku rds

 Opens a MySQL console connected to the current database. Ingress access
 is required to run this command (use rds:ingress to grant access).

Additional commands, type "heroku help COMMAND" for more details:

  rds:access                            # displays current ingress access settings
  rds:dump [FILE]                       # Download a database dump, bzipped and saved locally
  rds:import FILE                       # uploads a local database dump into the remote databse
  rds:ingress [IP] [SECURITY GROUP]     # Authorize ingress access to a particular IP
  rds:pull [RAILS_ENV or DATABASE_URL]  # downloads the remote database into a local database
  rds:push [RAILS_ENV or DATABASE_URL]  # uploads the local database into the remote database
  rds:revoke [IP] [SECURITY GROUP]      # Revokes previously-granted ingress access from a particular IP

Planned features

  • rds:snapshot - capture a snapshot
  • rds:restore - restore from a snapshot
  • rds:reboot - reboot instance
  • rds:describe - show all RDS instances you have access to
  • rds:scale - change instance size

These commands are not ingress related so the target of the command cannot be inferred from DATABASE_URL. This functionality is also readily available from the RDS dashboard, so implementing them is not considered critical.