Dokku is compatible with continuous integration (CI) and continuous deployment (CD) services that support git over SSH deployments. Some of the services we've reviewed and supported include the following:
- CircleCI
- CodeShip
- Jenkins
- Bitbucket Pipelines
- GitHub Actions
To setup integration with your Healthcare Blocks server, first generate a deployment key in the CI / CD service. Create a help desk ticket and include a copy of the public portion of this key, specifying which environment needs the key.
In the CI / CD configuration for your project, define a git remote pointing to your Healthcare Blocks server, e.g.:
git remote add hcb dokku@my-server-id.healthcareblocks.com:my-app-name
(replace the values for my-server-id and my-app-name with the ones supplied to you when the server was provisioned)
Then define a step that will deploy code to your server, e.g.
git push hcb main
Finally, test your configuration by pushing code to the source control vendor associated with your CI / CD service, triggering a new build and release cycle.