Skip to main content
Version: 0.7 (Next)

Git Connection

Git Connection​

Konstruct connects to your Git provider to manage GitOps repositories and automate infrastructure delivery. GitHub organizations connect via a GitHub App. GitLab groups and other providers connect via a personal access token (PAT). When you connect a Git provider, Konstruct automatically creates two private repositories for managing your platform.

Prerequisites​

  • GitHub: A GitHub App configured for your Konstruct instance. See GitHub App Setup. The GitHub App must be installed on the GitHub organization you want to connect.
  • GitLab: A personal access token with repository write access to your GitLab group.

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

Connect a GitLab Group​

  1. Navigate to Organizations and select your organization.
  2. Click the Git connection tab.
  3. Select GitLab as the provider and enter your GitLab group URL and personal access token.
  4. Click Connect. Konstruct verifies the token and creates the required repositories in your GitLab group.

Repositories Created​

When you connect a Git provider, 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. Argo CD automatically syncs those changes to your Konstruct clusters.

Disconnect​

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