This guide assumes that you have enabled the
artifactsRewritefeature flag. See Prerequisite configuration/setup.
This functionality uses GitHub Webhooks for delivering messages to Spinnaker, and must be configured to send messages to Spinnaker’s event bus as shown below.
If you (or your Spinnaker admin) have already configured Spinnaker to listen to a GitHub webhooks from the repository you plan to publish commits to, you can skip this section.
You need the following:
A GitHub repository either under your user, or in an organization or user’s account that you have permission to publish commits to.
This will be referred to as
$ORGANIZATION/$REPOSITORYfrom now on (for example,
A running Spinnaker instance. This guide shows you how to update it to accept messages from GitHub.
artifactsRewritefeature flag enabled in Spinnaker. In
default), add the line
window.spinnakerSettings.feature.artifactsRewrite = true;.
At this point, we will configure GitHub webhooks and a GitHub artifact account. The webhook will be received by Spinnaker whenever a commit is made, and the artifact account will allow you to download any pertinent files.
1. Configure GitHub webhooks
Follow the GitHub webhook configuration.
2. Configure a GitHub artifact account
Follow the GitHub artifact configuration.
3. Apply your configuration changes
Once the artifact changes have been made using Halyard, run
hal deploy apply
to apply them in Spinnaker.
Using GitHub artifacts in pipelines
We will need either an existing or a new pipeline that we want to be triggered on changes to GitHub artifacts. If you do not have a pipeline, create one as shown below.
Configure the GitHub trigger
Let’s add a Git trigger to run our pipeline. To configure the trigger:
|Organization or User||
|Branch||(optional) Can be used (via regular expressions) to describe which branches to listen to changes one|
|Secret||(optional) Strongly encouraged It must match the secret provided to the webhook configuration|
Configure the GitHub artifact
Now we need to declare that the GitHub trigger expects that a specific artifact matching some criteria is available before the pipeline starts executing. In doing so, you guarantee that an artifact matching your description is present in the pipeline’s execution context. If no artifact for this description is present, the pipeline won’t start.
To configure the artifact, go to the Artifact Constraints dropdown for the GitHub trigger configuration, and select “Define a new artifact…“ to bring up the Expected Artifact form.
Enter the artifact information:
Enter a Display Name, or leave the autogenerated default.
In the Account dropdown, select your GitHub account.
Enter a value in the File path field.
☞ Note: This path can be a regular expression. You can, for example, set the object path to be
folder/.*\.ymlto trigger on any change to a YAML file inside
folderin your repository.
Test the pipeline
If you add or modify a file matching your expected artifact to the configured repository, it should execute. If it doesn’t, you can start by checking the logs of the Echo service.