Skip to main content

Git

The git key is intended to be used to add additional scope to app installation tokens.

Keys

KeyRequiredTypeDescription
tokenN(see below)Token scope settings for VELA_GIT_TOKEN variable

Usage

The token key

KeyRequiredTypeDescription
repositoriesNsliceAdd repositories to receive permissions set for token
permissionsNmapDefine permissions for the token (checks, contents)

The token key can be used to generate an installation token so long as the repo has the Vela GitHub App installed.

---
# This setting will generate an installation token with write contents and write checks permissions for
# the repositories listed below as well as the repository running the build: VELA_GIT_TOKEN
git:
token:
repositories:
- alpha/beta
- gamma/delta
permissions:
checks: write
contents: write
note

This token will only be generated if the repository owner also has access to the repositories listed.