To develop on this gem, you must the following installed:
- a sane Ruby 1.9+ environment with
bundler
$ gem install bundler
- Docker v1.3.1 or greater
- Clone the git repository from Github:
$ git clone git@github.com:upserve/docker-api.git
- Install the dependencies using Bundler
$ bundle install
- Create a branch for your changes
$ git checkout -b my_bug_fix
- Make any changes
- Write tests to support those changes.
- Run the tests:
bundle exec rake
- Assuming the tests pass, open a Pull Request on Github.
This repository comes with five Rake commands to assist in your testing of the code.
This command will run Rspec tests normally on your local system. You must have all the required base images pulled.
Pulls down all the required base images for testing.
Certain Rspec tests will require your credentials to the Docker Hub. If you do not have a Docker Hub account, you can sign up for one here. To avoid hard-coding credentials into the code the test suite leverages three Environment Variables: DOCKER_API_USER
, DOCKER_API_PASS
, and DOCKER_API_EMAIL
. You will need to configure your work environment (shell profile, IDE, etc) with these values in order to successfully run certain tests.
export DOCKER_API_USER='your_docker_hub_user'
export DOCKER_API_PASS='your_docker_hub_password'
export DOCKER_API_EMAIL='your_docker_hub_email_address'