Configure a GitHub artifact account

Spinnaker can be configured to listen to changes to a repository in GitHub. These steps show you how to configure a GitHub artifact account so that Spinnaker can download files from GitHub.

Prerequisites

Downloading credentials

Start by generating an access token for GitHub. The token requires the repo scope.

Place the token in a file ($TOKEN_FILE) readable by Halyard:

echo $TOKEN > $TOKEN_FILE

Editing your artifact settings

All that’s required are the following values:

# See the prerequisites section above
TOKEN_FILE=

ARTIFACT_ACCOUNT_NAME=my-github-artifact-account

First, make sure that artifact support is enabled:

hal config features edit --artifacts true
hal config artifact github enable

Next, add an artifact account:

hal config artifact github account add $ARTIFACT_ACCOUNT_NAME \
    --token-file $TOKEN_FILE

There are more options described here if you need more control over your configuration.