Getting started with Cloud IDE¶

Setting up Cloud IDE¶

To install your IDE, complete the following steps:

1. Sign in to Cloud Platform.
2. Open your local terminal application.
3. Generate a Cloud Platform API token, and record a copy of your API Key and API Secret.
4. From the command line, run acli auth:login and follow the prompts to provide your API Key and API Secret.
5. From the command line, run acli ide:create. Enter a descriptive label for your IDE, and then select the application with Cloud IDE enabled.

Once the IDE is created, Acquia CLI will display both a link to your IDE and a link to your Drupal website’s public URL. You can open your IDE at any time by running the following command from your terminal and selecting the IDE you wish to open:

acli ide:open

For information about changing preferences in Cloud IDE, see Settings and preferences.

Cloning your Cloud application to your IDE¶

After setting up your IDE, clone your Cloud Platform application to your IDE by completing the following steps:

1. From the command line on your local computer, run the following command to open your IDE and select the IDE you wish to open:

   acli ide:open
   

2. On the Cloud IDE Get Started Page, click CONFIGURE IDE to connect the IDE to your Cloud Platform account. This authenticates the IDE with the Cloud Platform API and then automatically generates an SSH key that is linked to your Cloud Platform user account.

   

3. Click the COPY FROM ACQUIA CLOUD button to copy your existing Cloud Platform application into the Cloud IDE. This will copy your application’s code, databases, and files into the Cloud IDE.

   Note

   Alternatively, you can leverage acli refresh for refreshing your code, database, files from the Cloud Platform, and run scripts to set up your application in the IDE. By default the command refreshes your code, database, and files. It also runs scripts to configure your application. You can use optional parameters to specify what you don’t want to refresh. Use acli refresh --help to get the list of optional parameters.

Cloning your application from a Github repository to your IDE¶

To clone your application from a Github repository to your IDE, complete the following steps:

1. Copy the contents of your IDE SSH public key at /home/ide/.ssh/id_rsa_acquia_ide_<UUID>. Make sure to replace the following example code with your own IDE SSH public key:

   $ cat /home/ide/.ssh/id_rsa_acquia_ide_<UUID>.pub
   ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDia6OKJKFQYmQysWWL6+bRpjfGbGHaYx3b9mdqhRxtBr9
   +q1TUUljNPX3dT6y+GsQEC4ImAhm82fPpFjEpwPGrM5+kvlk4zkLMV+TILnQXA9athf3CWPTCUQxyY9t5ZO
   wbmjRPhFeDKCVogSAjHdCoVRQfKOy1J0ffO+I7nnjVNbhMLfeL1PU1WZhyx4tBRweKX44QZA1hccrIfw0SV
   rXnJ72Gm/0SESnCaAkfnEjo8+wwyiSNfTFOfY/MrgkNjePaxTPP0LaFwoiGpfyNRNAd6w+ztfIQa34kfviT
   NCp4Us/cGrtLH6AYvrtVbIwToNdXvTPliz+D1GJYcaWlbfdwHselKDQffVbnYLbpgopWgDJjmy/ex0TG4Gv
   Qnn1CVHZayKbivuVT0sEgcWrOmyKcqpO2PlZ+W4SCpCdQZ3Tz6I0I+O9VKLF2lauKtjHkmpfOxI46YkLEA8
   6sTuK3s9cyt8irn9X/4ggV7D4PbiYdaweQMjRgQPVhLcB+dosDml750bnEGjjY1iFJwIbT69gF5zucrheIr
   zr6OarwPjwW1V314sKfszssjSYpablgYYm/8zOjowKpgf+6XS0Ug0aKePWRPUVfSdnn5fDBEr9U3K4r3cv5
   L6Ol0GIJVcfEi7Vq6OsmDxgiEfAzKdpXaHZBwacpATrawZ0DQqr58V/xCw== [email protected]
   4ba0-b737-13187c3c8b96-6799564b7d-rbn58
   

2. Paste the SSH public key into the Key field at https://github.com/settings/ssh/new:

   

3. You can clone your repository into the correct folder in the IDE with the following command, replacing [your-URL.git] with the Git URL of your repository:

   git clone [your-URL.git] /home/ide/project
   

   Note

   When pulling the code from an external Git repository, you can use acli refresh --no-code to only pull the database and files from your Cloud Platform application.

View your application within Cloud IDE by clicking Open Drupal Site in the admin menu. Then click Open site in a new tab to open the application in a new tab in your browser. Clicking Open Site in the IDE alone will open the application in the Preview pane.