This document provides the steps to perform the following:
Link your installation of Acquia CLI to the Cloud Platform API
Set up SSH access to your Cloud Platform environment
Create a new Drupal project on your local machine, after you have installed Acquia CLI
Note
To troubleshoot most of the error messages related to Acquia CLI, run the commands again
using the --verbose
option to diagnose issues.
To begin using Acquia CLI, authenticate against your Cloud Platform account. Open your Terminal and type:
acli auth:login
This command prompts you to open the page from which you can create a Cloud Platform API token in the Cloud Platform user interface.
Note
If you use other Acquia products, such as BLT or Pipelines CLI, your machine might already be authenticated with the Cloud Platform, and you can reuse an existing token.
See the following example:
$ acli auth:login
You will need a Cloud Platform API token from
https://cloud.acquia.com/a/profile/tokens
Do you want to open this page to generate a token now? y
Please enter your API Key: <ENTER API KEY HERE>
Please enter your API Secret: <ENTER API SECRET HERE>
Saved credentials to /home/<user>/.acquia/cloud_api.conf
You can also authenticate in a non-interactive manner through Terminal by providing your tokens as parameters or environment variables. For more information about providing your tokens as parameters, run the following command:
acli auth:login --help
In priority order, Acquia CLI will accept the following:
An access token stored in the ACLI_ACCESS_TOKEN
environment variable with
its corresponding ACLI_ACCESS_TOKEN_EXPIRY
value
An ACLI_KEY
environment variable and its corresponding ACLI_SECRET
Values defined in ~/.acquia/cloud_api.conf
as generated by the acli
auth:login
command
To interact with Cloud Platform, you must generate and upload an SSH key. This allows you to access your Cloud Platform environments using SSH.
Run the following command:
acli ssh-key:create-upload
For more information on Acquia CLI, see Acquia CLI commands.