CodeRabbit Deploy Integration
Overview
Deploy CodeRabbit AI code review integration across your repositories and CI/CD pipelines. CodeRabbit is a GitHub/GitLab App, so deployment means configuring the App installation, customizing review behavior via .coderabbit.yaml , and integrating review status into your merge workflows.
Prerequisites
-
GitHub or GitLab organization admin access
-
CodeRabbit GitHub App installed from coderabbit.ai
-
Repository access configured for CodeRabbit
-
.coderabbit.yaml configuration file
Instructions
Step 1: Install CodeRabbit GitHub App
- Visit https://github.com/apps/coderabbitai
- Click "Install" and select your organization
- Choose repositories (all or select specific ones)
- Authorize the required permissions
Step 2: Configure Review Behavior
.coderabbit.yaml (repository root)
language: en reviews: auto_review: enabled: true drafts: false base_branches: - main - develop path_filters: - "!dist/" - "!/.min.js" - "!/generated/" - "!**/.lock" review_instructions: - path: "src/api/" instructions: "Focus on security, authentication, and input validation" - path: "src/db/" instructions: "Check for SQL injection and proper transaction handling" - path: "**/.test." instructions: "Verify test coverage and edge cases" chat: auto_reply: true
Step 3: Branch Protection Rules
Require CodeRabbit approval before merge
gh api repos/$OWNER/$REPO/branches/main/protection -X PUT
--field required_pull_request_reviews='{"required_approving_review_count":1}'
--field required_status_checks='{"strict":true,"contexts":["coderabbitai"]}'
Step 4: CI Integration
.github/workflows/pr-check.yml
name: PR Checks on: [pull_request]
jobs: wait-for-coderabbit: runs-on: ubuntu-latest steps: - name: Wait for CodeRabbit review uses: lewagon/wait-on-check-action@v1.3.4 with: ref: ${{ github.event.pull_request.head.sha }} check-name: "coderabbitai" repo-token: ${{ secrets.GITHUB_TOKEN }} wait-interval: 30
Step 5: Organization-Wide Configuration
.github/.coderabbit.yaml (organization-level defaults)
language: en reviews: auto_review: enabled: true path_filters: - "!**/.generated." chat: auto_reply: true
Error Handling
Issue Cause Solution
Review not triggered App not installed on repo Check GitHub App installation
Config not applied YAML syntax error Validate .coderabbit.yaml syntax
Review takes too long Large PR Split into smaller PRs
False positives Missing context Add review_instructions for specific paths
Examples
Verify Installation
gh api repos/$OWNER/$REPO/installation --jq '.app_slug'
Should output: coderabbitai
Resources
-
CodeRabbit Setup Guide
-
Configuration Reference
-
GitHub App Permissions
Next Steps
For multi-environment config, see coderabbit-multi-env-setup .
Output
-
Configuration files or code changes applied to the project
-
Validation report confirming correct implementation
-
Summary of changes made and their rationale