This page describes any known issues with Cloud IDE.
If you encounter any difficulties with Cloud IDE, contact Acquia Support for assistance.
If you’re working with multiple IDEs simultaneously, you might receive the following error message when performing an action that requires invoking a Cloud Platform API endpoint. For example, when using Acquia CLI.
Your Cloud Platform API credentials are invalid.
It happens because at the moment only one IDE at a time can be authenticated against the Cloud Platform API. To work around this issue, ensure that only one IDE is opened in a browser tab at any given point in time.
Cloud IDE automatically connects to the Cloud Platform API. However, sometimes the connection might fail. As a workaround, you can generate a Cloud Platform API token and manually authenticate using Acquia CLI with the following command:
acli auth:login
A known Theia issue is that the Git history panel does not respect the maximum count (100) of Git commits to display. Depending upon the size of your Git history, this can lead to running into performance issues with the IDE being locked for a few seconds and up to a minute while all commits and file changes are being fetched.
Workaround:
Acquia recommends that you use the git log
command in the IDE Terminal window
until this issue is fixed.
In Cloud IDE, Acquia preconfigures your database connection so that you can run
your application without requiring manual configuration of the Drupal database
array. However, if you use database prefixes, Acquia cannot detect
this custom setting and you must configure the Drupal database array
manually in settings.php
.
The visual database editor offers the option to generate and locally download a MySQL backup of your tables. Due to the very nature of PHP processes and fixed timeouts across the stack (Apache and nginx), it is normal that databases larger than a few hundred megabytes will fail to download.
The best practice to download a database backup from Cloud Platform is
to leverage Acquia CLI, by using the pull:db --no-import
command.
Alternatively, to download the IDE database, use Drush or a raw MySQL command
instead.
In Cloud IDE, pulling an application times out with the following error when the Shield tunnel is down.
ssh: connect to host myapp01live.ssh.enterprise-g1.acquia-sites.com port 22: Connection timed out
To prevent this issue, use a network monitoring tool to generate keepalive pings. For more information, see resolving Shield issues.
Sending emails from Cloud IDE is not currently supported. As a workaround, you can use an external SMTP relay.
Acquia automatically adds and manages SSH keys in Cloud IDE so that you can use the Theia Git plugin automatically.
If you create a custom SSH key with a passphrase, Theia cannot load the Git
plugin because it does not know the passphrase. As a result, your IDE fails
to load entirely with the Error occurred while trying to proxy
error.
Acquia recommends that you use the SSH public key that Acquia automatically
creates in your IDE. It is with the form id_rsa_acquia_ide_<UUID>.pub
so that you can easily determine the IDE the key belongs to at any point
in time.
For monitoring and authentication purposes, Cloud IDE has defined a number of reserved paths. This means those paths cannot be used in your Drupal application and will fail to load entirely for the expected node or endpoint.
Here is the list of reserved paths:
/health
/check
/oauth
/forbidden
The workaround is to use different paths in your Drupal application.
The Dark Reader browser extension (Chrome / Firefox) increases the number of HTTP requests per page load as it analyzes images and sends them to a third party to see if the colors should be inverted. This results in too many API requests to the IDE proxy and display the following error:
{
"error": "rate_limit_exceeded",
"message": "You have reached the maximum number of requests to the API. Please try again later."
}
The Vimium browser extension (Chrome / Firefox) provides keyboard shortcuts for navigation and control in the browser. It might break the IDE functionality, such as the Vim editor in the terminal. Acquia recommends disabling the Vimium browser extension by creating a rule.
To create a rule, go to Vimium Options, and add the following URL in the “Patterns” field. Click Add Rule, and then click Save Changes.
https?://*.ide.ahdev.cloud/*
By design, BLT does not recognize Cloud IDE environments as local environments.
Workaround:
Use the BLT plugin that allows a Cloud IDE environment to be treated like a local environment. For more information on this plugin, see Using Cloud IDE with BLT.