Skip to main content
Version: 0.3

Git Connection

Git Connection​

Konstruct connects to your GitHub organizations through a GitHub App to manage GitOps repositories and automate infrastructure delivery. When you connect a GitHub organization, Konstruct automatically creates two private repositories for managing your platform.

Prerequisites​

  • A GitHub App configured for your Konstruct instance. See GitHub App Setup.
  • The GitHub App installed on the GitHub organization you want to connect.

Connect a GitHub Organization​

  1. Navigate to Organizations and select your organization.

  2. Click the Git connection tab.

  3. Click Connect and complete the GitHub App authorization flow. This redirects you to GitHub where you authorize the Konstruct GitHub App and select the organization to install it on.

  4. After completing the flow, you should see the GitHub connected status with your Konstruct repositories listed:

    GitHub App connected confirmation

Repositories Created​

When you connect a GitHub organization, Konstruct creates two private repositories:

RepositoryNaming ConventionPurpose
Organization GitOps repositoryorgname-gitopsInfrastructure, platform tooling, and cluster configurations
Application repositoryorgname-gitops (in the application org)Application delivery and deployment states

Organization GitOps Repository​

The organization GitOps repository houses your infrastructure and platform resources. As clusters are provisioned, Konstruct populates this repository with templates and registry entries from konstruct-templates, including workload cluster templates, Terraform modules, and cluster-specific configurations.

Your organization's GitOps repository includes:

  • catalog/ directory: Reusable GitOps Catalog for infrastructure and application templates
  • registry/ directory: Deployed instances and environment configurations
    • registry/environments/: Application deployments per environment and cluster
    • registry/clusters/: Infrastructure and platform tool configurations

Learn more about creating catalogs for reusable infrastructure and application templates.

Application Repository​

The application repository manages application delivery. As your team's applications update with new container builds and charts, the updated versions are set in this repository. ArgoCD automatically syncs those changes to your Konstruct clusters.

Disconnect​

To disconnect the GitHub organization, click the Disconnect button on the Git connection tab.