Getting started with Code Studio¶

Review the prerequisites and complete the following steps to get started with Acquia Code Studio:

Prerequisites
Create a test account
Create a Code Studio project
Setting up a Code Studio project
Pushing Drupal application code into your Code Studio project

Prerequisites¶

The following prerequisites are required to use Acquia Code Studio:

Acquia Cloud Platform or Site Factory subscription
Code Studio entitlement
GitLab group and user account, which will be configured manually by Acquia
Acquia Cloud IDE

The following skills are required to use Acquia Code Studio:

Basic knowledge of the command line:
- For example, changing directories, using drush, and so on.
- Using git on the CLI. For more information, see git basics and gitlab101.
Basic understanding about building and installing Drupal.
Familiarity with Acquia Cloud Platform or Site Factory.

Important

The documentation assumes that you link Code Studio to your personal Acquia Cloud account through an SSH key. This may be considered a security risk. If a person can access your private SSH key in Code Studio, the person will have full access to any Acquia Cloud Platform application you have access to.

Acquia recommends creating a test account in Acquia Cloud Platform that you use exclusively for testing on Code Studio.

Creating a test account¶

Create a new test Acquia Cloud Platform user account using an email alias, such as jane.doe+codestudio@acquia.com.
Ensure that the new test user is assigned a role with the following permissions:
- Pull and deploy code, files, or databases to non-production environments
- Add SSH key to git repository
- Add SSH key to non-production environments
- Add a CD environment
- Delete a CD environment
- Manage environment variables on a non-production environment

For more information on Acquia Cloud Platform user roles and permissions, see About Cloud Platform permissions.

Creating a Code Studio project¶

You can accomplish either of the following using the Setting up a Code Studio project instructions:

Create and configure a new Acquia Code Studio project for your Acquia Cloud application.
(Re)configure an existing Acquia Code Studio project for your Acquia Cloud application.

By completing these instructions, you have a Code Studio with an AutoDevOps pipeline that automatically:

Builds, tests, and deploys your Drupal application for each commit.
Builds, tests, stages, and deploys your Drupal application for each merge request.
Performs scheduled pipelines to automatically update your Composer packages and deprecated custom code.

Setting up a Code Studio project¶

Create an Acquia Cloud IDE for your Acquia Cloud application.
Launch the Cloud IDE.
If you already have a Drupal application code on Acquia Cloud Platform, select Configure IDE and Copy Code From Cloud Platform.

To create a new Drupal application, run the acli new command and select acquia/drupal-recommended-project.
Generate a personal access token in Code Studio by performing the following steps:
1. Log in to Code Studio.
2. In the top right corner, click your profile icon.
3. Click Edit profile.
  
  The system displays your user settings.
4. Click Access Tokens.
5. In the Add a personal access token section, provide the required details to create a new personal access token for authenticating with Code Studio.
6. In Name, enter a name for the token.
7. In Selected Scopes, select the api and write_repository checkboxes.
8. Click Create personal access token.
  
  Code Studio creates your new personal access token and displays it on the screen.
9. Copy your new token.

Important

You must save your personal access token as you cannot access it again.

Run the following command to authenticate with Code Studio:
```
glab auth login
```
Select HTTPS when prompted.
Run the following commands to create and/or configure a Code Studio project for your Acquia Cloud application:
```
acli update
acli cs:wizard
```
The ACLI command walks you through the following process:
- (prompt) Creating an API token for Code Studio
- (automated) Creating an SSH key for Code Studio
- (automated) Setting GitLab CI/CD variables
- (automated) Creating a scheduled pipeline for automatic updates
- (automated) Pushing your Acquia Cloud application code to Code Studio

Note

Acquia Cloud Platform sends an email to your user account notifying that an SSH key labeled CODESTUDIO_+key is added to your Acquia account. This is a normal, expected, and secure email that serves as a notification.

Pushing Drupal application code into your Code Studio project¶

Requirements:

Complete the steps in the Setting up a Code Studio project.

Note

This includes an important step to run glab auth login.
Use an Acquia Cloud IDE.

Use one of the following options to continue the process of pushing Drupal application code into your Code Studio project:

Option 1: Use an existing Drupal application repository
Option 2: Generate a new Drupal application repository with Acquia CLI

Option 1: Use an existing Drupal Application repository¶

Requirements:

You must use a Drupal 8+ site.
You must use Composer to manage your application dependencies.
You must clone a copy of your Drupal code on your local machine or Cloud IDE.

To push an existing Drupal application repository into Code Studio:

Navigate to your Drupal project directory on your local machine or in a Cloud IDE:
```
cd <git repository path on your local machine or Cloud IDE>
```

Push to Code Studio:

git remote add codestudio http://code.acquia.com/[gitlab-group]/[gitlab-project-name].git

git push codestudio <enter branch name>

Option 2: Generate a new Drupal application repository with Acquia CLI¶

To generate a new Drupal application repository:

Run the acli new command and select acquia/drupal-recommended-project.
Navigate to your new directory by running the cd <directory name> command.
To use BLT, see the Using BLT section.
Follow the directions to use an existing Drupal Application repository.

Looking for something?