Known issues

This page describes known issues in Pipelines:

For issues with Cloud Platform CD, see Known issues in Cloud Platform CD.

The Pipelines section in the Cloud Platform UI doesn’t work with IP allowlisting enabled

The Cloud Platform pipelines user interface uses a user authentication system incompatible with IP address allowlisting.

Workaround: If you are using IP address allowlisting you must use pipelines from the command line, instead of the user interface.

Custom IdP authentication causes 403 error on Pipelines

Users authenticated into using custom identity provider integration receive a 403 error when attempting to authenticate into the Cloud Platform pipelines UI feature and the pipelines client/CLI.

You can only connect Pipelines to repositories owned by the current Bitbucket user

If you are experiencing issues with Bitbucket connections, see the important notes at Connecting pipelines to your Bitbucket repo.

The Bitbucket permissions model requires the current user to own the repository that exists in the personal default workspace of the user, and all of the code being deployed. Repositories cannot be part of a custom workspace.

If permissions are not configured correctly, users might be unable to add branches from external pull requests or experience other issues.

Pipelines is incompatible with Bitbucket infrastructure

Pipelines only works with Bitbucket Cloud, and not Bitbucket infrastructure.

The Bitbucket API has known issues with forks

The API for Bitbucket does not allow you to pull in the branch from a fork inside a pull request.

The Bitbucket API only allows collaborators to see branches

You must add a user as a collaborator to your fork to see the user’s branches.

Deleting pull request branches on merge causes pipelines errors

Bitbucket has an optional setting to automatically delete pull request branches after pull requests are merged. This will cause the pr-merged event in pipelines to fail with an error:

Failed to parse the build file. The VCS path [feature/branch] was not found
in git repository.

Bitbucket commits must be linked to an active Bitbucket user

Bitbucket uses the username and email address associated with a Git commit to associate the commit with a Bitbucket user account. If no user is associated with a commit, Pipelines will fail with an error:

webhook start failed to start pipeline for app [app]. Operation failed with
the following details: Payload do not have the following required

Workaround: Ensure the username and email attached to the commit is associated with a Bitbucket user account.

Pipelines jobs fail if they contain SSH keys generated by OpenSSH version 7.8 or later

OpenSSH version 7.8 now generates RSA key pairs with a default format incompatible with Pipelines. Pipelines jobs that include a SSH key generated in the default format by these versions of OpenSSH in the ssh-keys section of the build definition file will fail with the following error:

Failed to parse the build file. The SSH key named [KEY NAME] is not a valid
SSH private key or requires a password.

Workaround: Generate a key using a format compatible with pipelines jobs:

ssh-keygen -m PEM -t rsa -b 4096

Linked repository cannot be changed if GitHub personal access token is revoked

Pipelines allows you to link repositories to the service to trigger new Pipelines jobs using webhooks.

If you’ve linked Pipelines to a GitHub repository and later revoke the GitHub personal access token used by Pipelines, trying to change the linked Pipelines repository will result in an error: “Please ensure your personal access token is valid. Failed to remove webhook.”

Workaround: Use the Pipeline CLI to reconnect to GitHub, or reconnect GitHub by directly visiting the linking page at the following URL, replacing my-application-id with your application ID:

Why cannot I manually start jobs on tags?

Manually starting jobs only works with branches. Tags are not supported. To manually start a job, ensure that you do it from a branch instead.

Why is my job not triggered automatically?

When both branches and tags do not trigger your pipelines jobs automatically, then it might indicate we need to reset your pipelines credentials.

Contact Acquia Support to request your Pipelines credentials to be reset.

Why cannot I use RVM?

If your YAML build definition invokes RVM (Ruby Version Manager), you will run into errors. To work around the issue, you need to switch your build to using rbenv instead. Rbenv is a lightweight and more developer-friendly option to switch between Ruby versions.

To continue using different versions of Ruby, replace any instances of RVM in your YAML build definition with equivalent rbenv commands.

rvm install x.x.x becomes rbenv install x.x.x.
rvm use x.x.x becomes rbenv global x.x.x or rbenv local x.x.x depending on the desired behavior.