Git Integrations

Integrate with GitHub, Bitbucket, or GitLab to perform checks against your repositories and define services through config-as-code with opslevel.yml.

You likely use a myriad of cloud-based tools to operate your services. At OpsLevel, part of our master plan is bringing various data points from all of these tools to help you gain insights and build more reliable software.

Git Integration

Our Git integrations unlock a lot of functionality in OpsLevel:

  • Checks that can dive deep into your codebase.
    Do you want to make sure all your Python services are on a modern version of the language?  Or that no services are using an old library that you’re trying to deprecate?  Or that every service has a CircleCI config file?  You can do that.
  • OpsLevel will stay up-to-date by reading the opslevel.yml files in your services’ repos.
    Now you don’t have to go to OpsLevel’s UI to update your service metadata and can make changes to service metadata using pull requests.

To set up a GitHub, Bitbucket, or GitLab integration, go to our Integrations tab and hit “New Integration”. Then, look for the integration you want and hit “Add Integration.” Make sure the account you use has the right permission level to add the respective apps to your Organizations/Projects/Groups.

New GitHub Gitlab Bitbucket Integration

You will be prompted to go to follow the link to your Git provider where you will need to sign in and authorize.

Add GitHub Integration Modal

Once you’ve authorized the app, we will pull in your repos, and try to connect any services with an opslevel.yml.

Sync Repos

Map a Repository to a Service

Now that OpsLevel can scan your repos, all that’s left is to map them to your services.

NOTE: If you want to manage your service metadata in code with an opslevel.yml file, you can skip the steps below. Adding an opslevel.yml file to your repo will automatically create a service in OpsLevel and do the mapping for you.

If you need to manually map a service to a repository, you can do this from that service’s Repositories card.

On the service’s detail page, navigate to the Operations Tab. Then in the Repositories card, click “Edit”.

Edit Service Repositories

Then click “Add Repository”.

Edit Repositories Button

From here you can pick the repo that corresponds to this service’s code base.

If the service’s code lives in a mono-repo, you can optionally include a sub-path in the “Directory” field.

Add Repository Modal

If the service’s code is split across multiple repos, feel free to map multiple repositories to your service in OpsLevel. Checks will be run across all of them.

Have fun

Now you can start setting up some Repo File Checks, Repo Search Checks and start using opslevel.yml to keep OpsLevel data up-to-date.

If you have any questions or are interested in trying out OpsLevel, hit us up at info@opslevel.com.