# Open in Cloud Shell

> A guided Cloud Shell walkthrough that picks the project, enables the five APIs, runs applane-setup.sh and links the two console steps. Nothing to install.

Source: https://docs.applane.dev/gcp-admins/setup/cloud-shell/

**Who:** GCP admin  
**Time:** 10 minutes

Cloud Shell is a terminal Google runs in your browser, already signed in as you, with `gcloud` installed. The walkthrough opens the Applane setup repository in it and shows a step panel on the side.

Pick this when you want a one-off by hand and nothing installed on your machine.

## Open it

Click the button. It clones the setup repository into your Cloud Shell and opens the tutorial panel.

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/open?cloudshell_git_repo=<APPLANE_SETUP_REPO_URL>&cloudshell_tutorial=infra/cloudshell/tutorial.md&cloudshell_workspace=infra)

The link with the repository filled in is on the Applane console's Setup page.

## What the panel walks you through

1. **Pick the project.** A project picker with a billing check. An existing project is fine. Set it as active in the terminal:

   ```bash
   gcloud config set project <GCP_PROJECT_ID>
   export GOOGLE_CLOUD_PROJECT=<GCP_PROJECT_ID>
   ```

2. **Enable the five APIs.** A button in the panel, or let the script do it in the next step. Both enable the same five.

3. **Run the setup script.** Preview first, then apply:

   ```bash
   GROUP=applane-builders@<YOUR_DOMAIN>
   scripts/applane-setup.sh --dry-run --project $GOOGLE_CLOUD_PROJECT --group $GROUP
   scripts/applane-setup.sh --project $GOOGLE_CLOUD_PROJECT --group $GROUP
   ```

   With a budget alert:

   ```bash
   gcloud billing projects describe $GOOGLE_CLOUD_PROJECT --format='value(billingAccountName)'
   scripts/applane-setup.sh --project $GOOGLE_CLOUD_PROJECT --group $GROUP \
     --budget-account <BILLING_ACCOUNT_ID> --budget-amount 50
   ```

4. **Consent screen and OAuth client.** The panel opens APIs & Services for you. Follow [OAuth consent screen](https://docs.applane.dev/gcp-admins/oauth-consent-screen/) and [OAuth client](https://docs.applane.dev/gcp-admins/oauth-client/).

5. **Check the result.**

   ```bash
   scripts/applane-setup.sh --check --project $GOOGLE_CLOUD_PROJECT --group $GROUP
   ```

   Every line should read `PASS`. The two `INFO` lines (the per-user Apps Script API setting and the OAuth client) are verified by the [setup checker in the Applane console](https://docs.applane.dev/console/setup-checklist/) instead.

## What it creates

The same three things as every option: the five APIs enabled, `roles/aiplatform.user` on the builders group, and a budget alert if you passed a billing account. See [Script](https://docs.applane.dev/gcp-admins/setup/script/) for the exact commands the script runs.

## Remove it

Cloud Shell keeps no state. To undo, follow the GCP part of [Uninstall](https://docs.applane.dev/workspace-admins/uninstall/#gcp-admin).