If you're interested in Gemini Enterprise Agent Platform training clusters contact your sales representative for access.

Before you can deploy your first cluster on
Gemini Enterprise Agent Platform training clusters, you must configure your
Google Cloud project and environment. This guide covers all the necessary
prerequisites, which fall into three main categories:

- Project Access: Gaining access to the service, which is by invitation only.

- Resource Configuration: Enabling APIs and setting up the required VPC
  network and storage services.

- User Permissions: Granting the necessary IAM roles for cluster
  management and resource access.

Completing these steps prepares your project for a successful deployment.

## Prerequisites

To use training clusters, you must:

1. **Allowlist your project** by contacting your sales representative for access.
2. **Obtain capacity** for [GPU clusters](https://docs.cloud.google.com/ai-hypercomputer/docs/process-overview.md.txt#choose-a-consumption-option-and-obtain-capacity) in supported regions.
3. **Enable the necessary APIs** , including the Compute Engine, Filestore, Cloud Storage, Managed Lustre (optional), [Hypercomputer Configuration Service](https://docs.cloud.google.com/ai-hypercomputer/docs.md.txt), and Agent Platform APIs.
4. **Configure networking** by ensuring an existing network meets specific conditions (for example, Google Private Access, firewall rules) or by creating a new VPC network and subnetwork.
5. **Configure storage** by creating a zonal or regional Filestore instance to serve as the `/home` directory and optionally configuring a [Google Cloud managed Lustre instance](https://docs.cloud.google.com/managed-lustre/docs/overview.md.txt).
6. **Grant IAM permissions** to users for cluster management, storage access and SSH access to cluster nodes, as described in the [IAM permissions](https://docs.cloud.google.com/gemini-enterprise-agent-platform/machine-learning/training/training-clusters/get-started.md.txt#iam-permissions) section.

### Supported regions

Accelerator availability varies by region and zone. To check which accelerators
are available in each location, see
[Using accelerators](https://docs.cloud.google.com/gemini-enterprise-agent-platform/machine-learning/general/locations.md.txt#accelerators).

> [!NOTE]
> **Note:** Issuing a request to any regions that aren't on this list causes an API error.

- `us-central1`
- `us-east1`
- `us-east4`
- `us-east5`
- `us-south1`
- `us-west1`
- `us-west4`
- `asia-southeast1`
- `europe-west1`
- `europe-west4`
- `europe-north1`
- `asia-south2`
- `me-central1`

### IAM permissions

1. Grant the `roles/aiplatform.admin` role to users who will manage your training clusters.
2. Grant the `roles/aiplatform.viewer` role to users who only need to view clusters and their configurations.
3. Grant the following IAM roles to the user or service account that
   will manage (create, delete, and update) Managed Training clusters:

   | Role Name | Role ID |
   |---|---|
   | Compute Instance Admin (v1) | `roles/compute.instanceAdmin.v1` |
   | Logs Writer | `roles/logging.logWriter` |
   | Monitoring Metric Writer | `roles/monitoring.metricWriter` |
   | Service Account User | `roles/iam.serviceAccountUser` |
   | Service Networking Admin | `roles/servicenetworking.networksAdmin` |

4. To allow the cluster's nodes to read from and write to Cloud Storage buckets
   using Cloud Storage FUSE, grant the Storage Object User role (`roles/storage.objectUser`)
   to the service account used by the VMs.

5. For SSH access to the Slurm login nodes, grant the following permissions:

   | Permissions | Descriptions | Purpose |
   |---|---|---|
   | [Compute OS Login](https://docs.cloud.google.com/compute/docs/oslogin/set-up-oslogin.md.txt#configure_users) | Sign in to a VM as a standard (non-administrator) user. If `sudo` is needed then use Compute OS Admin Login instead. | SSH to the deployed login node |
   | [IAP-secured Tunnel User](https://docs.cloud.google.com/iap/docs/managing-access.md.txt) | Access Tunnel resources which use Identity-Aware Proxy. | SSH to the deployed login node |

### Enable APIs

1. Enable the Compute Engine API:

          gcloud services enable compute.googleapis.com

2. Enable the service networking since Filestore must be deployed before
   creating the cluster.

          gcloud services enable servicenetworking.googleapis.com

3. Enable the Cloud Storage API:

           gcloud services enable storage.googleapis.com

4. Enable the Lustre API (if using Lustre):

       gcloud services enable lustre.googleapis.com

5. Enable the HCS API:

       gcloud services enable hypercomputecluster.googleapis.com

6. Enable the [Gemini Enterprise API](https://console.cloud.google.com/):

       gcloud services enable aiplatform.googleapis.com

7. Enable the [Cloud Resource Manager API](https://console.cloud.google.com/):

       gcloud services enable cloudresourcemanager.googleapis.com

## What's next

For a detailed guide on creating a training cluster and running
your AI/ML workloads, contact your sales representative.