Skip to main content

Troubleshooting Pipelines and CI jobs

Guidance on how to troubleshoot your CI job issues, e.g. metadata types not deployed to your target environment

Valerio Chang avatar
Written by Valerio Chang
Updated yesterday

How can this article help?

While deploying via Gearset pipelines, some users encounter issues with their CI job not deploying metadata as they expect. Typically, this is caused by a couple of common configuration issues with the users CI job.

In our experience, almost all of the reasons a CI job would not deploy metadata are covered in this guide. If you find that your CI job hasn't deployed metadata as you expect, we would recommend checking the steps in this guide in order.

Steps to troubleshoot your CI job deployment issues

What to do if you want to deploy the (missing) components to the target environment of your CI job?

Once a PR has been merged, you may need to manually deploy to the org because the changes you were trying to deploy are already present on the environment branch.

The quickest way to do this is to use the manual deployment process (by which we mean Compare and deploy) to deploy the items that have not been deployed in the CI job.

Gearset will allow you to unselect the problem analyzer(s) on the dedicated problem analyzers page - which usually gets displayed on the pre-deployment summary page after you've selected your items for deployment and clicked on Next.

What if these questions haven't helped?

We believe that above guidance will help you with identifying at which stage the problem has occurred and what you can do.

However, if you come into a scenario that we haven't covered in our troubleshooting steps or they haven't helped - please reach out to us in the in-app, as we'd like to hear about it!

Did this answer your question?