GitHub Integration Guide

Connect GitHub to run GitOps from a repository, host GitHub Actions runners in your cluster, and pull images from ghcr.io.

Overview

Connecting GitHub gives your cluster:

• GitOps: Flux reconciles your cluster from a Git repository.
• CI/CD: private GitHub Actions runner scale sets that run jobs in your cluster.
• Container Registry: GitHub Container Registry (ghcr.io) as an image source.
• Pull request previews: branch deployments build from a branch or tag and create preview environments for pull requests.

Setting Up GitHub Integration

Step 1: Connect GitHub Account

1. Navigate to Integrations > GitHub in Edka dashboard
2. Click Connect GitHub
3. You’ll be redirected to GitHub for authorization

Step 2: Grant Repository Access

Choose repository access level:

• All repositories: Grant access to all current and future repos
• Selected repositories: Choose specific repositories

You can now go to your cluster’s GitOps tab and select the repository you want to use for GitOps.

GitHub Actions runners

After connecting GitHub, you can use Cluster > Actions to install the GitHub Actions Runner Controller add-on and create private runner scale sets for repositories or organizations that the GitHub App can access.

Each scale set registers a private runs-on label that GitHub Actions jobs can target from workflow YAML. See GitHub Actions Runners for setup, container modes, scaling, placement, and runtime logs.