This page provides tips to solve common problems that users have encountered.
Troubleshooting JFrog Platform
Troubleshooting Access Service
Troubleshooting Access Tokens
Troubleshooting High Availability in Xray
Troubleshooting Insight
Troubleshooting Pipelines
This troubleshooting section contains information to help you find and resolve some common Pipelines issues.
Pipelines Error Messages
This section lists commonly-encountered Pipelines error messages, possible causes, and some suggestions for resolving the errors. If you have trouble fixing any of these errors, submit a request to Support for further investigation.
Error: All resource versions are not fetched
Error | reqKick|executeStep|step|prepData|jFrogPipelinesSessionId:28be9c21-4ad6-4e3d-9411-7b9988535fd1|_getResourceVersions, All resource versions are not fetched. Requested resource versions: 16; received resource versions: [] |
Cause | After the run was triggered, but before it started running, one or more resources in the pipeline were reset. Hence, while fetching the resources associated with the run, the resource version was returned as an empty array. |
Resolution | Re-run the pipeline. When a resource is reset, it wipes out the resource version history and resets it to a single version, which is now considered the latest. This version is used for the new run. |
Error: fatal: reference is not a tree
Error | fatal: reference is not a tree: 679e2fc3c2590f7dbaf64534a325ac60b4dc8689 |
Cause | This could be a result of using |
Resolution | Either:
or
|
Error: Failed to create pvc for node
Error | Failed to create pvc for node |
Cause | Either the Kubernetes configuration does not have access to create a Persistent Volume Claim (PVC) resource or Pipelines cannot connect to the provided Kubernetes host server. |
Resolution | Review the Kubernetes configurationsand verify that the |
Error: SCM provider credentials do not have enough permissions
Error | The credentials provided for the integration "<integration_name>" do not have enough permissions. Ensure that the credentials exist and have the correct permissions for the provider: github. |
Cause | The credentials (username and/or token) provided while creating the integration are either incorrect or insufficient. |
Resolution | Ensure that the credentials provided for the SCM provider are correct and have sufficient permissions. |
Error: SCM provider URL is invalid
Error | The URL provided for the integration “<integration_name>” is invalid. Provide a valid URL for the SCM provider and try again. |
Cause | The SCM URL provided while creating the integration is incorrect. |
Resolution | Ensure that the URL provided for the SCM provider is correct. |
Error: SCM provider repository path is invalid
Error | The repository path "<repo_path>" is either invalid or does not exist. Ensure that the repository path exists and has the correct permissions for the integration: <integration_id>. |
Cause | The repository path provided for the SCM provider is either incorrect or does not exist. |
Resolution | Ensure that the repository name provided for the SCM provider is correct. |
Error: Step type cannot be updated
Error | type cannot be updated from <step_type> to <step_type> in step <step_name> Example: |
Cause | After the pipeline performs a sync, a step's type should not be modified, as it can cause pipeline sync errors. |
Resolution | Though not recommended, if you do want to change a step's type, perform the following steps:
|
Error: Ubuntu 16.04 not supported
Error | Ubuntu_16.04 has reached end of support. Please upgrade to a higher version. |
Cause | Ubuntu Linux 16.04 LTS reached the end of its five-year LTS window on April 30th 2021 and is no longer supported by its vendor. Due to this,Pipelines no longer supports your existing Ubuntu 16 node pools. |
Resolution |
For information about the supported Ubuntu versions, see the System Requirements Matrix. |
Error: CentOS 8.0 not supported
Error | CentOS 8 has reached end of support. Please change the OS to another supported version. For the list of supported versions, see System Requirements. |
Cause | CentOS 8.x reached end-of-life is on December, 2021 and is no longer supported by its vendor. Due to this, Pipelines no longer supports your existing CentOS 8 node pools. |
Resolution |
For the list of supported OS versions, see System Requirements. |
Error: postHook returned error 422
Error | Failed to sync hook with err: Webhook creation failed for path: userName/repoName and integration: myGithub with err: postHook returned error 422 for userName/repoName |
Cause | This is usually the result of too many webhooks. GitHub allows 20 webhooks per repository. |
Resolution | In GitHub, go to the Settings | Webhooks tab for the relevant repository and delete all the failed webhooks. |
Error: Connection was not successful
Error | Connection was not successful |
Cause | One of the reasons for this message to appear is when the Artifactory/Distribution URL provided for the integration is incorrect. |
Resolution | Verify that your Artifactory/Distribution URL provided for the integration is correct. If you find that it is incorrect, update the URL and use the Test Connection button to verify, and then save. |
Error: step "step_name" cannot interrupt affinityGroup "affinity_group_name".
Error | custupd_docker: step "bundle" cannot interrupt affinityGroup "group1". Connection was not successful |
Cause | This occurs when there are multiple steps in a pipeline and the intermediate step(s) belong to a different affinity group. This interrupts the flow of the steps. For example: There are three steps in sequence, Step A, Step B, and Step C. Step A and Step C are part of the affinity group Group A, but Step B is part of the affinity group Group B. |
Resolution | Define all the steps and its dependencies in the same affinity group. There should not be any intermediate steps that are part of a different affinity group. For example, do one of the following:
|
Error: Unable to get branches Ensure that the repository path exists and has the correct permissions for the integration id: 326
Error | Unable to get branches Ensure that the repository path exists and has the correct permissions for the integration id: 326 custupd_docker: step "bundle" cannot interrupt affinityGroup "group1". Connection was not successful |
Cause | This happens when the token has expired. |
Resolution | Use Test Connection to check the connection. If the test fails, use a new token and try again. |
Error: Pipeline <pipeline_name> has invalid integrations <credentials> in configuration.integrations.
Error | Pipeline <pipeline_name> has invalid integrations <credentials> in configuration integrations.Please check that they exist and that they are allowed to be used by this pipeline source. |
Cause | The integration is not shared with the Project. |
Resolution | Ensure that the integrations mentioned in the pipeline are added to or shared with the Project. |
Error: One or more of the steps in this pipeline has become inconsistent since the last successful sync. Please sync your pipeline now to try and correct this.
Error | One or more of the steps in this pipeline has become inconsistent since the last successful sync. Please sync your pipeline now to try and correct thisck that they exist and that they are allowed to be used by this pipeline source. |
Cause | The integration is not shared with the Project. |
Resolution | Ensure that the integrations mentioned in the pipeline are added to or shared with the Project. |
Error: Pipeline has disconnected steps
Error | Pipeline <pipeline_name> has disconnected step(s): <step_name> |
Cause | This happens when the step mentioned in the error is not an input/output to any other step. |
Resolution | Add the step as an input/output to another step in the pipeline. |
Issue: Build is triggered on branch and master. Expectation is to trigger only on branch
Issue | Build gets triggered on branch and master on creation of PR. Expectation is to trigger pipeline only on branch Example resources: - name: {{ .Values.gitResourceName }} type: GitRepo configuration: gitProvider: {{ .Values.gitProvider }} path: {{ .Values.repoPath }} files: exclude: .jfrog-pipelines/* branches: include: {{gitBranch}} pullRequestTargetBranches: include: master buildOn: pullRequestCreate: true |
Cause | This is because |
Resolution | This can be solved using one of the following:
|