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.
   • Important Note: You do not need to give us access to your code repositories, and do not need to select "All repositories".
   • 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!

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
   • 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 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 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.

Need help? Contact [email protected]