Download the PHP package typhonius/acquia_cli without Composer

[]()

Acquia Cli

The Acquia Cli tool provides developers, sysops, release managers and website administrators with a simple to use tool for obtaining information and running tasks on the Acquia Cloud.

Acquia Cli is simple to install and aligns to the permissions constructs already built into Acquia. The tool can be used for any task that can be completed using the Acquia web interface, and contains in-built instructions for each task.

If Acquia Cli doesn't have the task built in, simply create a ticket or a pull request for it to be included.

Pre-installation

Generating an API access token

To generate an API access token, login to https://cloud.acquia.com, then visit https://cloud.acquia.com/#/profile/tokens, and click Create Token.

• Provide a label for the access token, so it can be easily identified. Click Create Token.
• The token has been generated, copy the api key and api secret to a secure place. Make sure you record it now: you will not be able to retrieve this access token's secret again.

Downloading a version of the application

Select either the packaged application or the source application below before continuing with setup steps.

Installing the packaged application (easiest)

To install the packaged application quickly and easily, the following three steps may be executed.

Automatic updates

If the packaged application is used, it can be updated simply and easily whenever a new release is out by running the following command from anywhere on the computer:

Installing from source (advanced)

To install from source, clone the repository into a location on your computer with the following commands:

Setup

Choose one of the following methods to finish setting up your AcquiaCli installation.

Automatic setup

Once you have downloaded the application using one of the above steps, run the following commands to enter add your Acquia credentials.

1. Run acquiacli setup (or ./vendor/bin/acquiacli setup when used as a dependency in another project) which will ask for your credentials and automatically create this file.
2. Run acquiacli drush:aliases to download your available Drush aliases. Follow the instructions output by the command to install them.

Manual installation/setup

Alternatively, follow the below steps for a manual installation.

1. Copy the default.acquiacli.yml file to your project root and name it acquiacli.yml.
2. Add your Acquia key and secret to the acquiacli.yml file.

Environment Variables

Environmment variables can be used to store and provide the API key and secret, removing the need for configuration files. Refer to the values in default.acquiacli.yml for examples of how to configure these environment variables.

• ACQUIACLI_KEY The environment variable for the API key
• ACQUIACLI_SECRET The environment variable for the API secret
• ACQUIACLI_TIMEZONE Use a supported PHP timezone to see times in your locale.
• ACQUIACLI_FORMAT Use a supported PHP date string to show times in an alternate format.
• ACQUIACLI_TASKWAIT A number in seconds to wait before hitting the API to check the status of a task.
• ACQUIACLI_TIMEOUT A number in seconds before a task is considered to have timed out.

If environment variables are to be used, these will need to be placed in the relevant bash file on Linux/Mac e.g. $HOME/.bashrc or $HOME/.bash_profile in the following format.

Windows users will need to add the environment variables within their system settings.

Configuration

The Acquia Cli tool uses cascading configuration on the user's own machine to allow both global and per project credentials and overrides as needed.

Acquia Cli will load configuration in the following order with each step overriding matching array keys in the step prior:

1. Firstly, default configuration from default.acquiacli.yml in the project root/packaged with the Phar is loaded.
2. Next, if it exists, global configuration from $HOME/.acquiacli/acquiacli.yml is loaded.
3. Finally, if it exists, an acquiacli.yml file in the project root will be loaded. (Not applicable if using the Phar)
4. Environment variables take overall precedence for the key and secret, however other config won't be overridden.

The global and per project files may be deleted (manually) and recreated with acquiacli setup whenever a user wishes to do so.

Options may be manually set within the relevant acquiacli.yml file to change the following parameters under the extraconfig key:

Usage/Examples

Some of the following commands have aliases for simplicity e.g. environment:info has the alias of e:i. `

Additional parameters

The --limit, --sort, and --filter parameters can be added to every single command used with the Acquia Cli tool for providing more relevant information to users who are working on sites.

Limiting

To limit the number of returned entries, use --limit=x with a command.

Sorting

A comma-delimited string with fields can be used for sorting. The order of the fields is significant. A leading - in the field indicates the field should be sorted in a descending order. Not all fields are sortable.

Filtering

The filters query string parameter restricts the data returned from your request. Filtered queries restrict the rows that do (or do not) get included in the result by testing each row in the result against the filters. Not all fields are filterable.

There are eight filter operators that can be used and they must be URL encoded in order to be included. The operators are:

• Equals: =
• Does not equal: !=
• Greater than: >
• Less than: <
• Greater than or equal to: >=
• Less than or equal to: <=
• Contains substring: =@
• Does not contain substring: !@

Filters can be combined using OR and AND boolean logic. The OR operator is defined using a comma (,) and the AND operator is defined using a semi-colon (;).

See it in action

Command Parameters

Application UUID

If a command takes an application UUID as a parameter, it can be provided in one of three ways - see below for a description of hosting realm:

• The Acquia hosting ID on its own e.g. myacquiasite
• The full Acquia hosting realm and ID e.g. prod:myacquiasite
• The application UUID e.g. 8ff6c046-ec64-4ce4-bea6-27845ec18600

Hosting Realms

Acquia uses the concept of a 'realm' to differentiate between customers on the two tiers of hosting offered:

• prod: The 'prod' realm is exclusively for Acquia Cloud Enterprise (ACE) customers.
• devcloud: The 'devcloud' realm is exclusively for Acquia Cloud Professional (ACP) customers.

If no hosting realm is provided, prod is used by default. This can be overridden in the command by specifying a realm e.g. --realm=devcloud

Both the UUID and the hosting ID (with realm) for your applications may be discovered by running acquiacli application:list

Other parameters

Environment parameters take the label name of the environment e.g. dev

Organization parameters take the label name of the organization e.g. mycompany

All other parameters are currently provided in the UUID form, including but not limited to:

• Role ID
• Team ID

Commands using the following parameters will be automatically converted by the Acquia Cli tool using the SDK. This is achieved in the validateUuidHook method in the AcquiaCommand class using a @hook validate annotation.

• $uuid is converted to the UUID of the application

Helper functions exist in CloudApi.php to convert user supplied parameters into more useful objects.

• Environments may be converted into an EnvironmentResponse object by using the getEnvironment method.
• Organizations may be converted into an OrganizationResponse object by using the getOrganization method.

Usage on Windows

The Phar file has been tested minimally on Windows. It may be executed using PHP from a tool such as Chocolatey. You may run into cURL issues with SSL in some instances. The recommended approach to remediating SSL issues is to follow the basic instructions here. You may need to use alternate paths based on your PHP installation.