Skip to content

Adding Git Repositories

Connect your Git repositories to CloudPie projects for managing infrastructure code, queries, and policies.

Prerequisites

  • An active project in CloudPie
  • User with permissions to add Git repositories
  • A GitHub App registered in CloudPie (Optional)
  • Valid Git repository URL (HTTPS)
  • Repository access token (Not needed if Github App is registered. Only if using manual token method for private repositories or if Github App is not registered)

Navigate to This Page

  1. Open the Dashboard.
  2. Select your desired project.
  3. In the sidebar, click Git Repositories → Add Repository.

Example Image: Add Git Repository Page
Add Git Repository Page

Step-by-Step Guide

1. Repository Settings

  • Repository URL (Required):
    Enter the full HTTPS URL of your repository.
    Example: https://github.com/orgname/infrastructure.git

  • Branch Name (Optional):
    Specify the branch to use. Default is main.

If your organization has configured the GitHub App, repository discovery will automatically suggest available repositories for selection.

2. Configuration Paths (Optional)

Define optional paths if your repository contains specific configurations:

  • Terraform Configuration Path — Example: /terraform
  • Steampipe Queries Path — Example: /queries
  • Custom Powerpipe Benchmark Path — Example: /benchmarks
  • Policy Governance Path — Example: /policies

Each path tells CloudPie where to locate specific components when running tasks or compliance scans.

3. Authentication

If the repository is private, authentication is required:

  • Via GitHub App:
    The preferred and most secure option. No token entry is needed once the GitHub App is registered.

  • Via Token (manual):
    If no GitHub App is registered, you may use a Personal Access Token (PAT) with read permissions to the repository.
    Example: ghp_xxxxxxxxxxxxxxxxxxxxx

4. Submit

  1. Review all entries for correctness.
  2. Click Submit to save and connect the repository.
  3. The repository will now appear under the Git Repositories list for your project.

Important Notes

  • Repository name is automatically derived from the URL.
  • Invalid paths may cause CI/CD or compliance job failures.
  • Using GitHub App registration is recommended for enhanced security and discovery.
  • Manual tokens should only be used for testing or non-organization repositories.
  • Removing a repository disconnects it from project automations but does not delete it from GitHub.