Integrating Git Accounts

Why Link your Git Accounts?

Facets enables GitOps workflows by connecting your Git accounts. This allows you to:

  • Manage infrastructure configurations directly from your Git repositories
  • Track infrastructure changes through Git history
  • Enable two way sync between your Git accounts and Facets

How To Link Your Github Account

Connect your Github account by installing the Facets Github App, providing secure access to your repositories.

Steps to Link:

  1. Navigate to Settings -> Accounts in Facets
  2. Click on the Github icon.
  3. Provide a Unique Name for the integration, this is only used on Facets.
  4. Click on Link to start the GitHub App installation
  5. Select your Organization and Repositories you'd like to give access to through GitHub's interface.
  6. You have now successfully linked your GitHub account!

Interactive Walkthrough

Here's an Interactive demo showing the step-by-step GitHub linking process

How To Link Your GitLab Account

Connect your GitLab account by installing the Facets GitLab App, providing secure access to your repositories.

Steps to Link:

  1. Navigate to Settings -> Accounts in Facets
  2. Click on the GitLab icon.
  3. Provide a Unique Name for the integration, this is only used on Facets.
  4. Click on Link to start the GitLab App installation
  5. You will be redirected to GitLab, where you can approve the installation.
  6. Once you approve the installation, you'll be redirected back to the platform.
  7. Select the GitLab Group you want to grant access to Facets
  8. Click on Save Details to update the connection
  9. You have now successfully linked your GitLab account!

Interactive Walkthrough

Here's an Interactive demo showing the step-by-step GitLab linking process


How To Link Your Bitbucket Account

Connect your Bitbucket account by installing the Facets Bitbucket App, providing secure access to your repositories.

Steps to Link:

  1. Navigate to Settings -> Accounts in Facets
  2. Click on the Bitbucket icon
  3. Provide a Unique Name for the integration, this is only used on Facets
  4. Click on Link to start the Bitbucket App installation
  5. You will be redirected to Bitbucket, where you can approve the installation
  6. Once you approve the installation, you'll be redirected back to the platform
  7. Select the GitLab Workspace and Project Key you want to grant access to Facets
  8. Click on Save Details to update the connection
  9. You have now successfully linked your Bitbucket account!

Interactive Walkthrough

Here's an Interactive demo showing the step-by-step GitLab linking process


Post-Installation

After linking your Git Account :

  • The connected account appears in your Account Management dashboard and is immediately active for GitOps workflows.
  • You can view the connection status, projects it is being used in by clicking on the account.

Need help? Contact [email protected]