Context
If we are using GitHub releases as part of our release workflow, we can use GitHub Actions to accomplish many tasks, such as notifying services about the new release.
This is very helpful as we can use a single step on our workflow to keep all integrated services in sync.
In this tutorial, we'll update an environment variable on Heroku. A real-world scenario for this is an API built with Node.js that has an endpoint for its current version running or uses the version on error monitoring clients like Sentry's.
Services
Heroku
Heroku is a container-based cloud Platform as a Service (PaaS) that supports several programming languages. It enables simple application development and deployment and it's very beginner-friendly.
GitHub Actions
GitHub Actions enables automation of our software workflows. It's possible to run workflows with many triggers and perform many tasks from them.
There are thousands of actions available on the marketplace and built by the community that enables us to lint, format, test, build, deploy our projects... The use cases are endless.
Setup
Heroku
In order to communicate with Heroku, we need an auth token. Generate one by running heroku authorizations:create
on the Heroku CLI or through the dashboard.
Secrets
We need to setup 2 GitHub secrets on our repo. Go to Settings > Secrets
and create the following:
-
HEROKU_API_KEY
: Heroku auth token created before; -
HEROKU_APP_NAME
: Name of the project created on Heroku.
Workflow
With all the setup finished, create a YAML file under .github/workflows
, e.g. create-releases.yml
with the following content:
name: Create releases
on:
release:
types: [published]
jobs:
update-heroku-env-variable:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@master
- name: Trim tag name
run: echo '::set-env name=API_VERSION::${{ github.ref }}'
- name: Update API_VERSION on Heroku
run: heroku config:set API_VERSION=${API_VERSION##*/} -a ${{ secrets.HEROKU_APP_NAME }}
env:
HEROKU_API_KEY: ${{ secrets.HEROKU_API_KEY }}
And that's it! Now, every time we publish a new release on GitHub, the API_VERSION
environment variable on Heroku will be updated accordingly.
Note: The "Trim tag name" step will modify the tag name from refs/tags/x.x.x
to only x.x.x
.
Check out an example repo here. Check out the Actions tab to see details of the workflow.
Notes
The example above only updates the environment variable when our GitHub release is published. However, it's possible to run workflows on other events of a release - see GitHub's documentation.
It's possible to run other Heroku commands through the workflow. Check out their CLI documentation for more commands or check out this post for details on an entire deployment workflow.
I hope you enjoyed this post and follow me on any platform for more.
Top comments (0)