This Approach works for both GitHub and GitHub Enterprise
Regardless of which github version you're using this approach can work for either. However you will need to be mindful of adapting the code snippets to your particular scenario (i.e., github, or github_enterprise in the codecov.yml)
Rather than using a Team Bot, a GitHub App Integration can be used in GitHub (Cloud or Enterprise) to efficiently onboard new teams to Codecov.
The App Integration will allow teams to add Codecov directly to their repositories via the GitHub user interface.
This integration is meant to be a replacement for the Team Bot for GitHub (Cloud or Enterprise). Using it will ensure that comments are posted to Pull Requests as Codecov, rather than a Team Bot user.
Webhooks need to be enabled for the GitHub App to work. This is the method the app uses to connect and communicate with Codecov.
To create a GitHub App Integration for Codecov, first navigate to your GitHub Apps:
Choose "New GitHub App":
And fill out the relevant fields for app creation:
It's important to set the proper homepage and callback URLs. They should point to your Codecov Enterprise install as follows:
For the webhook URL:
You should provide a secret. Once provided, you will want to ensure that you properly provide the secret in the Codecov Enterprise codecov.yml. See:
Manually creating webhooks for Github Enterprise
The following screenshot shows all permissions needed by the app integration, as well as the relevant events. For visibility permissions with a greater setting than "No Access" have been emphasized in green.
No user permissions are required. All can be set to "No Access"
If you're not using GitHub Enterprise, make sure that you only publish this app for your organization.
After creating the GitHub App, Github will prompt you to create a .pem file from the github ui. This will result in a .pem file you can download. Once downloaded you will need to place this file in the same directory as your codecov.yml and docker-compose.yml and update your docker-compose.yml as follows:
web: #... other configuration volumes: - ./file.pem:/config/file.pem worker: #... other configuration volumes: - ./file.pem:/config/file.pem
You will need to add the
webhook_secret sections to the
github_enterprise) section of your codecov.yml as follows:
github: client_id: "ff523b316dbe1b573220" client_secret: "30f197d4aeb2ef64604f03c944595dd9b1d6abb6" webhook_secret: "ff523b3162ef64604f03c94459" integration: id: 63040 pem: /config/file.pem
integration.id is the
App ID value shown on your integration's page in GitHub, and
pem is the path to the pem file you created in the
- If you don't receive comments on Pull Requests for Repositories with the App Integration installed, visit the repo settings page for that particular repository on your Codecov Enterprise install:
For GitHub Enterprise:
Once there, check the "GitHub Webhook" section and press the "Create Web Hook" button if a webhook is not already set.
Updated 15 days ago