Integrate GitHub Actions with CTO.ai
The CTO.ai GitHub Action flips the pattern of integration with our platform—from passively collecting the user activity in your repo used for deriving Insights, to actively pushing the events defining your development workflow to the CTO.ai platform.
If you’re already comfortable with using GitHub Actions or just prefer having granular control of the events collected by the CTO.ai platform, we provide our own Action for you to drop into your existing workflows on GitHub. By explicitly defining when our Action runs within your GitHub Actions workflow, you can send Events to the CTO.ai platform at the points in your existing workflow that make the most sense. This additional level of control also makes it possible to fine-tune the metrics sent to our platform, improving the accuracy of the Insights we derive for complex collaborative processes.
Before you can configure our GitHub Action as part of your GitHub workflow, you will need credentials.
- A Secret Key and Client ID, which can be obtained by contacting support.
- An API Token for our Workflow Events API.
For more information about the Deployment Events and Change Events that the CTO.ai platform can receive and use for deriving Insights about your development lifecycle, have a look at our Insights Events documentation.
The examples below demonstrate some of the ways our GitHub Action can be used to track the milestones of your workflow.
The value defined by the
event_action keys should always be written in lowercase letters, for example:
Remember that quoting YAML string values is optional when the string doesn’t contain special characters.
Please note that these examples don’t include the steps you might use to deploy your application; rather, they demonstrate how you can integrate our GitHub Action in the context of your existing workflows.