GitHub
GitHub integration
GitHub Workflow Dispatcher
GitHub Workflow Dispatcher allows you to trigger Github workflows to deploy software or infrastructure.
Enable GitHub Integration
Enable the GitHub integration in your Ctrlplane workspace settings and invite the Github bot to your organization.
Workspace Settings > Integrations > GitHub
Creating a GitHub Workflow
Create a new workflow in your repository.
Due to limitations of the GitHub API, workflows do not return the run ID. In order for Ctrlplane to get the ID, it generates a random one that is passed into the pipeline and is expected to be added to the Run name. This can be done by adding:
Retrieving Job Inputs
Next, configure the action to retrieve job inputs from Ctrlplane using the
get-job-inputs
action. You will need to provide the base URL of your Ctrl
Plane instance, the job_id
(input), and an API key stored in your GitHub
secrets.
Commit Release Provider
Its commone to create a release for every commit to a repository. Here is an example github aciton that creates a release for a given commit.