gitlab-org--gitlab-foss/doc/ci/examples/test-and-deploy-ruby-application-to-heroku.md
Mike Lewis 3fe11b13a4 Doc types on tutorials in top level examples folder, minor edits
Variety of edits to conform with SSOT doc style standards
2019-06-11 16:39:26 +00:00

2.6 KiB

type
tutorial

Test and deploy a Ruby application with GitLab CI/CD

This example will guide you through how to run tests in your Ruby on Rails application and deploy it automatically as a Heroku application.

You can also view or fork the complete example source and view the logs of its past CI jobs.

Configure the project

This is what the .gitlab-ci.yml file looks like for this project:

test:
  stage: test
  script:
  - apt-get update -qy
  - apt-get install -y nodejs
  - bundle install --path /cache
  - bundle exec rake db:create RAILS_ENV=test
  - bundle exec rake test

staging:
  stage: deploy
  script:
  - gem install dpl
  - dpl --provider=heroku --app=gitlab-ci-ruby-test-staging --api-key=$HEROKU_STAGING_API_KEY
  only:
  - master

production:
  stage: deploy
  script:
  - gem install dpl
  - dpl --provider=heroku --app=gitlab-ci-ruby-test-prod --api-key=$HEROKU_PRODUCTION_API_KEY
  only:
  - tags

This project has three jobs:

  • test - used to test Rails application.
  • staging - used to automatically deploy staging environment every push to master branch.
  • production - used to automatically deploy production environment for every created tag.

Store API keys

You'll need to create two variables in your project's Settings > CI/CD > Environment variables:

  • HEROKU_STAGING_API_KEY - Heroku API key used to deploy staging app.
  • HEROKU_PRODUCTION_API_KEY - Heroku API key used to deploy production app.

Find your Heroku API key in Manage Account.

Create Heroku application

For each of your environments, you'll need to create a new Heroku application. You can do this through the Heroku Dashboard.

Create Runner

First install Docker Engine.

To build this project you also need to have GitLab Runner. You can use public runners available on gitlab.com or register your own:

gitlab-runner register \
  --non-interactive \
  --url "https://gitlab.com/" \
  --registration-token "PROJECT_REGISTRATION_TOKEN" \
  --description "ruby-2.2" \
  --executor "docker" \
  --docker-image ruby:2.2 \
  --docker-postgres latest

With the command above, you create a Runner that uses the ruby:2.2 image and uses a postgres database.

To access the PostgreSQL database, connect to host: postgres as user postgres with no password.