Repository connection issues

Warning
  • If the URL to your repository has suddenly stopped working, jump to this section.
  • If you don't see your GitHub repositories on the list, jump to this section.

Buddy uses your integration details to refresh the synchronized project as soon as it receives a webhook from the Git service hosting the repository. If the credentials to the repository are valid and the webhook has successfully reached the service, Buddy will run git fetch and clone the repository to the pipeline filesystem.

Error

Danger
Commits pushed to synchronized repositories do not appear in Buddy and do not trigger associated pipelines.
Success
If you encounter this problem for the first time, in 9 out of 10 cases refreshing the repository on Buddy will help (see below).
Hint
This kind of problem is usually caused by a networking issue between the Git provider and Buddy.

Possible solutions

I. Refreshing repository

To refresh the list of commits, go the Code tab in your project and click the Manual fetch button:

Image loading...Fetching missing commitsFetching missing commits

Checking provider status

If the problem persists, you can check the provider for possible downtime on their status page:

II. Re-adding desynchronized project

If you don’t see the Deliveries tab in your code details, it means that somebody in the workspace has changed the Git provider to Buddy, i.e. the repository is no longer synchronized with the original Git hosting service.

You can synchronize it back with the original provider by selecting the repository switch option in the top dropdown menu.

III. Debugging connection events

If refreshing the repository manually no longer helps, and you are sure your Git provider is up and running, select Activity from the left navigation panel and look for the following event:

Image loading...Connection errorConnection error

  1. If you find such event on the list, click on it to expand the details:

Image loading...Error details – Activity screenError details – Activity screen

  1. If you don't find such event on the list, go to CodeDeliveries and look for failed webhooks:

Image loading...Error details – Webhook detailsError details – Webhook details

There can be many types of errors there. The most common reasons the integration doesn’t work are:

Expired token

This case most often occurs upon switching the integration type from legacy to GitHub Apps. Try this if you don't see your projects on the list:

Image loading...Error details – repositories missing on the listError details – repositories missing on the list

  1. Go to the Integrations tab.
  2. Click the name of the integration that was used to synchronize the project.
  3. Click Refresh OAuth token.

No access to the project or limited rights

This means that the user who added the integration no longer has access rights to the project hosted on the selected Git provider.

Project name/URL has changed

Hint
Note for GitHub users: If you change the name of the project or move it to a different organization, GitHub updates the project's URL and redirects the old slug to the new address for 30 days. After this time, the old URL stops working on Buddy (we do not receive any information that the URL has changed), which can be confusing for the user given the time between the update on GitHub and the error on Buddy.
  1. Go to the Code tab.
  2. Click the hamburger icon at the top.
  3. Select Switch repository or Git hosting.
  4. Adjust the configuration and click Switch repository.
  5. Make sure to select Clone repository from scratch before refreshing the repository in the final step.

IV. Checking webhooks status

If you updated the integration and the project but new commits still don’t appear in Buddy, go to the Activity tab and see if there are any new push events with your commits.

If you are sure there are no events there, go back to Code > Deliveries and check the webhooks:

  1. If you can’t see any information about new webhooks, refresh the repository manually as in step 1.
  2. If this problem persists for a long time, go to the project's options on your Git provider and look up the Webhooks tab. Locate the webhook that was supposed to reach Buddy and check its status to see if it did reach our service. If everything looks fine, contact our support team.
Hint
In GitHub, the webhooks are located at https://github.com/ACCOUNT_NAME/PROJECT_NAME/settings/hooks.

Possible webhook cases

  1. If the webhook does exist, probably something went wrong while fetching changes to the copy of the repository on Buddy.

    Solution: Fetch the commits manually as in step 1 but make sure to select the option Clone repository from scratch. If subsequent pushes still do not appear on the activity stream, contact the support team.

  2. If pushes started to appear in Buddy but pipelines still aren’t triggered, for 99% the problem are pipelines settings.

    Solution: Make sure that the pipeline's trigger mode is set to On-push and correct ref is selected, and check the trigger conditions in the pipeline. If all these options appear to be correct, contact the support team.

Last update:
Sep 23, 2024