Cloud Platform
Installing the Pipelines client
This page describes how to download and install the Pipelines client, and how to update a previously installed client. The client is installed locally to perform Pipelines jobs, which are carried out by Cloud Platform.
Installing the Pipelines command-line client is optional, and not required for Pipelines to function with your application.
To use the Pipelines client, you must have PHP version 7.4, 8.2, 8.3 available in your local work environment (glossary term, activate to view definition).
To use the Pipelines client, you must have the Execute pipelines permission for the Cloud Platform application (glossary term, activate to view definition) that you’re working with. By default, users who have been assigned the
An organization (glossary term, activate to view definition)’s can create new roles that have these permissions, or modify existing roles to add these permissions. For more information, see
You can install the Pipelines client from the command prompt by using the following command:
Cloud Platformcurl -o pipelines https://cloud.acquia.com/pipeline-client/download
chmod a+x pipelines
mv pipelines /usr/local/bin
## If you encounter a Permission denied error when you use the mv command, you must use the command with sudo. Move the pipelines program to a directory in your PATH.
After you have installed the Pipelines client, you must configure the client with a Cloud Platform API token. This enables the client to authenticate with Cloud Platform.
Pipelines users are required to create an API token before starting a job. If an application does not currently have an API token attached, or the user does not have an API token, the user will be asked to create a token and attach it to the application.
To obtain the Cloud Platform API token from the Cloud Platform user interface:
Click the avatar in the upper right to open your profile (glossary term, activate to view definition), and click Account Settings.
The page is displayed.
You can now use the Pipelines client with your codebase. Your credentials are stored at ~/.acquia/pipelines/credentials.
If you have already installed the Pipelines client, run the pipelines self-update command to update your client to the latest available version. You can use the command pipelines --version to display your current version number.
Click Create Token to add an API token:
Pipelines CLI Client. A token label can help you identify your tokens if you create more than one.Click Create Token. The Create API Token dialog displays the API key and the API secret that make up the token. You can view the API key at any time in the Cloud Platform interface.
Do not close the dialog box until you record the API secret. Since you cannot display the API secret at a later time, be sure to configure the Pipelines client with the API secret before you close the dialog box.
If you lose the API secret, you must create another API token.
In a separate command prompt window, run the following command:
pipelines configurepipelines configure command prompts.If this content did not answer your questions, try searching or contacting our support team for further assistance.
Click Create Token to add an API token:
Pipelines CLI Client. A token label can help you identify your tokens if you create more than one.Click Create Token. The Create API Token dialog displays the API key and the API secret that make up the token. You can view the API key at any time in the Cloud Platform interface.
Do not close the dialog box until you record the API secret. Since you cannot display the API secret at a later time, be sure to configure the Pipelines client with the API secret before you close the dialog box.
If you lose the API secret, you must create another API token.
In a separate command prompt window, run the following command:
pipelines configurepipelines configure command prompts.If this content did not answer your questions, try searching or contacting our support team for further assistance.