Codecov Self-Hosted Install Guide

📘

Deployment using Terraform or Helm for AWS, GCP, and Azure

Full deployment scripts using Terraform or Helm can be found for AWS, GCP, and Azure here: https://github.com/codecov/enterprise-resources

Codecov Self-hosted does not endorse or support custom deployments beyond AWS, GCP, and Azure.

Prerequisites to Installing Codecov Self-Hosted

🚧

S3 Compatibility Requirements

Please note, to be able to use any S3 / minio compatible storage, you must be able to grant at least the following policies. The application will not work if any of these cannot be granted.

"s3:GetObject",
"s3:PutObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts",
"s3:GetBucketLocation",
"s3:HeadBucket",
"s3:ListBucket",
"s3:ListBucketVersions"

Sizing guide for Codecov infrastructure

📘

Infrastructure Monitoring

It is highly recommended to set up infrastructure monitoring from Day 1 of usage of Codecov Self-hosted in Grafana or a similar reporting tool.

Key metrics to monitor:

• Celery Queue Size should always be trending towards zero.
• CPU usage on the worker node. We recommend no more than 2 workers per compute node, due to high CPU requirements.
• Storage growth. Depending on the frequency of uploads and the report size, be sure to allocate sufficient DB storage.
• Due to resource consumption requirements, and different needs to prioritize CPU over RAM, it is strongly recommended to separate web and worker instances.

Read more about available StatsD metrics here

Bare Minimum Steps to a Working Implementation of Self-Hosted Codecov

1. Receive Needed credentials

• Receive an Enterprise License key from Codecov staff and placed it into your codecov.yml

2. Setup External Services

• Create an OAuth level integration in your repo service provider and have the Client ID and Client Secret ready to use.
• If using GitHub or Github Enterprise, you will have created a GitHub App Integration as well.
• Create an external, managed, postgres database (e.g., AWS RDS, Google Cloud SQL, etc) and have the url with username and credentials in your codecov.yml
• Create an object storage mechanism (e.g., an AWS S3 bucket, a Google Cloud Storage Bucket, etc) and have the bucket name on hand, plus credentials to supply to the codecov.yml
• Caveat: If you’re using S3, you can instead ensure codecov runs on a VM with a StorageAdmin S3 role, or using a suitably permissioned* S3 role.
• Create a separate, managed Redis database (e.g., AWS Elasticache, etc) and have the credentials to supply to the codecov.yml.

3. Edit Configuration

• Supply the needed configuration derived from the above steps into the codecov.yml

4. Setup Codecov Application Infrastructure

• Navigate to our configuration repo: https://github.com/codecov/enterprise-resources
• Choose the configuration preset that makes the most sense for your infrastructure and needs.
• Follow the instructions there to ensure and ensure your codecov installation is working by navigating to it in your browser.

Read more about Enterprise Deployment Strategies meant for production use.

5. Test Codecov

Integrate Codecov into your CI and upload a coverage report
Ensure that Codecov comments and status checks appear on Pull Requests