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 Add VCS Account, then choose GitHub.
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.
   • Important Note: You do not need to give us access to your code repositories, and do not need to select "All repositories".
   • Where your organization has been moved onto the shared Facets GitHub App installation, any repository a Praxis agent works on must sit inside this selection.
   • You can select any existing Facets blueprint repositories if you have them and want them imported into Facets.
   • Otherwise, select any random repository (GitHub does not allow selecting zero repositories, unfortunately).
   • After this setup, any project created from Facets will also have a repository created with it. That repository will automatically be added to the app installation.
6. You have now successfully linked your GitHub account!

To learn what the installation does after linking, and what a GitHub org admin may need to approve, see The Facets GitHub App.

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 Add VCS Account, then choose GitLab.
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
   • Important Note: The group is needed to know where to create the repositories when creating a new project in 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 Add VCS Account, then choose Bitbucket
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 Bitbucket Workspace and Project Key you want to grant access to Facets
   • Important Note: The workspace and project key are needed to know where to create the repositories when creating a new project in 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 Bitbucket 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.
• A GitHub account linked through the Facets GitHub App can be fully linked and still be blocked until a GitHub org admin approves updated permissions. See The Facets GitHub App to check the status and resolve it.

Need help? Contact support@facets.cloud