Docs
Support
IntroductionGetting StartedPlatform GuidePraxis (AI)API ReferenceChangelog

Integrating Git Accounts

Link GitHub, GitLab, or Bitbucket accounts to Facets for GitOps workflows, with step-by-step instructions and interactive walkthroughs for each provider.

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

The raptor commands on this page are the Praxis CLI. See Install Praxis CLI to set it up.

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

Using prompt

Link my Github account to Facets and call it my-github.

or

Using command

raptor create github-app-account --name my-github -w

This is the same App install the console starts: the command prints the URL to open, and -w waits until GitHub reports the installation done. Add --enterprise-host github.mycompany.com for GitHub Enterprise.

If you would rather authenticate with a personal access token than install the App, raptor create github-account --name my-github --username USER --token TOKEN --org MY_ORG does that instead, and the token is validated against the GitHub API before the account is created.

New to the CLI? Install it first.

  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.
    • Select any existing Facets blueprint repositories you want imported into Facets.
    • GitHub does not allow selecting zero repositories, so if you have none to import yet, pick any single repository just to complete the install. You can update the selection later.
    • 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.

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

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

Using prompt

Link my GitLab account to Facets and call it my-gitlab.

or

Using command

raptor create gitlab-app-account --name my-gitlab -w

The command prints the URL to authorize the app, and -w waits for the authorization to come back. Add --enterprise-host gitlab.mycompany.com for self-hosted GitLab. For a token instead of OAuth, use raptor create gitlab-account.

New to the CLI? Install it first.

  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.

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

Using prompt

Link my Bitbucket account to Facets and call it my-bitbucket.

or

Using command

raptor create bitbucket-app-account --name my-bitbucket -w

The command prints the URL to authorize the app, and -w waits for the authorization to come back. For a token instead of OAuth, use raptor create bitbucket-account.

New to the CLI? Install it first.

  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

Integrating Cloud Accounts

Step-by-step guide to connecting AWS, Azure, GCP, and Kubernetes accounts to Facets by running a generated command in your cloud provider's shell.

The Facets GitHub App

How the Facets GitHub App installation works, what "GitHub org approval needed" means, and what to know before changing the installation on GitHub.

On this page

Why Link your Git Accounts?
How To Link Your Github Account
How To Link Your GitLab Account
How To Link Your Bitbucket Account
Post-Installation