Configurazione di un progetto e di un ambiente di sviluppo

Per iniziare a utilizzare Vertex AI, questa pagina illustra come creare un progetto Google Cloud e abilitare le API Vertex AI. Se non disponi delle autorizzazioni per eseguire queste attività, chiedi a un amministratore di configurare un progetto e attivare Vertex AI per te. In questa pagina viene spiegato anche come configurare Google Cloud CLI nell'ambiente di sviluppo locale.

Configura un progetto

Per configurare un progetto, segui questi passaggi:

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Configura l'autenticazione

    Select the tabs for how you plan to access the API:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. Update and install gcloud components:

    gcloud components update
    gcloud components install beta

    4. Per configurare gcloud CLI in modo che utilizzi l'usurpazione di identità dell'account di servizio per autenticarsi alle API di Google anziché alle credenziali utente, esegui il seguente comando: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Per saperne di più, vedi Rappresentazione dell'account di servizio.

    Librerie client

    Per utilizzare le librerie client in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Per saperne di più, consulta Configurare l'ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud.

    Per configurare il file ADC locale in modo che utilizzi l'usurpazione dell'identità dell'account di servizio per autenticarsi alle API di Google anziché alle credenziali utente, esegui il seguente comando: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    Per saperne di più, vedi Rappresentazione dell'account di servizio.

    REST

    Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizza le credenziali fornite all'interfaccia alla gcloud CLI.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

    Puoi utilizzare l'usurpazione di identità dell'account di servizio per generare un token di accesso per le richieste all'API REST. Per saperne di più, consulta Account di servizio impersonato.

    Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Set up Application Default Credentials for code running on Google Cloud nella documentazione sull'autenticazione di Google Cloud.

Chiedi a un amministratore di configurare un progetto Vertex AI per te

Questa sezione descrive come un amministratore concede i ruoli necessari per utilizzare Vertex AI.

  1. Determina un nome e un ID progetto significativi per identificare il progetto. Se fai parte di un'organizzazione o prevedi di creare più progetti, considera quali convenzioni di denominazione e gerarchie di cartelle vengono seguite o potrebbero essere seguite per chiarire l'organizzazione dei progetti.
  2. Ruoli richiesti:
    1. L'accesso alla maggior parte delle funzionalità di Vertex AI è concesso dal ruolo IAM (roles/aiplatform.user) Vertex AI User e dovrebbe essere sufficiente per la maggior parte degli utenti di Vertex AI. Per il controllo completo delle risorse Vertex AI, puoi richiedere il ruolo Amministratore Vertex AI (roles/aiplatform.admin). Per scoprire le differenze tra questi e altri ruoli di Vertex AI, consulta Controllo dell'controllo dell'accesso di Vertex AI con IAM.
    2. Se intendi utilizzare anche le istanze di Vertex AI Workbench in Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Amministratore nuclei (roles/notebooks.admin) per il progetto, nonché il ruolo IAM Utente account di servizio (roles/iam.serviceAccountUser) nel progetto o nell'account di servizio predefinito di Compute Engine.
    3. Inoltre, per abilitare le API necessarie, devi disporre del ruolo IAM Amministratore utilizzo servizio (roles/serviceusage.serviceUsageAdmin) o l'amministratore deve abilitare le API per te seguendo i primi passaggi.
  3. Chiedi all'amministratore di abilitare le API Vertex AI per te. Se ti è stato concesso il ruolo IAM Amministratore utilizzo servizio (roles/serviceusage.serviceUsageAdmin), potrai eseguire questa operazione autonomamente.

Passaggi successivi