Skip to content

Latest commit

 

History

History
56 lines (42 loc) · 2.55 KB

github-apps.adoc

File metadata and controls

56 lines (42 loc) · 2.55 KB

GitHub Apps

We have been using the GitHub Apps in our infrastructure from July 30, 2020. These apps help us to provide higher rate API limits on the infrastructure, and to get access to GitHub Checks and Deployment APIs.

ci.jenkins.io

App URL owner

ci-jenkins-io

jenkinsci

This app is used to report build statuses on ci.jenkins.io. It is used in Multi-Branch Pipeline GitHub org folders, including plugins, Jenkins core repositories, infrastructure, etc.

Permissions:

  • The app requires write access to GitHub pull requests, checks and deployments. More permissions may be added later when we expand GitHub integrations on ci.jenkins.io. See this page for a full list of permissions (needs admin access to the jenkinsci GitHub org).

  • The app has access to the following GitHUb organizations:

    • jenkinsci- all repositories

    • jenkins-infra - a limited number of repositories which are built on ci.jenkins.io (Infra directory)

    • stapler - all repositories

  • More organizations and permissions might be added upon request in the Jenkins infrastructure channels.

Note
Not all functionality on ci.jenkins.io uses this GitHub app at the moment. There are Pipeline steps (e.g. Incrementals deployment) which use plugins not yet integrated with the GitHub App authentication support. Such functionality keeps using the @jenkinsadmin GitHub bot.

Plugin Site App

App URL owner

jenkins-plugin-site

jenkinsci

This app is used by the [Jenkins Plugin Site](http://plugins.jenkins.io/) which needs access to GitHub in order to generate documentation and to display dynamic content like changelogs and GitHub issues. See jenkins-infra/plugin-site-api/ and jenkins-infra/plugin-site/ for usages.

Permissions:

  • This app requires read-only access to the repository code, contents (releases, etc.) and metadata

  • This app is installed for all repositories in the jenkinsci GitHub organizations

  • At the moment we do not serve GitHub-based documentation for plugins hosted in other GitHub organizations, so plugin maintainers cannot enable this app elsewhere.