gitlab-ce/doc/ci/cloud_deployment/heroku.md

stage	group	info	title
Deploy	Environments	To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments	Use GitLab CI/CD to deploy to Heroku

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

You can deploy an application to Heroku by using GitLab CI/CD.

Prerequisites

• A Heroku account. Sign in with an existing Heroku account or create a new one.

Deploy to Heroku

1. In Heroku:

   1. Create an application and copy the application name.
   2. Browse to Account Settings and copy the API key.

2. In your GitLab project, create two variables:

   • HEROKU_APP_NAME for the application name.
   • HEROKU_PRODUCTION_KEY for the API key

3. Edit your .gitlab-ci.yml file to add the Heroku deployment command. This example uses the dpl gem for Ruby:

   heroku_deploy:
     stage: production
     script:
       - gem install dpl
       - dpl --provider=heroku --app=$HEROKU_APP_NAME --api-key=$HEROKU_PRODUCTION_KEY