Development Guide

We’re happy you’re interested in contributing to the Cilium project.

This section of the Cilium documentation will help you make sure you have an environment capable of testing changes to the Cilium source code, and that you understand the workflow of getting these changes reviewed and merged upstream.

• How To Contribute
  • Clone and Provision Environment
  • Submitting a pull request
  • Getting a pull request merged
  • Pull requests review process for committers
  • Weekly duties
    • Pull request review process for Janitors team
    • Triage issues for Triage team
    • Backporting PR for Backport team
  • Developer’s Certificate of Origin
    • Cilium Committer Grant/Revocation Policy
    • Template Emails
• Development Setup
  • Requirements
  • Vagrant Setup
    • Using the provided Vagrantfile
    • Options
    • Launch CI VMs
    • Manual Installation
    • Notes
  • Local Development in Vagrant Box
    • Build Cilium
    • Install to dev environment
    • Restart Cilium service
  • Making Changes
  • Add/update a golang dependency
  • Add/update a new Kubernetes version
    • Minor version
    • Patch version
  • Optional: Docker and IPv6
  • Debugging
    • Datapath code
• Building Container Images
  • Developer images
  • Official release images
  • Official Cilium repositories
  • Update cilium-builder and cilium-runtime images
  • Nightly Docker image
• Code Overview
  • High-level
  • Cilium
  • Hubble
  • Important common packages
• Debugging
  • toFQDNs and DNS Debugging
    • Isolating the source of toFQDNs issues
  • Mutexes / Locks and Data Races
    • Deadlock detection
• Hubble
  • Bumping the vendored Cilium dependency