To create, delete, list or open Cloud IDE, you must install Acquia CLI.
When managing your Cloud Platform organization’s roles, you can configure two permissions:
Yes, you can use any Git repository such as GitHub, Bitbucket, or GitLab. You must install an SSH key in the Acquia Cloud IDE that has permissions to access the external repository.
Cloud IDE fully supports Drupal multisite applications, whether they’re hosted
on the Cloud Platform or Site Factory. When running the acli pull command,
you can select any arbitrary database or files directory to pull from.
Since Cloud IDE has only one preview URL, it has a limitation that you need to run one application and one database at a time. For Drupal 7 applications migrating to Drupal 9, Acquia has also preconfigured a second database.
Note
Cloud IDE only recognizes the /sites/default folder. For more information, see the KB article.
At any point in time, all IDEs run on the same version of the software. However,
Acquia cannot carry through a few updates to existing IDEs. For example, Acquia
might not be able to properly apply the updates to .bashrc if you have have
customized it greatly.
Therefore, Acquia continues to recommend customers to view Cloud IDE as a disposable resource that can be destroyed and recreated at will. To leverage the latest and greatest IDE software, ensure that you periodically recreate your IDE. Acquia recommends you to recreate your IDE once per quarter.
Acquia Cloud IDE is compatible with all Cloud Platform products and Site Factory.
Note
For Site Factory customers, Acquia recommends you to use :doc:Acquia BLT </blt/> because it helps you to automatically connect to the Cloud IDE database.
MySQL data is available under /home/ide/mysql-data.
The Drupal watchdog log is available under /var/log/drupal/drupal-watchdog.log.
Read our documentation about it
for more information.
Cloud IDE does not include a dedicated Acquia Search index (core). To allow the Cloud IDE preview site to write to an Acquia Search index, you must implement a code override for the environment. For more information, see Overriding Solr index connection switching.
Yes. However, you must add the Cloud IDE NAT gateways to your allowlist before you can successfully pull your application.
To know which IP addresses must be added, create a support ticket.
If you configure the Cloud Platform pipelines feature to work with your Git repository, all Git pushes to the repository, or pull requests (PRs) opened from your external provider, will trigger a pipelines job.
After Drupal is installed, the settings.php file gets write-protected. On
the Acquia Cloud Platform, this is not an issue as the filesystem is
read-only. However, in Acquia Cloud IDE, as you can edit files, you might run
into this issue.
To make Drupal’s settings.php writable, run the following command from
within the project directory:
ide:~/project $ chmod 644 docroot/sites/[yoursite]/settings.php
Once your changes are made, run the following command to make the file write-protected again:
ide:~/project $ chmod 444 docroot/sites/[yoursite]/settings.php
While trying to delete files or directories in the Drupal docroot, you might
get the following Permission denied messages:
ide:~$ rm -Rf project
rm: cannot remove 'project/docroot/sites/default/files': Permission denied
rm: cannot remove 'project/docroot/sites/default/default.settings.php': Permission denied
rm: cannot remove 'project/docroot/sites/default/settings.php': Permission denied
rm: cannot remove 'project/docroot/sites/default/default.services.yml': Permission denied
The above issue is related to Drupal permissions. Before you can delete those files or directories, you must change permissions.
To do so, run the following command:
chmod -R u+w /home/ide/project/docroot/sites/default
You can now delete those files and directories.
You might have a contributed or custom module that causes a redirect loop. Here’s a list of contributed modules that can cause this issue:
Your .htaccess file might be configured in a way that is incompatible with
Cloud IDE. See Excluding Acquia domains and non-production environments and redirecting visitor requests with the .htaccess file.
One of the first things new Acquia customers ask our Support team is how to disable Varnish in non-production Cloud Platform environments, so that they can view their changes immediately. Taking this feedback into account, we’ve decided not to include Varnish in Acquia Cloud IDE so it’s easier to develop Drupal without any external caching in the way.
It is useful to understand who created or deleted an IDE. To
achieve this, use Acquia CLI, as Acquia CLI
lets you filter out your Cloud Platform notifications easisly. Ensure that
you adjust the --limit parameter to make it relevant. The rule of thumb
is: the more you have Cloud Platform notifications, the more you’ll have to
increase the limit.
$ acli api:applications:notification-list myapplication --limit=100 | grep -B2 -A1 IDE
"uuid": "2b328ed0-74be-413d-a3f9-d19c74a96239",
"event": "RemoteIdeCreatedEvent",
"label": "IDE created",
"description": "IDE \"Mary\" created for \"My Application\".",
"created_at": "2021-03-15T13:35:21+00:00",
--
"uuid": "p14300b9-cf78-46b6-bh3a-005d73bc6836",
"event": "RemoteIdeDeletedEvent",
"label": "IDE removed",
"description": "IDE removed from \"My Application\".",
"created_at": "2021-03-12T20:58:32+00:00",
The Cloud Platform UI has the concept of application relationships. This means multiple applications can be logically tied together to a parent subscription. Therefore, it might be complicated to determine the application(s) containing those IDEs.
Querying the Cloud Platform API can help with getting this information. Run the
following command after replacing <SubscriptionUUID> with your subscription
UUID:
$ acli api:subscriptions:ide-list <SubscriptionUUID> | jq -r '.[] | "Label: " + .label + "\nOwner: " + ._embedded.owner.email + "\nSubscription: " + ._links.application.href + "\n"'
Label: myfirstide
Owner: [email protected]
Subscription: https://cloud.acquia.com/api/applications/<applicationUUID1>
Label: mysecondide
Owner: [email protected]
Subscription: https://cloud.acquia.com/api/applications/<applicationUUID2>
Label: mythirdide
Owner: [email protected]
Subscription: https://cloud.acquia.com/api/applications/<applicationUUID3>
To view all applications related to your subscription UUID, visit the following
URL: https://cloud.acquia.com/a/subscriptions/<SubscriptionUUID>/views
No. Cloud IDE is restricted to serving pages over port 80 only. Acquia might support custom ports in the future, such as port 8080, so you can run alternate development servers.
Follow the procedure to Add a shortcut to a website as an app.
When prompted to create the shortcut, make sure to check the Open as window
check box. To locate your application, visit chrome://apps/ in your browser.
53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842