Skip to main content

VCS Providers

AIchor requires access to a Version Control System (VCS) provider to pull repositories and set up webhook integrations. This configuration must be in place before any projects can be created.

Supported providers are GitHub, GitLab, Bitbucket, and Azure DevOps. The VCS configuration is accessible from the Version Control System link in the top navigation menu.

A user must have access to the VCS repository before being added as a member of an AIchor project that uses it.

VCS setup VCS setup

GitLab​

  1. Select GitLab and enter the instance URL if using a self-hosted installation, then click Next.
  2. Click the link next to "register a new OAuth Application" to open GitLab in a new tab.
  3. In GitLab, click Add new application and fill in:
    • Name: a descriptive name for the integration
    • Redirect URI: the callback URL shown in AIchor
    • Scopes: select api (grants complete read/write access to the API, groups, projects, container registry, and package registry)
  4. After saving, GitLab displays the Application ID and Secret. Copy both values into AIchor along with the same name entered in GitLab, then click Create.

GitLab VCS setup GitLab VCS setup

GitHub​

Note: A GitHub organisation administrator must create the VCS integration on AIchor and grant access to the relevant repositories.

  1. Select GitHub and click Next.

  2. Click the Register App button to open GitHub in a new tab.

  3. Fill in the application name and enter the callback URL provided by AIchor.

  4. Choose whether to grant access to selected repositories or all repositories in the GitHub organisation.

  5. Enter the app name in AIchor and click Create.

Bitbucket​

  1. Open the Bitbucket workspace settings, navigate to OAuth consumers, and click Add OAuth consumer.
  2. Fill in:
    • Name: a descriptive name
    • Callback URL: the URL shown in AIchor
    • URL: the URL shown in AIchor
  3. After saving, Bitbucket displays the consumer key and secret. Copy both into AIchor along with the same name entered in Bitbucket, then click Create.

Azure DevOps​

  1. Select Azure DevOps in the VCS configuration screen.

    Azure DevOps VCS select Azure DevOps VCS select

  2. Follow the steps shown in the interface:

    Azure DevOps setup steps Azure DevOps setup steps

  3. In the Azure portal, go to App Registrations and click New registration. Enter a name and select the Single tenant option, then register the application.

  4. Search for Azure DevOps organizations in the Azure console and navigate to My Azure Organizations.

    Azure DevOps homepage

  5. Create a new organisation.

    Azure new org

  6. Inside that organisation, create a new project.

    Azure new project

  7. Open Organization settings (bottom left corner) and add the registered application as a user. Set Access level to Basic, select the project created in the previous step, set the role to Project Administrator, and click Add.

    Azure add user

  8. Copy the Application ID from the registered Azure app into AIchor and complete the setup.

Removing a VCS provider​

A VCS provider can be removed from an organisation provided no projects are currently associated with it. The delete option is accessible from the Version Control System link in the top navigation menu.

Delete VCS Delete VCS