lullabot / robo-acquia
A Robo task runner for the Acquia Cloud API.
Installs: 68 760
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 4
Forks: 4
Open Issues: 3
Type:robo-tasks
Requires
- php: >=7.1.0
- consolidation/robo: >=1.0
- typhonius/acquia-php-sdk-v2: ^3.1.0
Requires (Dev)
- enlightn/security-checker: ^1.10
- friendsofphp/php-cs-fixer: ^2.15
- maglnet/composer-require-checker: ^3.8
- php-coveralls/php-coveralls: ^2.1
- phpmd/phpmd: ^2.7
- phpro/grumphp: ^1.16
- phpunit/phpunit: ^9.6
- roave/security-advisories: dev-master
- squizlabs/php_codesniffer: ^3.4
This package is auto-updated.
Last update: 2024-11-04 21:35:58 UTC
README
This composer package integrates the Robo task runner with the Acquia Cloud API v2 PHP SDK to facilitate running Acquia CLI tasks either in Robo or Drush. If you aren't already using Robo or Drush and would like a command-line tool to interact with the Acquia Cloud API, it's recommended you use acquia_cli instead.
Installation
From your project's composer root directory, require this library:
$ composer require lullabot/robo-acquia
Usage in a Robofile.php
First, generate an Acquia Cloud API token. Once done, you should store that token in a secure place for retrieval in your command. For the purposes of this documentation, we will use the robo.yml in our project root.
./robo.yml
acquia: key: 'd0697bfc-7f56-4942-9205-b5686bf5b3f5' secret: 'D5UfO/4FfNBWn4+0cUwpLOoFzfP7Qqib4AoY+wYGsKE='
You may want to specify a custom config yml and set appropriate permissions so that unpriveleged users cannot read the key / secret.
Then, in our RoboFile.php, we can add a new command to print out a list of tasks.
./RoboFile.php
<?php use Consolidation\OutputFormatters\StructuredData\UnstructuredListData; class RoboFile extends \Robo\Tasks { use Lullabot\RoboAcquia\LoadRoboAcquiaTasks; private $acquiaKey; private $acquiaSecret; private $acquiaApplicationUuid; public function __construct() { $this->acquiaKey = \Robo\Robo::Config()->get('acquia.key'); $this->acquiaSecret = \Robo\Robo::Config()->get('acquia.secret'); $this->acquiaApplicationUuid = '[your-acquia-application-uuid]'; } /** * List out tasks. * * @return \Consolidation\OutputFormatters\StructuredData\UnstructuredListData * * @command acquia:task-list */ public function acquiaTaskList() { $response = $this->taskAcquiaCloudApiStack($this->acquiaKey, $this->acquiaSecret) ->tasks($this->acquiaApplicationUuid) ->run(); $tasks = []; foreach ($response['result'] as $task) { /* @var \AcquiaCloudApi\Response\TaskResponse $task */ $tasks[$task->uuid] = sprintf('%s: %s', $task->name, $task->status); } return new UnstructuredListData($tasks); } }
Running the command should result in a list of tasks:
➜ vendor/bin/robo acquia:task-list
[Lullabot\RoboAcquia\AcquiaCloudApiStack] tasks ["[your-acquia-application-uuid]"]
cd7ed2f4-fd8c-46d2-bc63-a14d9abed6e1: 'CodeSwitched: completed'
14a981c6-eeb0-46df-b965-ce4d74e5214b: 'VarnishCleared: completed'
d3dcafab-89db-4e72-abd2-d2448a0408dc: 'CodeSwitched: completed'
6e73e741-6d2a-475f-a3b8-1ed29563c71d: 'DatabaseBackupCreated: completed'
08417f0b-3957-470e-8400-f39b090bf269: 'DatabaseBackupCreated: completed'
2967397d-e7b0-4155-8107-6eae3818a39f: 'DatabaseBackupCreated: completed'
d26ea593-d863-4bcd-8178-d6566b8cad88: 'DatabaseBackupCreated: completed'
f82374db-7695-49e2-b15b-45c0e3311c36: 'DatabaseBackupCreated: completed'
e4b03419-4300-411e-89f8-e015a7e3a9ab: 'DatabaseBackupCreated: completed'
ee4b0286-7e7c-4e51-a7cc-d9690b9778b3: 'DatabaseBackupCreated: completed'
0308b62b-aa1c-4fd3-8437-61f30625cc9a: 'DatabaseBackupCreated: completed'
5a1e7f71-926f-4d16-8874-e257952223a1: 'DatabaseBackupCreated: completed'
db4e3e35-cd74-4350-8474-cdc09e1dcbeb: 'DatabaseBackupCreated: completed'
55debdad-7bf4-4da5-a293-899bd7f96203: 'DatabaseBackupCreated: completed'
e158de43-336e-4f58-8203-779ea6f4bf7d: 'DatabaseBackupCreated: completed'
Waiting for task completion
Many Acquia Cloud API operations queue long-running tasks in the background. Unfortunately, the API does not respond with the task ID to allow for programmatic monitoring of the task execution. The Acquia Robo task provides for a rudimentary workaround for this. This method is not fool proof, since the program cannot be sure that the task it finds and monitors is the exact one triggered. If you have a busy Acquia task queu with the potential for a mismatch of Acquia tasks with the current running command list, do not use this.
If you are still here, here's how you can wait for a task to complete. In this example, we will be using Robo and waiting for the completion of a backup to complete and a code deploy to occur before proceeding.
<?php use Lullabot\RoboAcquia\AcquiaTaskWatcher; use Lullabot\RoboAcquia\LoadRoboAcquiaTasks; class RoboFile extends \Robo\Tasks { use LoadRoboAcquiaTasks; private $acquiaKey; private $acquiaSecret; private $acquiaApplicationUuid; public function __construct() { $this->acquiaKey = \Robo\Robo::Config()->get('acquia.key'); $this->acquiaSecret = \Robo\Robo::Config()->get('acquia.secret'); $this->acquiaApplicationUuid = '[your-acquia-application-uuid]'; } /** * Perform a code deploy. * * @param string $env_uuid * The Acquia environment UUID to deploy to. * @param string $branch * The tag or branch to deploy. Prefix a tag with tags/, e.g. tags/[tag]. * @param string $database_name * The name of the database to backup. Defaults to www. * * @return \Robo\Result * * @command acquia:deploy */ public function deploy($env_uuid, $branch, $database_name = 'www') { $stack = $this->taskAcquiaCloudApiStack($this->acquiaKey, $this->acquiaSecret); // Simple waitForTaskCompletion with no callback. This will wait quietly // before proceeding to the next item in the stack. $stack->createDatabaseBackup($env_uuid, $database_name) ->waitForTaskCompletion($this->acquiaApplicationUuid, AcquiaTaskWatcher::DATABASE_BACKUP_CREATED); // Deploy code and provide feedback with a callback. This will print a // message and provide feedback with a dot every 3 seconds. Once // complete, it will provide a confirmation dialog before continuing. $callback = function ($result) { static $i = 0; if ($i === 0) { $this->output()->write("\nWaiting for task completion."); } $i++; // Print a dot every 3 seconds. if ($i % 3 === 0) { $this->output()->write('.'); } // If result is empty, that means the job is complete. if (empty($result[0]->status)) { $this->writeln("\nTask completion detected!"); if (!$this->confirm('Would you like to continue?')) { throw new \Robo\Exception\TaskExitException(static::class, 'Cancelled.', \Robo\Result::EXITCODE_USER_CANCEL); } } }; $stack->switchCode($env_uuid, $branch) ->waitForTaskCompletion($this->acquiaApplicationUuid, AcquiaTaskWatcher::CODE_SWITCHED, 240, $callback); // Run the stack of Acquia tasks now. $result = $stack->run(); if ($result->wasSuccessful()) { $this->yell("Backup created and code deployed!"); } return $result; } }
Credits
This Robo task runner was developed by Lullabot for Digital Services Georgia.