Troubleshoot

If you need further assistance setting up GitOps, feel free to reach us.

Issue not created

  1. Bytebase only observes merge event. If the file is pushed to the branch directly, it will be ignored.
  2. Migration file must follow the path and naming convention.
  3. Bytebase has configured a proper External URL and the URL is network accessible from VCS.

Bytebase observes the VCS merge event via webhook. The created webhook link is on the top of the Git connector setting page.

webhook-link

Check the webhook running history to debug the reason.

webhook-running-detail

Empty repository list

empty-repository-list

When you add GitOps connector to your project, make sure the configured Git Provider user has admin access to the repository. You can verify this by calling the VCS API directly:

Duplicate version

duplicate-version

This usually happens if a version has been successfully applied, and you are trying to modify the existing file having that version string. This is a typical sequence causing the error:

  1. You create a new migration 00890_my_feature.sql and merge it.
  2. The merge event creates a Bytebase issue.
  3. You successfully roll out the issue and thus apply migration version 00890 to the database.
  4. You want make some changes to my_feature. Thus you change the existing 00890_my_feature.sql and merge it.
  5. The merge event creates another Bytebase issue.
  6. Once you attempt to roll out the issue, you will receive the duplicate version error. Because version 00890 has already been applied.

Modifying existing file is only OK if the migration hasn't been completed successfully yet. This is a OK sequence:

  1. You create a new migration 00890_my_feature.sql and merge it.
  2. The merge event creates a Bytebase issue.
  3. You realize the error before attempting the rollout, or you attempt the rollout and it fails.
  4. You correct the error by making changes to 00890_my_feature.sql and merge it again.
  5. The merge event creates another Bytebase issue.
  6. You successfully roll out the issue and thus apply migration version 00890 to the database.
  7. You close the first issue. (You can also do this proactively after step 3).

GitLab

Failed to create webhook xxx, status code: 422

If you configure External URL with the private IP such as 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, you will need to enable Allow requests to the local network from webhooks and integrations first.

activity-warning

INVALID_ARGUMENT: failed to fetch repositories

gitlab-invalid-pat

If your GitLab is before 12.2, then the personal access token won't work and you need to use the OAuth token to configure the GitLab Provider

Edit this page on GitHub

Subscribe to Newsletter

By subscribing, you agree with Bytebase's Terms of Service and Privacy Policy.