GitHub

Connect GitHub

1. Sign in or choose GitHub during source selection.
2. Start the Kuberns GitHub App installation flow.
3. Select the GitHub account or organization.
4. Grant access to the repositories you want Kuberns to deploy.
5. Return to Kuberns.
6. Select the installation, repository, and branch.

Kuberns stores installation and repository identifiers used to retrieve source and match webhook events.

Push-triggered deployment

Kuberns verifies the GitHub webhook signature. On a matching branch push, it records:

• Repository owner and identifier.
• Full repository name.
• Branch.
• Commit ID.
• Compare URL.
• Commit message.
• Committer.

It then creates a Git push activity, creates build history, and queues deployment work.

Repository marker

During repository permission setup, Kuberns can create or update .kuberns. See The .kuberns file.

Change repository access

Update repository access from the GitHub App installation settings. If a repository no longer appears in Kuberns, verify that the selected installation still has access.