This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

External Plugins

This is a placeholder page. Some contents needs to be filled.

1 - cherrypicker

Cherrypicker is an external prow plugin that can also run as a standalone bot. It automates cherry-picking merged PRs into different branches. Cherrypicks are triggered from either comments or labels in GitHub PRs that need to be cherrypicked.

For comments:

/cherrypick release-1.10

The above comment will result in opening a new PR against the release-1.10 branch once the PR where the comment was made gets merged or is already merged.

To use label, you need to apply labels that contain the name of the branch in the form:

cherrypick/XXX

where XXX is the name of the branch.

The bot uses its own fork to push patches that need to be cherry-picked and opens PRs out of those patches. The fork is created automatically by the bot so there is no need to set it up manually.

Required scopes for the oauth token that need to be used are read:org and repo.

2 - netlify-preview

netlify-preview is an external Prow plugin that retries the latest Netlify deploy preview for a pull request in response to a chat command. It is intended for repositories whose pull request previews are built by Netlify (for example kubernetes/website and kubernetes/contributor-site).

Commands

/retest

Retries the latest Netlify deploy preview for the PR only when that preview is in error state. If the preview is ready, the plugin posts a comment explaining that /retest will not retry passing previews and points the user to /rebuild-preview.

/rebuild-preview

Forces a retry of the latest Netlify deploy preview regardless of its current state, with one exception: if a build is already running (building or enqueued), the plugin declines and reports the in-progress preview rather than triggering a redundant build.

Both commands require the comment author to be trusted under the same rules that Prow’s trigger plugin applies: org members, configured trusted apps and orgs, or PR authors who have received /ok-to-test.

Configuration

The plugin reads a small YAML configuration file that maps each repository to a Netlify site. Repositories that are not listed are ignored.

repos:
  kubernetes/website:
    site_id: <netlify-site-id>
  kubernetes/contributor-site:
    site_id: <netlify-site-id>

Repositories that are listed under external_plugins: in the Prow configuration but missing from this file will receive a comment explaining that no Netlify preview site is configured.

Required credentials

A Netlify personal access token (or a scoped equivalent) with permission to list site deploys and call the deploy retry endpoint. The plugin reads it from a file specified at startup. The token never reaches core Prow components.

Webhook events

The plugin only subscribes to issue_comment events.