Covered in this doc
Integrating Percy with your Buildkite CI environment
Start by configuring
PERCY_TOKEN, our project-specific, write-only API token. It can be found in your Percy project settings and add it to your Buildkite build pipeline config or agent hooks.
In your Buildkite pipeline, go to Settings > Steps > Environment Variables.
PERCY_TOKEN to the write-only token from your Percy project. This token can be found in each Percy project's settings.
Keep your Percy token secret
Anyone with access to your token can add builds to your project, though they cannot read data.
If you use Docker containers in your Buildkite builds, you need to pass some environment variables in to your containers for Percy's client library to detect the environment correctly.
Add this to your
environment BUILDKITE BUILDKITE_COMMIT BUILDKITE_BRANCH BUILDKITE_PULL_REQUEST BUILDKITE_BUILD_ID PERCY_TOKEN
By leaving the value blank, Docker will pass through the value from the host Buildkite environment.