GitHub Integration

The Kuberik Environment API uses the GitHub Environments and Deployments APIs as a coordination layer for multi-cluster promotions.

Setup

Create GitHub Token

Go to github.com/settings/tokens
Click Generate new token (classic)
Select scopes:
- repo:deployment (Read and write access to deployments)
Copy the generated token

Store this token securely. It provides write access to your repository.

Create Kubernetes Secret

kubectl create secret generic github-credentials \
  --from-literal=token=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  -n default

Verify:

kubectl get secret github-credentials

Configure Environment Backend

Reference the secret in your Environment:

apiVersion: environments.kuberik.com/v1alpha1
kind: Environment
metadata:
  name: production
spec:
  rolloutRef:
    name: my-app
  name: "production"
  backend:
    type: github
    project: "my-org/my-repo"    # owner/repo format
    secret: "github-credentials"  # Secret name

Next Steps

Automated Promotion

Multi-stage pipelines

Environments Concept

How environments work

FluxCD Integration Datadog Integration