Hello image data: Set up your project and environment

If you plan to use the Vertex AI SDK for Python, make sure that the service account initializing the client has the Vertex AI Service Agent (roles/aiplatform.serviceAgent) IAM role.

You'll set up your Google Cloud project to use Vertex AI. Then create a Cloud Storage bucket and copy image files to use for training an AutoML image classification model.

This tutorial has several pages:

  1. Set up your project and environment.

  2. Create an image classification dataset, and import images.

  3. Train an AutoML image classification model.

  4. Evaluate and analyze model performance.

  5. Deploy a model to an endpoint, and send a prediction.

  6. Clean up your project.

Each page assumes that you have already performed the instructions from the previous pages of the tutorial.

Before you begin

Complete the following steps before using Vertex AI functionality.

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
  3. Verify that billing is enabled for your Google Cloud project.

  4. Open Cloud Shell. Cloud Shell is an interactive shell environment for Google Cloud that lets you manage your projects and resources from your web browser.
  5. Go to Cloud Shell
  6. In the Cloud Shell, set the current project to your Google Cloud project ID and store it in the projectid shell variable:
      gcloud config set project PROJECT_ID &&
      projectid=PROJECT_ID &&
      echo $projectid
    Replace PROJECT_ID with your project ID. You can locate your project ID in the Google Cloud console. For more information, see Find your project ID.
  7. Enable the IAM, Compute Engine, Notebooks, Cloud Storage, and Vertex AI APIs:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    gcloud services enable iam.googleapis.com  compute.googleapis.com notebooks.googleapis.com storage.googleapis.com aiplatform.googleapis.com
  8. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/aiplatform.user, roles/storage.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    Replace the following:

    • PROJECT_ID: Your project ID.
    • USER_IDENTIFIER: The identifier for your user account. For example, myemail@example.com.
    • ROLE: The IAM role that you grant to your user account.
  9. The Vertex AI User (roles/aiplatform.user) IAM role provides access to use all resources in Vertex AI. The Storage Admin (roles/storage.admin) role you store the document's training dataset in Cloud Storage.

What's next

Follow the next page of this tutorial to use the Google Cloud console to create an image classification dataset and import images hosted in a public Cloud Storage bucket.